Jetpack Compose适配Android 7+的启动屏最优实现方案咨询

一、核心思路 #

通过分版本主题适配+视觉无缝过渡解决空白屏问题：

• Android 12+：基于官方Splash Screen API扩展，支持自定义背景图+居中图标
• Android 7-11：利用Activity主题预览窗口直接设置背景图和图标，再用Compose构建完全一致的启动屏，实现无感知过渡

二、步骤实现 #

1. 配置多版本主题 #

在res/values/themes.xml（适配7-11）和res/values-v31/themes.xml（适配12+）分别配置主题：

values/themes.xml（Android 7-11）

<style name="SplashTheme" parent="Theme.MaterialComponents.DayNight.NoActionBar">
    <item name="windowActionBar">false</item>
    <item name="windowNoTitle">true</item>
    <!-- 设置启动屏背景图（通过layer-list实现背景图+居中图标） -->
    <item name="android:windowBackground">@drawable/splash_background</item>
    <!-- 全屏显示（可选，根据需求调整） -->
    <item name="android:windowFullscreen">true</item>
</style>

values-v31/themes.xml（Android 12+）

<style name="SplashTheme" parent="Theme.SplashScreen">
    <item name="windowSplashScreenBackground">@drawable/splash_background</item>
    <!-- 可选：单独设置居中图标（若layer-list已包含则可省略） -->
    <item name="windowSplashScreenAnimatedIcon">@drawable/ic_app_logo</item>
    <item name="windowSplashScreenIconBackgroundColor">@android:color/transparent</item>
    <!-- 启动后跳转页面的主题 -->
    <item name="postSplashScreenTheme">@style/AppTheme</item>
    <item name="android:windowFullscreen">true</item>
</style>

2. 创建启动屏背景Drawable（splash_background.xml） #

在res/drawable下创建layer-list，实现背景图+居中图标布局：

<?xml version="1.0" encoding="utf-8"?>
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 全屏背景图 -->
    <item>
        <bitmap
            android:src="@drawable/splash_bg"
            android:gravity="fill" />
    </item>
    <!-- 居中显示应用图标 -->
    <item>
        <bitmap
            android:src="@drawable/ic_app_logo"
            android:gravity="center" />
    </item>
</layer-list>

3. 配置启动Activity #

在AndroidManifest.xml中设置启动Activity的主题为SplashTheme：

<activity
    android:name=".SplashActivity"
    android:exported="true"
    android:theme="@style/SplashTheme">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

4. 实现SplashActivity（Jetpack Compose版） #

class SplashActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        
        // Android 12+ 必须调用该方法启用官方Splash Screen扩展能力
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
            installSplashScreen()
        }

        setContent {
            // 构建和主题预览窗口完全一致的Compose界面
            SplashScreen()
            
            // 执行启动逻辑（替换为真实业务初始化，如加载配置、检查登录状态等）
            LaunchedEffect(Unit) {
                delay(2000) // 仅为演示，实际根据业务耗时调整
                startActivity(Intent(this@SplashActivity, MainActivity::class.java))
                finish()
            }
        }
    }
}

@Composable
fun SplashScreen() {
    Box(
        modifier = Modifier
            .fillMaxSize()
            .background(
                painterResource(id = R.drawable.splash_bg),
                contentScale = ContentScale.FillBounds
            )
    ) {
        // 居中显示应用图标
        Image(
            painter = painterResource(id = R.drawable.ic_app_logo),
            contentDescription = "App Logo",
            modifier = Modifier.align(Alignment.Center)
        )
    }
}

5. 解决空白屏关键细节 #

• 禁用android:windowDisablePreview：该属性会强制系统显示空白预览窗口，取而代之的是让主题windowBackground和Compose启动屏视觉完全一致，系统预览窗口直接展示启动屏内容，实现无空白过渡。
• Android 12+ 必须调用installSplashScreen()：确保官方API的过渡动画和自定义背景生效，避免闪屏。
• 启动逻辑异步处理：耗时初始化操作放在LaunchedEffect或协程中，避免阻塞主线程导致预览窗口停留过久。

三、适配验证 #

• Android 7-11：启动时系统直接显示windowBackground内容，Compose界面加载后与预览窗口视觉一致，无空白或闪屏。
• Android 12+：官方Splash Screen API展示自定义背景和图标，启动完成后平滑跳转到主界面。

内容的提问来源于stack exchange，提问作者Harish Padmanabh