React Native升级Android 14（API34）失败，求助解决闪退问题

1. 权限适配（核心触发原因） #

Android 14对权限和后台行为做了严格限制，你的闪退大概率和未适配这些规则有关：

• 读取短信权限：Android 14拆分了原READ_SMS权限的适用场景，若涉及彩信读取需额外添加READ_MEDIA_IMAGES权限；所有短信相关权限必须在运行时动态申请，且不能在后台静默触发申请，同时要明确告知用户权限用途。
• 后台任务权限：Android 14限制了后台启动服务的行为，需针对性调整：
  • 若用WorkManager：必须为后台任务调用setForeground()标记为前台任务，或确保任务符合系统白名单规则（如用户主动触发、高优先级耗时任务）。
  • 若用自定义后台服务：替换为JobScheduler或WorkManager实现，避免直接启动后台服务。
• 通知权限：Android 14强制要求POST_NOTIFICATIONS权限，即使应用不主动发通知，只要后台任务涉及通知展示，必须在Manifest中声明并动态申请。

2. React Native版本兼容性修正 #

旧版RN（0.71及以下）对API 34支持不完善，会出现编译通过但运行崩溃的情况：

• 优先升级React Native到0.72及以上版本，该版本正式适配Android 14。
• 若无法升级RN主版本，需手动更新依赖：
  • 升级react-native-gradle-plugin到兼容API 34的版本。
  • 替换短信读取、后台任务类第三方库为最新版（如react-native-sms-retriever），移除依赖废弃API的旧库。

3. 构建配置补全 #

当前配置框架正确，但需补充API 34适配细节：

• 在android/build.gradle中同步NDK版本：

  ext {
    buildToolsVersion = "34.0.0"
    minSdkVersion = 23
    compileSdkVersion = 34
    targetSdkVersion = 34
    ndkVersion = "25.1.8937393" // 需匹配API 34的兼容NDK版本
  }
  

• 在android/app/build.gradle中指定Java 17编译（API 34推荐要求）：

  android {
    compileOptions {
      sourceCompatibility JavaVersion.VERSION_17
      targetCompatibility JavaVersion.VERSION_17
    }
    kotlinOptions {
      jvmTarget = '17'
    }
  }
  

4. 精准定位崩溃原因 #

若以上步骤无效，通过日志锁定具体问题：

• 执行adb logcat *:E查看崩溃日志，重点关注AndroidRuntime抛出的异常（如权限拒绝、类找不到、废弃API调用）。
• 模拟器闪退时，检查是否为完整的Android 14系统镜像，可尝试新建Android 14模拟器测试。

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