适配splashscreen步骤以及启动卡住不动(白屏)的坑

Android 12 启动画面

从 Android 12 开始,在所有应用的冷启动和温启动期间,系统一律会应用 Android 系统的默认启动画面。默认情况下,此系统默认启动画面由应用的启动器图标元素和主题的 windowBackground(如果是单色)构成。

也就是说,只要你的应用运行在Android 12的系统上,都会受到影响,以支付宝为例,截止到2023-01-24日,在Android 13的系统上冷启动时,可以很明显的看到会出现一个闪屏页,页面中间会显示一个启动图标。这个就是受到了系统影响,没有做适配。

请添加图片描述

Google应该是想让Android有一个统一的启动风格,但是讲道理推出的有点太晚了,国内的App启动页不仅仅是个简单的展示,有的还要显示广告,且风格也各不相同,都有自己的一套启动ui,所以,推出这个splashscreen对国内的app完全是个负担。
但是不适配的话启动的时候看起来有很怪,会出现两个闪屏页,所以,还是要硬着头皮适配一下。

SplashScreen适配

适配方法也很简单,按照官方文档的步骤来即可。
官方建议我们使用AndroidX中的SplashScreen库,该库使用 SplashScreen API,能够向后兼容,官方宣称可在所有 Android 版本上显示外观和风格一致的启动画面。

但是实际使用并非如此,例如动画在Android 12 以下的系统上不生效,如果需要动画,可自己使用其他方式实现,如果只是显示一个图片,那么就不受影响。

以下是适配步骤

将compileSdkVersion更改为31或以上

compileSdkVersion 31

添加依赖

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

准备启动页面要显示的图片或者动画

在这里插入图片描述

新增主题

    <style name="Theme.App.SplashScreen" parent="Theme.SplashScreen">
        <!--背景颜色-->
        <item name="windowSplashScreenBackground">@color/white</item>
        <!--设置动画或图片,注意动画在Android12 以下不生效 很难受...-->
        <item name="windowSplashScreenAnimatedIcon">
            @drawable/ic_splash
        </item>
        <!--动画执行时间-->
        <!--        <item name="windowSplashScreenAnimationDuration">1000</item>-->
        
        <!--设置闪屏也后启动页面的主题 说白了 就是app本来的主题-->
        <item name="postSplashScreenTheme">@style/Theme.XeonYuTheme</item>

    </style>

创建启屏页面 SplashActivity
先指定页面的主题
在这里插入图片描述

然后就是代码了,代码非常简单,如果你没有其他需求,直接在oncCreate中调用 installSplashScreen() ,然后正常跳转页面即可.

class SplashActivity : AppCompatActivity() {
    
    
    override fun onCreate(savedInstanceState: Bundle?) {
    
    
        super.onCreate(savedInstanceState)
        /*setContentView 可不写*/
//        setContentView(R.layout.activity_splash)
        /*创建与页面关联的SplashScreen实例*/
        installSplashScreen()
        /*跳转页面*/
        val intent = Intent(this, MainActivity::class.java)
        startActivity(intent)
    }
}

然后运行看看
请添加图片描述
可以看到,启屏页就ok了,非常简单。

在启动屏幕页面显示弹窗

一般情况下,我们需要在用户首次打开app时弹窗让用户同意隐私协议,以及做一些初始化操作之类的。那这种情况下,如要用户点击同意后再进行跳转。

此时,我们可以使用setKeepOnScreenCondition 配合 setOnExitAnimationListener,示例代码如下


class SplashActivity : AppCompatActivity() {
    
    

    /**
     * 控制是否保持启动页面的变量,值为false时继续往下走
     */
    private val keepOnScreenCondition = AtomicBoolean(true)

    override fun onCreate(savedInstanceState: Bundle?) {
    
    
        super.onCreate(savedInstanceState)
        /*setContentView 可不写*/
//        setContentView(R.layout.activity_splash)
        /*创建与页面关联的SplashScreen实例*/
        installSplashScreen().apply {
    
    
            /*保持住启动页面的显示*/
            setKeepOnScreenCondition {
    
    
                keepOnScreenCondition.get()
            }
            /*指定是否Activity要自己处理启动画面动画 实际上就是keepOnScreenCondition的值为false时这个就会回调*/
            setOnExitAnimationListener {
    
    
                /*在这里我们可以弹窗让用户同意隐私政策*/
                val alertDialog = AlertDialog.Builder(this@SplashActivity)
                    .setTitle("隐私协议")
                    .setMessage("隐私协议内容")
                    .setPositiveButton(
                        "同意"
                    ) {
    
     dialog, which ->

                        /*跳转页面*/
                        val intent = Intent(this@SplashActivity, MainActivity::class.java)
                        startActivity(intent)
                    }
                    .setNegativeButton("拒绝") {
    
     dialog, which ->
                        this@SplashActivity.finish()
                    }.create();
                alertDialog.show();
            }

        }


        MainScope().launch {
    
    
            Log.i("SplashActivity", "可以做一些初始化逻辑")
            delay(500)
            keepOnScreenCondition.compareAndSet(true, false)
        }

    }
}

