Flutter NDK at xxx/Android/sdk/ndk-bundle did not have a source.properties file

一、下载 ndk

• 查看项目支持的 ndk 版本，路径： android/app/build.gradle，如果修改版本也在这里指定：

  默认使用的是 flutter.ndkVersion，不清楚就先下个配置指定下，不对会报错指定版本，或者你换了也可以，但要注意兼容。

  底部的修改是举例怎么修改，建议非特殊情况不修改，免得出别的问题。

  

• 运行 Android 项目的时候报错找不到 ndk，可以打开 Android Studio 进行设置下载一下。

  

• 下载好后按照上面的路径进入找到 /Users/xxx/Library/Android/sdk/ndk/<版本号>，路径就有了。

二、配置

• 配置方式一：单项目配置

  Android 项目的 android/local.properties 中添加一行

  ndk.dir=/Users/xxx/Library/Android/sdk/ndk/<版本号>
  

• 配置方式二：全局配置

  打开 ~/.zshrc # 或 ~/.bashrc，贴入

  export ANDROID_NDK_HOME=/Users/xxx/Library/Android/sdk/ndk/<版本号>
  export PATH=$ANDROID_NDK_HOME:$PATH
  

  $ source ~/.zshrc # 或 ~/.bashrc
  

• 如果使用错了版本会报错

  [CXX1104] NDK from ndk.dir at /Users/xxx/Library/Android/sdk/ndk/28.0.12916984 had version [28.0.12916984] which disagrees with android.ndkVersion [23.1.7779620]

  报错内容表明项目指定的 NDK 版本是 23.1.7779620，但实际的 NDK 路径指向了 28.0.12916984 版本。

  那么去安装一下 23.1.7779620 这个版本，或者直接更换项目内指定的版本，文章顶部有。

三、生效

• 重新编译

  方式一：Android Studio 工具栏 clean 项目

  方式二：先 $ cd android，然后执行 $ ./gradlew clean

• 然后返回 flutter 项目根目录三连操作

  $ flutter clean
  $ flutter pub get
  $ flutter run