本頁面由 Cloud Translation API 翻譯而成。

Switch to English

Android 開發者代碼實驗室

您可以幫助開發地球歷史上安裝最廣泛的操作系統。是的，您來到這裡是為了踏上成為 Android 平台工程師的旅程。

儘管這條路充滿挑戰，但 Android 團隊會努力簡化您的旅程，每次發布。該團隊每天都通過在 Android 開源項目 (AOSP) 中的直接工作進行改進。

所以坐下來，啟動終端，讓我們創造歷史。

目標

此 Codelab 的任務有兩個：

讓您初步了解在該平台（操作系統）上工作的 Android 工程師的開發人員工作流程。
鼓勵您提供有關 Android 工具、文檔和開發人員工作流程的反饋。

先決條件

此 Codelab 的要求列表源自通用平台 ( AOSP ) 開發的要求。要參加此 Codelab，請設置以下內容：

滿足所有公共要求的物理 Linux 工作站。
編輯 Android 代碼庫所需的 Repo 和 Git 配置。

環境

通常，用戶直接在工作站上構建和開發。因為您可能在各種終端中工作，並且使用的許多命令都是特定於終端的，所以您需要在每個終端會話中重新運行它們。具體來說，這些包括source build/envsetup.sh和lunch命令。

設置工作站

在您的工作站上安裝必要的軟件包。
仍在終端中時，安裝 Repo 並獲取所有 Git 存儲庫的憑據。

初始化並同步代碼

導航到您的主目錄：
```
cd ~
```
在其中創建一個本地工作子目錄：
```
mkdir aosp
```
導航到目錄：
```
cd aosp
```

初始化 AOSP 存儲庫源代碼 master 分支（默認）：

repo init -u https://android.googlesource.com/platform/manifest

輸入或接受您的 Git 憑據（姓名、電子郵件地址）。
同步源代碼：
```
repo sync -j8
```

初始同步可能需要一個小時或更長時間。

每個 repo checkout 都由一個清單文件表示。允許一次有超過 1 個 repo checkout，只要它們存在於不同的目錄中。但請注意，每次檢出和構建大約需要 300 GB 的使用量（並且還在增加），因此要么限制自己進行 2 次回購檢出，要么使用輔助驅動器擴充系統。

提示：要增加可用空間，請刪除分支目錄並從目錄創建重新開始，如下所示： rm -rf aosp2.

構建代碼

要構建 Android，您必須選擇要使用lunch命令構建的目標設備類型。目標是設備排列，例如特定型號或外形規格。

下麵包含的設備目標aosp_cf_x86_64_phone-userdebug使您能夠構建Cuttlefish虛擬 Android 設備以在沒有物理設備的情況下進行測試。

要改為構建和更新物理設備，請選擇另一個目標並按照閃爍設備的說明進行操作。

通過從源代碼簽出的根目錄運行以下命令來設置構建 Android 設備的環境：
```
source build/envsetup.sh
```
將構建目標傳遞給 lunch 命令，如下所示：
```
lunch aosp_cf_x86_64_phone-userdebug
```
使用以下方法從結帳中的任何位置構建代碼：
```
m
```

預計第一次構建需要數小時。後續構建花費的時間要少得多。

創建 Acloud 實例

Acloud是 AOSP 中的命令行工具，可幫助用戶創建虛擬 Android 設備，在本例中為 Cuttlefish。

如果您在用於構建代碼的同一終端會話中，請繼續。否則，重新運行envsetup.sh腳本和您首先在此處使用的相同lunch命令。然後

使用以下命令創建 Acloud 本地實例：
```
acloud create --local-image --local-instance
```
接受對所需包的更新。
如果出現提示，請重新啟動工作站以使所有更改生效。
選擇 Cuttlefish 設備。

您應該會看到一個包含 Android 設備的 VNC 會話！

您可以使用鼠標和鍵盤與工作站上的虛擬設備進行交互。您還可以在使用設備時通過使用 Android 調試橋 (adb) logcat命令跟踪日誌中的活動：

adb logcat

做出改變

按照此示例更改列表更新源代碼。

從結帳的根目錄（ aosp/目錄）導航到frameworks/native Git 項目：
```
cd frameworks/native
```
使用此命令啟動一個臨時項目：
```
repo start <some-name> .
```
編輯SurfaceFlinger.cpp以在以下位置包含更改列表中的更新：
```
aosp/frameworks/native/services/surfaceflinger/SurfaceFlinger.cpp
```
找到這兩行：
```
postFrame();
postComposition();
```

