React Native安卓端如何解决自定义启动页前的启动白屏问题

打包后启动出现的1-2秒白屏是安卓冷启动阶段的默认预览窗口导致的，和后续加载的自定义闪屏逻辑无关：应用进程启动初期，还没执行到Activity的onCreate方法、更没完成React Native桥接初始化时，系统会根据Activity绑定的主题渲染一个临时启动预览窗口，未做自定义配置时这个窗口默认是纯白色，等代码执行到你写的闪屏渲染逻辑时才会替换成自定义闪屏资源，中间就出现了白屏间隔。你之前贴的MainActivity代码里onCreate只调用了父类实现，没有做启动阶段的主题适配，是典型的配置遗漏。

• 配置专属启动主题
  在路径android/app/src/main/res/values/styles.xml中新增独立的闪屏启动主题，直接将窗口背景指向你准备好的闪屏drawable资源，不要沿用默认应用主题：

  <style name="SplashTheme" parent="Theme.AppCompat.Light.NoActionBar">
      <item name="android:windowBackground">@drawable/your_splash_drawable</item>
      <item name="android:statusBarColor">@android:color/transparent</item>
      <item name="android:navigationBarColor">@android:color/transparent</item>
  </style>
  

  其中@drawable/your_splash_drawable替换为你项目里实际存放的闪屏页资源，和后续闪屏页展示的视觉内容保持完全一致即可。
• 给启动Activity绑定闪屏主题
  打开android/app/src/main/AndroidManifest.xml，找到MainActivity的注册节点，将原来的android:theme属性替换为刚定义的SplashTheme：

  <activity
    android:name=".MainActivity"
    android:theme="@style/SplashTheme"
    android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|screenSize|smallestScreenSize|uiMode"
    android:launchMode="singleTask"
    android:windowSoftInputMode="adjustResize"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
  </activity>
  

• 修正MainActivity的onCreate逻辑
  在调用父类onCreate方法之前，将主题切回正常的应用主题，避免闪屏资源长期驻留Activity背景占用内存，修正后的代码如下：

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    setTheme(R.style.AppTheme);
    super.onCreate(savedInstanceState);
  }
  

• Release包专项配置
  打开AppTheme的配置节点，新增如下配置，禁用RN框架默认的白色加载背景，注意不要把android:windowDisablePreview设为true，该属性会导致点击应用图标后无即时反馈，体验更差：

  <item name="android:windowBackground">@null</item>
  

• 必须打release签名包验证效果，debug模式下需要连接本地开发服务加载JS bundle，初始化流程额外耗时，无法复现release包的真实启动表现。
• 不要使用纯JS层实现的闪屏组件，这类组件必须等RN桥接初始化完成才能渲染，必然存在原生预览窗口的空窗期，无法彻底解决白屏问题。
• 如果使用react-native-splash-screen等第三方闪屏库，要确认库版本和当前RN大版本匹配，0.60+版本的RN对启动流程做过调整，低版本第三方库没有适配原生预览窗口配置，依然会出现白屏。

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