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

संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.

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

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

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

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

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

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

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

फ़्लो को पसंद के मुताबिक बनाने के लिए, Upgrade Party Style Guide में दिए गए दिशा-निर्देशों को पढ़ें और फ़ॉर्म के जवाब में, पसंद के मुताबिक बनाने की जानकारी शामिल करें.

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

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

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

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

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

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

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

लेआउट

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

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

स्टाइल

अगर आपको 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 ओएस वाले डिवाइस पर चलती है.