安装react-native-agora后React Native项目无法构建如何解决

按以下步骤逐一排查修复，覆盖90%以上的编译失败场景：

Android端适配 #

• 调整最低SDK版本：4.x及以上版本的react-native-agora要求Android minSdkVersion ≥ 24，直接修改android/app/build.gradle内的配置：

android {
    defaultConfig {
        minSdkVersion 24 // 低于该版本会直接构建失败
        // 其余原有配置保持不变
    }
}

• 对齐NDK版本：在android/build.gradle中指定和RN版本兼容的NDK版本，避免原生库编译不通过：

buildscript {
    ext {
        ndkVersion = "21.4.7075529"
        // 其余原有配置保持不变
    }
}

• 处理依赖冲突：如果构建日志报重复类、依赖重复引入错误，在android/app/build.gradle的android同级位置加依赖排除规则：

configurations.all {
    exclude group: 'io.agora.rtc', module: 'full-sdk'
    exclude group: 'com.android.support', module: 'support-v4'
}

• 清理构建缓存后重新编译：

cd android
./gradlew clean
cd ..
npx react-native start --reset-cache

iOS端适配 #

• 更新原生依赖：进入ios目录更新pod仓库，拉取完整的Agora原生SDK：

cd ios
pod deintegrate
pod install --repo-update

• 关闭Bitcode：Agora iOS SDK不支持Bitcode编译，直接在Xcode中打开项目，找到target的Build Settings，将Enable Bitcode选项设置为NO。
• 架构兼容处理：如果是M系列芯片Mac模拟器编译报架构错误，在Build Settings的Excluded Architectures中，给模拟器编译选项添加arm64排除规则。
• 清理Xcode缓存后重新编译：Xcode中按快捷键Command + Shift + K清空构建缓存，再执行编译。

版本兼容校验 #

• 检查react-native-agora版本和当前React Native版本的匹配关系：RN 0.70+ 请直接使用4.x以上稳定版，不要使用3.x及更早的旧版本，重新安装最新稳定版的命令：

# npm
npm install react-native-agora@latest --save
# yarn
yarn add react-native-agora@latest

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