将您的启动画面实现迁移到 Android 12 及更高版本

如果您在 Android 11 或更早版本中实施了自定义启动画面，请将您的应用迁移到 SplashScreen API，以帮助确保它在 Android 12 及更高版本中正确显示。

从 Android 12 开始，系统会对所有应用的 冷启动 和 热启动 应用 Android 系统默认启动画面。默认情况下，此系统启动画面是使用您的应用启动器图标元素和您的主题的 windowBackground（如果它是一个单色）构建的。

如果您不迁移应用，您的应用在 Android 12 及更高版本上的启动体验可能会下降或产生意外结果。

  • 如果您的现有启动画面是使用 覆盖 android:windowBackground 的自定义主题 实现的，那么系统会在 Android 12 及更高版本上将您的自定义启动画面替换为默认的 Android 系统启动画面。这可能不是您应用的预期体验。

  • 如果您的现有启动画面是使用专用 Activity 实现的，那么在运行 Android 12 或更高版本的设备上启动应用会导致启动画面重复：系统启动画面 会显示，然后是您现有的启动画面活动。

您可以通过完成本文档中描述的迁移过程来防止这些下降或意外体验。迁移后，API 将提高启动时间，让您完全控制启动画面体验，并为平台上的其他应用创建更一致的启动体验。

SplashScreen 兼容库

您可以直接使用 SplashScreen API，但我们强烈建议改为使用 Androidx SplashScreen 兼容库。兼容库使用 SplashScreen API，支持向后兼容，并为所有 Android 版本创建一致的启动画面显示外观和感觉。本文档使用兼容库编写。

如果您直接使用 SplashScreen API 迁移，那么在 Android 11 及更早版本上，您的启动画面与迁移之前完全相同。从 Android 12 开始，启动画面具有 Android 12 的外观和感觉。

如果您使用 SplashScreen 兼容库迁移，系统会在所有 Android 版本上显示相同的启动画面。

迁移您的启动画面实现

完成以下步骤，将您的现有启动画面实现迁移到 Android 12 及更高版本。

此过程适用于您从哪种类型的实现迁移。如果您从专用 Activity 迁移，请遵循本文档中描述的 最佳实践，以适应您的自定义启动画面 Activity。 SplashScreen API 还减少了专用启动画面活动引入的启动延迟。

要迁移您的启动画面，请执行以下操作

  1. 在 build.gradle 文件中，更改您的 compileSdkVersion 并将 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. 在启动活动中调用 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 返回启动画面对象，您可以选择使用它来自定义动画或使启动画面在屏幕上显示更长时间。有关自定义动画的更多详细信息，请参阅 使启动画面在屏幕上显示更长时间 和 自定义启动画面关闭的动画。

将您的自定义启动画面 Activity 适配到启动画面

迁移到 Android 12 及更高版本的启动画面后，请决定如何处理以前的自定义启动画面 Activity。您有以下选项

  • 保留自定义活动，但阻止其显示。
  • 出于品牌原因保留自定义活动。
  • 删除自定义活动并根据需要调整您的应用。

阻止自定义 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 API 来为您的启动画面添加品牌。

如果您需要显示 对话框，我们建议在后续的自定义启动画面活动或在系统启动画面后的主活动上显示它。

删除自定义启动画面 Activity

通常，我们建议完全删除您以前的自定义启动画面 Activity，以避免启动画面重复，提高效率并缩短启动画面加载时间。您可以使用不同的技术来避免显示多余的启动画面活动。

  • 对您的组件、模块或库使用延迟加载。 避免加载或初始化应用启动时不需要的组件或库。在应用需要时再加载它们。

    如果您的应用确实需要一个组件才能正常工作，请仅在真正需要时（而不是在启动时）加载它，或者使用后台线程在应用启动后加载它。尝试尽可能减少您的 Application.onCreate()。

    您还可以从使用 应用启动库 在应用启动时初始化组件中获益。这样做时，请确保仍然加载启动活动所需的所有模块，并且不要引入延迟加载的模块变得可用的卡顿。

  • 在本地加载少量数据时创建占位符。 使用推荐的主题方法，并在应用准备就绪之前保留渲染。要实现向后兼容的启动画面，请遵循 使启动画面在屏幕上显示更长时间 中概述的步骤。

  • 显示占位符。 对于具有不确定持续时间的基于网络的加载，请关闭启动画面并为异步加载显示占位符。考虑对内容区域应用反映加载状态的微妙动画。确保已加载内容的结构尽可能匹配 骨架结构，以在加载内容时支持平滑过渡。

  • 使用缓存。当用户第一次打开您的应用时，您可以显示一些 UI 元素的加载指示器，如以下图所示。下次用户返回您的应用时，您可以在加载更多最新内容时显示此缓存的内容。

图 1. 显示 UI 占位符。