एंड्रॉइड देव समिट में कई प्रकार के नए उपकरणों और सुविधाओं की घोषणा के साथ, इन-ऐप अपडेट्स (IAU) एपीआई पर विशेष ध्यान दिया जाना चाहिए जिससे डेवलपर्स को सक्रिय उपयोगकर्ताओं को सुविधाएं, बग-फिक्स और प्रदर्शन सुधार की गति बढ़ाने में मदद मिल सके। चूंकि यह सुविधा Google I / O 2019 के बाद आखिरकार जारी की गई थी, इस लेख में मैं IAUs API पर गहरा गोता लगाऊंगा, उपयोगकर्ता द्वारा सुझाए गए विवरणों में वर्णन करूंगा और कुछ कोड नमूने प्रदान करूंगा। इसके अलावा, मैं पांडो ऐप में आईएयू के एकीकरण का कुछ अनुभव साझा करूंगा , जो चीनी सामानों के लिए एक मार्केटप्लेस प्लेटफॉर्म है।

नया एपीआई डेवलपर्स को ऐप को अपडेट करने के लिए सक्रिय उपयोगकर्ताओं को पुश करने के लिए एक नया इन-ऐप अपडेट अनुरोध प्रवाह शुरू करने की अनुमति देता है। Iaus मौजूदा Google Play ऑटो-अपडेट तंत्र का अनुपालन करता है, लेकिन, दुर्भाग्य से, किसी भी प्रकार के अपडेट को अक्षम करने के लिए कुछ उपयोगकर्ताओं के इरादों पर कोई प्रभाव नहीं पड़ता है। IAU के अनुरोध को दो तरीकों से लागू किया जा सकता है, जो पूरी तरह से अलग उपयोगकर्ता अनुभव प्रदान करते हैं।

लचीला प्रवाह उपयोगकर्ताओं को पृष्ठभूमि में एक अद्यतन डाउनलोड करने और इसे सुविधाजनक समय पर स्थापित करने के लिए प्रेरित करता है। यह मामलों में इस्तेमाल किया जाना चाहिए, जबकि यह अभी भी उपयोगकर्ता के लिए ऐप के पुराने संस्करण का उपयोग करने के लिए उपयुक्त है जबकि नया जारी किया गया था।
तत्काल प्रवाह के लिए उपयोगकर्ताओं को ऐप का उपयोग जारी रखने से पहले एक अपडेट डाउनलोड और इंस्टॉल करना होगा। यह उन मामलों में उपयोग किया जाना चाहिए, जबकि अपडेट लागू होने से पहले डेवलपर्स के लिए ऐप के उपयोग को रोकना महत्वपूर्ण है।

चूँकि बाद के उपयोग का मामला पांडो ऐप के लिए कम महत्वपूर्ण और उपयुक्त है, हम पूर्व में विस्तार से चर्चा करेंगे।

Iaus लचीले प्रवाह एकीकरण

मामले का उपयोग करें

लचीले IAU के प्रवाह में निम्न चरण होते हैं।

ऐप Google Play Play को उपलब्ध जानकारी के लिए Play Core लाइब्रेरी का उपयोग करने का अनुरोध करता है।
यदि कोई उपलब्ध अद्यतन है, तो ऐप Google Play को IAUs संवाद दिखाने का अनुरोध करता है। Google Play उपयोगकर्ता को अपडेट अनुरोध संवाद दिखाता है।
यदि उपयोगकर्ता अपडेट के अनुरोध को स्वीकार करता है, तो Google Play पृष्ठभूमि में एक अपडेट डाउनलोड करता है, जो उपयोगकर्ता को स्टेटस बार में सुंदर स्टेट मॉनिटरिंग प्रदान करता है।
यदि एप्लिकेशन डाउनलोड होने की प्रक्रिया पृष्ठभूमि में है, तो Google Play स्वचालित रूप से इंस्टॉलेशन पूरा करता है। ऐसे मामलों के लिए जब ऐप अग्रभूमि में डाउनलोड पूरा हो जाता है, हमें अपडेट पूरा होने के लिए कस्टम तर्क को परिभाषित करना होगा। कार्यान्वयन के लिए कई सर्वोत्तम प्रथाओं पर विचार करें।
1. उपयोगकर्ता के लिए इंस्टॉलेशन प्रगति के साथ Google Play स्क्रीन प्रदर्शित करते समय ऐप इंस्टॉलेशन प्रक्रिया को लॉन्च करता है। इंस्टॉलेशन पूरा होने के बाद, ऐप पुनरारंभ होता है और एक अपडेटेड वर्जन खुलता है। इस मामले में, उपयोगकर्ता को स्पष्ट रूप से पुष्टि करने की अनुमति देने के लिए एक अतिरिक्त संवाद प्रदर्शित करने की अनुशंसा की जाती है कि वह अभी ऐप को फिर से लॉन्च करने के लिए तैयार है। यह एक अत्यधिक अनुशंसित प्रवाह है ।
2. ऐप बैकग्राउंड में जाने तक इंतजार करता है और फिर अपडेट को चुपचाप पूरा करता है। एक हाथ, यह विकल्प उपयोगकर्ता अनुभव के मामले में कम आक्रामक है। लेकिन दूसरी ओर, एप्लिकेशन को पृष्ठभूमि में जाने पर डेवलपर को यह पता लगाने के लिए एक मुश्किल विशेषता को लागू करने की आवश्यकता होती है।

