用 DevEco Studio 编译 HarmonyOS 鸿蒙Next项目时提示“NDK not found”，但明明装了？

用 DevEco Studio 编译 HarmonyOS 鸿蒙Next项目时提示“NDK not found”，但明明装了？ 在 Windows 上开发含 C++ 模块的鸿蒙 App，DevEco Studio 报错找不到 NDK，路径也配置了，就是不行。

4 回复

HarmonyOS 5 的 NDK 需通过 DevEco 自带的 SDK Manager 安装，不能使用 Android NDK 或手动下载版本

更多关于用 DevEco Studio 编译 HarmonyOS 鸿蒙Next项目时提示“NDK not found”，但明明装了？的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


试试把NDK放到其他文件夹下，文件路径不要有中文、空格或特殊符号。

检查DevEco Studio中NDK路径配置。在File > Settings > SDK Manager > HarmonyOS SDK中确认NDK是否已安装且版本匹配。若已安装，在File > Project Structure > SDK Location中手动设置NDK路径。确保项目local.properties文件中的ndk.dir指向正确路径。

在 HarmonyOS Next 开发中，DevEco Studio 提示“NDK not found”但已安装，通常由以下几个原因导致，可按顺序排查：

  1. NDK 版本不匹配
    HarmonyOS Next 对 NDK 有特定版本要求（如 API 11+需使用配套 NDK）。请确认安装的 NDK 版本与当前 HarmonyOS SDK 兼容。

    • 打开 DevEco Studio → Tools → SDK Manager → HarmonyOS SDK，检查 Native 选项卡中 NDK 是否已安装且版本正确。
    • 若未安装，勾选对应版本并点击 Apply 下载。

  2. NDK 路径未正确关联
    即使已安装，项目可能未指向正确的 NDK 路径。

    • 检查项目级配置：打开项目根目录下的 local.properties 文件，确认是否存在 ohos.ndk.dir 路径配置（例如：ohos.ndk.dir=C:\\Users\\xxx\\AppData\\Local\\Huawei\\Sdk\\native\\x.x.x.x）。
    • 若文件不存在或路径错误，可手动创建该文件并指定路径，或通过 IDE 自动同步：File → Sync Project with SDK。

  3. 环境变量冲突
    系统环境变量中若存在其他 NDK（如 Android NDK）路径，可能导致冲突。

    • 临时解决方案：在 DevEco Studio 的终端中执行命令明确指定 NDK 路径（示例）：
      set OHOS_NDK_HOME=C:\\Users\\xxx\\AppData\\Local\\Huawei\\Sdk\\native\\x.x.x.x
    • 长期解决：在系统环境变量中设置 OHOS_NDK_HOME，并确保其优先级高于其他 NDK 变量。

  4. 项目配置未同步
    修改配置后未同步项目可能导致报错。

    • 尝试清理并重建：执行 Build → Clean Project，随后 Build → Rebuild Project。
    • 检查 build-profile.json5 中 externalNativeOptions 配置的 NDK 路径是否与本地一致。

  5. SDK 安装不完整
    部分情况下 NDK 组件下载不完整。

    • 在 SDK Manager 中重新安装 NDK：取消勾选 NDK 后点击 Apply 卸载，重新勾选并再次安装。

若以上步骤仍无法解决，请检查项目是否包含 C++ 文件但未在 CMakeLists.txt 或 build-profile.json5 中正确配置 NDK 依赖，并确认 DevEco Studio 已更新至支持 HarmonyOS Next 的最新版本。

回到顶部