Android开发启动画面_windowsplashscreenbehavior 使用-CSDN博客

本文链接：https://blog.csdn.net/mozushixin_1/article/details/147444049

重要提示：如果您在 Android 11 或更低版本中实现了自定义启动画面，请将您的应用迁移到 SplashScreen API，以确保它会在 Android 12 及更高版本中正确显示。如需相关说明，请参阅将现有的启动画面实现迁移到 Android 12。

从 Android 12 开始，SplashScreen API 支持应用以动画形式启动，包括启动时的进入应用动画、显示应用图标的启动画面，以及向应用本身的过渡。SplashScreen是 Window和因此涵盖 Activity

启动画面体验将标准设计元素融入到每个应用中发布时，该图标也是可自定义的，因此您的应用可以保留其独特的品牌信息。

除了使用 SplashScreen 平台 API 之外，您还可以使用封装 SplashScreen API 的 SplashScreen compat 库。

启动画面的工作原理

当用户在应用进程未运行（冷启动）时启动应用 start）或 Activity 并非（即温启动时），以下事件发生：

系统会使用主题和您为其指定的所有动画来显示启动画面定义。
当应用准备就绪后，系统会关闭启动画面并显示应用。

在浏览器设置期间，热启动。

启动画面的元素和机制

启动画面的元素由 Android 清单文件中的 XML 资源文件定义。每个元素都有浅色模式和深色模式版本。

启动画面的可自定义元素包括应用图标、图标背景和窗口背景：

请考虑以下元素，如图所示：

1 应用图标必须是矢量可绘制对象。它可以是静态的，也可以是动画形式。虽然动画的时长可以不受限制，但我们建议不超过 1,000 毫秒。启动器图标是默认的图标。

2 可以选择添加图标背景；在图标与窗口背景之间需要更高的对比度时图标背景很有用。如果您使用一个自适应图标，当该图标与窗口背景之间的对比度足够高时，就会显示其背景。

3 与自适应图标一样，前景的三分之一被遮盖。

4 窗口背景由不透明的单色组成。如果窗口背景已设置且为纯色，则使用该背景则默认设置为“0”。

启动画面尺寸

启动画面图标使用的规范与自适应图标相同，如下所示：

品牌图片：尺寸必须为 200×80 dp。
带有图标背景的应用图标：尺寸必须为 240×240 dp，并且位于直径 160 dp 的圆圈内。
无图标背景的应用图标：尺寸必须为 288×288 dp，并且位于直径 192 dp 的圆圈内。

例如，如果图片的完整尺寸为 300×300 dp，则图标需要位于直径 200 dp 的圆圈内。圆圈以外的所有内容都会不可见（被遮盖）。

启动画面动画和启动序列

额外的延迟时间通常与在冷启动时启动应用有关。向启动画面添加动画图标具有明显的美感，并提供更优质的体验。用户研究表明，感知到的初创公司动画的时长会更短。

启动画面动画会嵌入到启动序列组件中，如图所示。

进入动画：包含从系统视图到启动画面的动画。它由系统控制，不可自定义。
启动画面（在序列的“等待”部分显示）：您可以对启动画面进行自定义，从而提供自己的徽标动画和品牌形象。它必须满足本页中所述的要求，才能正常运行。
退出动画：由隐藏启动画面的动画组成。如果您想对其进行自定义，请使用 SplashScreenView 及其图标。并且可以在它们之上运行任何动画（需要设置转换、不透明度和颜色）。在这种情况下，请在动画播放完毕后手动移除启动画面。

运行图标动画时，如果应用先前已准备就绪，应用启动功能可让您选择跳过相应序列。应用会触发 onResume() 或者启动画面会自动超时，因此确保用户能够轻松跳过启动画面动画。启动画面只能通过 onResume() 关闭当从视觉角度来看应用稳定后，系统不会显示额外的旋转图标所需的资源。引入不完整的界面可能会给用户带来不快，并让用户感觉不可预知或不够完善。

启动画面动画要求

您的启动画面必须符合以下规范：

设置不透明的单一窗口背景颜色。SplashScreen 兼容性库支持日间模式和夜间模式。
确保动画图标符合以下规范：
- 格式：图标必须是 AnimatedVectorDrawable (AVD) XML。
- 尺寸：AVD 图标的大小必须是自适应图标大小的四倍，如下所示：
  - 图标面积必须是 432 dp，即 108 dp 的 4 倍，108 dp 是无遮盖自适应图标的面积。
  - 图片内部三分之二的内容显示在启动器图标上，并且必须是 288dp，也就是构成自适应图标的内部遮罩区域。
- 时长：我们建议在手机上的时长不超过 1,000 毫秒。您可以使用延迟启动，但不能超过 166 毫秒。如果应用启动时间超过 1,000 毫秒，假设使用循环动画。
确定合适的时间来关闭启动画面，这发生在应用绘制第一帧时。您可以按照让启动画面在屏幕上显示更长时间部分的说明进一步自定义此设置。

启动画面资源

下载入门套件示例，演示了如何创建动画、设置动画格式以及将动画导出到 AVD。此软件包包含以下工具：

动画的 Adobe After Effects 项目文件。
最终导出的 AVD XML 文件。
动画的 GIF 示例。

下载这些文件，即表示您同意 Google 服务条款。

Google 隐私权政策介绍了此服务如何处理数据。

自定义应用中的启动画面