再来运行看看:
请添加图片描述

部分设备debug模式下setOnExitAnimationListener不回调的问题

美滋滋的写完代码后,以为没啥问题了,结果换了个Android12的真机运行后发现一直卡在启动页,并没有弹窗或者跳转页面,试了好多次依旧如此。
加了log发现setOnExitAnimationListener中的回调没有执行。明明是按照官方文档写的,怎么会有问题呢?
仔细看了下文档说是要保证在splashscreen退出前setOnExitAnimationListener,这个我代码是肯定没问题的。

后来手动把app杀死,然后点击图标手动启动时又是正常的,给我整懵了,于是查了下资料发现其他人也遇到了这种问题。

https://issuetracker.google.com/issues/197906327

这个问题被google官方人标记为是预期的,不会解决,解释如下:
在这里插入图片描述

意思就是:
这个是有意这样的,因为IDE实际上使用Instrumentation来打开应用程序,所以系统将其解释为一个应用程序打开另一个应用程序,而不是用户单击启动器图标。
所以会出现setOnExitAnimationListener不执行的情况。

除了debug时会受到影响,通过其他方式拉起App也会收到影响比如一些rom上安装后会自动打开App,这种就会卡住,必须杀掉进程后重新冷启动才能正常进去。
因此,我们需要做的就是即使 setOnExitAnimationListener 没有被回调,也要保证后续代码得到执行。

下面抛砖引玉,大体思路就是给最终被执行的方法加个标记,在 keepOnScreenCondition.compareAndSet(true, false) 之后延迟短暂的时间再去调用一下最终要执行的方法,以确保一定会得到执行。

示例代码如下:
伪代码

import android.content.Intent
import android.os.Bundle
import android.util.Log
import androidx.appcompat.app.AppCompatActivity
import androidx.core.splashscreen.SplashScreen.Companion.installSplashScreen
import com.yzq.kotlincommon.ui.activity.MainActivity
import kotlinx.coroutines.MainScope
import kotlinx.coroutines.launch
import java.util.concurrent.atomic.AtomicBoolean

class SplashActivity : AppCompatActivity() {
    
    

    /**
     * 控制是否保持启动页面的变量,值为false时继续往下走
     */
    private val keepOnScreenCondition = AtomicBoolean(true)

    /*最终的方法是否调用*/
    private val dialogShowInvoke = AtomicBoolean(false)

    override fun onCreate(savedInstanceState: Bundle?) {
    
    
        super.onCreate(savedInstanceState)
        /*setContentView 可不写*/
//        setContentView(R.layout.activity_splash)
        /*创建与页面关联的SplashScreen实例*/
        installSplashScreen().apply {
    
    
            /*保持住启动页面的显示*/
            setKeepOnScreenCondition {
    
    
                keepOnScreenCondition.get()
            }
            /*指定是否Activity要自己处理启动画面动画 实际上就是keepOnScreenCondition的值为false时这个就会回调*/
            setOnExitAnimationListener {
    
    
                /*在这里我们可以弹窗让用户同意隐私政策*/
                showDialog()
            }

        }


        MainScope().launch {
    
    
            Log.i("SplashActivity", "可以做一些初始化逻辑")
            /*解除blockui,此时正常情况下会调用setOnExitAnimationListener 已知Android12拉起App时不会调用*/
            keepOnScreenCondition.compareAndSet(true, false)
            delay(100)//这里最好延迟一下,保证setOnExitAnimationListener有机会得到执行
            if(!dialogShowInvoke.get()){
    
    
            	showDialog()//这里去掉调用一下最终要执行的方法,兜个底
            }
        }

    }

    @Synchronized
    private fun showDialog() {
    
    
        if (dialogShowInvoke.get()) {
    
    
            /*已经执行了*/
            return
        }
        dialogShowInvoke.compareAndSet(false, true)
        val alertDialog = AlertDialog.Builder(this@SplashActivity)
            .setTitle("隐私协议")
            .setMessage("隐私协议内容")
            .setPositiveButton(
                "同意"
            ) {
    
     dialog, which ->

                /*跳转页面*/
                val intent = Intent(this@SplashActivity, MainActivity::class.java)
                startActivity(intent)
            }
            .setNegativeButton("拒绝") {
    
     dialog, which ->
                this@SplashActivity.finish()
            }.create();
        alertDialog.show()
    }
}

这样我们就能够确保启动时不会卡住,但是在Android12上被其他app调起会出现设置的UI显示不正常的情况,比较影响观感,暂时还没想到好的办法,有知道怎么弄的大佬可以指点一波。


如果你觉得本文对你有帮助,麻烦动动手指顶一下,可以帮助到更多的开发者,如果文中有什么错误的地方,还望指正,转载请注明转自喻志强的博客 ,谢谢!

猜你喜欢

转载自blog.csdn.net/yuzhiqiang_1993/article/details/128756426
今日推荐