Android 闪屏页适配

3,337 阅读6分钟

遇到的坑

按官方文档设置完之后,debug运行,或者直接点击Run运行,闪屏页的logo不显示,清掉后台,从桌面点击启动logo才显示,不过设置的windowBackgroud 都是显示正常的,这个问题我调了一天,,,AndroidStudio版本4.2.2

内容来自官方文档 文档地址:点我

如果您之前在 Android 11 或更低版本中实现了自定义初始屏幕,则需要将您的应用迁移到 SplashScreenAPI 以确保它在 Android 12 及更高版本中正确显示。

从 Android 12 开始,系统始终在所有应用的 启动和 热启动时应用新的Android 系统默认启动画面。默认情况下,此系统默认启动画面是使用您的应用程序的启动器图标元素和 您的主题(如果它是单色)构建的。windowBackground

如果您不迁移您的应用,您在 Android 12 及更高版本上的应用启动体验将会降级或可能出现意外结果:

  • 如果您现有的初始屏幕是使用覆盖 的自定义主题android:windowBackground实现的,则系统会将您的自定义初始屏幕替换为 Android 12 及更高版本上的默认 Android 系统初始屏幕(这可能不是您应用的预期体验)。
  • 如果您现有的初始屏幕是使用专用的 实现的,则Activity在运行 Android 12 或更高版本的设备上启动您的应用会导致重复的初始屏幕:显示新的系统初始屏幕 ,然后是您现有的初始屏幕活动。

您可以通过完成本指南中描述的迁移过程来防止这些降级或意外体验。迁移后,新 API 会缩短启动时间,让您完全控制初始屏幕体验,并确保与平台上其他应用程序的启动体验更加一致。

SplashScreen 兼容库

您可以SplashScreen直接使用 API,但我们强烈建议使用 AndroidxSplashScreen兼容库 。compat 库使用SplashScreenAPI,支持向后兼容,并为所有 Android 版本的初始屏幕显示创建一致的外观。本指南是使用 compat 库编写的。

如果您选择直接使用 SplashScreen API 进行迁移,在 Android 11 上并降低您的初始屏幕看起来与以前完全相同;从 Android 12 开始,初始屏幕将具有新的 Android 12 外观。

迁移您的启动画面实施

完成以下步骤,将您现有的初始屏幕实施迁移到适用于 Android 12 及更高版本的新体验。

此过程适用于您从中迁移的任何类型的实现。如果您是从专用迁移Activity,您还应该遵循本文档中描述的最佳实践来调整您的自定义启动屏幕Activity。新的SplashScreenAPI 还减少了由专用启动屏幕活动引入的启动延迟。

使用SplashScreencompat 库迁移后,系统会在所有版本的 Android 上显示相同的初始屏幕。

要迁移初始屏幕:

  1. build.gradle文件中,更改您的 compileSdkVersion并将 SplashScreencompat 库包含在依赖项中。

    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 either 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. -->
       <!-- 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()

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

installSplashScreen返回初始屏幕对象,您可以选择使用它来自定义动画或将初始屏幕保持在屏幕上更长的时间。有关自定义动画的更多详细信息,请参阅 让初始屏幕在屏幕上停留更长时间 和自定义动画以关闭初始屏幕

使您的自定义启动屏幕活动适应新的启动屏幕体验

在您迁移到适用于 Android 12 及更高版本的新初始屏幕体验后,您的自定义初始屏幕Activity仍然存在,因此您需要选择如何处理它。您有以下选择:

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

阻止自定义 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()
     }
   ...
  

保留品牌化的自定义活动

如果您想使用后续启动画面Activity来获得品牌体验,您可以Activity通过自定义关闭启动画面的动画,从系统启动画面过渡到您的自定义启动画面。但是,如果可能的话,最好避免这种情况,并使用新的 SplashScreenAPI 来标记您的启动画面。

移除自定义闪屏Activity

一般来说,我们建议您Activity 完全删除您自定义的启动画面,以避免重复启动画面无法迁移,提高效率并减少启动画面加载时间。您可以使用不同的技术来避免显示多余的闪屏活动。

  • 延迟加载组件、模块或库:避免加载或初始化应用程序启动时不需要的组件或库,并在应用程序需要时加载它们。

    如果您的应用确实需要某个组件才能正常工作,请仅在真正需要时而不是在启动时加载它,或者在应用启动后使用后台线程加载它。尽量保持你Application onCreate()的轻盈。

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

  • 在本地加载少量数据时创建占位符:使用推荐的主题化方法并保留渲染,直到应用程序准备好。要实现向后兼容的初始屏幕,请按照使初始屏幕在屏幕上停留更长时间中概述的步骤。

  • 显示占位符:对于持续时间不确定的基于网络的加载,关闭初始屏幕并显示占位符以进行异步加载。考虑将微妙的动画应用于反映加载状态的内容区域。确保加载的内容结构 尽可能匹配骨架结构,以便在加载内容后实现平滑过渡。

  • 使用缓存:当用户第一次打开您的应用程序时,您可以显示某些 UI 元素的加载指示符(如下例所示)。下次用户返回您的应用时,您可以在加载更新的内容时显示此缓存内容。