ตั้งแต่วันที่ 27 มีนาคม 2025 เป็นต้นไป เราขอแนะนำให้ใช้ android-latest-release แทน aosp-main เพื่อสร้างและมีส่วนร่วมใน AOSP โปรดดูข้อมูลเพิ่มเติมที่หัวข้อการเปลี่ยนแปลงใน AOSP

หน้านี้ได้รับการแปลโดย Cloud Translation API

ลองพัฒนาแอป Android
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

บทแนะนำนี้จะช่วยให้คุณลองพัฒนาระบบปฏิบัติการ Android เป็นครั้งแรก

ตั้งค่าสําหรับการพัฒนา Android

ก่อนดาวน์โหลดและสร้างandroid-latest-releaseสาขาไฟล์ Manifest ของแหล่งที่มาของ Android โปรดตรวจสอบว่าฮาร์ดแวร์ของคุณเป็นไปตามข้อกำหนดที่จำเป็นและซอฟต์แวร์ที่จำเป็นได้รับการติดตั้งอย่างถูกต้อง นอกจากนี้ คุณควรทำความคุ้นเคยกับคำศัพท์ต่อไปนี้ด้วย

Git: Git เป็นระบบควบคุมเวอร์ชันแบบกระจายแบบโอเพนซอร์สและไม่มีค่าใช้จ่าย Android ใช้ Git สำหรับการดำเนินการในเครื่อง เช่น การแยกสาขา การคอมมิต การเปรียบเทียบ และการแก้ไข หากต้องการความช่วยเหลือในการเรียนรู้ Git โปรดดูเอกสารประกอบของ Git
Repo: Repo คือ Wrapper ของ Python สำหรับ Git ที่ช่วยลดความซับซ้อนของการดำเนินการที่ซับซ้อนในที่เก็บ Git หลายแห่ง Repo ไม่ได้มาแทนที่ Git สำหรับการดำเนินการควบคุมเวอร์ชันทั้งหมด แต่ช่วยให้การดำเนินการที่ซับซ้อนของ Git ทำได้ง่ายขึ้นเท่านั้น Repo ใช้ไฟล์ Manifest เพื่อรวบรวมโปรเจ็กต์ Git ไว้ในโปรเจ็กต์ Android หลัก
ไฟล์ Manifest: ไฟล์ Manifest คือไฟล์ XML ที่ระบุตำแหน่งของโปรเจ็กต์ Git ต่างๆ ในซอร์สโค้ด Android ภายในลําดับชั้นซอร์สโค้ด AOSP

ข้อกำหนดของฮาร์ดแวร์ Meet

เวิร์กสเตชันสำหรับการพัฒนาควรเป็นไปตามข้อกำหนดด้านฮาร์ดแวร์ต่อไปนี้หรือมากกว่า

ระบบ x86 64 บิต

หมายเหตุ: คุณสามารถคอมไพล์ AOSP เวอร์ชันก่อน 2.3.x ในระบบ 32 บิตได้
พื้นที่ว่างในดิสก์อย่างน้อย 400 GB เพื่อเช็คเอาต์และสร้างโค้ด (250 GB สำหรับเช็คเอาต์ + 150 GB สำหรับสร้าง)

หมายเหตุ: หากจะตรวจสอบมิเรอร์ คุณจะต้องมีพื้นที่ว่างมากกว่านี้เนื่องจากมิเรอร์โปรเจ็กต์โอเพนซอร์ส Android (AOSP) แบบสมบูรณ์จะมีที่เก็บ Git ทั้งหมดที่เคยใช้
RAM อย่างน้อย 64 GB Google ใช้เครื่อง 72 คอร์ที่มี RAM 64 GB เพื่อสร้าง Android เมื่อใช้การกำหนดค่าฮาร์ดแวร์นี้ การสร้าง Android แบบสมบูรณ์จะใช้เวลาประมาณ 40 นาที และการสร้าง Android แบบเพิ่มจะใช้เวลาเพียงไม่กี่นาที ในทางตรงกันข้าม การสร้างแบบสมบูรณ์บนเครื่อง 6 คอร์ที่มี RAM 64 GB จะใช้เวลาประมาณ 6 ชั่วโมง

มีคุณสมบัติตรงตามข้อกำหนดของระบบปฏิบัติการ

