RN 0.64.0升级targetSdkVersion至34后安卓真机Release崩溃求助

崩溃核心原因 #

1. Android 14组件导出性强制校验：Release模式下系统会严格检查所有组件（Activity、Service、Receiver等）的android:exported属性，RN旧版本内置组件（如HeadlessJsTaskService）或自定义组件未显式声明该属性，导致启动时被拦截崩溃。
2. Play Core库版本兼容不足：RN 0.65.0及以下默认依赖的Play Core版本过低，无法适配Android 14的新特性，触发运行时异常。
3. Release混淆规则缺失：未添加Android 14相关RN组件的保护规则，核心代码被混淆删除，导致运行时找不到类或方法。

分步解决方案 #

1. 修复组件导出性配置 #

• 打开android/app/src/main/AndroidManifest.xml，为所有组件显式添加android:exported属性：
  • 主Activity配置示例：

    <activity
        android:name=".MainActivity"
        android:exported="true"
        android:label="@string/app_name"
        android:configChanges="keyboard|keyboardHidden|orientation|screenSize|uiMode"
        android:launchMode="singleTask"
        android:windowSoftInputMode="adjustResize">
    

  • 若使用HeadlessJS，添加服务配置：

    <service
        android:name="com.facebook.react.HeadlessJsTaskService"
        android:exported="false" />
    

• 动态注册广播接收器时，显式指定非导出（需依赖androidx.core:core-ktx）：

  // MainApplication.java中修改registerReceiver调用
  registerReceiver(yourReceiver, yourIntentFilter, Context.RECEIVER_NOT_EXPORTED);
  

  在android/app/build.gradle中添加依赖：

  implementation 'androidx.core:core-ktx:1.12.0'
  

2. 强制升级Play Core库 #

在android/app/build.gradle的dependencies块中添加指定版本的Play Core依赖，覆盖RN默认的旧版本：

dependencies {
    // 保留原有依赖，新增以下行
    implementation 'com.google.android.play:core:1.12.0'
}

3. 补充Release混淆规则 #

编辑android/app/proguard-rules.pro，添加以下规则保护RN核心组件：

# 保护React Native核心类
-keep class com.facebook.react.** { *; }
# 保护AndroidX核心组件
-keep class androidx.core.app.** { *; }
# 保护Play Core库
-keep class com.google.android.play.core.** { *; }
# 保留HeadlessJS服务
-keep class com.facebook.react.HeadlessJsTaskService { *; }
# 保留RN原生模块和包
-keep class * extends com.facebook.react.bridge.ReactContextBaseJavaModule { *; }
-keep class * extends com.facebook.react.ReactPackage { *; }

4. 验证Gradle配置正确性 #

确保android/build.gradle中的版本配置匹配：

buildscript {
    ext {
        buildToolsVersion = "34.0.0"
        minSdkVersion = 21
        compileSdkVersion = 34
        targetSdkVersion = 34
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:7.3.0'
    }
}

同时确认android/gradle/wrapper/gradle-wrapper.properties的Gradle版本：

distributionUrl=https\://services.gradle.org/distributions/gradle-7.4.2-all.zip

5. 清理缓存并重新构建 #

执行以下命令清理旧构建缓存，生成新的Release包：

cd android
./gradlew clean
./gradlew assembleRelease

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