پیاده‌سازی Splash Screen خود را به Android 12 و بالاتر منتقل کنید

مراحل زیر را برای انتقال پیاده‌سازی Splash Screen موجود خود به Android 12 و بالاتر انجام دهید.

این روش برای هر نوع پیاده سازی که از آن مهاجرت می کنید اعمال می شود. اگر از یک Activity اختصاصی مهاجرت می کنید، بهترین شیوه های شرح داده شده در این سند را برای تطبیق Activity سفارشی شده در صفحه نمایش اسپلش دنبال کنید. SplashScreen API همچنین تأخیر راه اندازی را کاهش می دهد که با یک فعالیت اختصاصی صفحه نمایش اسپلش معرفی شده است.

برای انتقال صفحه نمایش اسپلش، موارد زیر را انجام دهید:

1. در فایل build.gradle ، compileSdkVersion خود را تغییر دهید و کتابخانه compat SplashScreen را در وابستگی ها قرار دهید.

   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 در اکتیویتی آغازین فراخوانی کنید.

   کاتلین

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

   جاوا

   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 شیء splash screen را برمی گرداند، که می توانید به صورت اختیاری از آن برای سفارشی کردن انیمیشن یا نگه داشتن صفحه نمایش اسپلش برای مدت طولانی تری روی صفحه استفاده کنید. برای جزئیات بیشتر در مورد سفارشی کردن انیمیشن، نگاه کنید به نگه داشتن صفحه چلپ چلوپ روی صفحه برای مدت زمان طولانی و سفارشی کردن انیمیشن برای رد کردن صفحه نمایش اسپلش .

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