البدء

تصف هذه الصفحة كيفية إطلاق إصدار AOSP باستخدام حبَّار.

التحقق من مدى توفّر KVM

حبَّار هو جهاز افتراضي يعتمد على المحاكاة الافتراضية المتاحة على الجهاز المضيف.

في الوحدة الطرفية في الجهاز المضيف، تأكد من أن المحاكاة الافتراضية باستخدام يتوفر الجهاز الافتراضي المستند إلى النواة (KVM):

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

من المفترض أن يعرض هذا الأمر قيمة غير صفرية.

ملاحظة: على الجهاز السحابي، قد تحتاج إلى اتباع الخطوات الخاصة بالسحابة الإلكترونية أو الخطوات الخاصة بالبائع لتمكين KVM. بالنسبة إلى Google Compute Engine (GCE)، يُرجى الاطّلاع على لمحة عن المحاكاة الافتراضية المدمَجة

فعند تشغيل الجهاز على جهاز ARM64، فإن الطريقة المباشرة هي التحقق من /dev/kvm:

find /dev -name kvm

ملاحظة: يمكنك استخدام هذا الأمر لتأكيد توافق KVM في أي بيئة.

---

إطلاق حبَّار

1. في نافذة المحطة الطرفية، عليك تنزيل حزم دبيان المضيفة وإنشاؤها وتثبيتها.

   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. حبَّار هو جزء من نظام Android الأساسي المفتوح المصدر (AOSP). إصدارات يمكن العثور على الجهاز الافتراضي على موقع Android Continuous Integration. إلى والعثور على فهرس بجميع إصدارات Android، والانتقال إلى إصدار Android Continuous موقع الدمج في http://ci.android.com/

3. أدخِل اسم الفرع. استخدِم الفرع التلقائي لتطبيق aosp-main أو استخدِم فرع صورة النظام العامة (GSI) مثل aosp-android13-gsi.

4. انتقِل إلى هدف الإصدار aosp_cf_x86_64_phone وانقر على userdebug لأحدث إصدار.

   ملاحظة: بالنسبة إلى ARM64، يجب استخدام الفرع aosp-main-throttled والجهاز. aosp_cf_arm64_only_phone-trunk_staging-userdebug.

5. انقر على المربع الأخضر أسفل userdebug لاختيار هذا الإصدار. التفاصيل مع مزيد من المعلومات الخاصة هذا الإصدار. في هذه اللوحة، انقر على العناصر للاطّلاع على قائمة بجميع الأدوات المرتبطة بهذا الإصدار.

6. في لوحة "العناصر" ( Artifacts)، نزِّل العناصر الخاصة بالحبَّار.

   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. إطلاق حبَّار:

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

التحقق من ظهور الحبار من خلال adb

تمامًا مثل أي جهاز فعلي، يكون الحبار مرئيًا من خلال Android Debug Bridge (adb):

في المجلد نفسه الذي أطلقت فيه تطبيق Cuttlefish، نفّذ الخطوات التالية للاطّلاع على قائمة بجميع أجهزة Android المتاحة من خلال adb على الجهاز المضيف:

./bin/adb devices

عرض الجهاز الافتراضي في الويب والتفاعل معه

يتم تلقائيًا تشغيل لعبة الحبّارة باستخدام --start_webrtc، ما يؤدي إلى تفعيل WebView. من خلال المنفذ 8443 على الجهاز المضيف.

لعرض الأجهزة الافتراضية والتفاعل معها، انتقِل إلى https://localhost:8443 في متصفح الويب.

لمزيد من المعلومات، يُرجى مراجعة حبَّار: بث WebRTC.

إيقاف حبَّار

أوقِف تشغيل الجهاز الافتراضي في الدليل نفسه الذي استخدمته لتشغيل الجهاز:

HOME=$PWD ./bin/stop_cvd