Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-zh
提交
c2368706
unidocs-zh
项目概览
DCloud
/
unidocs-zh
通知
3172
Star
105
Fork
804
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
93
列表
看板
标记
里程碑
合并请求
67
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
93
Issue
93
列表
看板
标记
里程碑
合并请求
67
合并请求
67
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
提交
c2368706
编写于
11月 18, 2024
作者:
辛宝Otto
🥊
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
Docs/add mp harmony
上级
205498f2
变更
2
隐藏空白更改
内联
并排
Showing
2 changed file
with
104 addition
and
0 deletion
+104
-0
docs/collocation/manifest.md
docs/collocation/manifest.md
+13
-0
docs/tutorial/mp-harmony/intro.md
docs/tutorial/mp-harmony/intro.md
+91
-0
未找到文件。
docs/collocation/manifest.md
浏览文件 @
c2368706
...
...
@@ -625,6 +625,19 @@ Tips:关于摇树优化(treeShaking)原理及优化结果,参考:[http
|:-|:-|:-|
|subPackages|Boolean|是否开启分包优化|
### 鸿蒙元服务项目设置@mp-harmony
|属性|类型|说明|
|:-|:-|:-|
|distribute|Object|分发配置|
#### distribute 选项
|属性|类型|说明|
|:-|:-|:-|
|bundleName|String|元服务包名|
### 自定义小程序项目配置
HBuilderX 3.6.16+ 支持项目根目录(cli 项目为 src 目录)下创建配置文件自定义小程序项目配置。平台对应文件名如下:
...
...
docs/tutorial/mp-harmony/intro.md
0 → 100644
浏览文件 @
c2368706
# 概述
从
`HBuilderX 4.34`
版本开始,uni-app 支持
**鸿蒙元服务**
平台应用开发。
目前仅支持 Vue3 项目编译到鸿蒙元服务平台,Vue2 项目升级 Vue3 项目请参考:
[
vue2 项目迁移到 vue3
](
../migration-to-vue3.md
)
欢迎加入
[
uni-app鸿蒙化技术交流群
](
https://im.dcloud.net.cn/#/?joinGroup=668685db8185e1e6e7b7b15e
)
进行交流。
## 前置准备
### 开发环境准备
-
HBuilderX 4.34+
[
下载地址
](
https://www.dcloud.io/hbuilderx.html
)
-
DevEco-Studio 5.0.5.200+
[
下载地址
](
https://developer.huawei.com/consumer/cn/download/
)
### 鸿蒙新手指引
鸿蒙元服务和鸿蒙应用开发流程相似,如果你是第一次安装鸿蒙 DevEco-Studio 和鸿蒙模拟器,可以参考
[
uni-app 开发鸿蒙应用环境要求
](
../harmony/runbuild
)
进行环境配置。
如果可以在模拟器、鸿蒙真机运行官方 Hello World 示例,说明相关环境、证书配置完成。
### 元服务 appid 注册
元服务的开发和上架需要使用元服务的包名 BundleName,包名的形式
`com.atomicservice.[你的应用包名]`
。
如果还没有创建元服务,访问
[
华为 AppGallery Connect
](
https://developer.huawei.com/consumer/cn/service/josp/agc/index.html#/myApp
)
完成元服务应用的注册,得到相关包名。
## 运行与调试
在 HBuilderX 运行 uni-app 项目到元服务分成四个步骤:
1.
配置
`manifest.json`
文件。
2.
配置签名证书。
3.
配置权限模版。
4.
项目启动。
下面进行详细说明。
### 1. 配置 manifest.json 文件
项目运行需要配置元服务包名,打开项目根目录的
`mainefest.json`
填写
`鸿蒙元服务配置 - 应用包名`
,结构类似
`com.atomicservice.[你的应用包名]`
。
### 2. 配置签名证书
项目运行到模拟器、真机需要配置签名证书。签名证书的配置和鸿蒙应用开发类似,请参考
[
鸿蒙证书签名配置指南
](
/tutorial/harmony/runbuild.html#signature
)
进行证书签名。
项目根目录创建
`harmony-as-configs/build-profile.json5`
文件,将元服务原生项目中的
`build-profile.json5`
文件内容复制。
### 3. 配置权限模版
鸿蒙元服务需要获取使用特定的能力,比如元服务登录、震动、获取网络状态等原生提供的能力,需要配置权限模版。
项目根目录创建
`harmony-as-configs/entry/src/main/module.json5`
文件。将元服务原生项目中的
`entry/src/main/module.json5`
的内容复制填充。HBuilderX 在构建时候会识别替换相关文件。
具体的鸿蒙元服务权限列表可以参考
[
鸿蒙对所有应用开放的权限清单
](
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/permissions-for-all-V5
)
进行查询。
### 4. 项目启动
选择
`运行 - 运行到小程序模拟器 - 鸿蒙元服务`
,在弹出的鸿蒙设置选择框中选择模拟器。
等待构建完成后,即可进行元服务开发和运行。
## 发行与上架
在 HBuilderX 中开发 uni-app 上架到鸿蒙元服务需要下面 4 个步骤:
1.
授权 uni-app 协助上架。
2.
配置发行签名证书。
3.
应用打包。
4.
等待上架审批通知。
下面进行详细说明。
### 1. 配置发行签名证书
开发调试期间的证书不可用于应用上架。元服务发布证书的申请流程和鸿蒙应用开发类似,访问
[
鸿蒙发布元服务文档
](
https://developer.huawei.com/consumer/cn/doc/app/agc-help-harmonyos-releaseservice-0000001946273965
)
进行发布证书的获取。
### 2. 应用打包
在 HBuilderX 中选择
`发行 - 鸿蒙元服务`
,进行元服务打包。等待打包完成,得到 app 后缀文件。
## 备注事项
### 发布报错 `hvigor ERROR: Invalid storeFile value. Make sure it is not null or empty. The file must be included`
构建时候证书缺少或者配置不对。参考
[
鸿蒙发布元服务
](
https://developer.huawei.com/consumer/cn/doc/app/agc-help-harmonyos-releaseservice-0000001946273965
)
进行证书申请。
## 版本变更
HBuilderX 4.34 适配鸿蒙元服务
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录