คุณช่วยพัฒนาระบบปฏิบัติการที่ติดตั้งอย่างแพร่หลายที่สุดในประวัติศาสตร์ของโลกได้ ใช่แล้ว คุณพร้อมเริ่มต้นเส้นทางสู่การเป็นวิศวกรแพลตฟอร์ม Android
แม้ว่าเส้นทางจะท้าทาย แต่ทีม Android ก็มุ่งมั่นที่จะลดความซับซ้อนของการเปิดตัวในทุกๆ การเปิดตัว และทีมงานก็ทำการปรับปรุงทุกวันผ่านงานโดยตรง ในโครงการโอเพนซอร์ส Android (AOSP)
นั่งรอสบายๆ แล้วเปิดขั้วปลายสายไฟ แล้วก็สร้างประวัติศาสตร์กันเลย
เป้าหมาย
พันธกิจของ Codelab นี้มี 2 ประการดังนี้
- เพื่อให้คุณเห็นภาพคร่าวๆ ว่าเวิร์กโฟลว์ของนักพัฒนาซอฟต์แวร์เป็นอย่างไร สำหรับวิศวกร Android ที่ทำงานบนแพลตฟอร์มนี้ (ระบบปฏิบัติการ)
- สนับสนุนให้คุณแสดงความคิดเห็นเกี่ยวกับเครื่องมือ เอกสารประกอบ และเวิร์กโฟลว์ของนักพัฒนาซอฟต์แวร์ของ Android
สิ่งที่ต้องมีก่อน
รายการข้อกำหนดสำหรับ Codelab นี้ได้มาจากข้อกำหนดสำหรับการพัฒนาแพลตฟอร์มทั่วไป (AOSP) ในการใช้ Codelab นี้ ให้ตั้งค่าสิ่งต่อไปนี้
- เวิร์กสเตชันของ Linux จริงเป็นไปตามข้อกำหนดสาธารณะทั้งหมด
- ต้องใช้ที่เก็บและการกำหนดค่า Git เพื่อแก้ไขฐานของโค้ด Android
สภาพแวดล้อม
โดยปกติแล้ว ผู้ใช้จะสร้างและพัฒนาบนเวิร์กสเตชันโดยตรง เนื่องจากคุณอาจกำลังทำงานในเทอร์มินัลหลายขั้ว และคำสั่งจำนวนมากที่ใช้นั้นเจาะจงเฉพาะเทอร์มินัล คุณจึงต้องเรียกใช้อีกครั้งในเซสชันเทอร์มินัลแต่ละเซสชัน ซึ่งก็คือคำสั่ง source build/envsetup.sh
และ lunch
ตั้งค่าเวิร์กสเตชัน
- ติดตั้งแพ็กเกจที่จำเป็นบนเวิร์กสเตชัน
- ขณะที่ยังคงอยู่ในเทอร์มินัล ให้ติดตั้ง Repo และรับข้อมูลเข้าสู่ระบบ สำหรับที่เก็บ Git ทั้งหมด
เริ่มต้นและซิงค์โค้ด
ไปที่ไดเรกทอรีหน้าแรก
cd ~
สร้างไดเรกทอรีย่อยที่ใช้งานอยู่ภายในเครื่อง โดยทำดังนี้
mkdir aosp
ไปที่ไดเรกทอรีโดยทำดังนี้
cd aosp
เริ่มต้น Branch หลักของซอร์สโค้ดของที่เก็บ AOSP (ค่าเริ่มต้น):
repo init -u https://android.googlesource.com/platform/manifest
ป้อนหรือยอมรับข้อมูลเข้าสู่ระบบ Git ของคุณ (ชื่อ, อีเมล)
ซิงค์ซอร์สโค้ด
repo sync -j8
การซิงค์ครั้งแรกอาจใช้เวลาอย่างน้อย 1 ชั่วโมง
การชำระเงินที่เก็บแต่ละครั้งจะแสดงด้วยไฟล์ Manifest เราอนุญาตให้มีการชำระเงินที่เก็บมากกว่า 1 รายการต่อครั้ง ตราบใดที่รายการเหล่านั้นอยู่ในไดเรกทอรีที่แตกต่างกัน แต่โปรดทราบว่าการชำระเงินแต่ละครั้งและสร้างปริมาณการใช้งานประมาณ 300 GB (และเพิ่มขึ้นเรื่อยๆ) คุณจึงควรจำกัดการชำระเงินในที่เก็บ 2 ครั้ง หรือเพิ่มระบบด้วยไดรฟ์สำรอง
สร้างโค้ด
หากต้องการสร้าง Android คุณต้องเลือกประเภทอุปกรณ์เป้าหมาย
ที่จะสร้างด้วยคำสั่ง lunch
เป้าหมายคือการเรียงสับเปลี่ยนของอุปกรณ์
เช่น รุ่นหรือรูปแบบของอุปกรณ์ที่เฉพาะเจาะจง
อุปกรณ์เป้าหมาย aosp_cf_x86_64_phone-userdebug
ช่วยให้คุณสร้างอุปกรณ์ Android เสมือน Cuttlefish เพื่อการทดสอบได้โดยไม่ต้องใช้อุปกรณ์จริง
หากต้องการสร้างและอัปเดตอุปกรณ์จริงแทน ให้เลือกเป้าหมายอื่นและทำตามวิธีการสำหรับอุปกรณ์ที่กะพริบ
ตั้งค่าสภาพแวดล้อมสำหรับการสร้างอุปกรณ์ Android โดยเรียกใช้คำสั่งต่อไปนี้จากรูทของการชำระเงินในซอร์สโค้ด
source build/envsetup.sh
ส่งเป้าหมายบิลด์ไปยังคำสั่งอาหารกลางวัน ดังนี้
lunch aosp_cf_x86_64_phone-trunk_staging-userdebug
สร้างโค้ดได้จากทุกที่ใน การชำระเงินด้วย:
m
คาดว่าบิลด์แรกจะใช้เวลาหลายชั่วโมง การสร้างครั้งต่อๆ ไปจะใช้เวลา น้อยกว่านั้นมาก
ปล่อยหมึกกระดอง
Cuttlefish เป็นโปรแกรมจำลองของ Android ที่ใช้ทดสอบบิลด์ของคุณ
หากไม่เคยติดตั้ง Cuttlefish คุณต้องติดตั้งทรัพยากร Dependency ของ Cuttlefish ที่จำเป็น ในหน้าต่างเทอร์มินัล ให้เรียกใช้คำสั่งต่อไปนี้เพื่อดาวน์โหลด สร้าง และติดตั้งแพ็กเกจ 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/
) ให้ไปที่โปรเจ็กต์ Gitframeworks/native
ดังนี้cd frameworks/native
เริ่มต้นโปรเจ็กต์ชั่วคราวด้วยคำสั่งนี้
repo start <some-name> .
แก้ไข
SurfaceFlinger.cpp
เพื่อรวมการอัปเดตจากรายการการเปลี่ยนแปลงในตำแหน่งต่อไปนี้aosp/frameworks/native/services/surfaceflinger/SurfaceFlinger.cpp
ค้นหาเส้นนี้:
void SurfaceFlinger::updateColorMatrixLocked() {
เพิ่ม 2 บรรทัดนี้ที่จุดเริ่มต้นของ 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
adb sync
adb reboot
ตรวจสอบว่าอุปกรณ์ที่เลือกเปลี่ยนสีเหมือนกับที่แสดงในรูปที่ 1
รูปที่ 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 โดยรวมคำสั่ง เช่น git clone
เพื่อทำงานกับที่เก็บ (หรือโปรเจ็กต์) ของ Git จำนวนมากพร้อมกันได้
ดูภาพรวมของ Git และที่เก็บได้ในเครื่องมือควบคุมแหล่งที่มา พร้อมลิงก์ไปยังเอกสารฉบับเต็มเกี่ยวกับการทำงานกับซอร์สโค้ด Android ดูที่เก็บ AOSP สำหรับรายการทั้งหมดของโปรเจ็กต์ 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 main:
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/main
ดูการเปลี่ยนแปลงของคุณใน Gerrit
ไปที่ลิงก์ซึ่งพิมพ์อยู่ที่เครื่องชำระเงิน ซึ่งมีรูปร่างคล้ายลิงก์ต่อไปนี้
https://android-review.googlesource.com/c/platform/frameworks/native/+/1098432
ขั้นตอนนี้จะสิ้นสุด Codelab เริ่มต้นสำหรับการพัฒนาแพลตฟอร์ม Android ดูการส่งแพตช์สำหรับขั้นตอนถัดไป และรายละเอียดทั้งหมดเกี่ยวกับการพัฒนา Android ส่วนที่เหลือของเว็บไซต์นี้
เปลี่ยนกลับการเปลี่ยนแปลง
โดยปกติแล้ว หลังการทดสอบและเมื่อมีการตรวจสอบและอนุมัติ คุณจะส่งการเปลี่ยนแปลงใน Gerrit และผสานรวมเข้ากับที่เก็บ
ตามวัตถุประสงค์ของ Codelab นี้แทน ให้เปลี่ยนกลับรายการการเปลี่ยนแปลงโดยคลิกละทิ้งใน Gerrit
จากนั้นยกเลิก Branch ชั่วคราวที่เชื่อมโยงในไดเรกทอรีของโปรเจ็กต์ 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 .
เท่านี้ก็เรียบร้อย เยี่ยมไปเลย
รับความช่วยเหลือ
หากคุณพบข้อผิดพลาดระหว่าง Codelab นี้ ให้รายงานข้อผิดพลาดโดยใช้ลิงก์เครื่องมือติดตามปัญหาที่ด้านล่างของหน้าใดก็ได้ ส่งคำถามให้ กลุ่ม android-building