从零开始开发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个工作日用于审核修改。

相关推荐
猫林老师6 小时前
HarmonyOS分布式数据库深度应用
harmonyos
我是华为OD~HR~栗栗呀7 小时前
华为OD-Java面经-21届考研
java·c++·后端·python·华为od·华为·面试
LucianaiB8 小时前
【成长纪实】从“Hello World”到分布式实战的进阶之路
harmonyos·鸿蒙·成长纪实
万添裁9 小时前
基于ArkAnalyzer的HarmonyOS通用API多端安全性分析工具
harmonyos·ark
无风听海9 小时前
HarmonyOS之启动应用内的UIAbility组件
前端·华为·harmonyos
Bert丶seven10 小时前
鸿蒙Harmony实战开发教学(No.8)-Hyperlink超链接组件基础到进阶篇
华为·harmonyos·arkts·arkui·1024程序员节·开发教程
JohnnyDeng9411 小时前
ArkTs-Android 与 ArkTS (HarmonyOS) 存储目录全面对比
android·harmonyos·arkts·1024程序员节
王嘉俊92512 小时前
HarmonyOS 超级终端与服务卡片开发:打造无缝多设备交互体验
华为·架构·harmonyos·arkts·1024程序员节
俩毛豆13 小时前
【图片】【编缉】图片增加水印(通过组件的Overlay方法增加水印)
前端·harmonyos
逻极16 小时前
HarmonyOS 5 鸿蒙多设备适配与分布式开发指南
分布式·华为·harmonyos·鸿蒙