APK और ट्रैक

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

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

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

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

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

    • "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 को किसी ट्रैक पर रिलीज़ करते समय, उसका रेफ़रंस देने के लिए आप इस वर्शन कोड का इस्तेमाल करेंगे.
  3. हर उस ट्रैक के लिए Edits.tracks: अपडेट तरीके को कॉल करें, जिस पर आपको APKs रिलीज़ करने हैं. अनुरोध के मुख्य हिस्से में, 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" रिलीज़ को बदलें. स्टेटस को "halted" पर सेट करें.

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

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

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

ड्राफ़्ट रिलीज़ से, APKs अपने-आप अपलोड होने और एपीआई के ज़रिए रिलीज़ बनाने की सुविधा मिलती है. रिलीज़ को बाद में 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. बदलाव करने के लिए, 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."}
      ]
  }]
}