असाधारण स्थितियों में, अपडेट पूरा होने पर Google Play बैकग्राउंड टास्क को स्वचालित रूप से स्थगित कर दिया जाएगा। यह विकल्प स्पष्ट उपयोग के लिए अनुशंसित नहीं है क्योंकि यह अपडेट की स्थापना के बारे में कोई गारंटी नहीं देता है।

मैनुअल परीक्षण के लिए बुनियादी आवश्यकताएँ

परीक्षण उपकरण पर मैन्युअल रूप से पूर्ण अद्यतन प्रवाह करने के लिए, आपके पास अलग-अलग संस्करण संख्या के साथ ऐप के कम से कम दो संस्करण होने चाहिए: एक स्रोत संस्करण और एक लक्ष्य संस्करण।

उच्च संस्करण संख्या वाले स्रोत संस्करण को Google Play पर प्रकाशित किया जाना चाहिए, यह वह संस्करण है जिसे Google Play द्वारा उपलब्ध अद्यतन के रूप में पहचाना जाएगा। निचले संस्करण संख्या और एकीकृत IAU सुविधा के साथ लक्ष्य संस्करण को आपके डिवाइस पर स्थापित किया जाना चाहिए, यह वह संस्करण है जिसे अपडेट किया जाएगा। बात यह है, जब ऐप उपलब्ध अपडेट के लिए Google Play से जांच करने का अनुरोध करता है, तो यह Google Play में अंतिम उपलब्ध बिल्ड के संस्करण संख्या के साथ इंस्टॉल किए गए ऐप के संस्करण संख्या की तुलना करता है। तो IAU की सुविधा केवल तभी चालू होगी जब Google Play में संस्करण संख्या डिवाइस पर ऐप के वास्तविक संस्करण से अधिक हो।
स्रोत और लक्ष्य संस्करणों दोनों को समान पैकेज नाम की आवश्यकता है और उन्हें एक ही रिलीज़ प्रमाण पत्र के साथ हस्ताक्षरित किया जाना चाहिए।
Android 5.0 (एपीआई स्तर 21) या उच्चतर।
कोर लाइब्रेरी 1.5.0 या उच्चतर चलायें ।

नमूना कोड

इस खंड में IAUs के उपयोग के लिए कुछ नमूना कोड हैं, जो आधिकारिक दस्तावेज में भी पाया जा सकता है। इसके साथ शुरू करने के लिए, प्ले-कोर लाइब्रेरी को मॉड्यूल-स्तरीय ग्रेडल फ़ाइल में जोड़ना आवश्यक है।

dependencies { ... implementation "com.google.android.play:core:1.5.0" }

अगला, आइएयू प्रबंधक का एक उदाहरण बनाते हैं और AppUpdateInfo कार्य में कॉलबैक जोड़ते हैं। इस कार्य के परिणाम में एक अद्यतन उपलब्धता, एक अद्यतन शुरू करने के इरादे के बारे में जानकारी शामिल है यदि यह उपलब्ध है, और अद्यतन की वर्तमान प्रगति डाउनलोड होती है यदि यह पहले ही शुरू हो चुकी है।

 // Create instance of the IAUs manager. val appUpdateManager = AppUpdateManagerFactory.create(context) // Add state listener to app update info task. appUpdateManager.appUpdateInfo.addOnSuccessListener { appUpdateInfo -> // If there is an update available, prepare to promote it. if (appUpdateInfo.updateAvailability() == UpdateAvailability.UPDATE_AVAILABLE) { // ... } // If the process of downloading is finished, start the completion flow. if (appUpdateInfo.installStatus() == InstallStatus.DOWNLOADED) { // ... } } .addOnFailureListener { e -> // Handle the error. }

