Android Studio के लिए जर्नी

Android Studio के लिए Journeys, एआई की विज़न और रीज़निंग क्षमताओं का इस्तेमाल करता है. इससे, नैचुरल लैंग्वेज में दिए गए निर्देशों के आधार पर, आपके ऐप्लिकेशन को नेविगेट और टेस्ट किया जा सकता है. आपके निर्देशों के सेट को जर्नी कहा जाता है. इन्हें कार्रवाइयों में बदल दिया जाता है, ताकि एआई आपके ऐप्लिकेशन पर उन्हें पूरा कर सके. इसके अलावा, ज़्यादा मुश्किल दावे लिखे और उनके बारे में बताया जा सकता है. एआई, डिवाइस पर दिखने वाली जानकारी के आधार पर इनका आकलन करता है.

Gemini यह तय करता है कि लक्ष्यों को पूरा करने के लिए कौनसी कार्रवाइयां करनी हैं. इसलिए, आपके ऐप्लिकेशन के लेआउट या व्यवहार में मामूली बदलाव होने पर भी, यात्राएं ज़्यादा असरदार होती हैं. इससे आपके ऐप्लिकेशन के अलग-अलग वर्शन और डिवाइस के अलग-अलग कॉन्फ़िगरेशन पर टेस्ट चलाने के दौरान, कम फ़्लेकी टेस्ट मिलते हैं.

Android Studio या कमांड लाइन से, किसी भी लोकल या रिमोट Android डिवाइस पर जर्नी लिखी और चलाई जा सकती हैं. आईडीई, जर्नी और ज़्यादा बेहतर नतीजों (रिच रिज़ल्ट) को बनाने के लिए, नया एडिटर उपलब्ध कराता है. इससे आपको Gemini के तर्क और जर्नी को लागू करने के तरीके को बेहतर ढंग से समझने में मदद मिलती है.

यात्रा की योजना बनाना

Android Studio में फ़ाइल टेंप्लेट और नया एडिटर उपलब्ध है. इससे जर्नी बनाना और उनमें बदलाव करना आसान हो जाता है. यात्राओं के बारे में जानकारी देने के लिए, एक्सएमएल सिंटैक्स का इस्तेमाल किया जाता है. इससे यात्रा के ब्यौरे और चरणों को व्यवस्थित किया जा सकता है.

कोई जर्नी बनाने और उसमें बदलाव करने के लिए, यह तरीका अपनाएं:

1. Android Studio में Project पैनल में जाकर, उस ऐप्लिकेशन मॉड्यूल पर राइट क्लिक करें जिसके लिए आपको जर्नी लिखनी है.
2. नया > जर्नी टेस्ट को चुनें.

3. दिखने वाले डायलॉग बॉक्स में, अपनी जर्नी का नाम और जानकारी दें.

   

4. पूरा करें पर क्लिक करें. Android Studio, आपकी यात्रा के लिए एक एक्सएमएल फ़ाइल बनाता है. इसका नाम वही होता है जो आपने चुना है. एक्सएमएल में सीधे बदलाव करने के लिए, कोड व्यू का इस्तेमाल किया जा सकता है. इसके अलावा, आसानी से बदलाव करने के लिए डिज़ाइन व्यू का इस्तेमाल किया जा सकता है.

5. डिज़ाइन व्यू में अपनी यात्रा देखते समय, टेक्स्ट फ़ील्ड का इस्तेमाल करके अपनी यात्रा के हर चरण के बारे में बताएं. हर चरण में, ऐसी कार्रवाइयां शामिल की जा सकती हैं जिन्हें आपको Gemini से पूरा करवाना है. इसके अलावा, ऐसे दावे भी शामिल किए जा सकते हैं जिनका आकलन आपको Gemini से करवाना है.

6. उसी जर्नी में नया चरण शुरू करने के लिए, अपने कीबोर्ड पर Enter दबाएं. आपको जिस यात्रा के हर चरण को तय करना है उसके लिए, इस प्रोसेस को अपनी ज़रूरत के हिसाब से दोहराया जा सकता है.

बिल्ड के वैरिएंट कॉन्फ़िगर करना

जर्नी, आपके ऐप्लिकेशन के कुछ खास बिल्ड वैरिएंट के साथ काम करती हैं. विज़र्ड का इस्तेमाल करके पहली बार कोई जर्नी बनाने पर, जनरेट किया गया टेस्ट सुइट, Android Studio में चालू बिल्ड वैरिएंट के साथ काम करने के लिए कॉन्फ़िगर किया जाता है.

