← AI 专题

hongmeng:Web App → 鸿蒙原生 AppGallery 上架流水线

一句话:把任何 Web App 转成鸿蒙原生应用,自动上架华为应用市场。这是从 SOSO App 真实项目里长出来的 Skill,每条指令都踩过坑、改过 bug。


能做什么


真实案例:SOSO App 全流程

SOSO 是一款针对高血脂、脂肪肝中青年群体的健康管理 App。经历:

6 月 1 日

PWA 原型验证产品逻辑,打包为 zip/apk

6 月 17 日

创建 ArkTS 工程:9 页面 + 8 组件 + 数据层

6 月 19 日

首次 AGC 提交审核 🔥

6 月 27 日

修复驳回问题后重新提交,审核通过


踩过的 4 个大坑

坑 1:AGC 只要 .app 不要 .hap

构建命令必须用 assembleApp 而非 assembleHap。.hap 是鸿蒙的普通安装包格式,但 AppGallery 只接受 .app 格式。

坑 2:多语言资源必须完整

entry 模块必须有独立的 color.json5 和完整多语言资源。审核驳回原因之一:任务列表白屏——因为启动窗口引用了 entry 模块的颜色变量,但 entry 根本没有 color.json5。

教训:AppScope 的资源配置不代表 entry 模块能用。两层资源都要配齐。

坑 3:应用信息页图标是独立上传的

包内图标改了,但 AGC 应用信息页的图标没改 → 审核告警"默认语言图标与简体中文图标存在较大差异"。修复:包内 zh_CN/media/ 补图标 + AGC 后台重新上传。

坑 4:API Level 上限

AGC 限制 API Level ≤ 23,但本地 DevEco 可能已升级。解决方案:compileSdkVersion=24 + targetSdkVersion=22——用高版本 SDK 编译,目标 API 满足限制。


签名体系

signing/
├── release-keypair.jks     # 发布密钥对
├── SOSO Release Cert.cer   # 华为颁发证书
├── SOSO ProfileRelease.p7b # 发布配置文件
└── agc-config.json         # AGC API 凭据

复用场景

任何 Web App 要上架鸿蒙市场时,直接调用这套流水线。搭配 frontend-design Skill 形成完整链路:

frontend-design → hongmeng
Web 设计 → 鸿蒙 AppGallery 上架


📥 下载安装

SKILL.md 放到你的 Claude Code skills 目录(~/.claude/skills/hongmeng/SKILL.md),重启 Claude Code 即可使用。

⬇ 下载 SKILL.md(8 KB)