原始碼控制工作流程

使用 Android 程式碼需要使用Git （一種開源版本控制系統）和Repo （一種在 Git 之上運行的 Google 建置的儲存庫管理工具）。請參閱原始碼管理工具，以了解 Repo 和 Git 之間關係的說明以及每個工具的支援文件的連結。

流動

Android開發涉及以下基本工作流程：

1. 使用repo start啟動一個新的主題分支。
2. 編輯文件。
3. 使用git add進行階段變更。
4. 使用git commit提交更改。
5. 使用repo upload將變更上傳到審核伺服器。

任務

在 Android 程式碼儲存庫中使用 Git 和 Repo 涉及執行以下常見任務。

有關使用 Repo 下載原始程式碼的信息，請參閱下載原始程式碼和Repo 命令參考。

同步客戶端

若要同步所有可用項目的檔案：

repo sync

若要同步選定項目的文件：

repo sync PROJECT0 PROJECT1 ... PROJECTN

建立主題分支

每當您開始變更時（例如當您開始處理錯誤或新功能時），請在本機工作環境中啟動主題分支。主題分支不是原始文件的副本；而是原始文件的副本。它是指向特定提交的指針，這使得創建本地分支並在它們之間切換成為輕量級操作。透過使用分支，您可以將工作的某一方面與其他方面隔離。有關使用主題分支的有趣文章，請參閱分離主題分支。

若要使用 Repo 啟動主題分支，請導航至專案並執行：

repo start BRANCH_NAME .

尾隨句點 ( . ) 代表目前工作目錄中的項目。

若要驗證新分支是否已建立：

repo status .

使用主題分支

要將分支指派給特定項目：

repo start BRANCH_NAME PROJECT_NAME

有關所有項目的列表，請參閱android.googlesource.com 。如果您已經導航到專案目錄，只需使用句點代表目前專案。

要切換到本機工作環境中的另一個分支：

git checkout BRANCH_NAME

若要查看現有分支的清單：

git branch

或者

repo branches

這兩個指令都會傳回現有分支的列表，目前分支的名稱前面帶有星號 (*)。

暫存文件

預設情況下，Git 會注意到但不會追蹤您在專案中所做的更改。要告訴 Git 保留您的更改，您必須標記或暫存這些更改以包含在提交中。

階段更改：

git add

此指令接受專案目錄中的檔案或目錄的參數。儘管名稱如此，但git add並不是將檔案新增至 Git 儲存庫；它還可以將檔案新增至 Git 儲存庫。它也可用於暫存檔案修改和刪除。

查看客戶狀態

列出文件的狀態：

repo status

若要查看未提交的編輯（未標記為提交的本機編輯）：

repo diff

若要查看提交的編輯（位於標記為提交的編輯），請確保您位於專案目錄中，然後使用cached參數執行git diff ：

cd ~/WORKING_DIRECTORY/PROJECT
git diff --cached

提交變更

提交是 Git 中修訂控制的基本單位，由整個專案的目錄結構和文件內容的快照組成。使用以下命令在 Git 中建立提交：

git commit

當提示輸入提交訊息時，請為提交到 AOSP 的變更提供簡短（但有用）的訊息。如果不新增提交訊息，則提交失敗。

將更改上傳到 Gerrit

更新到最新版本，然後上傳變更：

repo sync
repo upload

這些命令會傳回您已提交的變更列表，並提示您選擇要上傳到審閱伺服器的分支。如果只有一個分支，您會看到一個簡單的y/n提示。

解決同步衝突

如果repo sync指令返回同步衝突：

1. 查看未合併的檔案（狀態代碼 = U）。
2. 根據需要編輯衝突區域。
3. 切換到相關的項目目錄。新增並提交受影響的文件，然後重新調整更改的基礎：

   git add .
   git commit
   git rebase --continue
   

4. 變基完成後，再次開始整個同步：

   repo sync PROJECT0 PROJECT1 ... PROJECTN
   

清理客戶

將變更合併到 Gerrit 後，更新本機工作目錄，然後使用repo prune安全刪除過時的主題分支：

repo sync
repo prune

刪除客戶

由於所有狀態資訊都儲存在您的用戶端中，因此您只需從檔案系統中刪除該目錄：

rm -rf WORKING_DIRECTORY

刪除用戶端會永久刪除您尚未上傳以供審核的所有變更。