默认情况下，SplashScreen 使用主题的 windowBackground（如果 windowBackground 是单色）。如需自定义启动画面，请添加属性。

您可以通过以下任一方式自定义应用的启动画面：

设置主题属性以更改其外观。
让其在屏幕上显示更长时间。
自定义用于关闭启动画面的动画。

开始使用

核心 SplashScreen 库为搭载 API 23 及更高版本的所有设备带来了 Android 12 启动画面。如需将其添加到项目中，请将以下代码段添加到 build.gradle 文件中：

dependencies {
    implementation("androidx.core:core-splashscreen:1.0.0")
}

设置启动画面的主题以更改其外观

您可以在 Activity 主题中指定以下属性来自定义应用的启动画面。如果您已有使用 android:windowBackground 等属性的旧版启动画面实现，不妨考虑为 Android 12 及更高版本提供替代资源文件。

使用 windowSplashScreenBackground 以特定的单色填充背景：

<item name="android:windowSplashScreenBackground">@color/...</item>

使用 windowSplashScreenAnimatedIcon 替换起始窗口中心的图标。

对于仅以 Android 12（API 级别 32）为目标平台的应用，请执行以下操作：

如果对象可通过 AnimationDrawable 和 AnimatedVectorDrawable，请将 windowSplashScreenAnimationDuration 设置为在显示起始窗口的同时播放动画。对于 Android 13，这不是必需的，因为时长会直接从 AnimatedVectorDrawable 推断出来。
```
<item name="android:windowSplashScreenAnimatedIcon">@drawable/...</item>
```
使用 windowSplashScreenAnimationDuration 指示启动画面图标动画的时长。设置此项不会影响启动画面的实际显示时间但您可以在自定义启动画面退出时检索该组件使用 Cloud Build SplashScreenView.getIconAnimationDuration。如需了解详情，请参阅下一部分，了解如何让启动画面在屏幕上显示更长时间。
```
<item name="android:windowSplashScreenAnimationDuration">1000</item>
```
使用 windowSplashScreenIconBackgroundColor 设置启动画面图标后面的背景。当窗口背景与图标之间的对比度不够高时，这很有用。
```
<item name="android:windowSplashScreenIconBackgroundColor">@color/...</item>
```
您可以使用 windowSplashScreenBrandingImage 设置要显示在启动画面底部的图片。不过，不建议使用品牌图片。
```
<item name="android:windowSplashScreenBrandingImage">@drawable/...</item>
```
您可以使用 windowSplashScreenBehavior 指定应用是否始终在 Android 13 及更高版本。默认值为 0，如果启动 activity 将 splashScreenStyle 设置为 SPLASH_SCREEN_STYLE_ICON, 或遵循系统行为（如果启动 activity 未指定样式。如果您希望从不显示空的启动画面，要显示的动画图标，请将此属性设为 icon_preferred 值。
```
<item name="android:windowSplashScreenBehavior">icon_preferred</item>
```

让启动画面在屏幕上显示更长时间

当应用绘制第一帧后，启动画面会立即关闭。如果您需要加载少量数据（例如从本地磁盘异步加载应用内设置），可以使用 ViewTreeObserver.OnPreDrawListener 让应用暂停绘制第一帧。

如果启动 activity 在绘制之前完成（例如，不设置内容视图并在 onResume 之前完成），则无需预绘制监听器。

// Create a new event for the activity.
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // Set the layout for the content view.
    setContentView(R.layout.main_activity)

    // Set up an OnPreDrawListener to the root view.
    val content: View = findViewById(android.R.id.content)
    content.viewTreeObserver.addOnPreDrawListener(
        object : ViewTreeObserver.OnPreDrawListener {
            override fun onPreDraw(): Boolean {
                // Check whether the initial data is ready.
                return if (viewModel.isReady) {
                    // The content is ready. Start drawing.
                    content.viewTreeObserver.removeOnPreDrawListener(this)
                    true
                } else {
                    // The content isn't ready. Suspend.
                    false
                }
            }
        }
    )
}

自定义用于关闭启动画面的动画

您可以通过 Activity.getSplashScreen() 进一步自定义启动画面的动画。

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // ...

    // Add a callback that's called when the splash screen is animating to the
    // app content.
    splashScreen.setOnExitAnimationListener { splashScreenView ->
        // Create your custom animation.
        val slideUp = ObjectAnimator.ofFloat(
            splashScreenView,
            View.TRANSLATION_Y,
            0f,
            -splashScreenView.height.toFloat()
        )
        slideUp.interpolator = AnticipateInterpolator()
        slideUp.duration = 200L

        // Call SplashScreenView.remove at the end of your custom animation.
        slideUp.doOnEnd { splashScreenView.remove() }

        // Run your animation.
        slideUp.start()
    }
}

在此回调开始时，启动画面上动画形式的矢量可绘制对象开始。根据应用启动的时长，可绘制对象可能在其动画的中间。使用 SplashScreenView.getIconAnimationStart 可了解动画何时开始。您可以按如下方式计算图标动画的剩余时长：

// Get the duration of the animated vector drawable.
val animationDuration = splashScreenView.iconAnimationDuration
// Get the start time of the animation.
val animationStart = splashScreenView.iconAnimationStart
// Calculate the remaining duration of the animation.
val remainingDuration = if (animationDuration != null && animationStart != null) {
    (animationDuration - Duration.between(animationStart, Instant.now()))
        .toMillis()
        .coerceAtLeast(0L)
} else {
    0L
}