Android应用构建失败：NDK缺少source.properties文件求助

问题描述 #

运行Flutter调试模式应用时，Gradle执行assembleDebug任务失败，报错提示指定路径下的NDK缺少source.properties文件，即使已安装对应NDK版本问题仍存在。完整报错日志：

Launching lib\login.dart on AOSP on IA Emulator in debug mode...
Support for Android x86 targets will be removed in the next stable release after 3.27. See https://github.com/flutter/flutter/issues/157543 for details.
Running Gradle task 'assembleDebug'...

FAILURE: Build failed with an exception.

* Where:
Build file 'C:\Users\User\StudioProjects\femuna\android\build.gradle' line: 13

* What went wrong:
A problem occurred evaluating root project 'android'.
> A problem occurred configuring project ':app'.
   > [CXX1101] NDK at C:\Users\User\AppData\Local\Android\sdk\ndk\26.3.11579264 did not have a source.properties file

* Try:
> Run with --stacktrace option to get the stack trace.
> Run with --info or --debug option to get more log output.
> Run with --scan to get full insights.
> Get more help at https://help.gradle.org.

BUILD FAILED in 1s
Error: Gradle task assembleDebug failed with exit code 1

解决方案 #

• 重新安装对应NDK版本
  打开Android Studio的SDK Manager → SDK Tools标签，找到NDK (Side by side)，先卸载版本26.3.11579264，再重新勾选安装。安装过程中避免中断，确保文件完整下载。

• 手动指定可用NDK版本

  1. 打开项目的android/local.properties文件，添加或修改NDK路径：

     ndk.dir=C:\\Users\\User\\AppData\\Local\\Android\\sdk\\ndk\\25.2.9519653
     

     （替换为你已确认存在source.properties的NDK版本路径）
  2. 或者在android/build.gradle的android块中指定NDK版本：

     android {
         ndkVersion "25.2.9519653"
     }
     

• 清理缓存后重试
  依次执行以下命令：

  flutter clean
  cd android
  gradlew clean
  cd ..
  flutter run
  

• 验证SDK路径配置
  检查系统环境变量ANDROID_HOME是否设置为C:\Users\User\AppData\Local\Android\sdk，同时确认Android Studio的Settings中SDK路径与该值一致。

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