譯文地址   

2.如何使用導航和取得進步？

在黑客日和講習班開始之前我需要做些什麼呢？

來之前你應該準備好你的膝上型電腦並搭建好當天需要的環境：

• 檢查硬體要求/作業系統/軟體要求
• 下載支撐軟體
• 搭建或者下載虛擬機器
• 搭建或者下載Docker映象
• 檢查虛擬機器和Docker映象是否正常工作
• 檢查OpenJDK是否正常工作

在“參加黑客日和講習班之前應該如何準備”中檢視對於以上幾點的詳細解釋。如果這個對你來說不適用或者你已經完成了這些工作，那麼請看下面的部分。
活動當天如何在你的機器上搭建環境？
看完“參加黑客日和講習班之前應該如何準備”之後，請看“活動當天如何在你的機器上搭建環境”。如果這個對你來說不適用或者你已經完成了這些工作，那麼請看下面的部分。

• 我是學生/初學者，對Adopt OpenJDK一點都不熟悉，希望學習，以前從未參加過OpenJDK黑客日，我該如何開始？
  請看“初等級別”中的步驟
• 我是學生/專業人士，對Adopt OpenJDK不是很熟悉，以前參加過OpenJDK黑客日，我該從哪裡繼續？
  請看“中等級別”中的步驟
•  我是專家/專業人士，對OpenJDK黑客日很熟悉，對相關技術/Java/JVM/OpenJDK非常熟悉，我能從你們這裡得到哪些好處？請看“高等級別”中的步驟

我在家有充裕的時間和頻寬，我該如何利用？或者說參加完黑客日和講習班後我應該做什麼。
請看“利用你的時間去學習的最好方法”。

我有一些想法而且我希望分享，並且希望對這本書有所貢獻？

2.1. 初等級別

我是學生/專業人士，對Adopt OpenJDK不是很熟悉，以前參加過OpenJDK黑客日，我該如何開始？
“Adopt OpenJDK – 入門指南” – 簡單地閱讀一下這些網頁和子網頁，當你在家的時候或者空閒的時候認真閱讀。
“虛擬機器” – 瀏覽這些網頁並根據頻寬和時間來建立和下載虛擬機器。或者向輔助商（請在相關網頁檢視更詳細的說明）索取虛擬機器映象。
“建立你自己的OpenJDK”  – 瀏覽這個部分並用你通過前面幾個步驟中搭建好的虛擬機器來搭建不同版本的OpenJDK。
接下來請看“中等級別”

2.2. 中等級別

我是學生/專業人士，對Adopt OpenJDK不是很熟悉，以前參加過OpenJDK黑客日，我該從哪裡繼續？

2.3.高等級別

我是專家/專業人士，對OpenJDK黑客日很熟悉，對相關技術/Java/JVM/OpenJDK非常熟悉，我能從你們這裡得到哪些好處？
•”構建效能優化的命令列引數”
•好好看看“高階階段”吧。
•最後如果你已經完成了上述步驟，看下“目錄”，看看還有哪些你沒有看的。

2.4. 有空有頻寬

我在家有充裕的時間和頻寬，我該如何利用？或者說參加完黑客日和講習班後我應該做什麼。
好好看看下面這幾個部分吧：
•“Adopt OpenJDK 入門指南”
•“虛擬機器”
•“二進位制”
如果你完成了，看看“目錄”然後還有沒有你沒有看過的

2.5. 如何對本書做出貢獻

通過GitBook

通過GitHub

1.建立一個分支，瀏覽這個網站來看如何建立分支：

https://github.com/neomatrix369/adoptopenjdk-getting-started-kit#fork-destination-box
2.把你的版本複製到你的工作空間裡

git clone [email protected]:{YOUR_GITHUB_ACCOUNT}/adoptopenjdk-getting-started-kit.git

3.新增Upstream

git remote add –track master upstream git://github.com/neomatrix369/adoptopenjdk-getting-started-kit.git
現在你就可以修改原是倉庫中你的分支了 git fetch upstream和 git merge upstream/master

