Flutter 如何解决 NDK Version 问题

最近跑了下 flutter upgrade 之后,debug 运行突然报一个 NDK Version 的 Warning,虽然实际上并不影响运行,但是看着挺烦人的,稍微查了下,解决方式倒也挺简单的。

错误现象

实际错误会有少许不同,但是都大差不差:

Your project is configured with Android NDK 26.3.11579264, but the following plugin(s) depend on a different Android NDK version:
- path_provider_android requires Android NDK 27.0.12077973
Fix this issue by using the highest Android NDK version (they are backward compatible).
Add the following to D:\Repository\repo_android\coworker\android\app\build.gradle.kts:

    android {
        ndkVersion = "27.0.12077973"
        ...
    }

解决方式

有两种解决方案:

  • 使用 AGP 版本

  • 手动指定 Flutter NDK 版本

1、使用 AGP 版本

如果你的项目使用 Android Studio 运行,则可以直接让 Android Gradle 插件 (AGP) 自动选择合适的 NDK 版本,解决方式非常简单:

AGP

在你的 Flutter 项目的 android/app/build.gradle.kts 中,直接注释掉 ndkVersion 这一项即可,就这么简单。

2、手动指定 Flutter NDK 版本

跟第一种解决方案一样,不过这次不是注释,而是修改成你现有的 NDK 版本即可:

指定 NDK

在指定 NDK 版本下,不使用 Android Studio 运行也不会报错。

除了在项目的 build.gradle.kts 中修改外,你还可以在 flutter_sdk/packages/flutter_tools/gradle/src/main/kotlin/FlutterExtension.kt 中进行修改来一次性解决所有 Flutter 项目的 NDK 报错:

直接修改 Flutter SDK 来指定 NDK

收摊,睡觉!


Flutter 如何解决 NDK Version 问题
https://blog.tihus.com/archives/f94929fa-bdfc-4bf8-8201-6e28c07b1cb4
作者
Yuki
发布于
2025年08月02日
许可协议