हालांकि, अगर बाद में कॉन्फ़िगरेशन अपडेट किए बिना, Android Studio में ऐक्टिव बिल्ड वैरिएंट (उदाहरण के लिए, demoDebug जैसे किसी दूसरे प्रॉडक्ट फ़्लेवर पर) स्विच किया जाता है, तो जर्नी नहीं चलेगी. इस समस्या को ठीक करने के लिए, आपको मॉड्यूल-लेवल की build.gradle.kts (या build.gradle) फ़ाइल के testSuites ब्लॉक में मौजूद targetVariants प्रॉपर्टी में नया वैरिएंट जोड़ना होगा.

उदाहरण के लिए, demoDebug वैरिएंट के लिए journeysTest सुइट को कॉन्फ़िगर करने के लिए:

android {
    // ...
    testSuites {
        create("journeysTest") {
            // ...
            targetVariants += listOf("demoDebug")
        }
    }
}

यात्राएं लिखने के बारे में सलाह

एआई, उन भाषाओं में लिखे गए ज़्यादातर चरणों को समझ सकता है जिनमें यह सुविधा उपलब्ध है. हालांकि, यात्राएं लिखने के लिए यहां दी गई सलाह को अपनाने से, ज़्यादा सटीक और उम्मीद के मुताबिक नतीजे मिल सकते हैं:

• मान लें कि आपका ऐप्लिकेशन पहले से ही फ़ोरग्राउंड में है: यात्रा शुरू करने पर, आपका ऐप्लिकेशन अपने-आप लॉन्च हो जाता है. यात्रा के चरण, ऐप्लिकेशन के पूरी तरह से लॉन्च होने के बाद शुरू होने चाहिए. इसका मतलब है कि आपको "ऐप्लिकेशन लॉन्च करें" को एक चरण के तौर पर शामिल करने की ज़रूरत नहीं है.
• ऐसी भाषा का इस्तेमाल करें जिसका मतलब समझने में मुश्किल न हो: सटीक जानकारी देने से, गलतफ़हमी कम होती है और भरोसेमंद नतीजे मिलते हैं.

• हर चरण में, यह जानकारी शामिल करें कि वह चरण कब पूरा माना जाएगा: इससे Gemini को आपके मकसद को बेहतर तरीके से समझने में मदद मिलती है. साथ ही, यह भी पता चलता है कि कोई चरण कब पूरा हुआ और अगला चरण कब शुरू किया जा सकता है.

• अपनी यात्रा को बेहतर बनाएं: अगर आपकी यात्रा उम्मीद के मुताबिक नहीं चल रही है, तो नतीजे देखें. साथ ही, ‘कार्रवाई की गई’ और उससे जुड़ी ‘वजह’ की जांच करें. इससे आपको यह समझने में मदद मिलेगी कि Gemini ने आपके बताए गए चरणों को आपकी उम्मीद के मुताबिक क्यों पूरा नहीं किया. इस जानकारी का इस्तेमाल करके, निर्देशों को ज़्यादा साफ़ तौर पर बताएं.
• अपने सफ़र को ज़्यादा सटीक चरणों में बाँटें: एआई, एक से ज़्यादा कार्रवाइयों वाले चरणों को समझ सकता है. हालाँकि, कभी-कभी ज़्यादा बारीक और अलग-अलग चरणों से, सफ़र की सटीक जानकारी मिलती है और उसे दोहराया जा सकता है.
  • "गड़बड़ी: ज़्यादा से ज़्यादा कोशिशों के बाद भी कार्रवाई पूरी नहीं की जा सकी": अगर आपको यह गड़बड़ी दिखती है, तो जिन चरणों में गड़बड़ी हो रही है उन्हें दो या उससे ज़्यादा छोटे चरणों में बांटकर देखें. ऐसा इसलिए होता है, क्योंकि यह गड़बड़ी तब होती है, जब एआई आपके ऐप्लिकेशन के साथ ज़्यादा से ज़्यादा इंटरैक्शन करने के बाद भी कार्रवाई पूरी नहीं कर पाता.

इसके साथ काम करने वाली और काम न करने वाली सुविधाएं

यहां यात्रा के बारे में लिखते समय, इस्तेमाल की जा सकने वाली और फ़िलहाल पूरी तरह से इस्तेमाल न की जा सकने वाली सुविधाओं की खास जानकारी दी गई है. यहां दी गई सूचियां पूरी नहीं हैं.

जर्नी में ये कार्रवाइयाँ की जा सकती हैं:

