菜单
检查 HarmonyOS 项目中的废弃 SDK 接口并提供修复建议。当需要清理废弃 API、升级 API 版本、优化代码质量或进行静态语法检查时使用。提供详细的迁移方案、修复优先级分类和代码示例。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | hmos-arkts-deprecated-interface-checker |
| description | 检查 HarmonyOS 项目中的废弃 SDK 接口并提供修复建议。当需要清理废弃 API、升级 API 版本、优化代码质量或进行静态语法检查时使用。提供详细的迁移方案、修复优先级分类和代码示例。 |
本技能专门用于检查 HarmonyOS 项目中使用的废弃（Deprecated）SDK 接口，并提供详细的修复建议和迁移方案。帮助开发者保持代码的现代性和可维护性。
⚠️ 重要提示：本技能依赖MCP工具
在执行任何检查操作之前，必须先检查MCP工具是否可用：
依赖的MCP工具：
mcp_codegenie-mcp_check_ets_files - ETS文件静态语法检查mcp_codegenie-mcp_harmonyos_knowledge_search - HarmonyOS知识搜索（可选）检查方法：
尝试调用 mcp_codegenie-mcp_check_ets_files
如果工具不可用，会收到错误提示
如果MCP工具未安装：
❌ MCP工具未安装或不可用
本技能需要依赖 CodeGenie MCP Server 工具才能正常工作。
📦 安装方式：
在 MCP 配置文件中添加以下配置：
{
"mcpServers": {
"codegenie-mcp": {
"command": "npx",
"args": [
"-y",
"@deveco-codegenie/mcp@beta",
"--registry=https://registry.npmjs.org"
],
"env": {
"PROJECT_PATH": "${workspaceFolder}",
"DEVECO_PATH": "path to deveco studio"
}
}
}
}
📚 详细文档：
- GitHub: https://github.com/open-deveco/deveco-toolbox
- 飞书指导文档: https://my.feishu.cn/wiki/open-deveco/deveco-toolbox
💡 安装完成后，请重新使用本技能。
验证成功后继续执行后续步骤。
首先分析项目结构和配置：
# 检查项目类型（ArkTS/ETS）
# 查看 build-profile.json5 配置
# 确定 compileSdkVersion 和 compatibleSdkVersion
# 查看 module.json5 中的配置
使用 MCP 工具进行 ArkTS 静态语法检查：
步骤：
获取项目 ETS 源文件列表
**/*.ets 文件oh_modules 和 build 目录调用静态检查工具
mcp_codegenie-mcp_check_ets_files
参数: files - ETS 文件路径列表
分析检查结果
报告包含以下信息：
报告格式示例：
📊 HarmonyOS 废弃接口检查报告
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔴 严重：X 个错误
🟡 警告：X 个警告
ℹ️ 信息：X 个废弃接口提示
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
【信息】使用已废弃的 API
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📍 文件：entry/src/main/ets/pages/Index.ets:8:12
⚠️ 问题：使用了 @Deprecated 的 px2vp 方法
📚 废弃原因：该签名已被标记为废弃
💡 替代方案：使用新的 API 接口
🔗 官方文档：https://developer.huawei.com/consumer/cn/doc/harmonyos-references/
📋 迁移示例：
// 旧代码:
px2vp(100)
// 新代码:
// 使用推荐的替代方法
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
【警告】未使用的变量
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📍 文件：entry/src/main/ets/pages/Index.ets:8:8
⚠️ 问题：变量 'a' 已声明但从未被使用
💡 建议：删除未使用的变量或使用下划线前缀命名
针对每个问题提供：
每个修复建议包含：
提供自动化修复指导：
开始检查流程
│
├─ MCP工具可用？
│ ├─ 否 → 提示安装MCP工具 → 终止
│ └─ 是 → 继续
│
├─ 发现废弃 API 警告
│ │
│ ├─ 是否有直接替代 API？
│ │ ├─ 是 → 检查最低支持版本
│ │ │ ├─ 满足要求 → 使用替代 API（P1）
│ │ │ └─ 不满足 → 保持现状，添加注释说明（P2）
│ │ │
│ │ └─ 否 → 需要重构代码逻辑
│ │ ├─ 影响核心功能 → 立即处理（P0）
│ │ └─ 非核心功能 → 计划迁移（P1）
│ │
│ └─ 问题严重程度判定
│ ├─ 导致编译失败 → Critical（P0）
│ │ └─ 行动：必须立即修复
│ ├─ 运行时可能出错 → Warning（P1）
│ │ └─ 行动：强烈建议修复
│ └─ 仅警告提示 → Info（P2）
│ └─ 行动：可选优化
详细的废弃 API 列表、迁移示例和错误码参考请查看 废弃 API 参考。
| 废弃 API | 替代方案 | 说明 |
|---|---|---|
px2vp(value: number) | 使用新的签名 | 参数类型变更 |
vp2px(value: number) | 使用新的签名 | 参数类型变更 |
@ohos.fileio | @ohos.file.fs | 模块迁移 |
详细的配置示例和说明请查看 配置参考。
code-linter.json5:
{
"files": ["**/*.ets"],
"ignore": ["**/oh_modules/**", "**/build/**"],
"rules": {
"no-unused-vars": "warn"
}
}
当用户需要检查废弃接口时：
确认项目信息
获取源文件列表
运行静态检查
mcp_codegenie-mcp_check_ets_files(files: [...])
分析报告
制定迁移计划
辅助实施
| 工具名称 | 用途 |
|---|---|
mcp_codegenie-mcp_check_ets_files | ETS 文件静态语法检查 |
mcp_codegenie-mcp_build_project | 构建项目 |
mcp_codegenie-mcp_harmonyos_knowledge_search | 搜索 HarmonyOS 开发文档 |
| 错误码 | 类型 | 说明 |
|---|---|---|
| 6133 | Warning | 未使用的变量/符号 |
| 6387 | Information | 使用了废弃的 API |
详细的诊断信息格式和错误码说明请查看 废弃 API 参考。
执行检查后，将提供：
**MUST** use 'devecocli' for HarmonyOS apps (scaffold, build, run, debug, devices, emulators, logs, docs, 鸿蒙开发文档, skills). **REQUIRED** and **MANDATORY** if workspace has build-profile.json5 or oh-package.json5, or user mentions HarmonyOS, 鸿蒙, DevEco, ArkTS, ArkUI, docs, 鸿蒙文档, 知识, 搜索, or skills.
检索 ArkTS 语言指南文档，为代码开发、审查和调试提供语法参考。当需要查找 ArkTS 语法规则、库使用方法或代码示例时使用。提供基于索引的高效检索和可追溯的文档引用。
检查并修复 HarmonyOS 项目的 ArkTS 语法错误，自动化构建项目。当需要编译项目、修复编译错误、生成 HAP/App 产物时使用。提供静态语法检查、错误自动修复、循环构建直到成功的完整工作流程。支持错误优先级分类（P0/P1/P2）、最大重试机制、构建产物自动定位。
编写、审查或改进ArkUI代码，遵循状态管理(V1/V2)、组件结构、布局选择、性能优化的最佳实践。触发场景：构建新页面或组件、实现状态管理、开发布局(列表/网格/瀑布流)、添加动画手势、搭建导航路由、处理弹窗模态、MVVM架构设计、V1迁移V2。
帮助开发者将ArkUI状态管理从V1迁移到V2。触发场景：(1) V1项目升级到V2；(2) 迁移@Component/@State/@Prop/@Link/@Observed/@ObjectLink/@Provide/@Consume/@Watch/@Reusable装饰器；(3) 迁移LocalStorage/AppStorage/PersistentStorage/Environment应用级状态；(4) 将ForEach/LazyForEach迁移到Repeat；(5) 解决animateTo在V2中的兼容问题；(6) 处理V1与V2混用场景；(7) 询问V1和V2装饰器对应关系或差异。
Handle HarmonyOS avoid-area adaptation through a declarative scene and resource index. Use when the task involves safe area expansion, status bar or navigation bar avoidance, notch or cutout handling, immersive full-screen layouts, or soft keyboard overlap handling.