Android 12上全新的应用启动API，适配一下？

2023-10-29

/ 今日科技快讯 /

近日，谷歌宣布，将在欧洲市场上销售的Android手机中免费添加更多移动搜索应用，欧洲Android用户可以通过全新的“搜索引擎选项”来选择并设置自己设备上的默认搜索引擎。

/ 作者简介 /

本篇文章来自TechMerger同学的投稿，和大家介绍了Android 12上应用启动API相关的内容，相信会对大家有所帮助！同时也感谢作者贡献的精彩文章！

TechMerger的博客地址：

https://juejin.cn/user/4011435956644013

/ 前言 /

早期的Android上App的启动速度常为人诟病，如今的启动表现已不逊iOS。Google针对系统的不断优化绝对功不可没，从8.0独立出来的SplashWindow，到12上推出的全新SplashScreen。

在App的主要内容展示之前，按照需求的不同，或多或少会先展示这样几个画面。

画面	用途
Splash Screen	展示品牌Logo或Slogan
Advertisement Screen	展示节日活动或日常广告
Guide Screen	演示重点功能，一般只展示一次

我们常常花费精力去打造引导画面或广告画面，而作为第一印象的启动画面却容易被忽视。回想下以前都是怎么处理这个画面的：

一般通过设置windowSplashscreenContent属性来展示UI提供的启动图，系统将为它创建专门的Window
假使忘记设置这个属性的话，默认的白色背景将导致启动过程中会有个白画面一闪而过
要去掉这个突兀的白画面可不能简单地设置Background为null，不然一闪而过的又会变成黑画面
最终发现windowDisablePreview属性可以彻底关闭这个画面，这样一来确实没有任何突兀的画面一闪而过了

但这又会带来启动"变慢"的副作用，因为用来过渡的启动画面被关闭之后，App描画前屏幕几乎没有什么变化。即便App性能没有劣化，但为了留住用户，我们还是得好好对待这个启动画面。

然而现有的windowSplashscreenContent可供定制的空间着实有限。也许官方也注意到了这点，便精心设计了Splash Screen API，并在Android 12里重磅推出。

有了这个全新特性的帮助，启动画面的定制将更加自由、方便。先来看下采用SplashScreen API 快速定制的启动效果。

/ 定制进入效果 /

采用xml即可快速定制各式进入效果。

默认的启动效果

默认情况下启动画面将展示白色背景和Launcher上的Adaptive Icon，也是不错的，比以前的白画面要好很多。

自定义静态Icon

替换Icon为Adaptive Icon的前景图，背景色微调为米黄色。

<item name="android:windowSplashScreenBackground">@color/newSplashScreenColor</item>
<item name="android:windowSplashScreenAnimatableIcon">@drawable/ic_kotlin_hero_new</item>

自定义Icon背景

Icon色调和画面背景色的对比不够明显的情况下，可以添加Icon背景色加强辨识度。

<item name=”android:windowSplashScreenIconBackground”>@color/newSplashIconMaskColor</item>

自定义品牌Logo

添加品牌Logo可以展示企业形象或Slogan，使得启动画面更为完整和精细。

<item name=”android:windowSplashScreenBrandingImage”>@drawable/ic_tm_brand_newer</item>

自定义动画Icon

动画形式的Icon可以增添设计和创意，使得启动流程更加流畅和有趣。

<item name="android:windowSplashScreenAnimatableIcon">@drawable/ic_kotlin_hero_new_animated_rotate</item>
<item name="android:windowSplashScreenAnimationDuration">@integer/icon_animator_duration</item>

比如让机器人图标旋转起来。

再比如让机器人在Kotlin上侧滑。

或者让几何图案拼凑出字母K之后和机器人汇合，象征着Android和Kotlin的强强联合。

注意：

动画Icon的时长上限为1000ms。
图标的进入动画可以定制，但由系统控制，不可以被监听和额外处理。

延长启动画面

The splash screen is dismissed as soon as your app draws its first frame. If you need to load a small amount of data such as in-app theme settings from a local disk asynchronously, you can use ViewTreeObserver.OnPreDrawListener to suspend the app to draw its first frame.

后台数据的加载难免耗时，启动画面结束了主要内容仍未加载好的话，体验不是太好。能够控制启动画面的持续时时长就好了。

