React Native安卓应用在Vivo IQOO Neo7（Android14）启动时崩溃

问题定位 #

从崩溃堆栈可明确：崩溃根源是Vivo系统私有组件com.vivo.vspa.promotion.SlidingRecognitionInfo初始化时，调用Context.getPackageName()遇到空对象引用，触发NullPointerException，进而引发ExceptionInInitializerError，崩溃发生在闪屏显示环节（org.devio.rn.splashscreen.SplashScreen.show）。

具体解决方案 #

1. 延迟闪屏显示时机 #

修改HomeDashBoardActivity.kt中调用SplashScreen.show的时机，避开onCreate方法早期执行，改为在onResume或onWindowFocusChanged中延迟调用：

override fun onResume() {
    super.onResume()
    // 延迟执行闪屏，给系统组件初始化留足时间
    Handler(Looper.getMainLooper()).postDelayed({
        SplashScreen.show(this)
    }, 300)
}

2. 替换闪屏依赖库 #

org.devio.rn.splashscreen存在兼容性隐患，建议替换为React Native官方闪屏方案：

• 移除旧库：执行npm uninstall react-native-splash-screen，并删除Android端相关配置
• 集成官方方案：按照React Native官方文档配置原生启动页，替代Dialog形式的闪屏实现

3. 针对性兼容Vivo Android14设备 #

在应用启动时检测设备品牌和系统版本，对Vivo Android14设备做特殊处理：

fun isVivoAndroid14(): Boolean {
    val brand = Build.BRAND.lowercase()
    val sdkInt = Build.VERSION.SDK_INT
    return brand.contains("vivo") && sdkInt == Build.VERSION_CODES.UPSIDE_DOWN_CAKE
}

// 在HomeDashBoardActivity.onCreate中
if (!isVivoAndroid14()) {
    SplashScreen.show(this)
} else {
    // 针对Vivo Android14，使用自定义布局替代原闪屏或延迟加载
    Handler(Looper.getMainLooper()).postDelayed({
        // 加载自定义闪屏布局或直接进入应用
    }, 500)
}

4. 禁用Vivo系统相关私有服务 #

在AndroidManifest.xml中添加配置，尝试禁用Vivo滑动识别相关服务：

<application
    ...>
    <!-- 禁用Vivo滑动识别服务 -->
    <meta-data
        android:name="vivo.vspa.promotion.disable"
        android:value="true" />
</application>

5. 调整Activity启动模式 #

修改HomeDashBoardActivity的启动模式，避免系统初始化冲突：

<activity
    android:name=".ui.mainapp.HomeDashBoardActivity"
    android:launchMode="singleTop"
    ...>
</activity>

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