自 2025 年 3 月 27 日起，我們建議您使用 android-latest-release 而非 aosp-main 建構及貢獻 AOSP。詳情請參閱「Android 開放原始碼計畫變更」。

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

嘗試 Android 開發
透過集合功能整理內容你可以依據偏好儲存及分類內容。

本教學課程可讓您初次嘗試 Android 作業系統開發作業。

設定 Android 開發環境

下載及建構 Android 來源的 android-latest-release 資訊清單分支前，請確認硬體符合必要需求，且已正確安裝必要軟體。您也應熟悉下列術語：

Git: Git 是免費的開放原始碼分散式版本管控系統。Android 會使用 Git 執行本機作業，例如分支、修訂版本、差異比較和編輯。如需 Git 學習相關說明，請參閱 Git 說明文件。
Repo: Repo 是 Git 的 Python 包裝函式，可簡化在多個 Git 存放區中執行複雜作業的程序。Repo 不會取代 Git 的所有版本控制作業，只會讓複雜的 Git 作業更容易完成。Repo 會使用資訊清單檔案，將 Git 專案匯入 Android 超級專案。
資訊清單檔案: 資訊清單檔案是 XML 檔案，可指定 Android 來源中的各個 Git 專案在 AOSP 來源樹狀結構中的放置位置。

符合硬體需求

開發工作站應符合或超越下列硬體需求：

64 位元 x86 系統。

注意： 您可以在 32 位元系統上編譯 2.3.x 之前的 AOSP 版本。
至少要有 400 GB 的可用磁碟空間，才能檢出及建構程式碼 (檢出 250 GB + 建構 150 GB)。

注意： 如果您要查看鏡像，則需要更多空間，因為完整的 Android 開放原始碼專案 (AOSP) 鏡像會包含所有曾經使用的 Git 存放區。
至少有 64 GB 的 RAM。Google 使用 72 核心機器和 64 GB RAM 建構 Android。在這個硬體設定下，完整版 Android 的建構作業大約需要 40 分鐘，而累加版 Android 的建構作業只需要幾分鐘。相較之下，如果使用 6 核心機器 (64 GB RAM) 進行完整建構作業，大約需要 6 小時。

符合作業系統需求

您的開發工作站必須執行任何 64 位元 Linux 發行版，並搭載 GNU C 程式庫 (glibc) 2.17 以上版本。

安裝必要套件

如要安裝 Ubuntu 18.04 以上版本的必要套件，請執行下列指令：

sudo apt-get install git-core gnupg flex bison build-essential zip curl zlib1g-dev libc6-dev-i386 x11proto-core-dev libx11-dev lib32z1-dev libgl1-mesa-dev libxml2-utils xsltproc unzip fontconfig

安裝必要軟體

您必須先安裝 OpenJDK、Make、Python 3 和 Repo，才能使用 AOSP。Android 的最新版本分支會隨附預先建構的 OpenJDK、Make 和 Python 3 版本，因此不需要額外的安裝步驟。下一個章節將說明如何安裝 Repo。

安裝存放區

請按照下列步驟安裝 Repo：

下載目前的套件資訊：
```
sudo apt-get update
```
執行下列指令安裝 Repo 啟動器：
```
sudo apt-get install repo
```
Repo 啟動器會提供 Python 指令碼，用於初始化檢查作業並下載完整的 Repo 工具。

如果成功，請跳至步驟 4。

(選用) 使用下列一系列指令手動安裝 Repo：

export REPO=$(mktemp /tmp/repo.XXXXXXXXX)
curl -o ${REPO} https://storage.googleapis.com/git-repo-downloads/repo
gpg --recv-keys 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65
curl -s https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ${REPO} && install -m 755 ${REPO} ~/bin/repo

前三個指令會設定暫存檔案、將 Repo 下載至檔案，並驗證提供的金鑰是否符合必要金鑰。如果這些指令執行成功，最後一個指令會安裝 Repo 啟動器。

確認 Repo 啟動器版本：
```
repo version
```
輸出內容應顯示 2.4 以上版本，例如：

repo launcher version 2.45

下載 Android 原始碼

Android 原始碼位於 Google 代管的 Git 存放區集合中。每個 Git 存放區都包含 Android 來源的完整記錄，包括來源變更內容和變更時間。如要下載 Android 原始碼，請按照下列步驟操作：

前往主目錄：
```
cd ~
```
在其中建立本機工作子目錄：
```
mkdir aosp
```
前往目錄：
```
cd aosp
```

初始化 Android 開放原始碼計畫存放區原始碼最新版本分支 (android-latest-release)：

repo init --partial-clone -b android-latest-release -u https://android.googlesource.com/platform/manifest

輸入或接受 Git 憑證 (名稱、電子郵件地址)。
同步處理原始碼：
```
repo sync -c -j8
```
如果在下載時遇到任何問題，請參閱排解及修正同步處理問題。

建構程式碼

如要建構程式碼，請按照下列步驟操作：

在工作目錄中來源 envsetup.sh 指令碼，以設定建構環境：
```
source build/envsetup.sh
```

