React Native assembleDebug正常但assembleRelease特定页面崩溃求助

问题背景 #

使用React Native 0.70.6、Gradle 7.2.2，debug构建正常，但release构建后特定页面崩溃，构建日志存在两类核心问题：Gradle隐式依赖警告、JS Bundle未声明变量警告。

一、修复Gradle隐式依赖问题 #

日志提示两个任务依赖未声明，导致构建优化被禁用，可能打乱资源打包顺序：

1. :app:bundleReleaseJsAndAssets 依赖 :react-native-vector-icons:writeReleaseAarMetadata
2. :app:compressReleaseAssets 依赖 :app:copyReleaseBundledJs

解决步骤： #

• 打开android/app/build.gradle，在文件末尾添加任务依赖声明：

  // 修复vector-icons与bundle任务的依赖
  tasks.named('bundleReleaseJsAndAssets') {
      dependsOn(':react-native-vector-icons:writeReleaseAarMetadata')
  }
  
  // 修复压缩资源与拷贝bundle的依赖
  tasks.named('compressReleaseAssets') {
      dependsOn(':app:copyReleaseBundledJs')
  }
  

• 清理构建缓存并重新构建：

  ./gradlew clean assembleRelease
  

二、修复JS Bundle未声明变量警告 #

这些警告在release严格模式下可能触发报错，导致页面崩溃，需配置Metro打包时保留相关全局变量：

解决步骤： #

1. 打开项目根目录的metro.config.js，修改transformer的minifier配置：

   module.exports = {
     transformer: {
       getTransformOptions: async () => ({
         transform: {
           experimentalImportSupport: false,
           inlineRequires: true,
         },
       }),
       // 添加全局变量保留配置
       minifierConfig: {
         mangle: {
           keep_fnames: true,
         },
         keep_classnames: true,
         keep_fnames: true,
         globals: {
           __REACT_DEVTOOLS_GLOBAL_HOOK__: false,
           DebuggerInternal: false,
           setTimeout: true,
           clearTimeout: true,
           setImmediate: true,
           requestAnimationFrame: true,
           FileReader: true,
           Blob: true,
           Buffer: true,
           btoa: true,
           nativeFabricUIManager: false
         }
       }
     },
   };
   

2. 验证第三方库配置：
   • 确保react-native-vector-icons的fonts.gradle已正确引入到android/app/build.gradle：

     apply from: "../../node_modules/react-native-vector-icons/fonts.gradle"
     

   • 旧架构项目需检查MainApplication.java是否注册了VectorIconsPackage。
3. 重新生成Release Bundle：

   npx 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/
   

4. 排查崩溃页面代码：确认是否使用了依赖这些全局变量的库（如网络、文件处理类库），确保其在release模式下加载正常。

三、额外排查建议 #

• 查看设备崩溃日志：使用adb logcat *:E过滤错误日志，定位具体崩溃的代码行，精准修复问题。
• 优化混淆规则：打开android/app/proguard-rules.pro，添加必要的混淆排除规则，避免误删核心类：

  -keep class com.facebook.react.** { *; }
  -keep class com.oblador.vectoricons.** { *; }
  

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