当前位置:首页>鸿蒙APP>从 0 到鸿蒙签名包:我用 CodeX 跑通了一次小游戏上线链路

从 0 到鸿蒙签名包:我用 CodeX 跑通了一次小游戏上线链路

  • 2026-11-04 08:24:52
从 0 到鸿蒙签名包:我用 CodeX 跑通了一次小游戏上线链路
这两天,我用 CodeX 从零开发了一款轻量解谜小游戏。
名字叫《镜潮织星》。
一开始,我以为这只是一次很普通的 AI 编程实验:
想一个玩法,让 CodeX 帮我写代码,生成 H5 游戏,然后再封装成鸿蒙应用。
但真正跑完整条链路之后,我才发现:
小游戏能跑,只是 50%。
剩下的 50%,才是真正把一个作品从“自己电脑里能玩”,推到“可以作为应用提交平台”的关键。
这一次,我完整走了一遍:
玩法设计、H5 实现、HarmonyOS 封装、正式签名、应用市场资料、隐私政策、截图素材、审核问题修复。
最后形成了一个可重新上传的 Release 签名包。
这篇文章,我不想写成“AI 又多厉害”的鸡血文。
我更想把这次真实开发链路拆开讲清楚:
普通人用 CodeX 开发小游戏,到底能做到哪一步?
鸿蒙上线到底卡在哪里?
下一款游戏应该如何避免重复踩坑?

一、最开始,我只是想验证一件事

现在很多人都在说:
AI 可以写代码。
AI 可以做游戏。
AI 可以帮普通人开发产品。
但我一直觉得,这句话只说了一半。
因为真正的问题不是:
AI 能不能写出一个 Demo。
而是:
AI 能不能帮你把一个东西推进到“接近真实上线”的状态。
Demo 很容易。
一个能点、能动、能展示的小游戏,用 AI 辅助,确实可以很快做出来。
但真正上线之前,你还会遇到一堆问题:
应用包格式对不对?
签名证书有没有问题?
bundleName 是否一致?
截图尺寸是否符合要求?
隐私政策是否能公开访问?
上传的是 HAP 还是 APP?
SDK 元数据是不是 Release?
游戏分类是否涉及版号材料?
这些东西,才是普通开发者最容易忽略的地方。
所以这次我没有只停留在“做个小游戏玩玩”。
而是决定把它往鸿蒙应用发布链路上推一遍。

二、《镜潮织星》的玩法:先做一个小而完整的核心机制

这款游戏的名字叫《镜潮织星》。
它不是那种复杂的大型游戏,而是一款轻量解谜小游戏。
核心玩法很简单:
玩家点击轨片时,本格会旋转,镜像格也会反向旋转。
这就形成了一个很有意思的推理压力:
你不是只控制一个位置,
而是每一次操作都会同时影响两个地方。
游戏目标也不是简单连通路线,而是让“日星”和“月星”沿着轨道同步归航。
这样一来,玩法就从普通的“铺路解谜”,变成了“双线协调解谜”。
这类玩法适合用 AI 快速开发,因为它有三个特点:
第一,规则足够清晰。
第二,关卡可以逐步扩展。
第三,不依赖复杂联网和后端系统。
这次版本里,我把它做成了 8 个渐进关卡,适配手机和平板两种设备形态,并且完全不依赖联网。你的复盘材料也记录了这款游戏的核心机制、8 个渐进关卡、2 种设备形态和 0 联网依赖。
这一步给我的感受很明显:
用 CodeX 做小游戏,不要一开始就想做大。
不要一上来就要开放世界、排行榜、社交系统、皮肤商城。
AI 最适合帮你先做出一个“小而闭环”的东西。
有核心规则。
有可玩的关卡。
有基础 UI。
有开始、重玩、胜利、失败流程。
有移动端适配。
做到这些,已经比 90% 停留在想法阶段的人更进一步了。

三、技术路线:先 H5,再封装鸿蒙

