ओएस से जुड़े अपडेट के लिए Android Upgrade पार्टी

अपग्रेड पार्टी, डिस्कवरी फ़्लो है. इसमें Android उपयोगकर्ताओं के लिए नई सुविधाओं को हाइलाइट किया जाता है. यह सुविधा, ओएस को बड़े पैमाने पर अपग्रेड करने पर मिलती है.

Android ऑपरेटिंग सिस्टम को बड़े पैमाने पर अपग्रेड करने पर, आपके उपयोगकर्ताओं को निराशा हो सकती है. अपग्रेड पार्टी फ़्लो से, उपयोगकर्ता की दिलचस्पी बढ़ती है. साथ ही, उपयोगकर्ताओं को यह समझने में मदद मिलती है कि नए ओएस को कैसे इस्तेमाल किया जाए.

ओएस के नए वर्शन पर अपग्रेड करने के बाद, उपयोगकर्ताओं को पुश नोटिफ़िकेशन मिलता है. इसमें नए ओएस का स्वागत किया जाता है और नई सुविधाओं के साथ कार्ड फ़्लो दिखाया जाता है.

डिवाइस बनाने वाली कंपनियां, Android ओएस वाले अपने डिवाइसों के लिए, अपग्रेड पार्टी की सुविधा चालू कर सकती हैं. इसके लिए, उन्हें Android अपग्रेड पार्टी की सुविधा चालू करने का अनुरोध फ़ॉर्म सबमिट करना होगा.

अपग्रेड पार्टी के अनुभव को पसंद के मुताबिक बनाना

अपग्रेड पार्टी के अनुभव को इन तरीकों से पसंद के मुताबिक बनाया जा सकता है:

• काम की न होने वाली सुविधाओं को हटाएं.
• टेक्स्ट ब्लॉक में भाषा अपडेट करें.
• अपने ब्रैंड के हिसाब से ऐनिमेशन, रंग, और फ़ॉन्ट में बदलाव करें.

फ़्लो को पसंद के मुताबिक बनाने के लिए, अपग्रेड पार्टी की स्टाइल गाइड में दिए गए दिशा-निर्देशों की समीक्षा करें. साथ ही, फ़ॉर्म के जवाब में, पसंद के मुताबिक बनाने से जुड़ी जानकारी शामिल करें.

अपग्रेड के न्योते की स्टाइल गाइड

अपग्रेड के न्योते की दिखावट में बदलाव करने के लिए, इस स्टाइल गाइड का इस्तेमाल करें. इससे, स्क्रीन, रंग, और फ़ॉन्ट को अपने ब्रैंड के हिसाब से बदला जा सकता है . हमारा सुझाव है कि साइज़ और स्ट्रक्चर को ओरिजनल डिज़ाइन के आस-पास ही रखें.

अपग्रेड के न्योते के फ़्लो में ये तीन कॉम्पोनेंट शामिल होते हैं:

• जानकारी देने वाली स्क्रीन
• सुविधा की जानकारी देने वाली स्क्रीन
• आखिरी स्क्रीन

हर स्क्रीन पर मौजूद ऐनिमेशन से, हर सुविधा के बारे में जानकारी मिलती है.

जानकारी देने वाली स्क्रीन

जानकारी देने वाली स्क्रीन पर एक छोटा ऐनिमेशन होता है. इससे उपयोगकर्ता का स्वागत किया जाता है और उन्हें जानकारी देने वाली स्क्रीन पर दिखाए गए फ़्लो को शुरू करने के लिए बढ़ावा मिलता है.

लेआउट

डिवाइस के ऐनिमेशन में हमेशा ये चीज़ें शामिल होती हैं:

• सफ़ेद बैकग्राउंड और रंगीन आकार
• डिवाइस का फ़्रेम
• यूज़र इंटरफ़ेस का कॉन्टेंट

स्टाइल

अगर Material You की स्टाइल को अपनाना है, तो उदाहरण में दिखाए गए डिफ़ॉल्ट रंगों और आकारों का इस्तेमाल किया जा सकता है.

अगर अपने ब्रैंड के रंग का इस्तेमाल करना है, तो पक्का करें कि वह यूज़र इंटरफ़ेस के बैकग्राउंड के साथ अच्छी तरह से काम करे.

मोशन

पहला विकल्प: होम स्क्रीन पर घड़ी के साथ

