Android सीएलआई के बारे में खास जानकारी

Android सीएलआई, एक कमांड-लाइन इंटरफ़ेस है. इसकी मदद से, अपनी पसंद के किसी भी टूल का इस्तेमाल करके, Android के लिए ज़्यादा बेहतर तरीके से ऐप्लिकेशन बनाए जा सकते हैं. यह एजेंट-फ़र्स्ट वर्कफ़्लो के लिए, डेवलपमेंट की मुख्य क्षमताओं को स्टैंडर्ड बनाता है. साथ ही, आधिकारिक टूल, कौशल, और जानकारी के लिए एंट्री पॉइंट उपलब्ध कराता है, ताकि आप ज़्यादा असरदार तरीके से डेवलपमेंट कर सकें. यह Android डेवलपमेंट के लिए, सीआई, रखरखाव, और स्क्रिप्ट वाले किसी भी अन्य ऑटोमेशन को भी बेहतर बना सकता है.

उदाहरण के लिए, कोई एजेंट या स्क्रिप्ट, सीएलआई का इस्तेमाल करके ये काम कर सकती है:

  • आस-पास के माहौल और Android SDK के सेटअप को ऑटोमेट करना
  • टेंप्लेट से नए प्रोजेक्ट बनाना
  • वर्चुअल डिवाइसों को मैनेज करें, APK इंस्टॉल करें, और लाइव डिवाइस की स्क्रीन और यूज़र इंटरफ़ेस (यूआई) के क्रम की जांच सीधे अपने टर्मिनल से करें
  • सिमैंटिक कोड का विश्लेषण करने, कंपोज़ की झलक रेंडर करने, और डिपेंडेंसी के वर्शन खोजने के लिए, Android Studio के चालू इंस्टेंस से कनेक्ट करें
  • गतिविधि की मदद से अपने ऐप्लिकेशन की जांच करना

Android के सीएलआई की मदद से, आपके एजेंटों को Android की स्किल और Android के खास नॉलेज बेस का ऐक्सेस भी मिलता है. इससे यह पक्का करने में मदद मिलती है कि आपके प्रोजेक्ट में, Android के सुझाए गए पैटर्न और सबसे सही तरीके लागू किए गए हों.

Android सीएलआई कमांड और विकल्पों के बारे में पूरी जानकारी पाने के लिए, Android सीएलआई कमांड का रेफ़रंस देखें.

Android सीएलआई इंस्टॉल करना

Android CLI इंस्टॉल करने के लिए, यह तरीका अपनाएं:

  1. Android का सीएलआई डाउनलोड करें.

  2. पक्का करें कि Android CLI का नया वर्शन इस्तेमाल किया जा रहा हो. इसके लिए, इसे अपडेट करें:

    android update

यह देखने के लिए कि आपके कंप्यूटर पर Android CLI पहले से इंस्टॉल है या नहीं, which android या command -v android चलाएं: अगर यह कोई पाथ दिखाता है, तो इसका मतलब है कि यह इंस्टॉल है.

एजेंट के लिए सेट अप करना

एजेंट को Android CLI को समझने और उसका इस्तेमाल करने में मदद करने के लिए, android-cli स्किल इंस्टॉल करने के लिए android init चलाएं.

इकट्ठा किया गया डेटा

Android CLI, टूल के बुनियादी इस्तेमाल से जुड़ा डेटा इकट्ठा करता है. हम यह डेटा इकट्ठा करते हैं:

  • android कमांड और सब-कमांड के इनवोकेशन. उदाहरण के लिए, android run और android create.
  • इस्तेमाल किए गए नॉन-पोज़िशनल आर्ग्युमेंट या विकल्पों के नाम. उदाहरण के लिए, --sdk या --version.
  • पोज़ीशनल आर्ग्युमेंट और फ़्लैग वैल्यू, Android CLI के ज़रिए मैनेज किए जाने वाले सिस्टम के विकल्पों के पहले से तय किए गए सेट से मैप होती हैं. उदाहरण के लिए, हम एम्युलेटर टेंप्लेट के नाम इकट्ठा करते हैं. जैसे, medium_phone और large_desktop. साथ ही, एजेंट के नाम इकट्ठा करते हैं. जैसे, GEMINI, CLAUDE या CODEX.
  • स्टैक ट्रेस और अपवाद वाले मैसेज. इनमें पहचान ज़ाहिर करने वाली निजी जानकारी को इकट्ठा करने से पहले ही हटा दिया जाता है, ताकि निजता को सुरक्षित रखा जा सके.