1.提交修改後的檔案
git add
git commit -am "meaningful description about your changes"
2.推送檔案 git push
3.建立一個pull請求，在GitHub中檢視你的倉庫：https://github.com/{YOUR_GITHUB_ACCOUNT}/adoptopenjdk-getting-started-kit/pulls點選New Pull Request按鈕來新建

如何確認本書的修改

我們在repo的根資料夾中有兩個指令碼，可以產生哪裡發生了改變的標記頁，像這樣。
生成哪裡發生了改變的標記的指令碼叫做 whatsChanged.sh和whatsChangedForAllLanguages.sh
請隨意改進，以便使它能夠持續不斷地發揮它的作用甚至變得更好。

2.6. 參加黑客日和講習班之前應該如何準備？

注：如果你遇到問題請參考“Known issu”，如果在那裡無法找到解決方法，請“Contribute to this book”或者“報告給我們”。
硬體要求/作業系統/軟體要求
以下是建立和使用虛擬機器的硬體要求：
64-bit CPU running (> 2.0 Ghz)
64-bit OS (Linux, MacOS, Windows)
20-25 GB free disk space minimum
4-8 GB RAM minimum
平臺/軟體要求：
VirtualBox installed
Java 7 and 8 installed*
Vagrant installed
Docker installed （可選）
Boot2Docker installed（可選）
*取決於你是在本地構建OpenJDK 還是在虛擬機器或者Vagrant或者Docker，你需要將它下載到虛擬機器或者本機中
其他要求:
瞭解Java
瞭解如何建立系統, maven, git, 等…
Linux和bash的一些經驗
關於OpenJDK的一些知識
關於vagrant (可選,除非你將要使用這項技術來工作)的一些經驗
docker(可選,除非你將要使用這項技術來工作)的一些經驗
下載支撐軟體
VirtualBox (用來載入虛擬機器): https://www.virtualbox.org/
Java (安裝在虛擬機器中): http://www.oracle.com/technetwork/java/javase/
Vagrant (用來啟動vagrant boxes) https://www.vagrantup.com/
可選
Docker: https://docs.docker.com/installation/#installation
Boot2Docker: http://boot2docker.io/
IntelliJ: https://www.jetbrains.com/idea/
Eclipse: https://eclipse.org/
Netbeans: https://netbeans.org/
SonarQube: http://www.sonarqube.org/
下載和複製做好的虛擬機器
下載下列虛擬機器 – Ubuntu 12.04 VM with OpenJDK9 (jigsaw) with Sources and IntelliJ:
https://copy.com/tA0l06zDrJNNDKVL
帳號: openjdk
密碼: openjdk123
你也可以通過行動硬碟將虛擬機器映象拷貝到本地磁碟
載入映象可以通過  File | Import Appliances…  VirtualBox main menu.
在本地或者雲中建立OpenJDK
在“Building OpenJDK 9”中檢視如何在執行在你電腦甚至是雲裡的作業系統（如Linux, MacOS或Windows）中構建OpenJDK
驗證安裝和環境
在你的本機或者虛擬機器中，進入openjdk*資料夾，然後執行以下命令（見Build OpenJDK 9）:
*openjdk – sources/jdk9 or dev/jdk9_dev
作為虛擬機器，你可以下載或複製Vagrant boxes或Docker image，已經有建立好的映象，你可以在講習班繼續使用無需修改基於程式碼的更新並重新編譯。
bash get_source.sh
因此請不要在vagrant box或Docker containers虛擬機器中執行上面的命令。因為這會導致等待映象完成編譯或者有時候編譯中斷，這會需要大量的投入和修復工作。
所以應該執行以下兩段命令:
bash configure –disable-warnings-as-errors
make images
注：請同樣避免 ‘make clean images’ 命令，除非真的必要，否則將需要等待到整個編譯過程完成。
如果以上命令中的任何一個失敗，那麼OpenJDK環境
最後
完成後請進入“How to navigate and make progress ? ”，順著流程進入下一步。
對於那些能夠順利完成以上步驟並且想了解Vagrant和Docker指令碼的有經驗的使用者，可以檢視“ Additional pre-hackday actions for experienced attendees”。

