स्प्लैश स्क्रीन लागू करने की सुविधा को Android 12 और उसके बाद के वर्शन पर माइग्रेट करना

अगर आपने Android 11 या उससे पहले के वर्शन में, पसंद के मुताबिक स्प्लैश स्क्रीन को लागू किया है, तो अपने SplashScreen एपीआई से मदद लें पक्का करें कि यह Android 12 और उसके बाद के वर्शन में सही तरीके से दिखे.

Android 12 और इसके बाद के वर्शन में, सिस्टम Android सिस्टम के लिए डिफ़ॉल्ट स्प्लैश स्क्रीन चालू है ठंडा और गर्म सभी ऐप्लिकेशन के लिए शुरू होता है. डिफ़ॉल्ट रूप से, इस सिस्टम स्प्लैश स्क्रीन को आपके ऐप्लिकेशन के लॉन्चर आइकॉन एलिमेंट और आपकी थीम के windowBackground का इस्तेमाल करके बनाया जाता है. हालांकि, ऐसा तब ही होता है, जब आपकी थीम एक ही रंग की हो.

अगर ऐप्लिकेशन को माइग्रेट नहीं किया जाता है, तो Android 12 और Android 12 पर ऐप्लिकेशन के लॉन्च होने का तरीका हो सकता है कि उसकी क्वालिटी ख़राब हो जाए या अनचाहे नतीजे मिलें.

• अगर आपकी मौजूदा स्प्लैश स्क्रीन को android:windowBackground को बदलने वाली कस्टम थीम का इस्तेमाल करके लागू किया गया है, तो सिस्टम आपकी कस्टम स्प्लैश स्क्रीन को Android 12 और उसके बाद के वर्शन पर, डिफ़ॉल्ट Android सिस्टम स्प्लैश स्क्रीन से बदल देता है. मुमकिन है कि यह आपके ऐप्लिकेशन के मुताबिक न हो अनुभव.

• अगर आपकी मौजूदा स्प्लैश स्क्रीन को किसी खास Activity का इस्तेमाल करके लागू किया गया है, Android 12 या उसके बाद के वर्शन वाले डिवाइसों पर ऐप्लिकेशन लॉन्च करने पर डुप्लीकेट स्प्लैश स्क्रीन: सिस्टम की स्प्लैश स्क्रीन मौजूदा स्प्लैश स्क्रीन गतिविधि के बाद दिखेगा.

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

SplashScreen की साथ काम करने वाली लाइब्रेरी

SplashScreen एपीआई का इस्तेमाल सीधे तौर पर किया जा सकता है. हालांकि, हमारा सुझाव है कि आप Androidx SplashScreen कंपैट लाइब्रेरी आज़माएं. कंपनी, SplashScreen API का इस्तेमाल करती है. इसकी मदद से, साथ ही, पुराने सिस्टम के साथ काम करता है. साथ ही, इससे स्प्लैश स्क्रीन पर एक जैसा रंग-रूप दिखता है सभी Android वर्शन पर दिखाई देते हैं. यह दस्तावेज़, compat library का इस्तेमाल करके लिखा गया है.

अगर सीधे SplashScreen API का इस्तेमाल करके माइग्रेट किया जाता है, तो Android 11 और उससे पहले के वर्शन पर आपकी स्प्लैश स्क्रीन, माइग्रेट करने से पहले की तरह ही दिखती है. Android 12 से, स्प्लैश स्क्रीन में Android 12 का लुक और स्टाइल दिखता है.

SplashScreen कंपैट लाइब्रेरी की मदद से माइग्रेट करने पर, सिस्टम यह दिखाता है Android के सभी वर्शन पर एक ही स्प्लैश स्क्रीन.

स्प्लैश स्क्रीन को लागू करने की प्रोसेस को माइग्रेट करना

मौजूदा स्प्लैश स्क्रीन को Android 12 और उसके बाद के वर्शन पर माइग्रेट करने के लिए, यह तरीका अपनाएं.

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

स्प्लैश स्क्रीन को माइग्रेट करने के लिए, यह तरीका अपनाएं:

1. build.gradle फ़ाइल में, अपना compileSdkVersion बदलें और डिपेंडेंसी में SplashScreen compat लाइब्रेरी शामिल करें.

   build.gradle
   
   android {
      compileSdkVersion 31
      ...
   }
   dependencies {
      ...
      implementation 'androidx.core:core-splashscreen:1.0.0-beta02'
   }
   

2. Theme.SplashScreen के पैरंट के तौर पर कोई थीम बनाएं. postSplashScreenTheme की वैल्यू को उस थीम पर सेट करें जिसका इस्तेमाल Activity को करना चाहिए. साथ ही, windowSplashScreenAnimatedIcon की वैल्यू को ड्रॉबल या ऐनिमेशन वाले ड्रॉबल पर सेट करें. दूसरे एट्रिब्यूट ज़रूरी नहीं हैं.

   <style name="Theme.App.Starting" parent="Theme.SplashScreen">
      <!-- Set the splash screen background, animated icon, and animation
      duration. -->
      <item name="windowSplashScreenBackground">@color/...</item>
   
      <!-- Use windowSplashScreenAnimatedIcon to add a drawable or an animated
           drawable. One of these is required. -->
      <item name="windowSplashScreenAnimatedIcon">@drawable/...</item>
      <!-- Required for animated icons. -->
      <item name="windowSplashScreenAnimationDuration">200</item>
   
      <!-- Set the theme of the Activity that directly follows your splash
      screen. This is required. -->
      <item name="postSplashScreenTheme">@style/Theme.App</item>
   </style>
   

   अगर आपको अपने आइकॉन के नीचे बैकग्राउंड का रंग जोड़ना है, तो Theme.SplashScreen.IconBackground थीम का इस्तेमाल करें और windowSplashScreenIconBackground एट्रिब्यूट सेट करें.

