鸿蒙原生记账应用简记APP全流程开发实践

鸿蒙专家

本文以简记APP为例，完整演示基于HarmonyOS的原生应用从开发、调试到上架的实战流程。文章涵盖环境搭建、AI辅助编码、本地数据存储、签名配置以及自动化部署，适合希望快速掌握鸿蒙应用全链路开发的个人开发者或团队参考。

一、项目概述与技术选型
简记APP是一款面向个人的轻量级记账工具，目标用户是希望通过简单操作快速掌握日常收支的用户。核心功能包括收支记录添加（含金额校验、分类选择）、按月按时间倒序的流水列表、删除记录、收支统计概览（含支出分类环形图），以及使用HarmonyOS关系型数据库（RelationalStore）进行本地数据持久化。
技术选型上，使用DevEco Studio作为IDE，借助华为云码道（CodeArts）代码智能体辅助生成基础代码，并利用harmonyos-build-deploy Skill实现一键编译和真机部署。整个案例预计耗时约120分钟。

二、基础环境准备
1. 安装DevEco Studio并创建工程
从华为开发者官网下载并安装DevEco Studio后，在欢迎页选择Create Project，模板选择Empty Ability，配置工程信息：应用名称SimpleAccountingApp、包名com.test.simpleaccountingapp、最低API Version设为6.0.0(20)。完成后工具会自动生成示例代码。
2. 创建本地模拟器
通过Tools > Device Manager打开设备管理，新建一个手机模拟器，设备类型Phone，API Version选择HarmonyOS 6.0.0(20)。首次使用需下载对应镜像，完成后启动模拟器。
3. 安装华为云码道插件
下载CodeArts_Agent离线插件包（.zip），在Settings > Plugins中通过Install Plugin from Disk导入，重启IDE后登录华为账号，模型切换为GLM-4.7-ArkTS-SPARK。该插件将在后续编码环节用于生成业务代码。
4. 确认Node.js环境
在Terminal执行node -v，若未安装则通过华为云官方SKILL快速配置Node.js环境。

三、鸿蒙原生记账应用代码实现
在DevEco Studio中点击华为云码道对话框，选择“探索模式”，输入需求提示词（包括产品名称、定位、核心功能如金额校验、分类预设、月度切换、关系型数据库存储等）。等待一段时间后，AI会生成基础代码。由于模型局限性，生成的代码可能存在语法或逻辑错误，建议直接从GitCode克隆已完善的开源项目：
git clone https://gitcode.com/u014005316/SimpleAccountingApp.git
克隆后用DevEco Studio打开项目，点击运行按钮即可在模拟器上看到应用。应用包含三个页面：记账页（添加收支记录）、账单页（按时间倒序展示流水，支持月度切换和删除）、统计页（展示当月收支总览和支出分类环形图）。建议验证功能：添加餐饮50元、购物100元、交通10元、工资300元，检查账单列表显示是否正确、统计环形图比例是否准确、删除购物记录后数据是否实时刷新。

四、签名配置与发布准备
HarmonyOS应用需通过数字证书（.cer文件）和Profile文件（.p7b文件）保证完整性。步骤分为：
1. 生成密钥和证书请求文件
在DevEco Studio中通过Build > Generate Key and CSR新建.p12密钥库文件，设置别名、密码、有效期（建议25年以上），并生成.csr证书请求文件。
2. 申请发布证书和Profile
登录AppGallery Connect，创建APP ID（应用名称简记APP，包名com.test.simpleaccountingapp），关联创建待发布的HarmonyOS应用。在“证书、APP ID和Profile”页面新增证书，类型选发布证书，上传之前生成的.csr文件，下载.cer证书到本地sign目录。然后添加Profile文件，类型选发布，关联刚申请的证书，下载.p7b文件。
3. 配置签名信息
在DevEco Studio的File > Project Structure > Project > Signing Configs中取消自动签名，手动添加签名配置：指定.p12文件路径、密码、密钥别名、.cer证书路径和.p7b文件路径，签名算法固定为SHA256withECDSA。保存后build-profile.json5文件中自动写入签名信息。

五、使用harmonyos-build-deploy Skill自动编译部署
该Skill是基于CodeArts智能体的自动化工具，支持一键编译并部署到模拟器或真机。
1. 安装Skill
从GitHub下载harmonyos-build-deploy项目，解压后重新压缩为.zip文件。在华为云码道设置中导入该技能包，系统会自动解压至.codeartsdoer/skills目录。
2. 编译部署到模拟器
将CodeArts模型切换为GLM-5.1（当前版本），在对话框中输入：“调用harmonyos-build-deploy，编译当前鸿蒙项目，部署到本地模拟器”。Skill将自动执行hvigorw构建并推送到模拟器。
3. 切换环境打包
若需Release模式打包，输入：“调用harmonyos-build-deploy，切换到生产环境，用release模式重新打包部署”。
4. 打包.app文件上架
最终发布时输入：“项目已开发完成，调用harmonyos-build-deploy，打包.app文件，上架华为应用市场”。Skill会输出.app包，用于后续上传。

六、上架华为应用市场
在AppGallery Connect中找到已创建的鸿蒙应用，填写应用信息（名称必须与包内一致，图标尺寸216x216px或1024x1024px，PNG格式3MB以内）。上传通过Skill打包的.app文件，勾选加密，配置发布国家地区、应用介绍、截图、年龄分级及隐私协议（可通过协议服务新建托管）。设置联系方式与上架时间后提交审核。审核通过后应用即上架。

七、总结
简记APP的完整开发实践展示了HarmonyOS原生应用从零到一的核心流程：DevEco Studio工程创建、CodeArts AI智能体辅助编码、本地关系数据库操作、签名证书配置、自动化构建部署及市场发布。对于希望快速投产鸿蒙应用的开发者而言，该流程可有效缩短开发周期，降低学习成本。

热心网友4

这篇文章写得太实用了！从环境搭建到上架全流程都覆盖了，尤其是AI辅助编码和自动化部署那部分，对个人开发者特别友好。我正好最近在学鸿蒙开发，按你的步骤先克隆项目试试本地运行。请教下：关系型数据库那块，如果后期要支持多设备同步，是不是要迁移到云数据库？