React Native BootSplash 在 Android 上禁用自动隐藏的正确方式

在使用 React Native BootSplash 库时，很多开发者会遇到一个常见问题：即使按照文档配置了禁用自动隐藏，Android 平台的启动屏仍然会自动消失。本文将深入分析这个问题的原因，并提供完整的解决方案。

问题现象

开发者尝试通过以下方式禁用启动屏的自动隐藏功能：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    RNBootSplash.init(this, false) // 预期禁用自动隐藏
}

但实际运行时，启动屏仍然会自动消失，而不是等待开发者手动调用 RNBootSplash.hide()。

根本原因

经过分析，这个问题通常由以下几个因素导致：

1. 初始化顺序错误：RNBootSplash.init() 应该在 super.onCreate() 之前调用
2. 参数使用不当：第二个参数应该是主题资源 ID 而非布尔值
3. 与其他启动屏库冲突：项目中可能同时安装了其他启动屏库（如 react-native-splash-screen）

正确配置方式

Android 端配置

在 MainActivity.kt 中，正确的初始化方式应该是：

override fun onCreate(savedInstanceState: Bundle?) {
    RNBootSplash.init(this, R.style.BootTheme) // 注意参数和调用顺序
    super.onCreate(savedInstanceState)
}

关键点：

• 必须在 super.onCreate() 之前调用
• 第二个参数使用主题资源 ID（R.style.BootTheme）
• 确保没有其他启动屏库干扰

React Native 端使用

在应用组件中，可以这样控制启动屏的隐藏时机：

import React, { useEffect } from 'react';
import RNBootSplash from 'react-native-bootsplash';

function App() {
  useEffect(() => {
    // 5秒后淡出隐藏
    setTimeout(() => {
      RNBootSplash.hide({ fade: true });
    }, 5000);
  }, []);

  return (/* 应用内容 */);
}

常见误区

1. 参数误解：init() 的第二个参数不是布尔值，而是主题资源
2. 调用顺序：必须在父类 onCreate 之前初始化
3. 混合使用：避免同时使用多个启动屏库
4. 构建缓存：修改配置后需要 clean 项目重新构建

最佳实践建议

1. 完全移除其他启动屏库的依赖
2. 仔细检查 android/app/src/main/res/values/styles.xml 中的主题配置
3. 修改配置后执行 gradlew clean
4. 使用最新版本的 react-native-bootsplash
5. 在复杂场景下，可以通过监听应用状态来控制启动屏隐藏时机

通过以上正确配置，开发者可以完全掌控 React Native 应用启动屏的显示和隐藏时机，实现更精细化的启动流程控制。