將這兩行替換為以下內容：

postFrame();
postComposition();
mClientColorMatrix = mat4(vec4{1.0f, 0.0f, 0.0f, 0.0f}, vec4{0.0f, -1.0f, 0.0f, 0.0f},
                          vec4{0.0f, 0.0f, -1.0f, 0.0f}, vec4{0.0f, 1.0f, 1.0f, 1.0f});
updateColorMatrixLocked();

構建代碼：
```
m
```

更新設備上的構建：

adb root
adb remount
adb sync
adb reboot
acloud reconnect

如果系統提示您選擇設備，請選擇顯示最短運行時間的設備。（這可能是您看到的列表中的最後一個。）要查看所有虛擬設備實例，請使用acloud list和acloud list -v命令。

確認您在所選設備上看到與圖 1 中所示類似的顏色變化。

Example of a successful color change

圖 1.成功更改顏色後的屏幕外觀

測試你的代碼

Codelab 的這一部分使用源代碼樹中的示例測試，但失敗了。這使用Atest在本地運行測試並測試代碼。

要使用該測試，請按照以下說明操作：

跑：
```
atest DevCodelabTest
```

測試將失敗。要修復它，請找到失敗測試的源代碼：

atest --info android.test.example.devcodelab.DevCodelabTest#testHelloWorld

然後看這裡

platform_testing/tests/example/devcodelab

要編輯文件，請在android.test.example.devcodelab.DevCodelabTest中獲取測試名稱並將.使用/ ，得到這個結果：
```
src/android/test/example/devcodelab/DevCodelabTest.java
```

然後編輯

platform_testing/tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.java

取代

Assert.assertTrue(false)

和

Assert.assertTrue(true)

再次運行測試以確認您已解決問題：
```
atest DevCodelabTest
```

上傳您的代碼以供審核

Repo 通過捆綁命令（例如git clone ）來同時跨多個 Git 存儲庫（或項目）工作，從而簡化了 Git 的使用。

請參閱源代碼管理工具以了解 Git 和 Repo 的概述，以及指向有關使用 Android 源代碼的完整文檔的鏈接。有關 Git 項目的完整列表以及與每個項目關聯的分支的各個項目（路徑），請參閱AOSP 存儲庫。

對於 Git 項目的代碼審查，您將使用基於 Web 的Gerrit代碼審查系統。

假設您在frameworks/native項目中進行了更改，請運行這些命令來上傳它們：
```
cd frameworks/native
repo start codelab .
git add .
git commit
```
對於您的提交消息，請輸入以下內容：
```
Android codelab change
Test: manual atest
```
上傳您的更改：
```
repo upload
```

如果您成功了，您會看到一條類似於此的消息：

Upload project frameworks/native/ to remote branch master:
  branch codelab ( 1 commit, Wed Aug 7 09:32:33 2019 -0700):
         ff46b36d android codelab change
to https://android-review.googlesource.com/ (y/N)? y
remote: Processing changes: refs: 1, new: 1, done
remote:
remote: SUCCESS
remote:
remote:   https://android-review.googlesource.com/c/platform/frameworks/native/+/1098432 android codelab change [NEW]
remote:
To https://android-review.googlesource.com/platform/frameworks/native
 * [new branch]          codelab -> refs/for/master

在 Gerrit 中查看您的更改

轉到打印在終端中的鏈接，類似於以下鏈接：

https://android-review.googlesource.com/c/platform/frameworks/native/+/1098432

這樣就完成了 Android 平台開發的入門代碼實驗室。請參閱為後續步驟提交補丁，有關開發 Android 的完整詳細信息，請參閱本網站的其餘部分。

還原您的更改

通常，在測試後和審核通過後，您在 Gerrit 中提交您的更改並將其合併到存儲庫中。

相反，出於此 Codelab 的目的，通過單擊 Gerrit 中的放棄來還原您的更改列表。

然後放棄frameworks/native項目目錄（或其子目錄）下關聯的臨時分支：

repo abandon codelab .

還請記住還原您對測試文件所做的更改。由於您沒有repo start 、 git commit和repo upload更改，您可以重置文件本身。假設您在aosp/platform_testing directory中，使用以下命令重置文件：

git reset HEAD tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.java
git checkout .

在這一點上，你完成了！幹得好！

得到幫助

如果您在此代碼實驗室中遇到錯誤，請使用任何頁面底部的問題跟踪器鏈接報告錯誤。向android-building組發送問題。