现有的ViewTreeObserver的OnPreDrawListener回调是可以挂起描画的，如果我们在数据准备好之后再放行描画，就可以间接地延长启动画面的显示。

比如Activity初始化2s后才放行描画。

class SplashActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        ...
        keepSplashScreenLonger()
    }

    private fun keepSplashScreenLonger() {
        // 监听Content View的描画时机
        val content: View = findViewById(android.R.id.content)
        content.viewTreeObserver.addOnPreDrawListener(
            object : ViewTreeObserver.OnPreDrawListener {
                override fun onPreDraw(): Boolean {
                    // 准备好了描画放行，反之挂起
                    return if (viewModel.isDataReady()) {
                        content.viewTreeObserver.removeOnPreDrawListener(this)
                        true
                    } else {
                        false
                    }
                }
            }
        )
    }
}

class MyViewModel(application: Application): AndroidViewModel(application) {
    companion object {
        const val WORK_DURATION = 2000L
    }
    private val initTime = SystemClock.uptimeMillis()
    fun isDataReady() = SystemClock.uptimeMillis() - initTime > WORK_DURATION
}

看一下效果，发现启动画面的展示时间确实变长了。

/ 定制退出效果 /

当App的第一帧开始描画，SplashScreen将会退出展示。为了丰富退出环节的体验，系统也开放了相应的入口，即画面退出的回调。在这个回调里可以开始退出效果的定制，包括整体的退出动画和图标的退出动画。

监听启动画面的退出

向SplashScreen注册OnExitAnimationListener接口即可监听启动画面的退出。

override fun onCreate(savedInstanceState: Bundle?) {
    ...
    customizeSplashScreenExit()
}

private fun customizeSplashScreenExit() {
    splashScreen.setOnExitAnimationListener { splashScreenView ->
        Log.d("Splash", "SplashScreen#onSplashScreenExit view:$splashScreenView")
        sleep(1000)
        Log.d("Splash", "SplashScreen#remove after sleeping")
        splashScreenView.remove()
    }
}

可以看到启动画面展示之后，不作定制的默认情况下就是全屏一下再消失。

日志如下：

Splash  : Activity:com.example.splash.MainActivity@f70c0d0 Activity:com.example.splash.MainActivity@f70c0d0 onCreate
Splash  : Activity:com.example.splash.MainActivity@f70c0d0 onStart
Splash  : Activity:com.example.splash.MainActivity@f70c0d0 onResume
Splash  : SplashScreen#onSplashScreenExit view:android.window.SplashScreenView{18339d5 V.E...... ........ 0,0-1080,2280}
Splash  : SplashScreen#remove after sleeping

一定记得调用remove及时移除启动画面，否则SplashScreen会长时间盖在主画面上，大概在5s左右。

另外，回调的注册需要放在Activity#onResume前，不然监听不到。

定制整体的退出动画

可以给启动画面的整体设置TRANSLATE、SCALE、ROTATE、ALPHA等各种动画，使得退出更加自然。

比如给SplashScreen加上一个缩小出屏幕的动画。

private fun customizeSplashScreenExit() {
    splashScreen.setOnExitAnimationListener { splashScreenView ->
        showSplashExitAnimator(splashScreenView)
    }
}

private fun showSplashExitAnimator(splashScreenView: SplashScreenView) {
    val path = Path()
    path.moveTo(1.0f, 1.0f)
    path.lineTo(0f, 0f)
    val scaleOut = ObjectAnimator.ofFloat(
        splashScreenView,
        View.SCALE_X,
        View.SCALE_Y,
        path
    )
    ...
    scaleOut.doOnEnd {
        splashScreenView.remove()
    }
    scaleOut.start()
}

又或者从上方平移出屏幕的动画。

private fun showSplashExitAnimator(splashScreenView: SplashScreenView) {
    val slideUp = ObjectAnimator.ofFloat(
        splashScreenView,
        View.TRANSLATION_Y,
        0f,
        -splashScreenView.height.toFloat()
    )
    ...
    slideUp.start()
}

定制图标的退出动画

当然也可以给图标单独加上动画，比如将Icon上滑。

private fun customizeSplashScreenExit() {
    splashScreen.setOnExitAnimationListener { splashScreenView ->
        showSplashIconExitAnimator(splashScreenView)
    }
}