1. स्क्रीन पर नंबर दिखते हैं.
2. नंबर, साइज़ में छोटे होते हुए स्क्रीन के बीच में आ जाते हैं. मोबाइल फ़ोन का फ़्रेम दिखता है.
3. फ़ोन का साइज़ छोटा हो जाता है. स्क्रीन पर आकार दिखने लगते हैं.
4. ऐनिमेशन पूरा हो जाता है. आकार धीरे-धीरे घूमते रहते हैं.

दूसरा विकल्प: होम स्क्रीन पर घड़ी न हो

1. मोबाइल फ़ोन स्क्रीन पर दिखता है.
2. फ़ोन, साइज़ में बड़ा होते हुए स्क्रीन के बीच में आ जाता है. स्क्रीन पर आकार दिखने लगते हैं.
3. फ़ोन, सबसे बड़े साइज़ में पहुंच जाता है और आकार घूमते रहते हैं.

सुविधा की जानकारी देने वाली स्क्रीन

हर सुविधा की जानकारी देने वाली स्क्रीन में, नए ओएस की किसी सुविधा को हाइलाइट किया जाता है.

लेआउट

डिवाइस के ऐनिमेशन में हमेशा ये चीज़ें शामिल होती हैं:

• रंगीन बैकग्राउंड
• डिवाइस का फ़्रेम
• यूज़र इंटरफ़ेस का कॉन्टेंट

स्टाइल

• बैकग्राउंड का ऐसा रंग चुनें जो यूज़र इंटरफ़ेस के कॉन्टेंट और सामान्य दिखावट के साथ अच्छी तरह से काम करे.
• स्क्रीन पर, फ़ॉन्ट का ऐसा साइज़ सेट करें जो आसानी से पढ़ा जा सके. ज़रूरत पड़ने पर, फ़ॉन्ट का बड़ा साइज़ सेट करें.

मोशन

हर सुविधा के फ़्लो का ऐनिमेशन रिकॉर्ड करें. इसमें टच इंटरैक्शन भी शामिल करें. रिकॉर्डिंग को Lottie फ़ाइलों के तौर पर एक्सपोर्ट करें.

आखिरी स्क्रीन

आखिरी स्क्रीन से फ़्लो पूरा होता है. इससे उपयोगकर्ताओं को पता चलता है कि उन्होंने सभी स्क्रीन देख ली हैं.

लेआउट

डिवाइस के ऐनिमेशन में हमेशा ये चीज़ें शामिल होती हैं:

• बैकग्राउंड पर आधा सर्कल (साथ ही, ऐनिमेटेड आकार)
• डिवाइस का फ़्रेम
• यूज़र इंटरफ़ेस का कॉन्टेंट

स्टाइल

• बैकग्राउंड का ऐसा रंग चुनें जो यूज़र इंटरफ़ेस के कॉन्टेंट और सामान्य दिखावट के साथ अच्छी तरह से काम करे.
• आधे सर्कल के आकार का इस्तेमाल करें.

मोशन

आखिरी स्क्रीन के ऐनिमेशन के स्टैंडर्ड फ़्लो का पालन करें:

1. मोबाइल फ़ोन थोड़ा ऊपर की ओर जाता है.
2. बैकग्राउंड में एक सर्कल दिखता है.
3. मोबाइल फ़ोन के पीछे से आकार दिखते हैं.
4. आकार, कन्फ़ेटी की तरह बैकग्राउंड से बाहर की ओर उड़ते हैं.

एसडीके टूल की मदद से, अपग्रेड पार्टी की सुविधा चालू करना

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

ज़रूरी शर्तें

पक्का करें कि आपके ऐप्लिकेशन की बिल्ड फ़ाइल में ये वैल्यू इस्तेमाल की गई हों:

• minSdkVersion 14 या इससे ज़्यादा
• compileSdkVersion 28 या इससे ज़्यादा

अपने ऐप्लिकेशन को कॉन्फ़िगर करना

1. दी गई ZIP फ़ाइल से लाइब्रेरी एक्सट्रैक्ट करें और उसे अपनी रिपॉज़िटरी में रखें.

2. अपने मॉड्यूल की ऐप्लिकेशन-लेवल की Gradle फ़ाइल में, Google Growth SDK टूल के लिए डिपेंडेंसी जोड़ें. आम तौर पर, यह फ़ाइल app/build.gradle होती है:

    dependencies {
        implementation files('<PATH_TO_BINARY>/play-services-growth-16.1.0-eap04.aar')
    }
   

