APK और ट्रैक

Google Play Developer API से आप अपने ऐप्लिकेशन के लिए नए APK अपलोड कर सकते हैं और उन्हें अलग-अलग रिलीज़ ट्रैक पर रिलीज़ कर सकते हैं. इससे आपको अपने ऐप्लिकेशन के ऐल्फ़ा और बीटा वर्शन डिप्लॉय करने की सुविधा मिलती है. ये वर्शन, मंज़ूरी पा चुके लोगों के लिए उपलब्ध कराए जाते हैं. इससे आपको कुछ लोगों के लिए रिलीज़ करने की सुविधा वाले वर्शन को भी डिप्लॉय करने की सुविधा मिलती है. यह वर्शन, ऐप्लिकेशन इस्तेमाल करने वाले कुछ ही उपयोगकर्ताओं के लिए अपने-आप उपलब्ध होता है. कुछ लोगों के लिए रिलीज़ करने वाला वर्शन रिलीज़ करने के बाद, ऐप्लिकेशन का वह वर्शन पाने वाले उपयोगकर्ताओं की संख्या धीरे-धीरे बढ़ाई जा सकती है. ऐसा तब तक होगा, जब तक कि उस वर्शन को “प्रोडक्शन” वर्शन के तौर पर डिप्लॉय नहीं किया जाता.

APK जोड़ना और उनमें बदलाव करना

1. Edits.apks: अपलोड करने वाले तरीके का इस्तेमाल करके, एक या उससे ज़्यादा APK अपलोड करें.

   यह तरीका APK को स्टोरेज "बकेट" में अपलोड करता है, जहां इसे उपयोगकर्ताओं के लिए डिप्लॉय करने के लिए, "ट्रैक" को असाइन किया जा सकता है. (अगर उस बदलाव को मिटाया या खारिज कर दिया जाता है, तो उस बदलाव में अपलोड किया गया कोई भी APK भी खो जाएगा.)

2. Edits.tracks: अपडेट को कॉल करके, "ट्रैक" पर APK रिलीज़ करें. इन ट्रैक पर APKs रिलीज़ किए जा सकते हैं:

   • "alpha" और "beta" जैसे टेस्टिंग ट्रैक

     ऐप के ऐल्फ़ा और बीटा वर्शन उन उपयोगकर्ताओं को डिप्लॉय किए जाते हैं जिन्हें आपने ऐल्फ़ा और बीटा टेस्ट ग्रुप को असाइन किया होता है. Google Play Console का इस्तेमाल करके, इन ग्रुप के लिए उपयोगकर्ताओं को असाइन किया जाता है.

   • इंटरनल टेस्टिंग ट्रैक: "qa"

     आपके ऐप्लिकेशन के अंदरूनी वर्शन, Google Play Console में कॉन्फ़िगर किए गए ऐप्लिकेशन के इंटरनल टेस्ट ट्रैक में डिप्लॉय कर दिए जाते हैं.

   • प्रोडक्शन ट्रैक: "production"

     "प्रोडक्शन" ट्रैक पर रिलीज़, सभी उपयोगकर्ताओं के लिए डिप्लॉय किए जाते हैं. "प्रोडक्शन" ट्रैक पर कुछ लोगों के लिए रिलीज़ करने का इस्तेमाल किया जा सकता है. इससे पहले, प्रोडक्शन का इस्तेमाल करने वाले कुछ लोगों के पास सुरक्षित तरीके से रिलीज़ लागू होती है. इसके बाद, जब रिलीज़ पर आपका भरोसा बढ़ता है, तब के लिए इस प्रतिशत को धीरे-धीरे बढ़ाया जा सकता है.

   सामान्य-मोड वाले उपयोगकर्ताओं को किसी भी ट्रैक पर एक से ज़्यादा APK नहीं रखने चाहिए. एक से ज़्यादा APK की सुविधा इस्तेमाल करने वाले बेहतर मोड इस्तेमाल करने वाले लोग, हर ट्रैक में शून्य, एक या उससे ज़्यादा APK अपलोड कर सकते हैं.

डिवाइस के नाप या आकार वाले ट्रैक के लिए, ट्रैक का नाम

डिवाइस के नाप या आकार के लिए, ट्रैक के नाम के आगे खास आइडेंटिफ़ायर दिया जाता है.

डिवाइस का नाप या आकार	प्रीफ़िक्स
Android Automotive OS	गाड़ियों से जुड़ी चीज़ें
Wear OS	पहनें
Android TV	टीवी

