3 定制退出效果
当App的第一帧开始描画,SplashScreen
将会退出展示。为了丰富退出环节的体验,系统也开放了相应的入口,即画面退出的回调。在这个回调里可以开始退出效果的定制,包括整体的退出动画和图标的退出动画。
3.1 监听启动画面的退出
向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
前,不然监听不到。
3.2 定制整体的退出动画
可以给启动画面的整体设置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() }
3.3 定制图标的退出动画
当然也可以给图标单独加上动画,比如将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() }
3.4 退出动画的适当时长
针对退出动画的定制官方还有一段补充说明。
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 } }
4 SplashScreen相关API
4.1 类和接口
4.2 属性
注意:windowSplashscreenContent
是8.0版本新增的定制启动画面的属性,自12开始废弃了,使用windowSplashscreenAnimatedIcon
替代
4.3 SplashScreen的构成
5 注意
需要尝鲜SplashScreen的话,需要在Android 12上开发,并做如下必要配置。
compileSdkVersion和targetSdkVersion声明为S
android:exported="true",明示声明启动画面的可见性,否则会安装失败
另外启动页的Icon无论是静态的还是动画效果的,都应遵循Adaptive Icon的规范,不然Icon会发生变形。
6 结语
Android 12上全新的SplashScreen
API非常简单清晰,整个定制过程非常流畅!
相信在全新的API加持下,APP的启动画面可以迸发出更多特色的、好玩的创意。
快快尝试起来,给你的用户留下第一眼的好印象~
本文DEMO
https://github.com/ellisonchan/SplashScreen