यहां ऐसे डेटा के कुछ उदाहरण दिए गए हैं जिसे हम इकट्ठा नहीं करते:

  • जब कोई कमांड चलाई जाती है, तब हम CLI के जवाबों को इकट्ठा नहीं करते.
  • हम उपयोगकर्ता के बनाए गए इनपुट या सीएलआई को पास किए गए बाहरी आइडेंटिफ़ायर इकट्ठा नहीं करते. जैसे, खास Maven कोऑर्डिनेट, लोकल फ़ाइल पाथ या कस्टम प्रोजेक्ट के नाम. उदाहरण के लिए, अगर android create --name=com.company.internal.app कमांड को एक्ज़ीक्यूट किया जाता है, तो हम यह रिकॉर्ड करते हैं कि --name आर्ग्युमेंट का इस्तेमाल करके android create को एक्ज़ीक्यूट किया गया था. हालांकि, हम com.company.internal.app वैल्यू को सेव नहीं करते हैं.

डेटा कलेक्शन की सुविधा बंद करने के लिए, Android CLI के साथ कोई कमांड चलाते समय --no-metrics फ़्लैग का इस्तेमाल करें.

सुझाव/राय देना या शिकायत करना और समस्याएं

अगर आपको कोई समस्या आती है या आपको कोई सुझाव/राय देनी है या शिकायत करनी है, तो बग की शिकायत करें.

पहले से मालूम समस्याएं

  • फ़िलहाल, Windows के लिए android emulator कमांड बंद है.
  • फ़िलहाल, Windows PowerShell से Android CLI डाउनलोड करने की सुविधा उपलब्ध नहीं है.

Android सीएलआई को कॉन्फ़िगर करना

.androidrc फ़ाइल बनाएं, ताकि Android CLI को हर बार शुरू करने पर फ़्लैग और विकल्प अपने-आप लागू हो जाएं. अपने ऑपरेटिंग सिस्टम के हिसाब से, फ़ाइल को यहां सेव करें:

  • macOS और Linux: ~/.androidrc
  • Windows: %USERPROFILE%\.androidrc

उन फ़्लैग को जोड़ें जिन्हें आपको फ़ाइल पर अपने-आप लागू करना है. हर फ़्लैग को अलग-अलग लाइन में जोड़ें.

उदाहरण के लिए, अगर आपको Android CLI को हर बार डिफ़ॉल्ट रूप से किसी खास Android SDK का इस्तेमाल करने के लिए सेट करना है, तो अपनी फ़ाइल में --sdk फ़्लैग जोड़ें:

--sdk=<path-to-sdk>

ग्लोबल ऑप्शन

ये ऐसे फ़्लैग हैं जिनका इस्तेमाल करना ज़रूरी नहीं है. हालांकि, इनका इस्तेमाल Android के अन्य सीएलआई कमांड के साथ किया जा सकता है.

-h, --help

इस्तेमाल: android <command> -h

जानकारी: इससे टूल या किसी खास कमांड के लिए सहायता मैन्युअल दिखता है.

उदाहरण:

  • android -h
  • android create -h

--sdk

इस्तेमाल: android --sdk=<path-to-sdk> <command>

ब्यौरा: उस Android SDK का पाथ जिसका इस्तेमाल आपको इसके बाद दिए गए कमांड के लिए करना है. जब भी आपको स्विच करना हो, तब ग्लोबल एनवायरमेंट वैरिएबल बदलने के बजाय, --sdk सेटिंग का इस्तेमाल करके, Android SDK को कुछ समय के लिए डिफ़ॉल्ट के तौर पर सेट किया जा सकता है. यह देखने के लिए कि डिफ़ॉल्ट रूप से कौनसा Android SDK इस्तेमाल किया जा रहा है, android info चलाएं.

उदाहरण: android --sdk=<path/to/sdk> sdk list

-v, --verbose

इस्तेमाल: android -v <command>

ब्यौरा: वर्बोस आउटपुट चालू करें. ज़्यादा शब्दों में जानकारी देने के लिए, -v के कई विकल्प तय करें. उदाहरण के लिए, -v, -vv या -vvv.

-V, --version

इस्तेमाल: android -V

ब्यौरा: प्रिंट वर्शन की जानकारी और बाहर निकलें.

निर्देश

Android सीएलआई कमांड और विकल्पों के बारे में पूरी जानकारी पाने के लिए, Android सीएलआई कमांड का रेफ़रंस देखें.