نقل بيانات تنفيذ شاشة البداية إلى نظام التشغيل Android 12 والإصدارات الأحدث

في حال استخدام شاشة بداية مخصّصة في Android 11 أو الإصدارات الأقدم، عليك نقل تطبيقك إلى واجهة برمجة التطبيقات SplashScreen للمساعدة في ضمان عرضه بشكل صحيح في Android 12 والإصدارات الأحدث.

بدءًا من Android 12، يطبّق النظام شاشة الترحيب الافتراضية لنظام Android عند بدء التشغيل على البارد وإعادة التشغيل البطيء لجميع التطبيقات. يتم تلقائيًا إنشاء شاشة البداية هذه للنظام باستخدام عنصر رمز مشغّل التطبيق وwindowBackground من المظهر، إذا كان لونًا واحدًا.

في حال عدم نقل بيانات تطبيقك، قد تنخفض تجربة تشغيله على الإصدار 12 من Android والإصدارات اللاحقة أو قد تؤدي إلى نتائج غير مقصودة.

  • إذا تم تنفيذ شاشة البداية الحالية باستخدام مظهر مخصّص يحلّ محل android:windowBackground، يستبدل النظام شاشة البداية المخصّصة بشاشة بداية تلقائية لنظام Android على الإصدار 12 من Android والإصدارات الأحدث. قد لا تكون هذه هي تجربتك المقصودة في تطبيقك.

  • إذا تم تنفيذ شاشة البداية الحالية باستخدام Activity مخصّص، يؤدي بدء تشغيل تطبيقك على الأجهزة التي تعمل بنظام التشغيل Android 12 أو الإصدارات الأحدث إلى ظهور شاشات بداية مكرّرة: شاشة بداية النظام ثم نشاط شاشة البداية الحالية.

يمكنك منع حدوث هذه التجارب غير المقصودة أو المتدهورة من خلال إكمال عملية النقل الموضّحة في هذا المستند. بعد نقل البيانات، تحسِّن واجهة برمجة التطبيقات وقت بدء التشغيل، وتمنحك إمكانية التحكّم الكامل في تجربة شاشة البداية، وتوفّر تجربة إطلاق أكثر اتساقًا مع التطبيقات الأخرى على المنصة.

مكتبة SplashScreen المتوافقة

يمكنك استخدام واجهة برمجة التطبيقات SplashScreen مباشرةً، ولكننا ننصحك بشدة باستخدام مكتبة Androidx SplashScreen compat بدلاً من ذلك. تستخدم مكتبة التوافق واجهة برمجة التطبيقات SplashScreen، وتتيح التوافق مع الإصدارات القديمة، وتُنشئ مظهرًا وأسلوبًا متسقَين لعرض شاشة البدء على جميع إصدارات Android. تم كتابة هذا المستند باستخدام مكتبة compat.

في حال نقل البيانات باستخدام واجهة برمجة التطبيقات SplashScreen مباشرةً على الإصدار 11 من نظام التشغيل Android والإصدارات الأقدم، ستظهر شاشة البداية بالشكل نفسه تمامًا كما كانت قبل نقل البيانات. بدءًا من الإصدار Android 12، ستتضمّن شاشة البداية مظهر Android 12 وأسلوبه.

في حال نقل البيانات باستخدام مكتبة التوافق SplashScreen، يعرض النظام شاشة البداية نفسها على جميع إصدارات Android.

نقل عملية تنفيذ شاشة البداية

أكمِل الخطوات التالية لنقل عملية تنفيذ شاشة البداية الحالية إلى الإصدار 12 من Android والإصدارات الأحدث.

ينطبق هذا الإجراء على أي نوع من أنواع التنفيذ الذي يتم نقل بياناته منه. إذا كنت بصدد نقل البيانات من 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. اتصل بـ installSplashScreen في النشاط الأوّلي قبل الاتصال بـ super.onCreate().

    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 لإبقاء نشاط التوجيه في مكانه ولكن إيقاف عرضه. يؤدي ذلك إلى نقل شاشة البداية إلى النشاط التالي وتوفير عملية انتقال سلسة.

Kotlin

  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()
     }
   ...

Java

  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() خفيفًا بقدر الإمكان.

    يمكنك أيضًا الاستفادة من استخدام مكتبة بدء تشغيل التطبيق لإعداد المكوّنات عند بدء تشغيل التطبيق. عند إجراء ذلك، احرص على تحميل كل الوحدات المطلوبة للنشاط الأوّلي، ولا تُدرِج أيّ تقطُّعات في الأداء عند توفُّر الوحدات التي يتم تحميلها بشكلٍ كسول.

  • أنشئ عنصر نائبًا أثناء تحميل قدر صغير من البيانات على الجهاز. استخدِم أسلوب تحديد المظهر المُقترَح وانتظر حتى يصبح التطبيق جاهزًا. لتنفيذ شاشة البداية المتوافقة مع الإصدارات القديمة، اتّبِع الخطوات الموضّحة في مقالة إبقاء شاشة البداية معروضة على الشاشة لفترات أطول.

  • إظهار العناصر النائبة: بالنسبة إلى عمليات التحميل المستندة إلى الشبكة التي لها مدد غير محدّدة، يجب إغلاق شاشة البداية وعرض العناصر النائبة لعمليات التحميل غير المتزامنة. ننصحك بتطبيق صور متحركة خفيفة على منطقة المحتوى تعكس حالة التحميل. تأكَّد من أنّ بنية المحتوى المحمَّل تتطابق مع بنية الهيكل بأكبر قدر ممكن من الدقة لتسهيل عملية النقل السلس عند تحميل المحتوى.

  • استخدام ميزة التخزين المؤقت عندما يفتح المستخدم تطبيقك لأول مرة، يمكنك عرض مؤشرات تحميل لبعض عناصر واجهة المستخدم، كما هو موضّح في الشكل التالي. في المرة التالية التي يعود فيها المستخدم إلى تطبيقك، يمكنك عرض هذا المحتوى المخزّن مؤقتًا أثناء تحميل محتوى أحدث.

الشكل 1. عرض عناصر نائبة لواجهة المستخدم