शुरू करें

इस पेज में कटलफ़िश का इस्तेमाल करके, एओएसपी बिल्ड को लॉन्च करने का तरीका बताया गया है.

पुष्टि करना कि केवीएम की सुविधा उपलब्ध है या नहीं

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

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

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

इस निर्देश से ऐसी वैल्यू मिलनी चाहिए जो शून्य नहीं हो.

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

find /dev -name kvm

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

  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. कटलफ़िश, Android Open-Source Platform (AOSP) का हिस्सा है. वर्चुअल डिवाइस के बिल्ड, Android लगातार इंटिग्रेशन साइट पर पाए जाते हैं. सभी Android बिल्ड का इंडेक्स देखने के लिए, http://ci.android.com/ पर जाकर, Android लगातार इंटिग्रेशन साइट पर जाएं.

  3. शाखा का नाम डालें. aosp-main की डिफ़ॉल्ट ब्रांच का इस्तेमाल करें या जेनरिक सिस्टम इमेज (जीएसआई) ब्रांच का इस्तेमाल करें, जैसे कि aosp-android13-gsi.

  4. aosp_cf_x86_64_phone बिल्ड टारगेट पर जाएं और नया बिल्ड देखने के लिए userdebug पर क्लिक करें.

  5. इस बिल्ड को चुनने के लिए, userdebug के नीचे मौजूद हरे बॉक्स पर क्लिक करें. इस बिल्ड के लिए ज़्यादा जानकारी वाला ब्यौरा पैनल दिखेगा. इस पैनल में, इस बिल्ड से अटैच की गई सभी आर्टफ़ैक्ट की सूची देखने के लिए, आर्टफ़ैक्ट पर क्लिक करें.

  6. आर्टफ़ैक्ट पैनल में जाकर, कटलफ़िश के लिए आर्टफ़ैक्ट डाउनलोड करें.

    1. x86_64 के लिए aosp_cf_x86_64_phone-img-xxxxxx.zip आर्टफ़ैक्ट या ARM64 के लिए aosp_cf_arm64_only_phone-xxxxxx.zip आर्टफ़ैक्ट पर क्लिक करें, जिसमें डिवाइस की इमेज होती हैं. फ़ाइल नाम में, "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 डीबग ब्रिज (adb) से भी देखा जा सकता है.

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

./bin/adb devices

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

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

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

ज़्यादा जानकारी के लिए, कटलफ़िश: WebRTC स्ट्रीमिंग देखें.

कटलफ़िश को रोकें

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

HOME=$PWD ./bin/stop_cvd