这次我没有直接从原生鸿蒙 ArkUI 开始重写游戏逻辑。
我选择的是一条更轻的路线:
先用 H5 做游戏主体,再用鸿蒙 Web 容器承载。
也就是:
游戏逻辑放在 Web 层。
Canvas 负责画面。
JavaScript 负责交互。
HTML/CSS 负责结构和样式。
鸿蒙侧用 ArkTS Web 容器加载本地 rawfile 资源。
这样做最大的好处是:
游戏资产可以复用,迁移成本低。
如果后面要发到网页、Astrocade、小游戏平台,H5 版本都还能继续利用。
鸿蒙工程只承担一个最小原生壳的角色。
你的复盘材料里也把这条路线写得很清楚:H5 游戏由 index.html / CSS / Canvas JS 组成,资源放进 entry/src/main/resources/rawfile,再通过 ArkTS Web 容器加载,最终形成 phone / tablet / release package。
当然,这条路线也有代价。
Web 容器的性能和系统能力肯定不如纯原生。
但对一款轻量解谜游戏来说,它是够用的。
我的判断是:
先用最短路径验证上架,再决定是否重写原生。
这是普通个人开发者更现实的选择。
因为你的第一目标不是把架构做得多完美,而是先验证:
玩法能不能成立?
用户能不能看懂?
平台能不能接受?
上线链路能不能跑通?
如果这些都没验证,直接投入大量时间做原生重构,很容易变成无效开发。

四、真正的麻烦,是从“打包上线”开始的

游戏跑起来之后,我原本以为后面就是简单打包。
结果真正的坑,从这里才开始。
鸿蒙应用上架不是把代码压缩一下上传就行。
你需要处理:
bundleName
发布证书
Profile
p12 文件
cer 文件
p7b 文件
store password
key password
Release 构建
包体校验
应用市场资料
任何一个地方不一致,都可能导致后台无法通过校验。
这一次项目的包名是:
com.mirrortide.puzzle
最终形成的上传包是:
mirror-tide-1.0.0-signed.app
这里有一个非常重要的经验:
上架不要传 HAP,而是使用正式签名后的 .app。
华为官方发布文档也提到,HarmonyOS 应用/元服务开发完成后,需要打包成 App Pack,也就是 .app 文件,用于上架到 AppGallery Connect。
这对第一次做鸿蒙应用的人非常关键。
因为本地调试时,你可能经常看到 HAP。
但真正面向市场提交时,后台认的是发布流程里的正式包。
我的复盘材料里也记录了这次的最终校验项:releaseType 为 Release、Beta1 无残留、SHA256 已记录、版本号 1.0.0。
这一步让我意识到:
应用市场不是看你的游戏“能不能玩”,而是先看你的包“合不合规”。
代码只是其中一部分。
签名、证书、元数据、版本包,都是上线的一部分。

五、上架资料不是附属工作,而是产品的一部分

很多个人开发者做产品,最容易犯的错误是:
先把功能做完,最后才开始补上架资料。
但这次我发现,这样做非常容易返工。
因为应用市场需要的不只是包。
它还需要:
应用名称
一句话简介
应用图标
横向截图
应用介绍
隐私政策
用户协议
联系邮箱
隐私标签
版本说明
这一次,《镜潮织星》的上架资料包括:
应用名称:镜潮织星
一句话简介:镜像潮汐解谜
横向截图:5 张 1920×1080 PNG
隐私政策:Vercel HTTPS 页面
隐私标签:不涉及个人信息收集
版本包:signed .app
华为 AppGallery Connect 也有专门的隐私声明配置文档,隐私政策、用户协议等材料并不是可有可无的装饰,而是应用发布准备中的正式环节。
这次我最大的感受是:
截图、图标、隐私政策、用户协议,要从开发阶段就开始准备。
不要等到上传后台时才临时拼。
因为那个时候你会发现:
截图尺寸不对。
图标规格不对。
隐私链接打不开。
页面不是 HTTPS。
介绍文案不符合分类。
游戏属性可能涉及额外材料。
这些都不是代码问题。
但它们会直接决定你能不能进入审核队列。

六、这次最真实的坑:技术能上传,不等于商业能上线

