शुरू करें

यह पृष्ठ वर्णन करता है कि कटलफिश का उपयोग करके AOSP बिल्ड कैसे लॉन्च किया जाए।

KVM उपलब्धता सत्यापित करें

कटलफिश एक वर्चुअल डिवाइस है और होस्ट मशीन पर उपलब्ध वर्चुअलाइजेशन पर निर्भर है।

अपने होस्ट मशीन के टर्मिनल में, सुनिश्चित करें कि कर्नेल-आधारित वर्चुअल मशीन (KVM) के साथ वर्चुअलाइजेशन उपलब्ध है:

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

इस आदेश को एक गैर-शून्य मान लौटाना चाहिए।

एआरएम मशीन पर चलते समय, सबसे सीधा तरीका /dev/kvm की जांच करना है:

find /dev -name kvm

कटलफिश लॉन्च करें

  1. टर्मिनल विंडो में, होस्ट डेबियन पैकेज डाउनलोड करें, बनाएं और इंस्टॉल करें:

    sudo apt install -y git devscripts config-package-dev debhelper-compat golang curl
    git clone https://github.com/google/android-cuttlefish
    cd android-cuttlefish
    for dir in base frontend; do
      cd $dir
      debuild -i -us -uc -b -d
      cd ..
    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. कटलफिश एंड्रॉइड ओपन-सोर्स प्लेटफॉर्म (एओएसपी) का हिस्सा है। वर्चुअल डिवाइस के बिल्ड एंड्रॉइड कंटीन्यूअस इंटीग्रेशन साइट पर पाए जाते हैं। सभी एंड्रॉइड बिल्ड का इंडेक्स ढूंढने के लिए, http://ci.android.com/ पर एंड्रॉइड कंटीन्यूअस इंटीग्रेशन साइट पर जाएं।

  3. शाखा का नाम दर्ज करें. डिफ़ॉल्ट aosp-main शाखा का उपयोग करें या aosp-android13-gsi जैसी सामान्य सिस्टम छवि (GSI) शाखा का उपयोग करें।

  4. aosp_cf_x86_64_phone बिल्ड लक्ष्य पर नेविगेट करें और नवीनतम बिल्ड के लिए userdebug पर क्लिक करें।

  5. इस बिल्ड को चुनने के लिए यूजरडीबग के नीचे हरे बॉक्स पर क्लिक करें। इस निर्माण के लिए विशिष्ट अधिक जानकारी के साथ एक विवरण पैनल दिखाई देता है। इस पैनल में, इस निर्माण से जुड़ी सभी कलाकृतियों की सूची देखने के लिए कलाकृतियों पर क्लिक करें।

  6. कलाकृतियाँ पैनल में, कटलफ़िश के लिए कलाकृतियाँ डाउनलोड करें।

    1. aosp_cf_x86_64_phone-img-xxxxxx.zip आर्टिफैक्ट पर क्लिक करें, जिसमें डिवाइस की छवियां हैं। फ़ाइल नाम में, "xxxxxx" इस डिवाइस के लिए बिल्ड आईडी है।

    2. पैनल में नीचे स्क्रॉल करें और cvd-host_package.tar.gz डाउनलोड करें। होस्ट पैकेज को हमेशा अपनी छवियों के समान बिल्ड से डाउनलोड करें।

  7. अपने स्थानीय सिस्टम पर, एक कंटेनर फ़ोल्डर बनाएं और पैकेज निकालें:

    mkdir cf
    cd cf
    tar -xvf /path/to/cvd-host_package.tar.gz
    unzip /path/to/aosp_cf_x86_64_phone-img-xxxxxx.zip
    
  8. कटलफिश लॉन्च करें:

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

सत्यापित करें कि एडीबी के माध्यम से कटलफिश दिखाई दे रही है

एक भौतिक उपकरण के समान, कटलफिश एंड्रॉइड डिबग ब्रिज (एडीबी) के माध्यम से दिखाई देती है।

उसी फ़ोल्डर में जहां आपने कटलफिश लॉन्च किया था, अपने होस्ट मशीन पर एडीबी के माध्यम से उपलब्ध सभी एंड्रॉइड डिवाइसों की सूची देखने के लिए निम्न कमांड चलाएं:

./bin/adb devices

वेब में वर्चुअल डिवाइस देखें और उसके साथ इंटरैक्ट करें

डिफ़ॉल्ट रूप से, कटलफ़िश --start_webrtc के साथ लॉन्च होता है, जो होस्ट मशीन पर पोर्ट 8443 के माध्यम से एक वेबव्यू सक्षम करता है।

अपने वर्चुअल डिवाइस को देखने और उसके साथ इंटरैक्ट करने के लिए, अपने वेब ब्राउज़र में https://localhost:8443 पर जाएँ।

अधिक जानकारी के लिए कटलफिश: वेबआरटीसी स्ट्रीमिंग देखें।

कटलफिश बंद करो

वर्चुअल डिवाइस को उसी निर्देशिका में रोकें जिसका उपयोग आपने डिवाइस को लॉन्च करने के लिए किया था:

HOME=$PWD ./bin/stop_cvd
,