3. मेनिफ़ेस्ट में, शुरुआती गतिविधि की थीम को उस थीम से बदलें पिछले चरण में बनाएं.

   <manifest>
      <application android:theme="@style/Theme.App.Starting">
       <!-- or -->
           <activity android:theme="@style/Theme.App.Starting">
   ...
   

4. super.onCreate() को कॉल करने से पहले, शुरू होने वाली गतिविधि में installSplashScreen को कॉल करें.

   Kotlin

   class MainActivity : Activity() {
   
      override fun onCreate(savedInstanceState: Bundle?) {
          // Handle the splash screen transition.
          val splashScreen = installSplashScreen()
   
          super.onCreate(savedInstanceState)
          setContentView(R.layout.main_activity)
   ...

   Java

   public class MainActivity extends Activity {
   
       @Override
       protected void onCreate(Bundle savedInstanceState) {
            // Handle the splash screen transition.
            SplashScreen splashScreen = SplashScreen.installSplashScreen(this);
   
            super.onCreate(savedInstanceState);
            setContentView(R.layout.main_activity);
       }
   }

installSplashScreen, स्प्लैश स्क्रीन ऑब्जेक्ट दिखाता है. इसका इस्तेमाल, ऐनिमेशन को पसंद के मुताबिक बनाने या स्प्लैश स्क्रीन को स्क्रीन पर ज़्यादा समय तक दिखाने के लिए किया जा सकता है. ऐनिमेशन को पसंद के मुताबिक बनाने के बारे में ज़्यादा जानकारी के लिए, देखें स्प्लैश स्क्रीन को लंबे समय तक स्क्रीन पर दिखाना और स्प्लैश स्क्रीन को खारिज करने के लिए, ऐनिमेशन को पसंद के मुताबिक बनाएं.

पसंद के मुताबिक बनाई गई स्प्लैश स्क्रीन पर की गई गतिविधि को स्प्लैश स्क्रीन के हिसाब से बनाएं

Android 12 और उसके बाद के वर्शन के लिए स्प्लैश स्क्रीन पर माइग्रेट करने के बाद, यह तय करें कि अपनी पिछली पसंद के मुताबिक बनाई गई स्प्लैश स्क्रीन Activity का क्या करना है. आपके पास ये विकल्प हैं:

• पसंद के मुताबिक बनाई गई गतिविधि को बनाए रखें, लेकिन उसे दिखने से रोकें.
• ब्रैंडिंग से जुड़ी वजहों के लिए, पसंद के मुताबिक गतिविधि को बनाए रखें.
• कस्टम गतिविधि हटाएं और अपने ऐप्लिकेशन को ज़रूरत के हिसाब से बदलें.

कस्टम गतिविधि दिखाने से रोकें

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

  class RoutingActivity : Activity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        val splashScreen = installSplashScreen()
        super.onCreate(savedInstanceState)

        // Keep the splash screen visible for this Activity.
        splashScreen.setKeepOnScreenCondition { true }
        startSomeNextActivity()
        finish()
     }
   ...
  

  public class RoutingActivity extends Activity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
      SplashScreen splashScreen = SplashScreen.installSplashScreen(this);

       super.onCreate(savedInstanceState);

       // Keep the splash screen visible for this Activity.
       splashScreen.setKeepOnScreenCondition(() -> true );
       startSomeNextActivity();
       finish();
    }
  ...
  

ब्रैंडिंग के लिए कस्टम गतिविधि को बनाए रखना

अगर आपको ब्रैंडिंग से जुड़ी वजहों के लिए, पिछली स्प्लैश स्क्रीन Activity का इस्तेमाल करना है, तो सिस्टम स्प्लैश स्क्रीन से कस्टम स्प्लैश स्क्रीन पर ट्रांज़िशन कर सकता है स्प्लैश को खारिज करने के लिए, ऐनिमेशन को को Activity के हिसाब से कस्टमाइज़ किया जा रहा है स्क्रीन का इस्तेमाल करें. हालांकि, अगर हो सके, तो इस स्थिति से बचें और अपनी स्प्लैश स्क्रीन को ब्रैंड करने के लिए SplashScreen एपीआई का इस्तेमाल करें.

अगर आपको कोई डायलॉग दिखाना है, तो हमारा सुझाव है कि आप इसे कस्टम स्प्लैश स्क्रीन ऐक्टिविटी के बाद या सिस्टम स्प्लैश स्क्रीन के बाद मुख्य ऐक्टिविटी के ऊपर दिखाएं.

कस्टम स्प्लैश स्क्रीन पर की गई गतिविधि को हटाना

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

• अपने कॉम्पोनेंट, मॉड्यूल या लाइब्रेरी के लिए लेज़ी लोडिंग का इस्तेमाल करें. ऐसे कॉम्पोनेंट या लाइब्रेरी को लोड करने या शुरू करने से बचें जिनकी ज़रूरत ऐप्लिकेशन के लॉन्च होने पर काम करने के लिए नहीं होती. जब ऐप्लिकेशन को इनकी ज़रूरत पड़े, तब इन्हें लोड करें.

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

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

• स्थानीय रूप से कुछ डेटा लोड करते समय प्लेसहोल्डर बनाएं. थीम तय करने के लिए सुझाए गए तरीके का इस्तेमाल करें. साथ ही, ऐप्लिकेशन तैयार होने तक रेंडरिंग रोकें. पुराने सिस्टम के साथ काम करने वाली स्प्लैश स्क्रीन को लागू करने के लिए, इसमें बताए गए चरण स्प्लैश स्क्रीन को लंबे समय तक स्क्रीन पर दिखाएं.

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

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