React Native从0.67.5升级到0.76.3后applyNativeModulesSettingsGradle()找不到
2026-6-15
React Native 0.67.5 升级至 0.76.3 后
react-native run-android 报错解决 错误信息
Could not find method applyNativeModulesSettingsGradle() for arguments [settings '
'] on settings '<title of the app>' of type org.gradle.initialization.DefaultSettings.</p> </blockquote> <h2 id="问题原因">问题原因 <a class="header-anchor" href="#问题原因" aria-hidden="true">#</a></h2> <p><code>applyNativeModulesSettingsGradle()</code> 是旧版 React Native（0.70 之前）用于配置原生模块的方法，在 0.70+ 版本的 React Native 中已被移除，Gradle 配置结构也做了调整，保留旧配置会导致方法找不到的报错。</p> <h2 id="解决步骤">解决步骤 <a class="header-anchor" href="#解决步骤" aria-hidden="true">#</a></h2> <ul> <li>打开项目根目录下的 <code>android/settings.gradle</code>（如果是 Kotlin DSL 则为 <code>settings.gradle.kts</code>），找到调用 <code>applyNativeModulesSettingsGradle(settings)</code> 的代码行，直接删除。</li> <li>确保 <code>settings.gradle</code> 文件符合 RN 0.76.3 的标准结构，示例如下：<pre class="hljs"><code class="language-gradle volc-pre-code">rootProject.name = "<你的应用名称>" include ':app' // 保留这行用于原生模块配置（新版本的正确方式） apply from: file("../node_modules/@react-native-community/cli-platform-android/native_modules.gradle"); applyNativeModulesAppBuildGradle(project) </code></pre> </li> <li>清理缓存并重新安装依赖：<pre class="hljs"><code class="language-bash volc-pre-code">cd android && ./gradlew clean rm -rf node_modules package-lock.json npm install </code></pre> </li> <li>重新执行 <code>react-native run-android</code></li> </ul> <p>内容的提问来源于stack exchange，提问作者Rares-Stelian</p>
相关产品推荐
相关产品推荐