यह पृष्ठ वर्णन करता है कि कटलफिश का उपयोग करके AOSP बिल्ड कैसे लॉन्च किया जाए।

KVM उपलब्धता सत्यापित करें

कटलफिश एक वर्चुअल डिवाइस है और होस्ट मशीन पर उपलब्ध वर्चुअलाइजेशन पर निर्भर है।

अपने होस्ट मशीन के टर्मिनल में, सुनिश्चित करें कि कर्नेल-आधारित वर्चुअल मशीन (KVM) के साथ वर्चुअलाइजेशन उपलब्ध है:

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

इस आदेश को एक गैर-शून्य मान लौटाना चाहिए।

एआरएम मशीन पर चलते समय, सबसे सीधा तरीका /dev/kvm की जांच करना है:

find /dev -name kvm

कटलफिश लॉन्च करें

  1. टर्मिनल विंडो में, होस्ट डेबियन पैकेज डाउनलोड करें, बनाएं और इंस्टॉल करें:

    sudo apt install -y git devscripts config-package-dev debhelper-compat golang curl
    git clone https://github.com/google/android-cuttlefish
    cd android-cuttlefish
    for dir in base frontend; do
      cd $dir
      debuild -i -us -uc -b -d
      cd ..
    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. कटलफिश एंड्रॉइड ओपन-सोर्स प्लेटफॉर्म (एओएसपी) का हिस्सा है। वर्चुअल डिवाइस के बिल्ड एंड्रॉइड कंटीन्यूअस इंटीग्रेशन साइट पर पाए जाते हैं। सभी एंड्रॉइड बिल्ड का इंडेक्स ढूंढने के लिए, http://ci.android.com/ पर एंड्रॉइड कंटीन्यूअस इंटीग्रेशन साइट पर जाएं।

  3. शाखा का नाम दर्ज करें. डिफ़ॉल्ट aosp-main शाखा का उपयोग करें या aosp-android13-gsi जैसी सामान्य सिस्टम छवि (GSI) शाखा का उपयोग करें।

  4. aosp_cf_x86_64_phone बिल्ड लक्ष्य पर नेविगेट करें और नवीनतम बिल्ड के लिए userdebug पर क्लिक करें।

  5. इस बिल्ड को चुनने के लिए यूजरडीबग के नीचे हरे बॉक्स पर क्लिक करें। इस निर्माण के लिए विशिष्ट अधिक जानकारी के साथ एक विवरण पैनल दिखाई देता है। इस पैनल में, इस निर्माण से जुड़ी सभी कलाकृतियों की सूची देखने के लिए कलाकृतियों पर क्लिक करें।

  6. कलाकृतियाँ पैनल में, कटलफ़िश के लिए कलाकृतियाँ डाउनलोड करें।

    1. aosp_cf_x86_64_phone-img-xxxxxx.zip आर्टिफैक्ट पर क्लिक करें, जिसमें डिवाइस की छवियां हैं। फ़ाइल नाम में, "xxxxxx" इस डिवाइस के लिए बिल्ड आईडी है।

    2. पैनल में नीचे स्क्रॉल करें और cvd-host_package.tar.gz डाउनलोड करें। होस्ट पैकेज को हमेशा अपनी छवियों के समान बिल्ड से डाउनलोड करें।

  7. अपने स्थानीय सिस्टम पर, एक कंटेनर फ़ोल्डर बनाएं और पैकेज निकालें:

    mkdir cf
    cd cf
    tar -xvf /path/to/cvd-host_package.tar.gz
    unzip /path/to/aosp_cf_x86_64_phone-img-xxxxxx.zip
    
  8. कटलफिश लॉन्च करें:

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

सत्यापित करें कि एडीबी के माध्यम से कटलफिश दिखाई दे रही है

एक भौतिक उपकरण के समान, कटलफिश एंड्रॉइड डिबग ब्रिज (एडीबी) के माध्यम से दिखाई देती है।

उसी फ़ोल्डर में जहां आपने कटलफिश लॉन्च किया था, अपने होस्ट मशीन पर एडीबी के माध्यम से उपलब्ध सभी एंड्रॉइड डिवाइसों की सूची देखने के लिए निम्न कमांड चलाएं:

./bin/adb devices

वेब में वर्चुअल डिवाइस देखें और उसके साथ इंटरैक्ट करें

डिफ़ॉल्ट रूप से, कटलफ़िश --start_webrtc के साथ लॉन्च होता है, जो होस्ट मशीन पर पोर्ट 8443 के माध्यम से एक वेबव्यू सक्षम करता है।

अपने वर्चुअल डिवाइस को देखने और उसके साथ इंटरैक्ट करने के लिए, अपने वेब ब्राउज़र में https://localhost:8443 पर जाएँ।

अधिक जानकारी के लिए कटलफिश: वेबआरटीसी स्ट्रीमिंग देखें।

कटलफिश बंद करो

वर्चुअल डिवाइस को उसी निर्देशिका में रोकें जिसका उपयोग आपने डिवाइस को लॉन्च करने के लिए किया था:

HOME=$PWD ./bin/stop_cvd