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

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

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

นั่งรอสบายๆ แล้วเปิดขั้วปลายสายไฟ แล้วก็สร้างประวัติศาสตร์กันเลย

เป้าหมาย

พันธกิจของ Codelab นี้มี 2 ประการดังนี้

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

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

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

สภาพแวดล้อม

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

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

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

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

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

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

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

    cd aosp
    
  4. เริ่มต้น Branch หลักของซอร์สโค้ดของที่เก็บ 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 คุณต้องติดตั้งทรัพยากร 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

  2. เปิด Cuttlefish:

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

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

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

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

    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. การทดสอบจะล้มเหลว ในการแก้ไขปัญหานี้ ให้ค้นหาซอร์สโค้ดของการทดสอบที่ล้มเหลว:

    atest --info android.test.example.devcodelab.DevCodelabTest#testHelloWorld
    
  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 และที่เก็บได้ในเครื่องมือควบคุมแหล่งที่มา พร้อมลิงก์ไปยังเอกสารฉบับเต็มเกี่ยวกับการทำงานกับซอร์สโค้ด Android ดูที่เก็บ AOSP สำหรับรายการทั้งหมดของโปรเจ็กต์ Git และโปรเจ็กต์ (เส้นทาง) แต่ละรายการสำหรับสาขาที่เชื่อมโยงกับแต่ละโปรเจ็กต์

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

จากนั้นยกเลิก 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