• यूज़र इंटरफ़ेस (यूआई) के एलिमेंट पर टैप करें.
• टेक्स्ट फ़ील्ड में टेक्स्ट डालने के लिए, टाइप करें.
• यूज़र इंटरफ़ेस (यूआई) में एक जगह से दूसरी जगह जाने के लिए, किसी दिशा में स्वाइप/स्क्रोल करें.

फ़िलहाल, ये सुविधाएं पूरी तरह से काम नहीं करती हैं या हो सकता है कि ये ठीक से काम न करें:

• एक से ज़्यादा उंगलियों से किए जाने वाले हाथ के जेस्चर (उदाहरण के लिए, ज़ूम करने के लिए पिंच करना) - स्क्रीन पर एक साथ दो या इससे ज़्यादा उंगलियों से इंटरैक्ट करना. जैसे, ज़ूम इन या ज़ूम आउट करने के लिए पिंच करना या दो उंगलियों से स्वाइप करना.
• दबाकर रखें - किसी उंगली को स्टैंडर्ड टैप से ज़्यादा देर तक दबाकर रखना.
• दो बार टैप करना - स्क्रीन पर एक ही जगह पर तेज़ी से दो बार टैप करना.
• स्क्रीन घुमाना/फ़ोल्ड करना - डिवाइस के ओरिएंटेशन में बदलाव होने पर, उसे मैनेज करना. जैसे, पोर्ट्रेट और लैंडस्केप मोड के बीच स्विच करना. इसके अलावा, फ़ोल्ड किए जा सकने वाले डिवाइसों की फ़िज़िकल स्थिति में बदलाव होने पर, उसे मैनेज करना. जैसे, डिवाइस को खोलना या बंद करना.
• मेमोरी - पिछली बातचीत या चरणों के दौरान दी गई किसी जानकारी, कॉन्टेक्स्ट या उपयोगकर्ता के इनपुट को बनाए रखना और उसे याद रखना.
• गिनती करना - मात्राओं, फ़्रीक्वेंसी या प्रोग्रेस को सटीक तरीके से ट्रैक करना.
• शर्तों के आधार पर कार्रवाई करने के निर्देश - इसमें यह तय किया जाता है कि दी गई अन्य शर्तें पूरी होने पर कौनसी कार्रवाइयां की जाएंगी.

सुविधाओं और क्षमताओं को लगातार बेहतर बनाया जा रहा है. हमारा सुझाव है कि ज़्यादा सुविधाओं और क्षमताओं के बारे में जानने के लिए, इस पेज को बाद में देखें. Journeys को बेहतर बनाने में हमारी मदद करने के लिए, अपने सुझाव/राय दें या शिकायत करें.

अपनी यात्रा शुरू करें

आपके पास, किसी भी उपलब्ध लोकल या रिमोट डिवाइस पर अपनी यात्रा को चलाने का विकल्प होता है. यह किसी भी अन्य इंस्ट्रूमेंटेड टेस्ट की तरह ही होता है. साथ ही, Android Studio ज़्यादा बेहतर नतीजे जनरेट करता है. इससे आपको अपनी यात्रा के एक्ज़ीक्यूशन को समझने में मदद मिलती है.

किसी जर्नी को टेस्ट करने के लिए, यह तरीका अपनाएं:

1. मुख्य टूलबार से कोई टारगेट डिवाइस चुनें. जैसे, इंस्ट्रुमेंटेड टेस्ट चलाते समय किया जाता है.
2. उस जर्नी की एक्सएमएल फ़ाइल पर जाएं जिसे आपको टेस्ट करना है. इसके बाद, उसे एडिटर में खोलें.
3. एडिटर में जाकर, इनमें से कोई एक काम करें:
   1. अगर आप डिज़ाइन व्यू में हैं, तो Run Journey पर क्लिक करें.
   2. अगर आप कोड व्यू में हैं, तो एक्सएमएल में जहां जर्नी का नाम तय किया गया है उसके बगल में गटर में मौजूद, 'test' चलाएं पर क्लिक करें.

Android Studio, आपके लिए Journeys Test कॉन्फ़िगरेशन बनाता है और इसे टारगेट डिवाइस पर चलाता है. लागू करने के दौरान, Android Studio आपके ऐप्लिकेशन को बनाता और डिप्लॉय करता है. साथ ही, Gemini से कनेक्ट होता है, ताकि यह तय किया जा सके कि आपकी यात्रा के हर चरण के लिए कौनसी कार्रवाइयाँ करनी हैं.

पहले से इंस्टॉल किए गए किसी भी ऐप्लिकेशन के लिए, जर्नी चलाएं

