Expo裸工作流发布版APK中StatusBar backgroundColor不生效问题

问题分析 #

开发模式下expo-statusbar的背景色设置正常，但EAS构建内部分发APK时仅style属性生效、背景色始终为白色，核心原因是Android主题配置中的android:windowTranslucentStatus="true"属性强制状态栏透明，覆盖了JS端的背景色设置。开发模式下Expo开发客户端会忽略部分原生主题限制，因此表现正常。

解决步骤 #

1. 修改Android主题配置 #

打开./android/app/src/main/res/values/style.xml，移除AppTheme中的android:windowTranslucentStatus="true"属性：

<resources xmlns:tools="http://schemas.android.com/tools">
  <style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar">
    <item name="android:textColor">@android:color/black</item>
    <item name="android:editTextStyle">@style/ResetEditText</item>
    <item name="android:editTextBackground">@drawable/rn_edit_text_material</item>
    <item name="colorPrimary">@color/colorPrimary</item>
    <!-- 移除这一行 -->
    <!-- <item name="android:windowTranslucentStatus">true</item> -->
    <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
  </style>
  <!-- 其余代码保持不变 -->
</resources>

2. 调整JS端StatusBar组件配置 #

在App.js中为StatusBar显式添加translucent={false}属性，确保背景色设置能正确覆盖原生主题：

import { StatusBar } from 'expo-status-bar';

return (
  <View>
    {/* 其余代码 */}
    <StatusBar style="dark" backgroundColor="#519259" translucent={false} />
  </View>
);

3. 清理缓存重新构建 #

执行清理缓存后的构建命令，确保修改完全生效：

eas build --platform android --profile internal --clear-cache

补充说明 #

如果后续需要状态栏半透明效果，不要直接设置android:windowTranslucentStatus，而是通过StatusBar组件的translucent={true}配合带透明度的backgroundColor值（比如backgroundColor="rgba(81, 146, 89, 0.8)"），这样JS端配置才能在生产构建中正常生效。

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