React Native集成liblinphone AAR库后App构建失败求助

我之前在开发RN原生模块的时候也踩过类似的依赖坑，你这个Failed to resolve: :liblinphone-sdk:报错，核心原因是通过react-native link把模块关联到主应用后，主应用的构建系统没法正确找到模块里的liblinphone SDK aar文件。下面是几个亲测有效的解决步骤：

1. 修正模块build.gradle的依赖暴露方式 #

首先检查你的react-native-liblinphone模块的build.gradle，确保aar依赖能被主应用继承到：

// react-native-liblinphone/android/build.gradle
repositories {
    flatDir {
        dirs 'libs' // 这里是你存放liblinphone-sdk.aar的目录，比如模块下的libs文件夹
    }
}

dependencies {
    // 重点：用api而不是implementation，这样依赖会暴露给上层主应用
    api(name: 'liblinphone-sdk', ext: 'aar')
    // 其他RN相关依赖，比如implementation "com.facebook.react:react-native:+"
}

为什么用api？ 因为implementation的依赖只会在当前模块生效，主应用构建时无法感知到；而api会把依赖传递给引用该模块的主应用，这是解决问题的关键。

2. 确认主应用settings.gradle的模块引用 #

执行react-native link后，主应用的settings.gradle应该自动添加了模块引用，但有时候路径可能出错，手动检查一下：

// 主应用/android/settings.gradle
include ':react-native-liblinphone'
project(':react-native-liblinphone').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-liblinphone/android')

确保路径指向你node_modules里模块的Android目录，如果你的模块是本地开发的（不是npm包），要把路径改成本地模块的Android路径。

3. 为主应用添加aar目录的引用 #

即使模块里配置了flatDir，主应用的构建系统可能还是找不到aar，需要在主应用的build.gradle里添加对模块libs目录的引用：

// 主应用/android/build.gradle -> allprojects节点
allprojects {
    repositories {
        mavenCentral()
        mavenLocal()
        // 添加这行，指向模块的libs目录
        flatDir {
            dirs project(':react-native-liblinphone').file('libs')
        }
    }
}

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

缓存经常会导致依赖识别异常，执行以下命令彻底清理后再构建：

# 清理RN缓存
npx react-native clean
# 清理Android构建缓存
cd android && ./gradlew clean
# 回到根目录重新运行
cd .. && npx react-native run-android

5. 手动替代自动link（如果自动配置失效） #

如果react-native link的自动配置有问题，可以手动完成两步：

• 在主应用的app/build.gradle里添加模块依赖：

// 主应用/android/app/build.gradle -> dependencies节点
implementation project(':react-native-liblinphone')

• 检查主应用的MainApplication.java，确保模块已经注册：

import com.yourmodule.LiblinphonePackage; // 替换成你的模块包名

@Override
protected List<ReactPackage> getPackages() {
    @SuppressWarnings("UnnecessaryLocalVariable")
    List<ReactPackage> packages = new PackageList(this).getPackages();
    // 添加这行
    packages.add(new LiblinphonePackage());
    return packages;
}

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