安装react-native-ble-manager后React-native-cli构建失败，疑为Gradle代理问题？

我之前也踩过这个坑，大概率是自动link没处理好细节，或者项目的Android SDK版本和BLE库的要求不匹配，试试下面这些针对性解法：

1. 先检查SDK版本适配 #

打开项目里的 android/build.gradle 文件，确认这几个配置符合要求：

• minSdkVersion 至少要设为 18（Android 4.3才开始支持BLE）
• compileSdkVersion 和 targetSdkVersion 建议用稳定的新版本（比如33或34）

修改完同步一下gradle，再尝试构建。

2. 手动补全自动link遗漏的配置 #

有时候自动link不会把所有配置都弄到位，得手动补：

• 打开 android/app/build.gradle，确保依赖里有这行：

dependencies {
    implementation project(':react-native-ble-manager')
}

• 再检查 android/settings.gradle 里是否包含：

include ':react-native-ble-manager'
project(':react-native-ble-manager').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-ble-manager/android')

3. 清理gradle缓存再重新构建 #

依赖解析失败很多时候是缓存搞的鬼，执行这串命令清缓存重启构建：

# 进入android目录清理缓存
cd android && ./gradlew clean
# 回到根目录重新运行项目
cd .. && react-native run-android --port=5714

4. 排查依赖冲突 #

如果上面的步骤没用，可能是和其他第三方库有依赖冲突。运行下面的命令查看完整依赖树，找出冲突的库：

cd android && ./gradlew app:dependencies

找到冲突项后，可以在 android/app/build.gradle 里排除冲突部分，比如：

implementation(project(':react-native-ble-manager')) {
    exclude group: 'com.android.support', module: 'support-v4'
}

5. 确认BLE权限配置（顺带检查） #

虽然这不是直接的依赖问题，但权限缺失也可能间接导致构建异常，确保 android/app/src/main/AndroidManifest.xml 里加了必要权限：

<uses-permission android:name="android.permission.BLUETOOTH"/>
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<!-- Android 12及以上额外需要 -->
<uses-permission android:name="android.permission.BLUETOOTH_SCAN"/>
<uses-permission android:name="android.permission.BLUETOOTH_ADVERTISE"/>
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT"/>

要是这些步骤都试过还不行，把完整的报错信息贴出来，能更精准定位问题。

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