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

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

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

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

अपने Android OS के लिए अपग्रेड पार्टी की सुविधा चालू करने के लिए, Android Upgrade Party को चालू करने का अनुरोध फ़ॉर्म का इस्तेमाल करके रजिस्टर करें.

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

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

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

फ़्लो को पसंद के मुताबिक बनाने के लिए, अपग्रेड पार्टी स्टाइल गाइड में दिए गए दिशा-निर्देशों को पढ़ें और Android अपग्रेड पार्टी को चालू करने का अनुरोध फ़ॉर्म में, पसंद के मुताबिक बनाने की जानकारी शामिल करें.

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

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

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

• जानकारी देने वाली स्क्रीन
• फ़ीचर स्क्रीन
• आउट्रो स्क्रीन

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

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

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

लेआउट

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

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

स्टाइल

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

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

मोशन

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

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

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

1. मोबाइल फ़ोन, स्क्रीन पर दिख रहा है.
2. फ़ोन का साइज़ बढ़ने के साथ-साथ, वह बीच में आ जाता है. आकार, स्क्रीन पर दिखने लगते हैं.
3. फ़ोन का साइज़ ज़्यादा से ज़्यादा हो जाता है और आकार हिलते रहते हैं.

परिचय वाली स्क्रीन का ऐनिमेशन है.

फ़ीचर स्क्रीन

सुविधा की हर स्क्रीन, नए ओएस की किसी सुविधा को हाइलाइट करती है.

लेआउट

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

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

स्टाइल

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

मोशन

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

आउट्रो स्क्रीन

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

लेआउट

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

• बैकग्राउंड पर आधा गोला (और एनिमेटेड आकार)
• डिवाइस का फ़्रेम
• यूज़र इंटरफ़ेस (यूआई) कॉन्टेंट

स्टाइल

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

मोशन

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

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

SDK टूल से अपग्रेड पार्टी को ट्रिगर करें

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

SDK टूल का उदाहरण

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

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 OS अपग्रेड करने पर, उपयोगकर्ताओं को दिखने वाले अपग्रेड पार्टी फ़्लो को टेस्ट करने के लिए, यह तरीका अपनाएं:

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