React Native项目Gradle同步报错：`settings.gradle`未配置Autolinking致Expo模块无法自动链接，求配置方法

嘿，我来帮你搞定这个同步Gradle时的Autolinking报错问题！这个错误其实很常见——就是你的项目里用了Expo模块，但Gradle不知道怎么自动链接它们，所以得手动在settings.gradle里加上对应的配置。下面是一步步的解决方法：

问题根源 #

当你在React Native项目中引入Expo相关模块时，需要让Gradle通过Autolinking机制自动识别并集成这些模块。如果settings.gradle里没配置对应的脚本，Gradle就找不到链接的入口，自然会抛出这个错误。

具体解决步骤 #

1. 确认Expo依赖已安装 #

如果你的项目还没安装expo核心包，先在项目根目录运行：

npm install expo

这一步是确保Autolinking的基础工具包存在。

2. 配置settings.gradle #

打开项目根目录下的android/settings.gradle文件，添加以下关键配置：

// 替换成你的项目名称，如果你已经有这行就保留
rootProject.name = 'YourProjectName'

// 引入Expo的Autolinking脚本
apply from: new File(["node", "--print", "require.resolve('expo/package.json')"].execute().text.trim(), "../scripts/autolinking.gradle")
// 启用Expo模块的自动链接
useExpoModules()

// 保留你原有的其他模块引用，比如这行通常都会有
include ':app'

注意：如果文件里原本有其他include语句（比如引入自定义模块），别删掉，只添加上面的apply from和useExpoModules()两行就行。

3. 调整android/build.gradle配置 #

打开android/build.gradle，做两处修改：

• 在buildscript的dependencies块中添加Expo Gradle插件的依赖：

buildscript {
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath("com.android.tools.build:gradle:7.3.1") // 确保版本和你的项目兼容
        classpath("expo:expo-gradle-plugin:^0.1.0") // 建议用对应Expo版本的插件，可查看package.json里的expo版本匹配
    }
}

• 在allprojects的repositories里添加Expo的Maven仓库：

allprojects {
    repositories {
        google()
        mavenCentral()
        maven { url 'https://maven.google.com' }
        // 添加这行，让Gradle能找到Expo模块的依赖
        maven { url "$rootDir/../node_modules/expo/android/maven" }
    }
}

4. 配置android/app/build.gradle #

打开android/app/build.gradle，在文件顶部的插件引用里添加Expo插件：

apply plugin: 'com.android.application'
apply plugin: 'expo' // 新增这行

另外，确保你的defaultConfig里的minSdkVersion至少是21（大部分Expo模块都要求这个最低版本）：

defaultConfig {
    applicationId "com.yourprojectname" // 替换成你的应用ID
    minSdkVersion 21
    targetSdkVersion 33
    versionCode 1
    versionName "1.0"
}

5. 同步并清理项目 #

回到Android Studio，点击「Sync project with Gradle Files」按钮。如果同步还是有问题，可以先在项目根目录运行清理命令：

cd android && ./gradlew clean

清理完成后再重新同步Gradle，应该就能解决报错了。

额外小贴士 #

• 如果你是从Expo Managed Workflow转成Bare Workflow的项目，这些配置原本应该是自动生成的，可能是你不小心删掉了，检查一下文件内容就行。
• 确保你的Node.js版本是LTS版本，和当前安装的Expo版本兼容，避免出现依赖不匹配的问题。
• 如果还是报错，可以检查node_modules/expo文件夹是否存在，要是没有的话，重新运行npm install安装依赖。

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