private fun showSplashIconExitAnimator(splashScreenView: SplashScreenView) {
    val iconView = splashScreenView.iconView ?: return
    val slideUp = ObjectAnimator.ofFloat(
        splashScreenView.iconView,
        View.TRANSLATION_Y,
        0f,
        -iconView.height * 2.toFloat()
    )
    ...
    slideUp.start()
}

退出动画的适当时长

针对退出动画的定制官方还有一段补充说明。

By the start of this callback, the animated vector drawable on the splash screen has begun. Depending on the duration of the app launch, the drawable might be in the middle of its animation. Use SplashScreenView.getIconAnimationStart to know when the animation started. You can calculate the remaining duration of the icon animation.

简言之，退出画面回调的时候Icon动画可能进行到了一半，最好计算Icon动画的剩余时长来执行退出动画。

原因在于设备性能会影响App描画的早晚，而第一帧描画的时候上述的退出回调将被执行。也就是说，性能的优劣会影响启动画面退出的回调时机。

性能好的话，画面退出的回调较早。此时Icon动画尚在进行当中，可以将Icon动画的预设时长的剩余时间交接给退出效果来执行
性能差的话，画面退出的回调稍晚。Icon动画早已经结束，为了让用户尽早看到画面内容，就不该再执行退出效果了而是直接退出

不能为了展示效果而让用户久等，否则会弄巧成拙。

借助SplashScreenView的iconAnimationStartMillis和iconAnimationDurationMillis方法可以推算出Icon动画的剩余时长。

*模拟器上运行的缘故，大部分时候我的Demo在启动画面退出的时候Icon动画都结束了，少部分情况下动画还剩余一点时间，可能实机的情况会不一样。

private fun showSplashIconExitAnimator(splashScreenView: SplashScreenView) {
    slideUp.duration = getRemainingDuration(splashScreenView)
    ...
}

fun getRemainingDuration(splashScreenView: SplashScreenView): Long  {
    // 取得Icon动画的时长
    val animationDuration = splashScreenView.iconAnimationDurationMillis
    // 取得Icon动画的开始时刻
    val animationStart = splashScreenView.iconAnimationStartMillis

    // 再结合当前时间计算出Icon动画的剩余时长
    // 1. 时长为负则固定为0ms即直接退出
    // 2. 时长为正则采用该时长执行退出动画
    return if (animationDuration != null && animationStart != null) {
        (animationDuration - SystemClock.uptimeMillis() + animationStart)
        .coerceAtLeast(0L)
    } else {
        0L
    }
}

/ SplashScreen相关API /

类和接口

类/接口	作用
SplashScreen	启动画面管理接口，通过Activity#getSplashScreen取得
OnExitAnimationListener	启动画面退出的回调接口，通过SplashScreen#setOnExitAnimationListener注册
SplashScreenView	启动画面包含的视图，用以定制整体或Icon的退出动画

属性

attr	作用	备注
splashScreenTheme	指定SplashScreen相关的Style	存在一点问题比如brand图片会不显示
windowSplashScreenBackground	定制启动画面的背景	默认从windowBackground里读取
windowSplashScreenBrandingImage	指定启动画面底部的品牌图标	-
windowSplashScreenAnimatedIcon	指定Icon，支持静态或动画Drawable	-
windowSplashScreenAnimationDuration	指定动画Icon时长	上限1000ms
windowSplashScreenIconBackgroundColor	补充Icon背景色	-

注意：windowSplashscreenContent是8.0版本新增的定制启动画面的属性，自12开始废弃了，使用windowSplashscreenAnimatedIcon替代。

SplashScreen的构成

/ 注意 /

需要尝鲜SplashScreen的话，需要在Android 12上开发，并做如下必要配置。

compileSdkVersion和targetSdkVersion声明为S
android:exported="true"，明示声明启动画面的可见性，否则会安装失败

另外启动页的Icon无论是静态的还是动画效果的，都应遵循Adaptive Icon的规范，不然Icon会发生变形。

/ 结束 /

Android 12上全新的SplashScreen API非常简单清晰，整个定制过程非常流畅！

相信在全新的API加持下，APP的启动画面可以迸发出更多特色的、好玩的创意。

快快尝试起来，给你的用户留下第一眼的好印象~

Demo如下：

https://github.com/ellisonchan/SplashScreen