2.7. 有經驗的參加者的額外動作

建立你自己的虛擬機器
注：你需要很好的頻寬來下載檔案以及大量的時間來建立。不是通過wifi連線完成。
“Build your own VM ”
“Build your own light-weight VM”

檢查虛擬機器
將虛擬機器載入VirtualBox
啟動虛擬機器
在虛擬機器中執行一些程式
關閉虛擬機器

下載/複製Docker映象
一旦映象下載完成，可以在不同的裝置之間複製，詳情見”Copy Images”
或者
建立映象
在Docker images下的“Build Images”裡檢視

檢驗安裝和環境
啟動虛擬機器或者Docker Container，進入jdk8或jdk9所在資料夾，執行以下命令：
bash configure
make clean images.
如果他們中的任何一個執行失敗了就說明環境沒有設定正確或者建立過程在OpenJDK master中中斷

最後
完成後請進入“How to navigate and make progress ? ”，順著流程進入下一步。

2.8. 當天如何設定你機器中的環境

注：如果你遇到問題請參考“Known issu”，如果在那裡無法找到解決方法，請“Contribute to this book”或者“報告給我們”
在本地或者雲中建立OpenJDK
注：除非你有很高的網路頻寬，否則請不要嘗試在本地建立OpenJDK
你無需複製任何東西，只需要在雲服務提供商（如亞馬遜或其他提供者）那裡註冊一下。
例項化一個執行你選擇的系統的box，然後按照“Adopt OpenJDK Build Instruction”中提到的步驟（我們推薦Linux發行版如Ubuntu或Fedora或Centos）
在Virtualbox虛擬機器中建立OpenJDK
將下列檔案從移動裝置中複製到你的機器
VirtualBox for Ubuntu/[binaries]
or
VirtualBox for MacOS/[binaries]
or
VirtualBox for Windows/[binaries]
OpenJDK VM Images/OpenJDK9_Jigsaw_vm
or
OpenJDK VM Images/OpenJDK VM with no IDE support
or
OpenJDK VM Images/OpenJDK VM with Eclipse
OpenJDK VM Images/OpenJDK VM passwords.txt

安裝VirtualBox
執行VirtualBox （Oracle VirtualBox）
匯入各自的虛擬機器（不要建立新的VirtualBox設定）
啟動虛擬機器
最後進入“Building OpenJDK 9”這個章節
在Vagrant script建立的虛擬機器中建立OpenJDK
將下列檔案從移動裝置中複製到你的機器: Vagrant/. Vagrant/openjdk-vagrant-images Vagrant/[binaries]
安裝Vagrant並確保其在各自的環境中正常工作
解壓Vagrant資料夾中的.tar.gz檔案
閱讀README.md來了解各個指令碼檔案是做什麼的
確定之後使用這些指令碼
注：不要通過執行Vagrantfile來建立映象 – 這需要很長時間已經很高的網路頻寬
注：沒有針對Windows的指令碼（歡迎貢獻）
在Docker script建立的容器中建立OpenJDK
將下列檔案從移動裝置中複製到你的機器：
Docker/*.*
Docker/OpenJDK9
Docker/OpenJDK9-baseimage
安裝Docker（和Boot2Docker）並確保其在各自的環境中正常執行
閱讀README.md來了解各個指令碼檔案是做什麼的
確定之後使用這些指令碼
用loadImageToFile.sh指令碼來載入docker映象到你本地的倉庫
注：不要通過執行Dockerfile 來建立映象 – 這需要很長時間已經很高的網路頻寬
注：沒有針對Windows的指令碼（歡迎貢獻）
最後
完成後請進入“How to navigate and make progress ? ”，順著流程進入下一步。