鸿蒙应用代码生成器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ea38fd42/harmonyos-app-dev。
技能介绍
要解决什么问题
HarmonyOS 应用开发往往卡在「文档分散 + ArkTS 约束多 + 工程结构不统一」:你描述的是业务页面,Agent 却容易输出教程片段、混用 V1/V2 状态管理,或在 build()、@Prop 初始化、Navigation 壳层上踩编译/白屏坑。本技能把目标收窄为可放进 DevEco Studio 工程直接编译运行的 .ets 与配置,而不是知识点罗列。
技能如何工作
生成前会先对齐几项设计决策并说明理由:
- 应用模型:默认 Stage 模型(文档中的唯一推荐路径)
- 状态管理:新项目优先 V2(
@ComponentV2、@Local、@Param、@Event等);老项目才回退 V1 - SDK:新项目面向 API 12+(HarmonyOS NEXT);维护场景可兼容 API 9–11
- 目录分层:
pages/、components/、model/、common/(复杂业务可加viewmodel/)
输出按固定顺序组织:设计概览 → 目录树 → 分文件代码 → 运行说明(权限、依赖、注意事项)。规范侧强调 ArkTS 常见硬规则,例如 build() 单一根节点、@Prop 等不可本地初始化、网络需 ohos.permission.INTERNET 且 http 用后 destroy()、V2 不与 @Component 混用等。文档还串联 DevEco 工具链选型:IDE(DevEco Studio)、Agent 终端(DevEco Code)、CLI(DevEco CLI)、IDE 插件(CodeGenie),并在编译、运行、日志、语法检查、知识库检索等场景给出对应工具。
专题段落覆盖实战高频能力:Share Kit(系统分享,非错误调用 pasteboard)、UserAuth(含 API 演进与成功码 12500000 等坑)、以及 DocumentViewPicker、Navigation 白屏、SymbolGlyph、网络请求等踩坑修复条目,便于对照日志改代码。
适用边界与注意点
- 模拟器对生物识别等能力支持有限,相关功能需真机验证。
- 敏感信息应走
preferences等存储,生产环境用 HTTPS;涉及权限会在生成时提醒(网络、生物识别、运行时授权等)。 - 技能侧重代码与工程约定;具体 Hvigor/DevEco Code 命令需在本地工具链中执行,文档提供场景对照而非替代你的构建环境。
使用场景
- 产品给出页面与交互说明后,要在新 Stage 工程里生成可编译的 `pages/` 入口页与 `module.json5` 网络等权限配置
- 在既有 HarmonyOS 工程里增量加一个列表/详情页,需 `@ComponentV2`、`LazyForEach` 与统一目录分层后交给 Hvigor 构建
- 编译卡在 `arkts-no-untyped-obj-literals` 或 `Navigation` 路由参数匿名对象,需按规范改成显式类型再过 ArkTS 检查
- 真机调试生物识别登录时成功却提示失败,需对照 UserAuth 结果码 `12500000` 与 `getAvailableStatus` 参数签名改认证流程
适合人员
- 负责 HarmonyOS NEXT(API 12+)功能交付、要求输出可直接合入工程的 `.ets` 而非教程的应用开发工程师
- 维护 API 9–11 老工程、要在 V1 状态管理与 Stage 分层之间做兼容决策的技术负责人
- 集成指纹/人脸/PIN 登录、需区分模拟器与真机并在日志里核对 UserAuth 错误码的移动端工程师
- 做应用内分享链接或图片、需从错误 API 迁移到 Share Kit `ShareController.show()` 的鸿蒙功能开发同学