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

news2025/4/3 3:08:01

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

硬件准备

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

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

硬盘：至少10GB可用空间

软件安装

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

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

# 检查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天）
材料准备