814
Adopt Open JDK官方文檔(二)如何使用導航和取得進步？
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黑客日我該從哪裏繼續
•“搭建你自己的虛擬機”或“搭建你自己的輕量級虛擬機”然後看“在Host 與 Guest VM 之間共享文件”最後看“源代碼”。
•如果想獲取OpenJDK目錄和文檔結構的概覽請看“各個OpenJDK的文檔結構”
•請先試一試“改變Random.java類”。
•在進行下一步之前請先閱讀“如何使用JTReg… – JAVA回歸測試工具”來了解JAVA的回歸測試框架
•接著試試“改變StringBuffer.java類來添加一個新的方法”
•看看“OpenJDK項目”和“Adopt OpenJDK項目”
•“測試JAVA早期項目”
•“OpenJDK項目代碼分析”和“OpenJDK代碼覆蓋率”有趣
•“補丁 – 如何創建和提交他們” – 如何創建補丁和提交給OpenJDK小組
•看一下“OpenJDK漏洞數據庫 (JIRA)”
•“OpenJDK9 – jimage ”有趣
•最後請看“高等級別”
2.3.高等級別
我是專家/專業人士對OpenJDK黑客日很熟悉對相關技術/Java/JVM/OpenJDK非常熟悉我能從你們這裏得到哪些好處
•”構建性能優化的命令行參數”
•好好看看“高級階段”吧。
•最後如果你已經完成了上述步驟看下“目錄”看看還有哪些你沒有看的。
2.4. 有空有帶寬
我在家有充裕的時間和帶寬我該如何利用或者說參加完黑客日和講習班後我應該做什麼。
好好看看下麵這幾個部分吧
•“Adopt OpenJDK 入門指南”
•“虛擬機”
•“二進製”
如果你完成了看看“目錄”然後還有沒有你沒有看過的
2.5. 如何對本書做出貢獻
通過GitBook
在Gitbook.com上建立賬戶申請成為Adopt OpenJDK GitBook的合作者
一些說明文檔和如何安裝GitBook應該會對你有幫助
通過GitHub
1.建立一個分支瀏覽這個網站來看如何建立分支
https://github.com/neomatrix369/adoptopenjdk-getting-started-kit#fork-destination-box
2.把你的版本複製到你的工作空間裏
git clone git@github.com:{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 addgit 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 (安裝在虛擬機中): https://www.oracle.com/technetwork/java/javase/
Vagrant (用來啟動vagrant boxes) https://www.vagrantup.com/
可選
Docker: https://docs.docker.com/installation/#installation
Boot2Docker: https://boot2docker.io/
IntelliJ: https://www.jetbrains.com/idea/
Eclipse: https://eclipse.org/
Netbeans: https://netbeans.org/
SonarQube: https://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 ? ”順著流程進入下一步。
最後更新：2017-05-22 13:01:15