เริ่มใช้งาน

หน้านี้จะอธิบายวิธีเปิดใช้บิลด์ AOSP โดยใช้ Cuttlefish

ยืนยันความพร้อมใช้งานของ KVM

Cuttlefish เป็นอุปกรณ์เสมือนและขึ้นอยู่กับการจำลองเสมือนที่ พร้อมใช้งานในเครื่องโฮสต์

ในเทอร์มินัลของเครื่องโฮสต์ ให้ตรวจสอบว่าการจำลองเสมือนด้วย Kernel-based Virtual Machine (KVM) พร้อมใช้งาน

grep -c -w "vmx\|svm" /proc/cpuinfo

คำสั่งนี้ควรแสดงค่าที่ไม่ใช่ 0

เมื่อเรียกใช้ในเครื่อง ARM64 วิธีที่ตรงที่สุดคือการตรวจสอบ /dev/kvm

find /dev -name kvm

เปิด Cuttlefish

1. ในหน้าต่างเทอร์มินัล ให้ดาวน์โหลด สร้าง และติดตั้งแพ็กเกจ 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
   tools/buildutils/build_packages.sh
   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 เป็นส่วนหนึ่งของแพลตฟอร์มโอเพนซอร์ส Android (AOSP) คุณดูบิลด์ของอุปกรณ์เสมือนได้ที่เว็บไซต์การผสานรวมอย่างต่อเนื่องของ Android หากต้องการ ดูดัชนีของ Android ทุกรุ่น ให้ไปที่เว็บไซต์การผสานรวมอย่างต่อเนื่องของ Android ที่ http://ci.android.com/

3. ป้อนชื่อสาขา ใช้กิ่ง aosp-android-latest-release เริ่มต้นหรือ ใช้กิ่งของอิมเมจระบบทั่วไป (GSI) เช่น aosp-android13-gsi

4. ไปที่เป้าหมายบิลด์ aosp_cf_x86_64_only_phone แล้วคลิก userdebug สำหรับบิลด์ล่าสุด

5. คลิกช่องสีเขียวด้านล่าง userdebug เพื่อเลือกบิลด์นี้ แผงรายละเอียด จะปรากฏขึ้นพร้อมข้อมูลเพิ่มเติมที่เกี่ยวข้องกับ บิลด์นี้ ในแผงนี้ ให้คลิกอาร์ติแฟกต์เพื่อดูรายการอาร์ติแฟกต์ทั้งหมด ที่แนบมากับการสร้างนี้

6. ในแผงอาร์ติแฟกต์ ให้ดาวน์โหลดอาร์ติแฟกต์สำหรับ Cuttlefish

   1. คลิกอาร์ติแฟกต์ aosp_cf_x86_64_phone-img-xxxxxx.zip สำหรับ x86_64 หรืออาร์ติแฟกต์ aosp_cf_arm64_only_phone-xxxxxx.zip สำหรับ ARM64 ซึ่งมีอิมเมจของอุปกรณ์ ในชื่อไฟล์ "xxxxxx" คือรหัสบิลด์ ของอุปกรณ์นี้

   2. เลื่อนลงในแผงแล้วดาวน์โหลด cvd-host_package.tar.gz ดาวน์โหลดแพ็กเกจโฮสต์จากบิลด์เดียวกันกับอิมเมจเสมอ

7. สร้างโฟลเดอร์คอนเทนเนอร์และแตกไฟล์แพ็กเกจในระบบของคุณ

   1. สถาปัตยกรรม x86_64:

      mkdir cf
      cd cf
      tar -xvf /path/to/cvd-host_package.tar.gz
      unzip /path/to/aosp_cf_x86_64_phone-img-xxxxxx.zip

   2. สถาปัตยกรรม ARM64:

      mkdir cf
      cd cf
      tar -xvf /path/to/cvd-host_package.tar.gz
      unzip /path/to/aosp_cf_arm64_only_phone-img-xxxxxx.zip

8. เปิดใช้ Cuttlefish

   HOME=$PWD ./bin/launch_cvd --daemon

ตรวจสอบว่า Cuttlefish มองเห็นได้ผ่าน adb

Cuttlefish จะมองเห็นได้ผ่าน Android Debug Bridge (adb) เช่นเดียวกับอุปกรณ์จริง

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

./bin/adb devices

ดูและโต้ตอบกับอุปกรณ์เสมือนในเว็บ

โดยค่าเริ่มต้น Cuttlefish จะเปิดตัวด้วย --start_webrtc ซึ่งจะเปิดใช้ WebView ผ่านพอร์ต 8443 ในเครื่องโฮสต์

หากต้องการดูและโต้ตอบกับอุปกรณ์เสมือน ให้ไปที่ https://localhost:8443 ในเว็บเบราว์เซอร์

ดูข้อมูลเพิ่มเติมได้ที่ Cuttlefish: การสตรีม WebRTC

หยุด Cuttlefish

หยุดอุปกรณ์เสมือนภายในไดเรกทอรีเดียวกับที่ใช้เปิดอุปกรณ์โดยทำดังนี้

HOME=$PWD ./bin/stop_cvd