HarmonyOS鸿蒙Next中Cannot find module '@kit.AgentFrameworkKit' or its corresponding type declarations. <ArkTSCheck>

HarmonyOS鸿蒙Next中Cannot find module ‘@kit.AgentFrameworkKit’ or its corresponding type declarations. <ArkTSCheck>

import { FunctionComponent, FunctionController } from '[@kit](/user/kit).AgentFrameworkKit';

提示这个

"compatibleSdkVersion": "5.0.0(12)"

https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/hmaf-function

这个是文档。


更多关于HarmonyOS鸿蒙Next中Cannot find module '@kit.AgentFrameworkKit' or its corresponding type declarations. <ArkTSCheck>的实战教程也可以访问 https://www.itying.com/category-93-b0.html

4 回复

【解决方案】：

根据版本清单文档查看当前依赖的Kit是哪个API版本引入的，然后修改build-profile.json5文件里面的配置项compatibleSdkVersion，为当前依赖Kit的最低API版本。’@kit.AgentFramework’最低版本是API20，可以修改compatibleSdkVersion为6.0.0(20)。

更多关于HarmonyOS鸿蒙Next中Cannot find module '@kit.AgentFrameworkKit' or its corresponding type declarations. <ArkTSCheck>的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


首先 需要升级到ide6.0版本以上 然后改这个

该错误表明项目缺少@kit.AgentFrameworkKit模块的声明文件或未正确安装。在HarmonyOS Next中，需确认以下两点：

  1. 检查oh-package.json5是否已声明该依赖，版本与API兼容；
  2. 执行ohpm install确保依赖包完整安装；

若依赖存在但仍报错，可能是ArkTS类型声明未同步，尝试清理项目并重新构建。

这个错误表明项目无法找到 [@kit](/user/kit).AgentFrameworkKit 模块。请按以下步骤排查：

  1. 检查 SDK 版本兼容性
    文档要求 SDK 版本为 9.0.0.21 或更高，但当前配置为 "compatibleSdkVersion": "5.0.0(12)"。需升级到支持的 SDK 版本。

  2. 验证模块依赖
    在 module.json5 中确认已正确声明依赖：

    "dependencies": [
  {
    "bundleName": "com.ohos.agentframeworkkit",
    "moduleName": "[@kit](/user/kit).AgentFrameworkKit"
  }
]

  3. 清理并重建项目
    删除 build 目录和 node_modules，重新运行 ohpm install 和构建命令。

  4. 检查 oh-package.json5
    确保已通过以下命令安装依赖：

    ohpm install [@kit](/user/kit)/agentframeworkkit

若以上步骤仍无法解决，请检查开发环境是否配置了正确的 SDK 路径和 HarmonyOS Next 工具链。

回到顶部