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

开发环境搭建(1-2天)

  1. 硬件准备

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

内存:8GB以上(推荐16GB)

硬盘:至少10GB可用空间

  1. 软件安装

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

  1. 安装时勾选:

    HarmonyOS SDK

    Node.js(自动集成)

    Ohpm(HarmonyOS包管理器)

  2. 环境验证

bash 复制代码
# 检查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个工作日用于审核修改。

相关推荐
Jalor1 小时前
Flutter 与 HarmonyOS NEXT | IAPKit(应用内支付服务)避坑指南
前端·flutter·harmonyos
__Benco4 小时前
OpenHarmony子系统开发 - DFX(三)
人工智能·harmonyos
学海无涯乐作舟5 小时前
鸿蒙开发踩坑记录 - 2024S2
harmonyos
__Benco14 小时前
OpenHarmony子系统开发 - DFX(一)
人工智能·harmonyos
90后的晨仔16 小时前
鸿蒙开发报错Argument of type '(item: ObjectData) => number' is not xxxx
harmonyos
HMS Core16 小时前
【FAQ】HarmonyOS SDK 闭源开放能力 —Push Kit(12)
华为·harmonyos
__Benco17 小时前
OpenHarmony子系统开发 - 安全(十)
人工智能·harmonyos
王喆18 小时前
跨平台全屏效果实现方案:HarmonyOS、Android与iOS实践总结
flutter·harmonyos
DADIAN_GONG19 小时前
incomplete command on Huawei switch
linux·运维·华为