दिए गए किसी डिवाइस के नाप या आकार के लिए, ट्रैक के नाम का हिसाब कैसे लगाया जाता है?

प्रोडक्शन, ओपन टेस्टिंग, और इंटरनल टेस्टिंग ट्रैक जैसे सामान्य ट्रैक टाइप, ट्रैक के लिए एक मशहूर नाम हैं.

ट्रैक प्रकार	डिफ़ॉल्ट ट्रैक नाम
प्रोडक्शन	प्रोडक्शन
सबके लिए उपलब्ध जांच	बीटा वर्शन
इंटरनल टेस्टिंग	qa

दिए गए डिवाइस के नाप या आकार के लिए, ट्रैक के नाम का हिसाब इस तरह से लगाया जा सकता है: "[prefix]:defaultTrackName". उदाहरण के लिए, Wear OS वाले डिवाइस के नाप या आकार के लिए, अन्य ट्रैक "wear:production", "wear:beta", और "wear:qa" होंगे.

क्लोज़्ड टेस्टिंग ट्रैक मैन्युअल तरीके से बनाए जाते हैं और इन्हें पसंद के मुताबिक नाम दिए जाते हैं. इसलिए, $name नाम वाले डिवाइस के नाप या आकार के लिए, क्लोज़्ड टेस्टिंग ट्रैक का ट्रैक नाम "[prefix]:$name" होगा.

APK वर्कफ़्लो का उदाहरण

