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

Codelab สำหรับนักพัฒนาซอฟต์แวร์ Android

คุณช่วยพัฒนาระบบปฏิบัติการที่ติดตั้งอย่างกว้างขวางที่สุดในประวัติศาสตร์ได้ ของโลก ใช่ คุณมาที่นี่เพื่อเริ่มต้นเส้นทางสู่การเป็นวิศวกรแพลตฟอร์ม Android

แม้ว่าเส้นทางจะท้าทาย แต่ทีม Android ก็มุ่งมั่นที่จะลดความซับซ้อนของเส้นทางนี้ในทุกรุ่น และทีมทำการปรับปรุงทุกวันผ่านการทำงานโดยตรงในโครงการโอเพนซอร์ส Android (AOSP)

โปรดนั่งผ่อนคลาย เปิดเทอร์มินัล แล้วมาสร้างประวัติศาสตร์กัน

เป้าหมาย

ภารกิจของ Codelab นี้มี 2 อย่าง ได้แก่

ต่อไปนี้เป็นตัวอย่างเวิร์กโฟลว์ของนักพัฒนาแอปสำหรับวิศวกร Android ที่ทำงานเกี่ยวกับแพลตฟอร์ม (ระบบปฏิบัติการ)
ขอแนะนำให้คุณแสดงความคิดเห็นเกี่ยวกับเครื่องมือ เอกสารประกอบ และเวิร์กโฟลว์ของนักพัฒนาแอป Android

สิ่งที่ต้องมีก่อน

รายการข้อกำหนดสำหรับ Codelab นี้ได้มาจากข้อกำหนดทั่วไป ของแพลตฟอร์ม (AOSP) หากต้องการใช้ Codelab นี้ ตั้งค่าต่อไปนี้

เวิร์กสเตชันของ Linux จริงเป็นไปตามข้อกำหนดสาธารณะทั้งหมด
ที่เก็บและการกำหนดค่า Git ที่จําเป็นสําหรับแก้ไขโค้ดเบส Android

สภาพแวดล้อม

โดยปกติแล้ว ผู้ใช้จะสร้างและพัฒนาบนเวิร์กสเตชันโดยตรง เนื่องจากคุณอาจทํางานในเทอร์มินัลต่างๆ และคําสั่งจํานวนมากที่ใช้นั้นใช้กับเทอร์มินัลโดยเฉพาะ คุณจึงต้องเรียกใช้คําสั่งเหล่านั้นอีกครั้งในแต่ละเซสชันเทอร์มินัล โดยเฉพาะอย่างยิ่ง คำสั่งเหล่านี้รวมถึงคำสั่ง source build/envsetup.sh และ lunch

ตั้งค่าเวิร์กสเตชัน

ติดตั้งแพ็กเกจที่จำเป็นในอุปกรณ์ ของเวิร์กสเตชัน
ขณะที่ยังอยู่ในเทอร์มินัล ให้ติดตั้งที่เก็บและรับข้อมูลเข้าสู่ระบบ ไปยังที่เก็บ Git ทั้งหมด

เริ่มต้นและซิงค์โค้ด

ไปที่ไดเรกทอรีหน้าแรก
```
cd ~
```
สร้างไดเรกทอรีย่อยที่ใช้งานอยู่ภายในเครื่อง โดยทำดังนี้
```
mkdir aosp
```
ไปที่ไดเรกทอรีโดยทำดังนี้
```
cd aosp
```
เริ่มต้นสาขาหลักของซอร์สโค้ดที่เก็บ AOSP (ค่าเริ่มต้น)
```
repo init -u https://android.googlesource.com/platform/manifest
```
ป้อนหรือยอมรับข้อมูลเข้าสู่ระบบ Git (ชื่อ อีเมล)
ซิงค์ซอร์สโค้ด
```
repo sync -j8
```

การซิงค์ครั้งแรกอาจใช้เวลาอย่างน้อย 1 ชั่วโมง

การชำระเงินที่เก็บแต่ละครั้งจะแสดงด้วยไฟล์ Manifest เราอนุญาตให้ชำระเงินในที่เก็บได้มากกว่า 1 รายการต่อครั้ง อยู่ในไดเรกทอรีที่แตกต่างกัน แต่โปรดทราบว่าการตรวจสอบและการสร้างแต่ละครั้งจะใช้พื้นที่เก็บข้อมูลประมาณ 300 GB (และเพิ่มขึ้นเรื่อยๆ) ดังนั้นให้จำกัดการตรวจสอบที่เก็บถาวรไว้ที่ 2 รายการ หรือเพิ่มไดรฟ์รองในระบบ

เคล็ดลับ: หากต้องการเพิ่มพื้นที่ว่าง ให้ลบไดเรกทอรีสาขาแล้วเริ่มใหม่จากการสร้างไดเรกทอรี ดังนี้ rm -rf aosp2.

สร้างโค้ด

หากต้องการสร้าง 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 คุณต้องติดตั้งข้อกําหนดเบื้องต้นที่จําเป็นสําหรับ 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/) ให้ไปที่ frameworks/nativeโปรเจ็กต์ Git โดยทำดังนี้
```
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
```

การทดสอบจะล้มเหลว ตรวจสอบสแต็กเทรซของการทดสอบที่ล้มเหลว โดยทำดังนี้

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)

จากนั้นดูที่นี่
```
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 และ Repo ในเครื่องมือควบคุมแหล่งที่มา พร้อมลิงก์ไปยังเอกสารประกอบฉบับเต็มเกี่ยวกับการใช้งานซอร์สโค้ด Android ดูที่เก็บ AOSP เพื่อดูรายการโปรเจ็กต์ Git ทั้งหมดและแต่ละโปรเจ็กต์ (เส้นทาง) สำหรับ Branch ที่เชื่อมโยงกับแต่ละโปรเจ็กต์

สำหรับการตรวจสอบโค้ดของโปรเจ็กต์ใน 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

จากนั้นยกเลิกสาขาชั่วคราวที่เชื่อมโยงในโปรเจ็กต์ 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