如何解决Android/Ionic应用启动时SplashScreen前出现灰屏白屏问题？

这两个异常屏幕本质是Android系统冷启动过程中加载应用进程时显示的Window预览层，不属于应用自身渲染的页面，仅修改闪屏页布局的常规方案无法生效，需按以下步骤从系统主题层面修改：

1. 自定义启动专属主题 #

在项目的res/values/themes.xml（旧版本项目为styles.xml）中新增启动专用主题，核心配置预览层背景和闪屏页完全对齐：

<style name="LauncherTheme" parent="Theme.MaterialComponents.Light.NoActionBar">
    <!-- 核心配置：将预览窗背景设置为和闪屏页一致的背景图/颜色 -->
    <item name="android:windowBackground">@drawable/splash_background</item>
    <!-- 可选：和闪屏页的全屏效果对齐，不需要可删除 -->
    <item name="android:windowFullscreen">true</item>
    <!-- 禁用系统默认启动动画，避免衔接突兀 -->
    <item name="android:windowAnimationStyle">@null</item>
    <!-- Android 12+ 系统自带闪屏兼容配置 -->
    <item name="android:windowSplashScreenAnimatedIcon">@drawable/your_splash_icon</item>
    <item name="android:windowSplashScreenBackground">@color/splash_bg_color</item>
</style>

2. 绑定主题到启动入口Activity #

打开AndroidManifest.xml，找到带LAUNCHER标记的入口Activity，绑定刚才的启动主题：

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

注意：不要给Application节点设置全局自定义主题，全局主题会被启动预览层优先调用，导致Activity绑定的主题失效。

3. 运行时切回应用正常主题 #

在闪屏页Activity的onCreate方法中，setContentView执行前先切回应用正常使用的主题，避免后续页面主题错乱：

// Kotlin 示例
override fun onCreate(savedInstanceState: Bundle?) {
    setTheme(R.style.YourAppNormalTheme)
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_splash)
    // 后续闪屏逻辑：倒计时、权限判断、跳主页等
}

// Java 示例
@Override
protected void onCreate(Bundle savedInstanceState) {
    setTheme(R.style.YourAppNormalTheme);
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_splash);
}

常规方案无效的排查点 #

• Android 12及以上系统强制自带SplashScreen组件，不要使用第三方闪屏库，直接适配系统自带API即可实现无缝衔接
• 检查闪屏背景资源是否放在base模块下，放在feature模块的资源冷启动时无法加载，会显示默认灰白背景
• 闪屏背景资源需要适配不同dpi的设备，避免拉伸变形导致看起来存在页面跳转
• 不要给启动Activity设置 android:hardwareAccelerated="false"，关闭硬件加速会导致预览层加载异常

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