इस सेक्शन में बताया गया है कि ट्रैक एपीआई किस तरह इस्तेमाल किया जाता है. इस मामले में, हम यह मान लेते हैं कि आपको हर ट्रैक के लिए APK के नए वर्शन अपलोड करने हैं. साथ ही, कुछ लोगों को ऐप्लिकेशन की रिलीज़ के लिए तैयार किया गया वर्शन पाने के लिए कुछ उपयोगकर्ताओं को असाइन करना है. (व्यावहारिक तौर पर, किसी डेवलपर को शायद एक ही कार्रवाई में ये सभी कार्रवाइयां करने की अनुमति न हो. इसके बजाय, आपके पास बीटा वर्शन को एक दिन अपडेट करने, किसी और दिन "प्रोडक्शन" पर कुछ लोगों के लिए रिलीज़ बनाने वगैरह का विकल्प होता है.

1. बदलाव वर्कफ़्लो में बताए गए तरीके से नया बदलाव खोलें
2. हर उस APK के लिए Edits.apks: अपलोड वाला तरीका इस्तेमाल करें जिसे आपको अपलोड करना है. APK को तरीके के अनुरोध के मुख्य हिस्से में पास करें. (यह APK को स्टोरेज एरिया में रखता है, लेकिन इसे ट्रैक पर रिलीज़ नहीं करता या डिप्लॉय नहीं करता.) यह तरीका आपके अपलोड किए गए हर APK के लिए एक वर्शन कोड दिखाता है; जब APK को किसी ट्रैक पर रिलीज़ किया जाता है, तब उस APK को रेफ़र करने के लिए इस वर्शन कोड का इस्तेमाल किया जाता है.

3. हर उस ट्रैक के लिए Edits.tracks: अपडेट वाला तरीका इस्तेमाल करें जिस पर आपको APK रिलीज़ करने हैं. अनुरोध के मुख्य हिस्से में, Edits.tracks संसाधन पास करें. इसमें वह रिलीज़ शामिल होती है जिसे आपको रोल आउट करना है. उदाहरण के लिए, वर्शन कोड 88 वाले APK को रिलीज़ करने के लिए:

   {
   "releases": [{
     "versionCodes": ["88"],
     "status": "completed"
   }]
   }
   

   फ़िलहाल, APK अब भी उपयोगकर्ताओं के लिए उपलब्ध नहीं हैं. दूसरे बदलावों की तरह, बदलाव तब तक लाइव नहीं होते, जब तक उन्हें लागू नहीं किया जाता.

4. बदलाव करने के लिए Edits: कमिट करें तरीके को कॉल करें. ऐसा करने के बाद, हर ट्रैक पर मौजूद उपयोगकर्ताओं को APK का अपडेट किया गया वर्शन दिया जाएगा. (सभी बदलावों की तरह, इन बदलावों को लागू होने में कई घंटे लग सकते हैं.)

कुछ लोगों के लिए रिलीज़ करना

जब आपके पास APK का ऐसा नया वर्शन हो जिसे आपको धीरे-धीरे डिप्लॉय करना हो, तो आपके पास उसे "कुछ लोगों के लिए रिलीज़ करने की सुविधा" के वर्शन के तौर पर रिलीज़ करने का विकल्प होता है. ऐसा करने पर, Google Play इसे अपने-आप ऐप्लिकेशन के उन उपयोगकर्ताओं के चुनिंदा हिस्से के लिए अपने-आप डिप्लॉय कर देता है जिन्हें आपने चुना है. अगर "रोलआउट" APK में कोई भी समस्या (जैसे क्रैश वगैरह) नहीं है, तो आपको उस वर्शन को पाने वाले उपयोगकर्ताओं की संख्या बढ़ सकती है. जब आप तैयार हों, तब उस APK को नए प्रोडक्शन वर्शन के रूप में डिप्लॉय करें.

इस सेक्शन में उन चरणों के बारे में बताया गया है जिनका इस्तेमाल करके, किसी APK को कई चरणों में रोल आउट करने के बाद उसे प्रोडक्शन में प्रमोट किया जा सकता है:

1. बदलाव वर्कफ़्लो में बताए गए तरीके से बदलाव करें.

2. बदलाव करने के लिए, Edits.apks: अपलोड करने वाले तरीके का इस्तेमाल करके, नया APK अपलोड करें.

3. Edits.tracks: अपडेट तरीके का इस्तेमाल करके, प्रोडक्शन ट्रैक पर "inProgress" कुछ लोगों के लिए रिलीज़ करने की सुविधा शुरू करें. उन उपयोगकर्ताओं का हिस्सा चुनें जिन्हें नया APK मिलना चाहिए. इस समय, APK किसी भी असली उपयोगकर्ता के लिए अब भी उपलब्ध नहीं है.

   {
   "releases": [{
     "versionCodes": ["99"],
     "userFraction": 0.05,
     "status": "inProgress"
   }]
   }
   

4. मौजूदा बदलाव में किए गए बदलावों को लागू करने के लिए, Edits: कमिट करें पर क्लिक करें. अगले कुछ घंटों में, उपयोगकर्ताओं के लिए नया APK लॉन्च किया जाएगा. आपके चुने गए कुछ उपयोगकर्ताओं को नया APK मिलेगा.

कुछ लोगों के लिए रिलीज़ करने की सुविधा की सफलता के आधार पर, हो सकता है कि आप उस रिलीज़ के लिए ज़रूरी शर्तें पूरी करने वाले उपयोगकर्ताओं का प्रतिशत बढ़ाना चाहें या रिलीज़ को रोकना चाहें.

कुछ लोगों के लिए रिलीज़ करने की सुविधा के लिए, उपयोगकर्ताओं के प्रतिशत की संख्या बढ़ाना

यह मानते हुए कि आपका ऐप्लिकेशन 5% तक रिलीज़ हो चुका है, जैसा कि पिछले सेक्शन में बताया गया है, यह सेक्शन बताता है कि जिन मामलों में रिलीज़ ठीक से चल रही है उनमें प्रतिशत को कैसे बढ़ाया जा सकता है:

1. बदलाव वर्कफ़्लो में बताए गए तरीके से बदलाव करें.

2. Edits.tracks: अपडेट तरीके का इस्तेमाल करके, प्रोडक्शन ट्रैक पर कुछ लोगों के लिए रिलीज़ की गई "inProgress" रिलीज़ को बदलें. उन उपयोगकर्ताओं का प्रतिशत बढ़ाएं जिन्हें नया APK मिलना चाहिए:

   {
   "releases": [{
     "versionCodes": ["99"],
     "userFraction": 0.1,
     "status": "inProgress"
   }]
   }
   

3. मौजूदा बदलाव में किए गए बदलावों को लागू करने के लिए, Edits: कमिट करें पर क्लिक करें. अगले कुछ घंटों में, उपयोगकर्ताओं के लिए नया APK लॉन्च किया जाएगा. आपके चुने गए कुछ उपयोगकर्ताओं को नया APK मिलेगा.

कुछ लोगों के लिए रिलीज़ करने की सुविधा को रोकना

मान लें कि आपका ऐप्लिकेशन 5% लोगों के लिए रिलीज़ हो रहा है, जैसा कि पिछले सेक्शन में बताया गया था, यह सेक्शन बताता है कि समस्या मिलने पर, कुछ लोगों के लिए रिलीज़ करने की सुविधा को कैसे रोका जा सकता है:

1. बदलाव वर्कफ़्लो में बताए गए तरीके से बदलाव करें.

2. Edits.tracks: अपडेट तरीके का इस्तेमाल करके, प्रोडक्शन ट्रैक पर कुछ लोगों के लिए रिलीज़ की गई "inProgress" रिलीज़ को बदलें. स्टेटस को "halted" पर सेट करें.

   {
   "releases": [{
     "versionCodes": ["99"],
     "status": "halted"
   }]
   }
   

3. मौजूदा बदलाव में किए गए बदलावों को लागू करने के लिए, Edits: कमिट करें पर क्लिक करें. आपकी रिलीज़ अब नए उपयोगकर्ताओं के लिए उपलब्ध नहीं होगी.

अगर बाद में रोकी गई रिलीज़ को फिर से शुरू करना हो, तो उसकी स्थिति को वापस "inProgress" पर सेट करें.

कुछ लोगों के लिए रिलीज़ करने की प्रोसेस पूरी करना

कुछ लोगों के लिए रिलीज़ करने की सुविधा ठीक से लागू करने और इसे 100% उपयोगकर्ताओं के लिए रोल आउट करने के बाद, रिलीज़ की स्थिति को "completed" पर सेट किया जा सकता है:

1. बदलाव वर्कफ़्लो में बताए गए तरीके से बदलाव करें.

2. Edits.tracks: अपडेट तरीके का इस्तेमाल करके, प्रोडक्शन ट्रैक पर कुछ लोगों के लिए रिलीज़ की गई "inProgress" रिलीज़ को बदलें. स्टेटस को "completed" पर सेट करें.

   {
   "releases": [{
     "versionCodes": ["99"],
     "status": "completed"
   }]
   }
   

3. मौजूदा बदलाव में किए गए बदलावों को लागू करने के लिए, Edits: कमिट करें पर क्लिक करें. अगले कुछ घंटों में, उपयोगकर्ताओं के लिए नया APK लॉन्च किया जाएगा. आपके चुने गए कुछ उपयोगकर्ताओं को नया APK मिलेगा.

ड्राफ़्ट रिलीज़

ड्राफ़्ट रिलीज़ की मदद से, एपीआई का इस्तेमाल करके APKs अपने-आप अपलोड किए जा सकते हैं और रिलीज़ बनाई जा सकती है. इस एपीआई को बाद में, Google Play Console से डिप्लॉय किया जा सकता है. किसी ट्रैक पर ड्राफ़्ट रिलीज़ बनाने का तरीका:

1. बदलाव वर्कफ़्लो में बताए गए तरीके से नया बदलाव खोलें
2. हर उस APK के लिए Edits.apks: अपलोड वाला तरीका इस्तेमाल करें जिसे आपको अपलोड करना है. APK को, तरीके के अनुरोध के मुख्य हिस्से में पास करें. यह तरीका, आपके अपलोड किए गए हर APK के लिए एक वर्शन कोड दिखाता है; जब APK को किसी रिलीज़ के लिए असाइन किया जाता है, तब उस APK की जानकारी देने के लिए इस वर्शन कोड का इस्तेमाल किया जाता है.

3. हर उस ट्रैक के लिए Edits.tracks: अपडेट वाला तरीका इस्तेमाल करें जिस पर आपको रिलीज़ करना है. अनुरोध के मुख्य हिस्से में, Edits.tracks रिसॉर्स पास करें. इसमें वह ड्राफ़्ट रिलीज़ शामिल होती है जिसे आपको बनाना है. उदाहरण के लिए:

   {
   "releases": [{
     "name": "My draft release",
     "versionCodes": ["88"],
     "status": "draft"
   }]
   }
   

4. बदलाव करने के लिए Edits: कमिट करें तरीके को कॉल करें. आपकी ड्राफ़्ट रिलीज़ की अब जांच की जा सकती है और उसे Google Play Console या एपीआई के ज़रिए रोल आउट किया जा सकता है.

प्रॉडक्ट की जानकारी देना

अपने ऐप्लिकेशन का नया वर्शन रिलीज़ करते समय, अपने ऐप्लिकेशन की रिलीज़ की जानकारी देकर, उपयोगकर्ताओं के लिए नया क्या है हाइलाइट किया जा सकता है.

ऐसा करने के लिए, Edits.tracks: अपडेट तरीके में, Edits.tracks संसाधन सप्लाई करते समय, "releaseNotes" फ़ील्ड का इस्तेमाल करें.

{
  "releases": [{
      "name": "Release with notes",
      "versionCodes": ["88"],
      "status": "completed",
      "releaseNotes": [
        {"language": "en-US", "text": "Describe what's new in this release."}
      ]
  }]
}