टेस्ट डिवाइस पर, पहले से इंस्टॉल किए गए ऐप्लिकेशन पर जर्नी चलाई जा सकती है. अगर आपको अपने ऐप्लिकेशन के प्रोडक्शन वर्शन की जांच करनी है या आपने अब तक अपने ऐप्लिकेशन को Android Gradle Plugin 9.0.0 या इसके बाद के वर्शन पर अपडेट नहीं किया है, तो यह विकल्प आपके लिए फ़ायदेमंद है.

1. Android Gradle प्लगिन 9.0.0 या इसके बाद के वर्शन पर अपडेट किया गया कोई प्रोजेक्ट खोलें या नया प्रोजेक्ट बनाएं.
2. सफ़र के बारे में जानकारी लिखना.
3. यात्रा के लिए, रन कॉन्फ़िगरेशन में बदलाव करें और यहां दिए गए एनवायरमेंट वैरिएबल जोड़ें. Android Studio से कोई जर्नी चलाने की कोशिश करने पर, रन कॉन्फ़िगरेशन अपने-आप बन जाता है.
   • JOURNEYS_CUSTOM_APP_ID को टारगेट ऐप्लिकेशन के पैकेज आईडी पर सेट करें.
4. बदलाव की गई यात्रा को शुरू करें. Android Studio को, उस टारगेट ऐप्लिकेशन पर यात्रा के चरणों को पूरा करना चाहिए जिसे आपने तय किया है.

कमांड लाइन से कोई जर्नी चलाना

कमांड लाइन से जर्नी चलाने के लिए, Android CLI का इस्तेमाल करें.

नतीजे देखें

Android Studio में आपकी यात्रा की जांच पूरी होने पर, टेस्ट के नतीजों वाला पैनल अपने-आप दिखता है. इसमें आपको नतीजे दिखते हैं.

Android Studio में की जाने वाली अन्य इंस्ट्रुमेंटेड जांचों की तुलना में, यात्राओं के नतीजों को दिखाने के तरीके में कुछ अंतर हैं.

• टेस्ट पैनल में, इस प्रोसेस को अलग-अलग चरणों में बांटा गया है. Gemini ने हर चरण को कैसे पूरा किया, इस बारे में ज़्यादा जानने के लिए, हर चरण पर क्लिक करें.
• नतीजे पैनल में, आपको Gemini के काम करने के तरीके के बारे में ज़्यादा जानकारी मिलती है. इससे आपको यह समझने में मदद मिलती है कि Gemini ने आपकी यात्रा के बारे में कैसे समझा और तर्क दिया. साथ ही, यह भी पता चलता है कि इसे कैसे पूरा किया गया.
  • Gemini को भेजे गए स्क्रीनशॉट, हर चरण में विज़ुअल एड के तौर पर दिखाए जाते हैं.
  • हर स्क्रीनशॉट के बगल में, की गई कार्रवाई और Gemini के उस कार्रवाई को करने की वजह के बारे में बताया गया है.
  • चरण में मौजूद हर कार्रवाई को नंबर दिया गया है.

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

• Gradle कॉन्फ़िगरेशन कैश से जुड़ी समस्याएं: Gradle कॉन्फ़िगरेशन कैश चालू होने पर, जर्नी उम्मीद के मुताबिक काम नहीं कर सकती हैं. उदाहरण के लिए, ऐसा होने पर एक से ज़्यादा जर्नी फ़ाइलें मौजूद होने पर, गलत जर्नी फ़ाइल चल सकती है. इससे पुष्टि करने में भी समस्याएं आ सकती हैं.

  इस समस्या को हल करने के लिए, अपने प्रोजेक्ट की org.gradle.configuration-cache=false फ़ाइल में gradle.properties सेट करके, कॉन्फ़िगरेशन कैश मेमोरी को बंद किया जा सकता है.

• किसी जर्नी की जांच करते समय, आपके ऐप्लिकेशन के लिए सभी अनुमतियां डिफ़ॉल्ट रूप से दी जाती हैं.

• Android 15 (एपीआई लेवल 35) पर चलने वाले डिवाइस पर किसी जर्नी को टेस्ट करते समय, आपको डिवाइस पर यह चेतावनी दिख सकती है: "असुरक्षित ऐप्लिकेशन ब्लॉक किया गया". यह चेतावनी "AndroidX क्रॉलर" के लिए दिखती है. इस जांच को बायपास करने के लिए, फिर भी इंस्टॉल करें पर क्लिक करें. इसके अलावा, डिवाइस पर डेवलपर के लिए सेटिंग और टूल कॉन्फ़िगर किए जा सकते हैं. साथ ही, यूएसबी पर ऐप्लिकेशन की पुष्टि करें विकल्प को बंद किया जा सकता है.