3. इन लाइब्रेरी को डिपेंडेंसी के तौर पर शामिल करें:

   com.google.android.gms:play-services-base:18.0.1
   com.google.android.gms:play-services-basement:18.0.0
   com.google.android.gms:play-services-tasks:18.0.1
   

एपीआई का इस्तेमाल करना

1. क्लाइंट को शुरू करने के लिए, UpgradeParty क्लास का इस्तेमाल करें और activity पैरामीटर सेट करें.

    import com.google.android.gms.growth.UpgradeParty;
    UpgradeParty.getClient(activity);
   

इससे मिलने वाला UpgradePartyClient, एपीआई की सुविधा को दिखाता है.

isEligibleForUpgradeParty

Task<Boolean> isEligibleForUpgradeParty();

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

invokeUpgradeParty

Task<Void> invokeUpgradeParty();

अपग्रेड पार्टी की Activity को शुरू करता है. इससे मिलने वाला Task ऑब्जेक्ट बताता है कि गतिविधि शुरू करते समय कोई गड़बड़ी हुई है या नहीं.

गड़बड़ियां

एपीआई के दोनों तरीकों में, com.google.android.gms.common.api.ApiException टाइप का अपवाद हो सकता है. ऐसे मामलों में, कॉलर से उम्मीद की जाती है कि वह बाद में फिर से कोशिश करेगा.

आम तौर पर, ये स्टेटस कोड दिख सकते हैं:

• INTERNAL_ERROR: यह कोड, लॉजिक के फ़्लो में किसी भी गड़बड़ी के लिए दिखता है.
• TIMEOUT: यह कोड तब दिखता है, जब अनुरोध को समय पर प्रोसेस नहीं किया जा पाता.
• API_NOT_CONNECTED: इसका मतलब है कि एपीआई उपलब्ध नहीं है. उदाहरण के लिए, UpgradeParty मॉड्यूल अब तक तैयार नहीं हुआ है.
• DEVELOPER_ERROR: यह कोड तब दिखता है, जब कॉल करने वाले पैकेज को UpgradeParty क्लास को ऐक्सेस करने की अनुमति नहीं होती.

एसडीके टूल का उदाहरण

एसडीके टूल को शुरू करने वाले ऐप्लिकेशन का यह उदाहरण देखें:

import android.app.Activity;
import android.os.Bundle;
import android.view.View;
import com.google.android.gms.growth.UpgradeParty;
import com.google.android.gms.growth.UpgradePartyClient;

public class SampleActivity extends Activity {

 @Override
 protected void onCreate(Bundle savedInstanceState) {
   super.onCreate(savedInstanceState);
   final UpgradePartyClient client = UpgradeParty.getClient(this);

   // Hide the invocation button initially
   View startUpgradePartyButton = findViewById(R.id.__some_button__);
   startUpgradePartyButton.setVisibility(View.GONE);

   // Register an onClick handler to invoke the Upgrade Party Activity
   startUpgradePartyButton
       .setOnClickListener(
           view -> {
             client
                 .invokeUpgradeParty()
                 .addOnCompleteListener(
                     task -> {
                       if (!task.isSuccessful()) {
                         // Do something with error, see task.getException()
                       }
                     });
           });
   }

   // Check if eligible for an Upgrade Party
   client
       .isEligibleForUpgradeParty()
       .addOnCompleteListener(
           task -> {
             if (!task.isSuccessful()) {
               // Do something with error, see task.getException()
             } else {
                  // Show/Hide invocation button, based on the result
                  int visibility =
                        task.getResult() ? View.VISIBLE : View.GONE;
                  startUpgradePartyButton..setVisibility(visibility);
             }
           });
   }

अपग्रेड पार्टी के फ़्लो की जांच करना

Android ओएस को अपग्रेड करने पर, उपयोगकर्ताओं को दिखने वाले अपग्रेड पार्टी के फ़्लो की जांच करने के लिए, यह तरीका अपनाएं:

1. टेस्ट के लिए इस्तेमाल किए जा रहे Android डिवाइस पर, सेटिंग > Google > अपग्रेड पार्टी डीबग पर जाएं.
2. अपग्रेड की रिपोर्ट करें को चुनें. इसके बाद, अपग्रेड पार्टी खोलें को चुनें. इससे, डिवाइस के ओएस वर्शन के हिसाब से, सही फ़्लो शुरू होता है. उदाहरण के लिए, Android 12 ओएस पर चलने वाले डिवाइस पर, Android 12 अपग्रेड पार्टी की सुविधा चालू होती है.