Android Jetpack Compose启动空白屏问题（Chipmunk版）如何解决？

问题本质 #

启动时的空白屏是Android系统在加载第一个Activity前显示的预览窗口，目的是避免App启动时无响应的视觉体验。你添加android:windowDisablePreview无效，大概率是因为主题配置层级问题，或是没有针对启动页单独设置专属主题。

分版本兼容方案 #

1. Android 11及以下：定制启动页主题 #

为启动页单独设置主题，替换系统预览窗口的内容，消除空白断层：

步骤1：修改themes.xml，添加启动页专属主题

将主主题和启动页主题分离，避免全局配置冲突：

<resources>

    <!-- 主应用主题 -->
    <style name="Theme.Owl" parent="@style/Theme.Material.DayNight.NoActionBar">
        <item name="android:colorPrimary">#ff00ff</item>
        <item name="android:colorAccent">#ff00ff</item>
        <item name="android:statusBarColor">@color/immersive_sys_ui</item>
        <item name="android:navigationBarColor">@color/nav_bar</item>
    </style>

    <!-- 启动页专属主题 -->
    <style name="Theme.Owl.Splash" parent="@android:style/Theme.Material.Light.NoActionBar">
        <!-- 设置预览窗口背景，建议和启动页布局视觉一致（颜色/图片） -->
        <item name="android:windowBackground">@drawable/splash_background</item>
        <!-- 禁用系统默认预览窗口（配合windowBackground使用，双重保障） -->
        <item name="android:windowDisablePreview">true</item>
        <!-- 可选：启动页全屏显示 -->
        <item name="android:windowFullscreen">true</item>
    </style>

    <style name="Theme.Material.DayNight.NoActionBar" parent="@android:style/Theme.Material.Light.NoActionBar" />

</resources>

注：@drawable/splash_background可以是纯色drawable或启动页图片，确保和你后续启动页布局视觉统一。

步骤2：为启动Activity指定主题

在AndroidManifest.xml中，给启动页Activity绑定专属主题：

<activity
    android:name=".SplashActivity"
    android:theme="@style/Theme.Owl.Splash">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

步骤3：启动页切换回主主题

在SplashActivity的onCreate方法中，先切换回主主题再执行其他逻辑：

override fun onCreate(savedInstanceState: Bundle?) {
    // 先切换主主题，避免后续页面继承启动页主题
    setTheme(R.style.Theme_Owl)
    super.onCreate(savedInstanceState)
    
    // 执行服务器调用等后台任务
    performServerCall()
}

private fun performServerCall() {
    // 模拟网络请求，实际替换为你的业务逻辑
    Handler(Looper.getMainLooper()).postDelayed({
        // 任务完成后跳转主页面
        startActivity(Intent(this, MainActivity::class.java))
        finish()
    }, 2000)
}

2. Android 12+ 兼容方案：使用Splash Screen兼容库 #

如果你担心版本兼容，推荐使用AndroidX的core-splashscreen库，一套代码覆盖所有版本，且支持后台任务期间保持启动页显示：

步骤1：添加依赖

在build.gradle（Module级别）中添加：

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

步骤2：修改启动页主题

继承Theme.SplashScreen，配置启动页样式及后续切换的主主题：

<style name="Theme.Owl.Splash" parent="Theme.SplashScreen">
    <!-- 启动页背景色 -->
    <item name="windowSplashScreenBackground">@color/splash_bg</item>
    <!-- 启动页图标（可选） -->
    <item name="windowSplashScreenAnimatedIcon">@drawable/ic_splash_logo</item>
    <!-- 图标动画时长（可选） -->
    <item name="windowSplashScreenAnimationDuration">2000</item>
    <!-- 指定启动完成后切换的主主题 -->
    <item name="postSplashScreenTheme">@style/Theme.Owl</item>
</style>

步骤3：启动Activity中控制启动页显示时机

通过installSplashScreen()方法，设置启动页保持显示直到后台任务完成：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    
    // 初始化Splash Screen
    val splashScreen = installSplashScreen()
    // 保持启动页显示，直到后台任务完成
    var isTaskCompleted = false
    splashScreen.setKeepOnScreenCondition { !isTaskCompleted }
    
    // 执行服务器调用
    performServerCall {
        isTaskCompleted = true
        startActivity(Intent(this, MainActivity::class.java))
        finish()
    }
}

private fun performServerCall(onComplete: () -> Unit) {
    // 替换为你的实际网络请求逻辑
    Handler(Looper.getMainLooper()).postDelayed(onComplete, 2000)
}

关键注意事项 #

• 不要在主主题中直接添加windowDisablePreview，容易导致其他页面出现启动延迟或视觉问题。
• 启动页背景要和后续布局视觉统一，避免切换时出现突兀的断层。
• 后台任务建议放在子线程执行，不要阻塞主线程，否则会延长启动时间。

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