Menu
检查 HarmonyOS 项目中的废弃 SDK 接口并提供修复建议。当需要清理废弃 API、升级 API 版本、优化代码质量或进行静态语法检查时使用。提供详细的迁移方案、修复优先级分类和代码示例。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| 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.