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

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

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

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

เป้าหมาย

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

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

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

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

สภาพแวดล้อม

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

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

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

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

  1. ไปที่ไดเรกทอรีหน้าแรก

    cd ~

  2. สร้างไดเรกทอรีย่อยที่ใช้งานอยู่ภายในเครื่อง โดยทำดังนี้

    mkdir aosp

  3. ไปที่ไดเรกทอรีโดยทำดังนี้

    cd aosp

  4. เริ่มต้นสาขาหลักของซอร์สโค้ดที่เก็บ AOSP (ค่าเริ่มต้น)

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

  5. ป้อนหรือยอมรับข้อมูลเข้าสู่ระบบ Git (ชื่อ อีเมล)

  6. ซิงค์ซอร์สโค้ด

    repo sync -j8

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

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

สร้างโค้ด

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

อุปกรณ์เป้าหมาย aosp_cf_x86_64_phone-userdebug อนุญาตให้คุณ เพื่อสร้างอุปกรณ์ Android เสมือนของ Cuttlefish สำหรับ โดยไม่ต้องใช้อุปกรณ์จริง

หากต้องการสร้างและอัปเดตอุปกรณ์จริงแทน ให้เลือกเป้าหมายอื่นแล้วทําตามวิธีการแฟลชอุปกรณ์

  1. ตั้งค่าสภาพแวดล้อมสําหรับการสร้างอุปกรณ์ Android โดยเรียกใช้คําสั่งต่อไปนี้จากรูทของการชำระเงินสําหรับโค้ดต้นฉบับ

    source build/envsetup.sh

  2. ส่งเป้าหมายบิลด์ไปยังคำสั่งอาหารกลางวัน ดังนี้

    lunch aosp_cf_x86_64_phone-trunk_staging-userdebug

  3. สร้างรหัสได้จากทุกที่ในการชำระเงินด้วย

    m

การสร้างครั้งแรกอาจใช้เวลาหลายชั่วโมง การสร้างครั้งต่อๆ ไปจะใช้เวลาน้อยลงอย่างมาก

ปล่อยหมึกกระดอง

Cuttlefish เป็นเครื่องจำลอง Android ที่ใช้ทดสอบบิลด์

  1. หากไม่เคยติดตั้ง 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 กฎ

  2. เปิด Cuttlefish:

    launch_cvd --daemon

  3. เชื่อมต่อกับอุปกรณ์ Cuttlefish โดยไปที่ https://localhost:8443 ในเว็บเบราว์เซอร์ คุณจะเห็นสตรีมวิดีโอของอุปกรณ์ที่ทำงานด้วยระบบ Android ที่คุณเพิ่งสร้าง

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

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

  1. จากรูทของการชำระเงิน (ไดเรกทอรี aosp/) ให้ไปที่ frameworks/nativeโปรเจ็กต์ Git โดยทำดังนี้

    cd frameworks/native

  2. เริ่มโปรเจ็กต์ชั่วคราวด้วยคำสั่งนี้

    repo start <some-name> .

  3. แก้ไข SurfaceFlinger.cpp เพื่อรวมการอัปเดตจากรายการการเปลี่ยนแปลงที่ ตำแหน่งต่อไปนี้:

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

  4. ค้นหาเส้นนี้:

    void SurfaceFlinger::updateColorMatrixLocked() {

  5. เพิ่ม 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});

  6. สร้างโค้ดโดยใช้คำสั่งต่อไปนี้

    m

  7. อัปเดตบิลด์ในอุปกรณ์โดยทำดังนี้

    adb root
adb remount
adb sync
adb reboot

ตรวจสอบว่าคุณเห็นการเปลี่ยนสีบนอุปกรณ์ที่เลือกคล้ายกับสีที่แสดง ในรูปที่ 1

ตัวอย่างการเปลี่ยนสีที่ทำสำเร็จ

รูปที่ 1 ลักษณะที่ปรากฏของหน้าจอหลังจากเปลี่ยนสีสำเร็จ

ทดสอบโค้ด

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

หากต้องการใช้การทดสอบ ให้ทําตามวิธีการต่อไปนี้

  1. เรียกใช้

    atest DevCodelabTest

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

    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)

  3. จากนั้นดูที่นี่

    platform_testing/tests/example/devcodelab

  4. หากต้องการแก้ไขไฟล์ ให้นำชื่อการทดสอบใน android.test.example.devcodelab.DevCodelabTest แล้วแทนที่ . ด้วย / เพื่อดูผลลัพธ์นี้

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

  5. จากนั้นแก้ไข

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

    เพื่อแทนที่

    Assert.assertTrue(false)

    กับ

    Assert.assertTrue(true)

  6. ทำการทดสอบอีกครั้งเพื่อยืนยันว่าคุณได้แก้ไขปัญหาแล้ว

    atest DevCodelabTest

อัปโหลดโค้ดเพื่อรับการตรวจสอบ

Repo ช่วยให้การใช้ Git ง่ายขึ้นด้วยการรวมคำสั่งต่างๆ เช่น git clone เพื่อทำงานกับที่เก็บ Git (หรือโปรเจ็กต์) หลายรายการพร้อมกัน

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

สำหรับการตรวจสอบโค้ดของโปรเจ็กต์ใน Git คุณจะใช้ Gerrit ระบบตรวจสอบโค้ดแบบเว็บ

  1. สมมติว่าคุณทำการเปลี่ยนแปลงในโปรเจ็กต์ frameworks/native ให้เรียกใช้คำสั่งต่อไปนี้เพื่ออัปโหลด

    cd frameworks/native
repo start codelab .
git add .
git commit

  2. สำหรับข้อความคอมมิต ให้ป้อนข้อมูลต่อไปนี้

    Android codelab change
Test: manual atest

  3. อัปโหลดการเปลี่ยนแปลง

    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