इस पेज में कटलफ़िश का इस्तेमाल करके, एओएसपी बिल्ड को लॉन्च करने का तरीका बताया गया है.
पुष्टि करना कि केवीएम की सुविधा उपलब्ध है या नहीं
कटलफ़िश एक वर्चुअल डिवाइस है और यह इस बात पर निर्भर करता है कि होस्ट मशीन पर वर्चुअलाइज़ेशन की सुविधा उपलब्ध है या नहीं.
अपनी होस्ट मशीन के टर्मिनल में, पक्का करें कि केर्नल-आधारित वर्चुअल मशीन (केवीएम) के साथ वर्चुअलाइज़ेशन की सुविधा उपलब्ध हो:
grep -c -w "vmx\|svm" /proc/cpuinfo
इस निर्देश से ऐसी वैल्यू मिलनी चाहिए जो शून्य नहीं हो.
ARM64 मशीन पर इस्तेमाल करते समय, सबसे आसान तरीका है कि आप /dev/kvm
की जांच करें:
find /dev -name kvm
कटलफ़िश लॉन्च करें
टर्मिनल विंडो में, होस्ट 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
नियम लागू होते हैं.कटलफ़िश, Android Open-Source Platform (AOSP) का हिस्सा है. वर्चुअल डिवाइस के बिल्ड, Android लगातार इंटिग्रेशन साइट पर पाए जाते हैं. सभी Android बिल्ड का इंडेक्स देखने के लिए, http://ci.android.com/ पर जाकर, Android लगातार इंटिग्रेशन साइट पर जाएं.
शाखा का नाम डालें.
aosp-main
की डिफ़ॉल्ट ब्रांच का इस्तेमाल करें या जेनरिक सिस्टम इमेज (जीएसआई) ब्रांच का इस्तेमाल करें, जैसे किaosp-android13-gsi
.aosp_cf_x86_64_phone बिल्ड टारगेट पर जाएं और नया बिल्ड देखने के लिए userdebug पर क्लिक करें.
इस बिल्ड को चुनने के लिए, userdebug के नीचे मौजूद हरे बॉक्स पर क्लिक करें. इस बिल्ड के लिए ज़्यादा जानकारी वाला ब्यौरा पैनल दिखेगा. इस पैनल में, इस बिल्ड से अटैच की गई सभी आर्टफ़ैक्ट की सूची देखने के लिए, आर्टफ़ैक्ट पर क्लिक करें.
आर्टफ़ैक्ट पैनल में जाकर, कटलफ़िश के लिए आर्टफ़ैक्ट डाउनलोड करें.
x86_64 के लिए
aosp_cf_x86_64_phone-img-xxxxxx.zip
आर्टफ़ैक्ट या ARM64 के लिएaosp_cf_arm64_only_phone-xxxxxx.zip
आर्टफ़ैक्ट पर क्लिक करें, जिसमें डिवाइस की इमेज होती हैं. फ़ाइल नाम में, "xxxxxx" इस डिवाइस का बिल्ड आईडी है.पैनल में नीचे स्क्रोल करें और
cvd-host_package.tar.gz
डाउनलोड करें. होस्ट पैकेज को हमेशा उसी बिल्ड से डाउनलोड करें जिससे आपकी इमेज डाउनलोड की गई हैं.
अपने लोकल सिस्टम पर, एक कंटेनर फ़ोल्डर बनाएं और पैकेज एक्सट्रैक्ट करें:
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
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
कटलफ़िश लॉन्च करें:
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