APK और ट्रैक

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

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

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

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

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

   • "alpha" और "beta" जैसे ट्रैक टेस्ट करना

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

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

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

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

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

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

फ़ॉर्म फ़ैक्टर ट्रैक का ट्रैक नाम

फ़ॉर्म फ़ैक्टर ट्रैक के ट्रैक के नाम को एक खास पहचानकर्ता से पहले जोड़ा जाता है.

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

किसी दिए गए फ़ॉर्म फ़ैक्टर ट्रैक के लिए ट्रैक नाम की गणना कैसे करें?

आम तौर पर, प्रोडक्शन, ओपन टेस्टिंग, और इंंटरनल टेस्टिंग ट्रैक के बारे में जाना-पहचाना ट्रैक होता है.

ट्रैक प्रकार	डिफ़ॉल्ट ट्रैक नाम
प्रोडक्शन	प्रोडक्शन
सबके लिए उपलब्ध जांच	बीटा वर्शन
इंंटरनल टेस्टिंग	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 को रेफ़र करने के लिए आप इस वर्शन कोड का इस्तेमाल करेंगे.

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

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

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

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

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

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

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

1. वर्कफ़्लो में बदलाव करता है के मुताबिक, बदलाव करें.

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

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

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

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

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

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

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

1. वर्कफ़्लो में बदलाव करता है के मुताबिक, बदलाव करें.

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

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

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

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

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

1. वर्कफ़्लो में बदलाव करता है के मुताबिक, बदलाव करें.

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

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

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

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

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

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

1. वर्कफ़्लो में बदलाव करता है के मुताबिक, बदलाव करें.

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

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

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

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

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

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

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

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

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

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

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

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

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