macOS Sonoma编译Android NDK模块时报source.properties缺失错误

问题场景 #

在macOS Sonoma系统下编译包含C++ Native代码的Android项目时，触发错误提示：

did not have a source.properties file

此前在旧版macOS环境下从未出现该问题。

原因推测 #

大概率是macOS Sonoma的文件移动/解压机制异常，导致NDK安装后的目录结构不符合Android构建工具的预期。

排查发现 #

通过Android Studio的SDK Manager或sdkmanager命令重装NDK后，观察到目录结构异常：

• 预期结构：source.properties文件应直接存放在NDK版本目录（如25.1.8937393）的根目录下
• 实际结构：source.properties文件被存放在版本目录的子目录android-ndk-r25b中

解决步骤 #

• 定位NDK安装目录，默认路径为：~/Library/Android/sdk/ndk/
• 进入出现异常的NDK版本目录（例如25.1.8937393）
• 将子目录android-ndk-r25b下的所有文件及文件夹移动到当前版本目录的根目录
• 删除空的android-ndk-r25b子目录
• 回到Android Studio，同步项目后重新执行编译

内容的提问来源于stack exchange，提问作者Randy Sugianto 'Yuku'