手把手教你搭建android模块化项目框架(十)——美好的项目从Splash开始

我们的app开发时,都会有一个splash页面,用于提升用户体验。

原因是android app在启动时,由于application初始化等原因会有一个短暂的延迟,导致点击launcher后不能马上启动activity并渲染。通常我们使用的方案是添加SplashActivity,并且将windowbackground设置成app品牌图标等方式能够让用户点击launcher后快速相应并展示,提升用户体验。

但是在android 12版本以后,我们发现点击launcher后,会显示一个应用Icon的图标一闪而过,然后才显示我们的Splash页面,没错,官方Splash,他来了~那么我们今天就适配官方splash吧。

官方适配文档,我们看到,这个splash其实是无法避免的,也就是说我们只能接受。

官方给出的建议是,取消原来的splash,直接使用MainActivity作为程序入口,适配SplashScreen充当原来的SplashActivity页面。但是由于种种原因,原有的Splash可能有一定功能并不能很好的移植到MainActivity中,例如:deeplink的路由功能、程序初始化配置入口、通知栏路由等。

所以今天我们就来适配老项目的Splash吧~

老规矩~先看效果

android12以上版本:

android12.gif

android12以下版本:

android10.gif

首先接入SplashCompat库,这是为了兼容android 12以下的版本。

   implementation "androidx.core:core-splashscreen:1.0.0"

然后配置Splash的样式,这里要注意~android 12以下和android 12以上要分开配置,android 12以下的splash并不支持动画效果,而android 12及以上是支持动画效果的,并且支持gif动画播放及splash结束的消失动画。

因此我们的通用style配置如下:

   <style name="SplashTheme" parent="Theme.AppCompat.Light.DarkActionBar">
        <item name="windowNoTitle">true</item>
        <item name="windowActionBar">false</item>
        <item name="android:windowTranslucentStatus">false</item>
        <item name="android:windowTranslucentNavigation">false</item>
        <item name="android:statusBarColor">@android:color/transparent</item>
        <item name="android:navigationBarColor">@android:color/transparent</item>
        <item name="android:windowAnimationStyle">@null</item>
    </style>

    <style name="Theme.App.Launcher" parent="Theme.SplashScreen">
        <item name="windowSplashScreenAnimatedIcon">@mipmap/ic_launcher_round</item> 显示的图片资源,android 12以下不支持动画
        <item name="postSplashScreenTheme">@style/SplashTheme</item>
    </style>

而values-31中配置android 12的主题如下。

   <style name="Theme.App.Launcher" parent="Theme.MaterialComponents.NoActionBar">
        <item name="windowNoTitle">true</item>
        <item name="android:windowFullscreen">true</item>
        <item name="android:windowBackground">@color/black</item>
        <item name="android:windowSplashScreenAnimatedIcon">@drawable/gif_splash</item>   显示的图片资源,android 12以上支持vector或gif资源
        <item name="android:windowSplashScreenAnimationDuration">1000</item>
        <item name="android:windowSplashScreenBackground">@color/black</item>
        <item name="android:windowTranslucentStatus">false</item>
        <item name="android:windowTranslucentNavigation">false</item>
        <item name="android:statusBarColor">@android:color/transparent</item>
        <item name="android:navigationBarColor">@android:color/transparent</item>
        <item name="android:windowAnimationStyle">@null</item>
    </style>

接下来我们看SplashAct中如何兼容版本

首先是初始化显示:

    override fun onCreate(savedInstanceState: Bundle?) {
         注意,这里的初始化要放到super.onCreate之前。
       val splashScreen = installSplashScreen()
        super.onCreate(savedInstanceState)
        保证android 12以下版本能够不直接销毁splashScreen
        splashScreen.setKeepOnScreenCondition { true }
        保证android 12以上版本能够不直接销毁splashScreen
        setupSplashScreen(splashScreen)
        setupExitSplashScreenAnim(splashScreen)
        mViewModel.init()
    }
  
 这段代码在android 12以下其实是不生效的,12以上会让splash一直显示,直到Splash中我们的自定义操作执行完成,准备跳转。
 原因是splashScreen组件会在当前Activity渲染第一帧时自动移除,而我们为了不显示两个Splash,就让系统的Splash多显示一会吧~
  private fun setupSplashScreen(splashScreen: SplashScreen) {
        val contentView: View = findViewById(android.R.id.content)
        contentView.viewTreeObserver.addOnPreDrawListener(object :
            ViewTreeObserver.OnPreDrawListener {
            override fun onPreDraw(): Boolean {
                if (mViewModel.isReady) {
                     这里是适配12以下系统,让其销毁。
                    splashScreen.setKeepOnScreenCondition { false }
                    contentView.viewTreeObserver.removeOnPreDrawListener(this)
                }
                这个return值如果使true,则12以上系统销毁splashScreen
                return mViewModel.isReady
            }
        })
    }
  
  splashScreen销毁时的动画,这里支持任何多种动画,我随便写了一个晃动。
  private fun exitSplashScreen(splashScreen: SplashScreen) {
        splashScreen.setOnExitAnimationListener { provider ->
            val splashScreenView = provider.view
            val springAnim = SpringAnimation(
                splashScreenView,
                SpringAnimation.TRANSLATION_X,
                splashScreenView.x
            )
            springAnim.spring.stiffness = SpringForce.STIFFNESS_MEDIUM
            springAnim.setStartVelocity(-2000f)
            springAnim.setStartValue(splashScreenView.x)
            springAnim.spring.dampingRatio = SpringForce.DAMPING_RATIO_HIGH_BOUNCY
            springAnim.start()
            springAnim.addEndListener { _, _, _, _ ->
                动画结束后,跳转页面
                jumpToMain()
                provider.remove()
            }
        }
    }

之后,我们调用我们自己的初始化方法~这里我delay了5秒,模拟初始化耗时操作。 代码如下:

 var isReady = false

  fun init() {
        viewModelScope.launch {
            //do something init
            //模拟初始化
            delay(5000)
            isReady = true
        }
    }

至此,我们已经完成了官方的splash适配效果~

完整项目地址:传送门

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,001评论 6 498
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,210评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 161,874评论 0 351
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,001评论 1 291
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,022评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,005评论 1 295
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,929评论 3 416
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,742评论 0 271
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,193评论 1 309
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,427评论 2 331
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,583评论 1 346
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,305评论 5 342
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,911评论 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,564评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,731评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,581评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,478评论 2 352

推荐阅读更多精彩内容