10.1、簡介
眾所周知,GitHub 伺服器在國外,如果網路不好的話,嚴重影響使用體驗,甚至會出現登入不上的情況。
針對這個情況,可以使用國內的專案託管平臺—— Gitee 碼雲,來替代 Github 這個國外的專案託管平臺。
Gitee 碼雲是開源中國推出的基於 Git 的程式碼託管服務中心,網址是 https://gitee.com 。
Gitee 的使用方式和 GitHub 基本一樣,此外它還是一箇中文網站,如果英文不是很好的話,它是最好的選擇。
10.2、註冊Gitee賬號
如上圖所示,在 Gitee 碼雲的首頁,點選“註冊”按鈕,進入註冊頁面。
如上圖所示,輸入註冊所需要的資訊,然後傳送驗證碼到註冊的郵箱中。
如上圖所示,從註冊郵箱中找到驗證碼,然後就可以完成註冊。
如上圖所示,註冊成功後,會自動登入跳轉到 Gitee 碼雲的個人主頁。
10.3、建立遠端倉庫
如上圖所示,點選“新建倉庫”。
如上圖所示,設定倉庫名稱和倉庫型別,然後點選“建立”按鈕,即可建立一個遠端庫倉庫。
注意:在 Gitee 碼雲新建倉庫時,倉庫型別不能直接選擇為開源的;需要先選擇為私有的,然後再在“倉庫設定”中修改為公開的。
如上圖所示,倉庫新建成功,可以獲取到這個倉庫的 HTTPS 和 SSH 地址。
注意:因為 Gitee 碼雲的伺服器在國內,所以推薦使用遠端庫的 HTTPS 地址。
10.4、IDEA整合Gitee碼雲
10.4.1、安裝Gitee碼雲外掛
如上圖所示,在“File”->“Settings”->“Version Control”中可以看到,IDEA 預設沒有和 Gitee 的相關的功能,因此需要額外安裝 Gitee 外掛。
如上圖所示,在“Plugins”->“Marketplace”中,搜尋“gitee”,即可找到 Gitee 外掛來安裝。
如上圖所示,接受安裝第三方外掛。
如上圖所示,安裝完成外掛後,需要重啟 IDEA 才能使用該外掛。
如上圖所示,Gitee 外掛安裝成功後,可以在“Version Control”中找到和 Gitee 的相關的功能。
10.4.2、登入Gitee賬號
如上圖所示,在“Version Control”->“Gitee”中,點選“+”按鈕,在登入彈窗中,輸入Gitee的賬號密碼直接登入。
10.4.3、分享專案到Gitee
10.4.3.1、開啟分享彈窗
如上圖所示,點選“VCS”->“Import into Version Control”->“Share Project on Gitee”,即可開啟分享專案到 Gitee 的彈窗。
10.4.3.2、設定遠端庫屬性
如上圖所示,在彈窗中設定遠端庫的名稱(Repository name,預設值和專案名一樣)及該遠端庫在本地的別名(Remote,預設值是gitee),一般上都設定成和本地庫的名稱一樣(本例已將遠端庫在本地的別名,修改為和本地庫的名稱一樣但加了 gitee 字首)。
此外,如果“Private”核取方塊被選中,則建立的遠端庫是私有庫;預設不選中,即建立的遠端庫是公有庫。
注意:因為本文所使用的 Gitee 賬號沒有繫結手機,所以建立不了公有庫,因此選中了“Private”核取方塊。
10.4.3.3、分享操作效果
如上圖所示,在彈窗中點選“share”按鈕(相當於建立遠端庫然後push操作)後,專案成功地被分享到 Gitee 。
如上圖所示,在 Gitee 中可以看到遠端庫已存在。
10.4.4、推送更新到遠端庫
10.4.4.1、在本地庫新增內容
如上圖所示,新增了一行內容;且經過修改內容後,已被 Git 追蹤過的檔案顏色會變成藍色。
10.4.4.2、將更新提交到本地庫
如上圖所示,因為專案所有的檔案在之前已被追蹤過,所以可以將修改直接提交到本地庫。
如上圖所示,在提交彈窗中,可以看到將要提交到本地庫的檔案有哪些變化。
在“Commit Message”中填寫提交資訊,然後點選“Commit”按鈕,即可完成提交到本地庫的操作。
如上圖所示,當修改後的檔案被提交到本地庫後,檔案的顏色恢復為最原始的黑色;且“Version Control”->“Log”介面也能看到提交資訊。
10.4.4.3、將更新推送到遠端庫(方式一)
如上圖所示,右擊專案名,然後點選“Git”->“Repository”->“Push”,即可開啟推送彈窗。
注意:餘下操作請參照方式二。
10.4.4.4、將更新推送到遠端庫(方式二)
如上圖所示,點選“VCS”->“Git”->“Push”,即可開啟推送彈窗。
如上圖所示,在推送彈窗中,會自動使用到遠端庫的別名。
10.4.4.5、推送操作效果
如上圖所示,點選“Push”按鈕後,本地庫的更新成功地被推送到遠端庫。
如上圖所示,在 Gitee 中可以看到遠端庫已存在新的提交。
10.4.5、拉取更新到本地庫
要想 push 成功,一定要保證本地庫的版本要比遠端庫的版本高!
因此一個成熟的程式設計師在動手改原生代碼之前,一定會先檢查下遠端庫跟原生代碼的區別!
如果本地的程式碼版本已經落後,切記要先 pull 拉取一下遠端庫的程式碼,將原生代碼更新到最新以後,然後再修改、提交、推送!
10.4.5.1、在遠端庫新增內容
如上圖所示,點選檔案的編輯按鈕,即可進入編輯頁面線上修改遠端庫的內容。
如上圖所示,在編輯頁面修改完內容後,填寫提交資訊,便可點選“提交”按鈕,即可完成在遠端庫提交的操作。
10.4.5.2、將更新拉取到本地庫(方式一)
如上圖所示,右擊專案名,然後點選“Git”->“Repository”->“Pull”,即可開啟拉取彈窗。
注意:餘下操作請參照方式二。
10.4.5.3、將更新拉取到本地庫(方式二)
如上圖所示,點選“VCS”->“Git”->“Pull”,即可開啟拉取彈窗。
如上圖所示,在拉取彈窗中,可以選擇拉取哪個遠端庫地址的更新。
10.4.5.4、拉取操作的效果
如上圖所示,點選“Pull”按鈕後,遠端庫的更新成功地被拉取到本地庫。
注意:拉取操作會自動合併,如果自動合併失敗,就需要手動解決合併衝突的問題。
10.4.6、克隆遠端庫到本地
10.4.6.1、刪除本地庫
如上圖所示,因為該專案已經託管(備份)到了遠端庫,所以刪除後也能從遠端庫克隆到本地。
10.4.6.2、使用IDEA克隆遠端庫到本地
如上圖所示,在 IDEA 的初始化介面,點選“Check out from Version Control”->“Git”,即可開啟克隆彈窗。
如上圖所示,在克隆彈窗中,輸入遠端庫地址,點選“Test”按鈕,看到連線成功的提示,即可點選“Clone”按鈕將該遠端庫克隆到本地。
如上圖所示,成功克隆遠端庫到本地後,IDEA 會提示是否開啟該專案。
如上圖所示,專案的內容和提交資訊都能正常克隆。
注意:如果在編譯執行時報錯“Error:java: 錯誤: 不支援發行版本 5”,請參考該解決方案。
10.5、Gitee複製Github專案
10.5.1、使用遠端庫地址匯入
如上圖所示,Gitee 碼雲提供了直接複製 GitHub 專案的功能,方便我們做專案的遷移和下載。
如上圖所示,複製 Github 遠端庫(https)地址,然後點選“匯入”按鈕,即可將該遠端庫地址的 Github 專案複製到 Gitee 。
注意:在 Gitee 碼雲新建倉庫時,倉庫型別不能直接選擇為開源的;需要先選擇為私有的,然後再在“倉庫設定”中修改為公開的。
如上圖所示,已成功將 Github 專案複製到 Gitee 。
10.5.2、強制同步功能
如上圖所示,GitHub 專案的內容有更新。
如上圖所示,在 Gitee 倉庫名稱旁邊,點選一個重新整理按鈕,即可將 Github 倉庫的更新同步到 Gitee 倉庫。
如上圖所示,在同步彈窗中,會提示 Gitee 倉庫會被覆蓋。
如上圖所示,強制同步成功。