React Native构建APK异常求助：Debug包加载失败、Release包安装失败

我来帮你一步步排查这两个问题，都是RN 0.x版本常见的构建坑，咱们先从Debug包的错误说起：

一、解决Debug APK的“Unable to load script from assets 'index.android.bundle'”错误 #

直接运行./gradlew assembleDebug的时候，React Native不会自动把JS bundle打包到APK的assets目录里——而react-native run-android会帮你自动完成这一步。所以你需要手动生成并拷贝bundle文件：

• 先在项目根目录创建assets文件夹（如果还没有的话）：

  mkdir -p android/app/src/main/assets
  

• 生成index.android.bundle文件（注意匹配你的入口文件名）：

  react-native bundle --platform android --dev false --entry-file index.js --bundle-output android/app/src/main/assets/index.android.bundle --assets-dest android/app/src/main/res/
  

  如果你的项目入口文件是index.android.js（RN 0.52版本部分项目还在用这个命名），记得把--entry-file参数改成index.android.js
• 最后重新构建Debug APK：

  ./gradlew assembleDebug
  

二、解决Release APK安装失败的问题 #

Release包安装出错通常和签名配置、bundle生成、混淆规则这三个点有关，咱们逐个排查：

1. 确保Release包包含正确的JS bundle #

和Debug包一样，Release构建前必须先生成生产环境的bundle文件（就是上面第二步的react-native bundle命令，一定要带--dev false参数，确保是生产模式），生成完成后再执行./gradlew assembleRelease。

2. 检查签名配置是否正确 #

React Native的Release APK必须签名才能安装到真机上，你需要在android/app/build.gradle里配置签名信息：

• 如果还没有签名密钥文件，先用keytool生成：

  keytool -genkey -v -keystore my-release-key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias my-key-alias
  

• 然后在android/app/build.gradle中添加签名配置：

  android {
      ...
      signingConfigs {
          release {
              storeFile file('my-release-key.jks') // 密钥文件路径，建议放在android/app目录下
              storePassword '你的密钥库密码'
              keyAlias '你的密钥别名'
              keyPassword '你的密钥密码'
          }
      }
      buildTypes {
          release {
              ...
              signingConfig signingConfigs.release // 绑定签名配置到Release构建
          }
      }
  }
  

  为了安全，你也可以用环境变量代替硬编码的密码，避免把敏感信息提交到代码仓库。

3. 检查混淆规则是否兼容React Native #

RN 0.52版本需要在android/app/proguard-rules.pro里添加必要的混淆规则，否则会把RN的核心代码混淆导致运行出错：

-keep class com.facebook.react.** { *; }
-dontwarn com.facebook.react.**
-keep class javax.annotation.** { *; }
-keep class android.support.v7.** { *; }
-keep interface android.support.v7.** { *; }

然后确保android/app/build.gradle的Release构建类型开启了混淆（如果没开的话）：

buildTypes {
    release {
        minifyEnabled true
        proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
    }
}

4. 清理构建缓存后重新构建 #

有时候旧的构建缓存会导致奇怪的问题，建议先清理缓存再重新构建：

# 清理Android构建缓存
cd android && ./gradlew clean && cd ..
# 重新生成bundle
react-native bundle --platform android --dev false --entry-file index.js --bundle-output android/app/src/main/assets/index.android.bundle --assets-dest android/app/src/main/res/
# 构建Release APK
cd android && ./gradlew assembleRelease

三、通用验证步骤 #

不管是构建Debug还是Release包，先确认这几点：

• JS代码没有语法错误（先运行react-native run-android确认能正常在模拟器运行，说明代码逻辑没问题）
• assets目录存在且bundle文件生成成功（可以去android/app/src/main/assets目录下查看是否有index.android.bundle）
• Release包的签名配置完全正确（这是真机安装的必要条件）

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