使用 lunch 指令指定要建構的目標裝置類型。目標是裝置變體，例如特定型號或板型規格。指定這個目標：

lunch aosp_cf_x86_64_only_phone-aosp_current-userdebug

您應該會看到目標和建構環境的摘要：

============================================
PLATFORM_VERSION_CODENAME=Baklava
PLATFORM_VERSION=Baklava
TARGET_PRODUCT=aosp_cf_x86_64_only_phone
TARGET_BUILD_VARIANT=userdebug
TARGET_ARCH=x86_64
TARGET_ARCH_VARIANT=silvermont
HOST_OS=linux
HOST_OS_EXTRA=Linux-6.10.11-1rodete2-amd64-x86_64-Debian-GNU/Linux-rodete
HOST_CROSS_OS=windows
BUILD_ID=BP1A.250305.020
OUT_DIR=out
============================================

建構目標：
```
m
```

第一次建構作業可能需要花上好幾個小時。後續的建構作業所需時間會大幅減少。建構作業的輸出內容會顯示在 $OUT_DIR 中。

啟動 Cuttlefish

Cuttlefish 是用來測試版本的 Android 模擬器。

執行下列指令，下載、建構及安裝主機 Debian 套件：

sudo apt install -y git devscripts equivs config-package-dev debhelper-compat golang curl
git clone https://github.com/google/android-cuttlefish
cd android-cuttlefish
for dir in base frontend; do
pushd $dir
# Install build dependencies
sudo mk-build-deps -i
dpkg-buildpackage -uc -us
popd
done
sudo dpkg -i ./cuttlefish-base_*_*64.deb || sudo apt-get install -f
sudo dpkg -i ./cuttlefish-user_*_*64.deb || sudo apt-get install -f
sudo usermod -aG kvm,cvdnetwork,render $USER
sudo reboot

重新啟動會觸發安裝其他核心模組，並套用 udev 規則。

啟動 Cuttlefish：
```
launch_cvd --daemon
```
在網路瀏覽器中前往 https://localhost:8443，即可連線至 Cuttlefish 裝置。系統會顯示虛擬 Android 裝置。

進行變更

根據這個範例變更清單更新原始碼。

從檢出的根目錄 (aosp/ 目錄) 前往 frameworks/native Git 專案：
```
cd frameworks/native
```
使用下列指令啟動臨時專案：
```
repo start <some-name> .
```

使用編輯器編輯下列位置的 SurfaceFlinger.cpp：

aosp/frameworks/native/services/surfaceflinger/SurfaceFlinger.cpp

找到以下這行程式碼：

void SurfaceFlinger::updateColorMatrixLocked() {

在 updateColorMatrixLocked() 開頭加入這一行：

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});

建構程式碼：
```
m
```

更新裝置上的版本：

adb root
adb remount -R
adb root
adb sync
adb reboot

確認所選裝置的顏色變更與圖 1 相似。

圖 1. 成功變更顏色後的畫面外觀

修正測試

本程式碼研究室的這部分會使用位於來源樹狀結構中且失敗的範例測試。

如要執行、偵錯及修正測試，請按照下列操作說明進行：

執行：
```
atest DevCodelabTest
```
測試失敗。

注意： atest 是指令列工具，可讓您在本機建構、安裝及執行 Android 測試。

檢查失敗測試的堆疊追蹤記錄：

STACKTRACE:
java.lang.AssertionError
 at org.junit.Assert.fail(Assert.java:87)
 at org.junit.Assert.assertTrue(Assert.java:42)
 at org.junit.Assert.assertTrue(Assert.java:53)
 at android.test.example.devcodelab.DevCodelabTest.testHelloWorld(DevCodelabTest.java:29)

堆疊追蹤的最後一行顯示失敗的測試 (testHelloWorld)。這個測試位於名為 DevCodelabTest.java 的檔案中。

如要判斷要修正的測試位置，請將 WORKING_DIRECTORY/platform_testing/tests/example/devcodelab/src/ 附加至堆疊追蹤記錄的最後一行，包括測試檔案名稱。因此，android.test.example.devcodelab.DevCodelabTest 會變成 WORKING_DIRECTORY/platform_testing/tests/example/devcodelab/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 中的專案進行程式碼審查，請使用 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 android15-qpr2-release:
 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/android15-qpr2-release

在 Gerrit 中查看變更

如要查看 Gerrit 中的變更，請前往終端機中的連結輸出內容。連結會類似以下內容：

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

還原變更

通常在測試後，並經過審查及核准程序，您會在 Gerrit 中提交變更，並將其合併至存放區。為了配合本程式碼研究室的目的，請改為還原您的工作：

在 Gerrit 中按一下「Abandon」。
在 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 平台開發程式碼研究室的內容。

取得說明

如果您在本程式碼研究室中遇到錯誤，請使用任何頁面底部的「Issue Tracker」連結回報問題。將問題傳送至 android-building 群組。

輸入 ps -A | grep crosvm 即可查看 crosvm 是否已在執行。如果 crossvm 正在執行，請輸入具有程序 PID 的 stop_cvd || true 或 kill crosvm 程序。