เวิร์กสเตชันสำหรับการพัฒนาต้องใช้งานระบบปฏิบัติการ Linux 64 บิตที่มี GNU C Library (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

ทำตามขั้นตอนต่อไปนี้เพื่อติดตั้ง 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
```
คำสั่ง 3 คำสั่งแรกจะสร้างไฟล์ชั่วคราว ดาวน์โหลด Repo ลงในไฟล์ และตรวจสอบว่าคีย์ที่ระบุตรงกับคีย์ที่จำเป็น หากคำสั่งเหล่านี้ทำงานได้สำเร็จ คำสั่งสุดท้ายจะติดตั้งตัวเปิด Repo
ยืนยันเวอร์ชันของเครื่องมือเปิด Repo โดยทำดังนี้
```
repo version
```
เอาต์พุตควรระบุเวอร์ชัน 2.4 ขึ้นไป เช่น

repo launcher version 2.45

ดาวน์โหลดซอร์สโค้ด Android

แหล่งที่มาของ Android อยู่ในคอลเล็กชันที่เก็บ Git ที่โฮสต์โดย Google ที่เก็บ Git แต่ละแห่งมีประวัติทั้งหมดของซอร์สโค้ด Android รวมถึงการเปลี่ยนแปลงในซอร์สโค้ดและเวลาที่ทําการเปลี่ยนแปลง วิธีดาวน์โหลดซอร์สโค้ด Android

ไปยังไดเรกทอรีบ้าน
```
cd ~
```
สร้างไดเรกทอรีย่อยสำหรับใช้งานในเครื่องภายในไดเรกทอรีหลัก ดังนี้
```
mkdir aosp
```
ไปยังไดเรกทอรีด้วยคำสั่งต่อไปนี้
```
cd aosp
```
เริ่มต้นใช้งานสาขารุ่นล่าสุดของซอร์สโค้ดที่เก็บ AOSP (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
```
เชื่อมต่อกับอุปกรณ์ Cuttlefish โดยไปที่ https://localhost:8443 ในเว็บเบราว์เซอร์ อุปกรณ์เสมือนที่ใช้ Android จะปรากฏขึ้น

ทำการเปลี่ยนแปลง

อัปเดตซอร์สโค้ดตามตัวอย่าง changelist นี้

จากรูทของการชำระเงิน (ไดเรกทอรี 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 ลักษณะที่ปรากฏของหน้าจอหลังจากเปลี่ยนสีสำเร็จ

แก้ไขการทดสอบ

ส่วนนี้ของ Codelab ใช้การทดสอบตัวอย่างที่อยู่ในสคีมาซอร์สโค้ดและดำเนินการไม่สำเร็จ

หากต้องการเรียกใช้ แก้ไขข้อบกพร่อง และแก้ไขการทดสอบ ให้ทําตามวิธีการต่อไปนี้

เรียกใช้
```
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 ง่ายขึ้นด้วยการรวมคำสั่งต่างๆ เช่น git clone เพื่อทำงานกับที่เก็บ 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 และผสานเข้ากับที่เก็บข้อมูล แต่ให้เปลี่ยนกลับไปใช้งานเดิมเพื่อวัตถุประสงค์ของ Codelab นี้

ใน Gerrit ให้คลิกยกเลิก
ทิ้ง Branch ชั่วคราวที่เกี่ยวข้องในไดเรกทอรี frameworks/native project (หรือไดเรกทอรีย่อย) ดังนี้
```
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 .
```

การดำเนินการนี้ถือเป็นการจบ Codelab สําหรับการพัฒนาแพลตฟอร์ม Android

รับความช่วยเหลือ

หากพบข้อผิดพลาดระหว่างที่ใช้ Codelab นี้ โปรดรายงานโดยใช้ลิงก์เครื่องมือติดตามปัญหาที่ด้านล่างของหน้าใดก็ได้ ส่งคำถามไปยังกลุ่ม android-building

พิมพ์ ps -A | grep crosvm เพื่อดูว่า crosvm ทำงานอยู่หรือไม่ หาก crossvm ทำงานอยู่ ให้พิมพ์กระบวนการ stop_cvd || true หรือ kill crosvm พร้อม PID ของกระบวนการ