这次开发过程中,我遇到的真正问题,不是游戏逻辑有多复杂。
而是上线边界。
比如:
DevEco SDK 元数据里出现 Beta 标记。
隐私链接不能随便填托管链接。
签名材料分散,容易搞混。
大陆游戏分类可能涉及版号、ISBN、软著或授权材料。
其中最关键的是游戏合规问题。
如果选择中国大陆游戏分类,就不能只从技术角度判断“我能不能上传”。
还要判断:
是否需要版号?
是否需要 ISBN?
是否需要出版单位?
是否需要运营主体材料?
是否需要软著或授权材料?
国家新闻出版署官网有专门的游戏审批结果和国产网络游戏作品审批事项页面,游戏名称、出版单位、运营机构、批复文号、出版物号等都是公开审批信息中的关键字段。
所以这次我没有把文章写成“已经轻松上线成功”。
因为真实情况是:
技术上已经形成可重新上传的 Release 签名包,但商业发布还要看地区、分类和材料要求。
这才是负责任的说法。
尤其是个人开发者,不要为了“快点上线”,随便改分类、绕规则、伪造材料。
短期看可能省事,长期看风险很大。
我的建议是:
如果目标是快速验证,可以优先评估允许的非大陆地区。
如果必须大陆上线,就要提前评估版号周期、材料成本和代理成本。
这不是代码问题。
这是发行决策问题。

七、CodeX 真正有价值的地方,不是替你写几行代码

这次用 CodeX 开发,我最大的感受不是“AI 写代码好快”。
而是:
它能把一个普通人的想法,推到工程化链路里。
以前一个人做小游戏,可能会卡在很多地方:
不知道怎么组织代码。
不知道怎么写 Canvas 逻辑。
不知道怎么做移动端适配。
不知道怎么拆关卡。
不知道怎么封装成应用。
不知道哪里报错。
不知道下一步该检查什么。
现在有了 CodeX,很多问题可以被快速推进。
但这里也必须说一句现实的话:
AI 不是产品负责人。
它可以帮你写代码。
可以帮你修 bug。
可以帮你解释报错。
可以帮你补文件。
可以帮你生成脚本。
可以帮你整理上架资料。
但它不能替你做所有判断。
比如玩法是否有吸引力。
用户是否愿意继续玩。
平台分类是否合适。
游戏是否需要版号。
发行地区怎么选。
商业化路径是否成立。
这些仍然需要人来判断。
所以我现在越来越觉得:
未来普通人做产品,不是“会不会写代码”的竞争。
而是:
你能不能用 AI 把想法推进成真实交付物。
从想法,到 Demo。
从 Demo,到工程。
从工程,到签名包。
从签名包,到应用市场资料。
从资料,到审核反馈。
从反馈,到下一轮修复。
这才是完整能力。

八、下一款小游戏,我会从第一天就按上线标准开发

这次《镜潮织星》跑完之后,我总结出一个很重要的 SOP。
以后再做小游戏,不能再等开发完才考虑上线。
应该从第一天就把上线要求前置。
立项前先确认三件事:
第一,平台和地区。
第二,分类材料要求。
第三,版号、软著或授权路径。
开发中同步做三件事:
第一,固定 bundleName。
第二,同步准备图标和截图。
第三,尽量避免敏感权限和复杂 SDK。
打包前检查三件事:
第一,是否使用 Release SDK。
第二,签名材料是否统一归档。
第三,pack.info 是否存在异常标记。
提交前再检查三件事:
第一,隐私链接是否公网可访问。
第二,文案是否避开敏感词和误导性表述。
第三,上传的是正式签名 .app,不是调试产物。
这套 SOP,是这次踩坑换来的。
你的复盘材料里也把这句话总结得很准确:
游戏能跑只是 50%,能合规签名、能被市场接受、能被审核理解,才是可上线版本。

九、写在最后:普通人做 AI 产品,别只停留在“生成”

这次用 CodeX 开发《镜潮织星》,给我最大的提醒是:
AI 时代,做产品的门槛确实降低了。
但不是低到“随便输入一句话就能赚钱”。
真正有价值的,不是生成一个 Demo。
而是你能不能把 Demo 往前推。
推到能运行。
推到能打包。
推到能签名。
推到能上传。
推到能被审核理解。
推到能面对真实平台规则。
这中间的每一步,都是能力。
所以我现在更愿意把 AI 编程工具看成一个“加速器”。
它可以大幅提升普通人的开发速度。
但最后决定你能不能做成产品的,仍然是:
你是否理解平台规则。
你是否愿意解决细节问题。
你是否能把一个想法做成完整交付。
你是否能在审核、合规、素材、市场之间持续推进。
《镜潮织星》这次还不是终点。
它更像是一次完整的实战演练。
从创意到上架包,我终于跑通了第一条链路。
下一步,就不是再问“AI 能不能做小游戏”。
而是要问:
我能不能用 AI,连续做出更多真正能上线、能验证、能增长的产品。
这,才是普通人真正值得抓住的机会。

最新文章

随机文章