从零开始开发HarmonyOS应用并上架

开发环境搭建（1-2天）

1. 硬件准备

操作系统：Windows 10 64位 或 macOS 10.13+

内存：8GB以上（推荐16GB）

硬盘：至少10GB可用空间

2. 软件安装

下载 DevEco Studio 3.1+（官网：https://developer.harmonyos.com/cn/develop/deveco-studio）

3. 安装时勾选：
   HarmonyOS SDK
   Node.js（自动集成）
   Ohpm（HarmonyOS包管理器）

4. 环境验证

# 检查Node.js版本
node -v  # 需≥14.19.1

检查ohpm版本

ohpm -v # 需≥1.0.0
配置镜像源（加速依赖下载）

修改ohpm/ohpmrc文件：

复制
registry=https://repo.harmonyos.com/ohpm/
二、项目创建与开发（7-30天）
新建项目

选择模板：Empty Ability + JS/ArkTS（推荐ArkTS）

最小API版本：建议≥API 7（对应HarmonyOS 3.0）

核心目录结构

复制
├── entry # 主模块
│ ├── src/main
│ │ ├── ets # ArkTS代码
│ │ ├── resources # 资源文件
│ │ └── config.json # 应用配置
关键开发要点

UI开发：使用ArkUI声明式语法

typescript
复制
@Entry
@Component
struct Index {
@State message: string = ‘Hello HarmonyOS’

build() {
Column() {
Text(this.message)
.fontSize(30)
Button(‘Click Me’)
.onClick(() => {
this.message = ‘Button Clicked!’
})
}
.width(‘100%’)
.height(‘100%’)
}
}
功能开发：

使用@ohos开头的系统API（如网络、传感器）

通过import router from '@ohos.router’实现页面跳转

调试技巧

使用HiLog输出日志：

typescript
复制
import hilog from ‘@ohos.hilog’;
hilog.info(0x0000, ‘testTag’, ‘Test Log Message’);
真机调试：开启开发者模式（设置→关于手机→连续点击版本号7次）

三、应用测试（3-7天）
测试类型

单元测试：使用@ohos/hypium框架

UI测试：XTS自动化测试框架

兼容性测试：至少覆盖3款不同分辨率设备

云测试服务

使用华为提供的云真机测试服务

重点测试项目：

冷启动时间≤1.5秒

内存峰值≤系统限制的80%

无ANR（应用无响应）情况

四、应用签名（0.5天）
生成密钥

在DevEco Studio：Build → Generate Key

必填信息：

Alias：至少8字符，包含大小写字母

Validity：≥应用市场要求的25年（建议填30年）

申请证书

登录AppGallery Connect

进入「我的项目」→「应用签名」→上传生成的CSR文件

签名配置

json
复制
// build-profile.json5
{
“app”: {
“signingConfigs”: [{
“name”: “release”,
“material”: {
“certpath”: “cert/example.p12”,
“storePassword”: “",
“keyAlias”: “exampleKey”,
“keyPassword”: "”,
“signAlg”: “SHA256withECDSA”
}
}]
}
}
五、上架华为应用市场（3-7天）
材料准备

应用截图：5张（1242x2208px PNG）

隐私政策URL：必须独立页面

测试账号（如有登录功能）

版权证明（如涉及第三方内容）

提交流程

登录华为开发者联盟

进入「应用市场」→「我的应用」→「创建应用」

填写信息：

分类选择精确到三级目录

年龄分级需符合实际内容

上传签名的HAP包（通过Build → Build HAP生成）

审核要点

隐私合规：必须遵循《华为应用市场审核指南》4.7条款

权限最小化：禁止请求非必要权限

无后台自启动（需在config.json声明）

六、常见问题解决方案
签名失败

现象：INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES

解决：清理旧包 adb uninstall com.example.app

审核被拒高频原因

隐私政策未明确数据收集类型

应用描述含"beta"、"测试版"等字样

图标含华为Logo等侵权元素

性能优化建议

使用组件替代大量

滚动

复杂计算使用Worker线程

图片资源使用.webp格式

进阶建议
持续集成

配置DevEco CLI自动化构建：

bash
复制
npm install -g @ohos/hpm-cli
hpm build
关注更新

定期查看HarmonyOS版本动态

社区资源

官方论坛：https://developer.huawei.com/consumer/cn/forum/block/harmonyos

代码样例：https://gitee.com/harmonyos/codelabs

按照以上流程，通常可在1-2个月内完成从开发到上架的全流程。建议首次提交时预留至少5个工作日用于审核修改。