Codelab นักพัฒนา Android

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

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

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

เป้าหมาย

ภารกิจของ Codelab นี้มีสองเท่า:

  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. เริ่มต้นสาขาหลักของซอร์สโค้ดที่เก็บ AOSP (ค่าเริ่มต้น):

    repo init -u https://android.googlesource.com/platform/manifest
    
  5. ป้อนหรือยอมรับข้อมูลรับรอง Git ของคุณ (ชื่อ ที่อยู่อีเมล)

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

    repo sync -j8
    

การซิงค์เริ่มต้นอาจใช้เวลาตั้งแต่หนึ่งชั่วโมงขึ้นไป

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

สร้างรหัส

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

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

หากต้องการสร้างและอัปเดตอุปกรณ์จริงแทน ให้เลือกเป้าหมายอื่นและทำตามคำแนะนำสำหรับ อุปกรณ์ที่กะพริบ

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

    source build/envsetup.sh
    
  2. ส่ง build target ไปยังคำสั่ง lunch ดังนี้:

    lunch aosp_cf_x86_64_phone-userdebug
    
  3. สร้าง รหัสจากที่ใดก็ได้ในการชำระเงินของคุณด้วย:

    m
    

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

สร้างอินสแตนซ์ Acloud

Acloud เป็นเครื่องมือบรรทัดคำสั่งใน AOSP ที่ช่วยผู้ใช้ในการสร้างอุปกรณ์ Android เสมือนจริง ในกรณีนี้คือ Cuttlefish

หากคุณอยู่ในเซสชันเทอร์มินัลเดียวกับที่ใช้ สร้างโค้ด ให้ดำเนินการต่อ มิฉะนั้น ให้รันสคริปต์ envsetup.sh อีกครั้งและคำสั่ง lunch เดิมที่คุณใช้ในตอนแรก แล้ว

  1. สร้างอินสแตนซ์โลคัล Acloud ด้วย:

    acloud create --local-image --local-instance
    
  2. ยอมรับการอัปเดตเป็นแพ็คเกจที่จำเป็น

  3. หากได้รับแจ้ง ให้รีสตาร์ทเวิร์กสเตชันเพื่อให้การเปลี่ยนแปลงทั้งหมดมีผล

  4. เลือกอุปกรณ์ปลาหมึก

คุณควรได้รับการต้อนรับด้วยเซสชัน VNC ที่มีอุปกรณ์ Android!

คุณสามารถโต้ตอบกับอุปกรณ์เสมือนบนเวิร์กสเตชันของคุณโดยใช้เมาส์และคีย์บอร์ด คุณยังสามารถติดตามกิจกรรมภายในบันทึกได้ในขณะที่คุณใช้อุปกรณ์โดยใช้คำสั่ง Android Debug Bridge (adb) logcat :

adb logcat

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

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

  1. จากรูทของการชำระเงินของคุณ ( aosp/ ไดเร็กทอรี) ให้ไปที่ frameworks/native Git project:

    cd frameworks/native
    
  2. เริ่มโครงการชั่วคราวด้วยคำสั่งนี้:

    repo start <some-name> .
    
  3. แก้ไข SurfaceFlinger.cpp เพื่อรวมการอัปเดตจากรายการเปลี่ยนแปลงในตำแหน่งต่อไปนี้:

    aosp/frameworks/native/services/surfaceflinger/SurfaceFlinger.cpp
    
  4. ค้นหาบรรทัดนี้:

    postComposition();
    
  5. แทนที่ทั้งสองบรรทัดด้วยสิ่งต่อไปนี้:

    postComposition();
    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});
    updateColorMatrixLocked();
    
  6. สร้างรหัส:

    m
    
  7. อัปเดตบิลด์บนอุปกรณ์:

    adb root
    adb remount
    adb sync
    adb reboot
    acloud reconnect
    
  8. หากคุณได้รับแจ้งให้เลือกอุปกรณ์ ให้เลือกอุปกรณ์ที่แสดงเวลาที่สั้นที่สุด (นี่อาจเป็นรายการสุดท้ายในรายการที่คุณเห็น) หากต้องการดูอินสแตนซ์อุปกรณ์เสมือนทั้งหมด ให้ใช้คำสั่ง acloud list และ acloud list -v

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

Example of a successful color change

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

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

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

    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 นี้ ให้เปลี่ยนรายการเปลี่ยนแปลงของคุณกลับโดยคลิก Abandon ใน Gerrit

จากนั้นละทิ้งสาขาชั่วคราวที่เกี่ยวข้องในไดเร็กทอรี 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