מתחילים

בדף הזה מוסבר איך להפעיל גרסה זמינה ל-AOSP באמצעות Cuttlefish.

איך בודקים את הזמינות של KVM

Cuttlefish הוא מכשיר וירטואלי ותלוי בכך שהווירטואליזציה תהיה זמינה במכונה המארחת.

בטרמינל במכונה המארחת, מוודאים שהווירטואליזציה עם מכונה וירטואלית מבוססת-ליבה (KVM) זמינה:

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

הפקודה הזו אמורה להחזיר ערך שאינו אפס.

כשמריצים את הקוד במכונה עם 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 Open Source Platform‏ (AOSP). גרסאות build של המכשיר הווירטואלי נמצאות באתר Android Continuous Integration. כדי למצוא אינדקס של כל גרסאות ה-build של Android, עוברים לאתר Android Continuous Integration בכתובת http://ci.android.com/.

  3. מזינים שם להסתעפות. משתמשים בהסתעפות aosp-android-latest-release שמוגדרת כברירת מחדל, או בהסתעפות של תמונה גנרית של מערכת (GSI), כמו aosp-android13-gsi.

  4. עוברים ליעד ה-build‏ aosp_cf_x86_64_only_phone ולוחצים על userdebug כדי לקבל את ה-build העדכני ביותר.

  5. לוחצים על התיבה הירוקה מתחת ל-userdebug כדי לבחור את הגרסה הזו. תופיע חלונית Details עם מידע נוסף ספציפי לגרסה הזו. בחלונית הזו, לוחצים על Artifacts כדי לראות רשימה של כל הפריטים שנוצרו ממנה שמצורפים לגרסה הזו.

  6. בחלונית Artifacts, מורידים את הארטיפקטים של Cuttlefish.

    1. לוחצים על הארטיפקט aosp_cf_x86_64_phone-img-xxxxxx.zip עבור x86_64 או על הארטיפקט aosp_cf_arm64_only_phone-xxxxxx.zip עבור ARM64, שמכילים את קובצי האימג' של המכשיר. בשם הקובץ, 'xxxxxx' הוא מזהה ה-build של המכשיר הזה.

    2. גוללים למטה בחלונית ומורידים את cvd-host_package.tar.gz. תמיד צריך להוריד את חבילת המארח מאותה גרסה של build כמו קובצי האימג'.

  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‏ (adb).

באותה תיקייה שבה הפעלתם את Cuttlefish, מריצים את הפקודה הבאה כדי לראות רשימה של כל מכשירי Android שזמינים דרך adb במכונה המארחת:

./bin/adb devices

הצגה של המכשיר הווירטואלי באינטרנט וביצוע פעולות בו

כברירת מחדל, Cuttlefish מופעל עם --start_webrtc, שמפעיל תצוגת אינטרנט דרך יציאה 8443 במכונה המארחת.

כדי להציג את המכשירים הווירטואליים ולבצע פעולות בהם, עוברים אל https://localhost:8443 בדפדפן האינטרנט.

למידע נוסף, ראו Cuttlefish: WebRTC Streaming.

איך מפסיקים את Cuttlefish

מפסיקים את המכשיר הווירטואלי באותה ספרייה שבה השתמשתם כדי להפעיל את המכשיר:

HOME=$PWD ./bin/stop_cvd