Google Play से कोड में अपडेट अनुरोध संवाद को कैसे ट्रिगर किया जाए, इसके संदर्भ में, आपको AppUpdateInfo ऑब्जेक्ट में एक PendingIntent मिलता है, जिसे आप startIntentSenderForResult शुरू कर सकते हैं। यह संवाद उपयोगकर्ता को अपडेट शुरू करने का अनुरोध करता है।

  appUpdateManager.startUpdateFlowForResult( // Pass the intent that is returned by 'getAppUpdateInfo()'. appUpdateInfo, // Or 'AppUpdateType.IMMEDIATE for immediate updates. AppUpdateType.FLEXIBLE, // The current activity. activity, REQUEST_CODE )

अद्यतन स्थिति की निगरानी करने के लिए, आप Iaus प्रबंधक में InstallStateUpdatedListener जोड़ सकते हैं। कृपया सुनिश्चित करें कि आपका InstallStateUpdatedListener जीवनचक्र से अवगत है।

 // Create a listener to track downloading state updates. val listener = InstallStateUpdatedListener { state -> // Update progress indicator, request user to approve app reload, etc. } // At some point before starting an update, register a listener for updates. appUpdateManager.registerListener(listener) // ... // At some point when status updates are no longer needed, unregister the listener. appUpdateManager.unregisterListener(listener)

जैसे ही अपडेट डाउनलोड किया जाता है ( DOWNLOADED स्थिति), अपडेट को पूरा करने के लिए ऐप को फिर से शुरू करना चाहिए। appUpdateManager.completeUpdate() को कॉल करके इसे आसानी से शुरू किया जा सकता है, लेकिन उपयोगकर्ता को यह स्पष्ट रूप से पुष्टि करने की अनुमति देने के लिए स्नैकबार प्रदर्शित करने की अनुशंसा की जाती है कि वह अभी ऐप को फिर से लॉन्च करने के लिए तैयार है।

 Snackbar.make( rootView, "An update has just been downloaded from Google Play", Snackbar.LENGTH_INDEFINITE ).apply { setAction("RELOAD") { appUpdateManager.completeUpdate() } show() }

"अपडेट उपलब्ध नहीं है" त्रुटि

सबसे पहले, कृपया "मूल कार्यान्वयन आवश्यकताओं" अनुभाग में उल्लिखित दोहरी जांच आवश्यकताओं को देखें। यदि आप सफलतापूर्वक सभी आवश्यकताओं के अनुपालन में उपरोक्त चरणों को सफलतापूर्वक पूरा करते हैं, हालांकि अद्यतन, onSuccess अनुसार, अभी भी उपलब्ध नहीं है, तो कृपया निम्नलिखित चाल पर ध्यान दें। सबसे संभावित कारण यह है कि Google Play एप्लिकेशन को आंतरिक कैशिंग तंत्र के कारण अभी तक अद्यतन के बारे में नहीं पता है। यह सुनिश्चित करने के लिए कि आपके पास कैश ताज़ा है जब आप मैन्युअल रूप से परीक्षण कर रहे हैं, तो आप Google Play ऐप में "मेरा ऐप्स और गेम्स" स्क्रीन पर जाकर कैश्ड संस्करण को ताज़ा कर सकते हैं। एक विकल्प के रूप में, आप बस सेटिंग में Google Play एप्लिकेशन का कैश साफ़ कर सकते हैं। ध्यान दें कि यह सिर्फ परीक्षण के लिए एक समस्या है और अंत उपयोगकर्ताओं को प्रभावित नहीं करता है क्योंकि कैश को रोजाना अपडेट किया जाता है।

पांडो में IAUs फ्लेक्सिबल फ्लो

शुरुआती पहुंच कार्यक्रम के एक हिस्से के रूप में, हमने पांडो ऐप में IAU के लचीले प्रवाह (अनुशंसित उपकरण) को एकीकृत किया है, जो कि चीनी निर्माताओं और विक्रेताओं के उत्पादों की पेशकश करने वाला एक बाज़ार है। IAUs संवाद मुख्य स्क्रीन पर दिखाया गया था, इसलिए अधिकतम उपयोगकर्ता इसके साथ बातचीत करने में सक्षम थे। शुरू में, हमने जोखिम वाले उपयोगकर्ताओं को परेशान करने से बचने के लिए दिन में एक बार से अधिक नहीं IAU के संवाद दिखाने का फैसला किया।

चूंकि ए / बी परीक्षण प्रत्येक नई सुविधा जीवन चक्र में एक महत्वपूर्ण कदम है, इसलिए हमने पांडो ऐप पर आईएयू के प्रभाव का मूल्यांकन करने का निर्णय लिया। हमने अपने उपयोगकर्ताओं को दो गैर-अतिव्यापी समूहों में अनियमित रूप से विभाजित किया है। पहला एक IAUs के बिना एक नियंत्रण समूह है जो 'नो-चेंज' बेसलाइन का प्रतिनिधित्व करता है, और दूसरा IAUs संवाद वाला एक परीक्षण समूह है।

अंजीर। 1. पांडो ऐप में IAU (लचीले प्रवाह) के लिए ए / बी परीक्षण।

पिछले कुछ रिलीज में, हमने प्रत्येक ऐप संस्करण के लिए सक्रिय उपयोगकर्ताओं का प्रतिशत मापा। यह पाया गया कि एक समय के संस्करण में उपलब्ध अंतिम भाग के साथ सक्रिय उपयोगकर्ताओं में प्रमुख भाग ग्रुप बी से था, यानी IAUS फीचर वाले उपयोगकर्ता। जैसा कि आप अंजीर पर बैंगनी रेखाओं से देख सकते हैं। 1, 1.29.1 ऐप संस्करण के प्रकाशन के बाद पहले दिनों में, IAUs सुविधा वाले सक्रिय उपयोगकर्ताओं की संख्या इस सुविधा के बिना उपयोगकर्ताओं की संख्या से अधिक थी। एप्लिकेशन के पिछले संस्करणों के लिए विपरीत स्थिति देखी जा सकती है, 1.29.1 ऐप संस्करण के प्रकाशन के बाद नीली और लाल रेखाएं देखें। इसलिए, यह कहा जा सकता है कि IAU के साथ उपयोगकर्ता ऐप संस्करण को और अधिक तेज़ी से अपडेट करते हैं।

अंजीर। 2. पांडो ऐप में IAUs संवाद (लचीला प्रवाह) पर पुष्टि दर ।

पांडो एनालिटिक्स डेटा (अंजीर। 2 देखें) के अनुसार, IAUs संवाद में पुष्टिकरण बटन पर क्लिक करने के लिए रूपांतरण रिलीज के पहले दिनों में चरम मूल्यों तक पहुंचता है और फिर अगले ऐप अपडेट तक लगातार घटता है। एक ही पैटर्न एक स्नैकबार में इंस्टॉल बटन पर क्लिक करने के लिए रूपांतरण में देखा जा सकता है, जो डाउनलोड किए गए अपडेट की स्थापना शुरू करता है। नतीजतन, ऐसा लगता है कि दोनों मामलों में औसत रूपांतरण दर सीधे रिलीज की आवृत्ति के आनुपातिक है। पांडो में, एक महीने के दौरान मापा गया औसत रूपांतरण दर पुष्टि बटन पर क्लिक करने के लिए 35% से अधिक और इंस्टॉल बटन पर क्लिक करने के लिए 7% से अधिक है।

हमने सुझाव दिया कि समय के साथ पुष्टि दर को कम करना केवल एक उपयोगकर्ता अनुभव समस्या है, क्योंकि नए ऐप संस्करण में रुचि रखने वाले लोग बहुत जल्दी अपडेट करने जा रहे हैं, और जिन्हें अपडेट करने में कोई दिलचस्पी नहीं है, वे रुचि नहीं लेते रहेंगे। इस जानकारी के आधार पर हमने कुछ उपयोगकर्ताओं को हर दिन पूछने के बजाय अपडेट करने में दिलचस्पी नहीं लेने का फैसला किया। यह एक अच्छा अभ्यास है जो 'गतिहीनता' के आधार पर विभिन्न अनुरोध तर्क की कोशिश कर रहा है, यानी वे कितने पुराने संस्करण पर हैं, कितनी बार उपयोगकर्ता ने पहले से ही उन्हें अपडेट करने के लिए कहा है और इसी तरह, जोखिम उपयोगकर्ताओं को परेशान करने के बजाय।

नतीजतन, IAUs ने ए / बी परीक्षण के दौरान मूल्यवान परिणामों का प्रदर्शन किया, इसलिए हमने सभी उपयोगकर्ताओं के लिए यह सुविधा शुरू की।

स्वीकृत खंड

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

इन-ऐप अपडेट फ्लेक्सिबल फ्लो: एंड्रॉइड पर ऐप अपडेट प्रक्रिया को गति दें