Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-zh
提交
6a07ef85
unidocs-zh
项目概览
DCloud
/
unidocs-zh
通知
3211
Star
106
Fork
815
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
94
列表
看板
标记
里程碑
合并请求
70
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
94
Issue
94
列表
看板
标记
里程碑
合并请求
70
合并请求
70
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
提交
6a07ef85
编写于
11月 18, 2024
作者:
辛宝Otto
🥊
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
docs: 补充相关图片说明
(cherry picked from commit
2a4695f2
)
上级
815fb4db
变更
1
显示空白变更内容
内联
并排
Showing
1 changed file
with
45 addition
and
4 deletion
+45
-4
docs/tutorial/mp-harmony/intro.md
docs/tutorial/mp-harmony/intro.md
+45
-4
未找到文件。
docs/tutorial/mp-harmony/intro.md
浏览文件 @
6a07ef85
...
@@ -40,37 +40,72 @@
...
@@ -40,37 +40,72 @@
项目运行需要配置元服务包名,打开项目根目录的
`mainefest.json`
填写
`鸿蒙元服务配置 - 应用包名`
,结构类似
`com.atomicservice.[你的应用包名]`
。
项目运行需要配置元服务包名,打开项目根目录的
`mainefest.json`
填写
`鸿蒙元服务配置 - 应用包名`
,结构类似
`com.atomicservice.[你的应用包名]`
。
![
配置 manifest.json 文件
](
https://web-ext-storage.dcloud.net.cn/uni-app/harmony/f7a94969-59d3-42ad-84be-adf5bcadcd54.png
)
### 2. 配置签名证书
### 2. 配置签名证书
项目运行到模拟器、真机需要配置签名证书。签名证书的配置和鸿蒙应用开发类似,请参考
[
鸿蒙证书签名配置指南
](
/tutorial/harmony/runbuild.html
#signature
)
进行证书签名。
项目运行到模拟器、真机需要配置签名证书。签名证书的配置和鸿蒙应用开发类似,请参考
[
鸿蒙证书签名配置指南
](
../harmony/runbuild.md
#signature
)
进行证书签名。
项目根目录创建
`harmony-as-configs/build-profile.json5`
文件,将元服务原生项目中的
`build-profile.json5`
文件内容复制。
项目根目录创建
`harmony-as-configs/build-profile.json5`
文件,将元服务原生项目中的
`build-profile.json5`
文件内容复制。
![
配置签名证书
](
https://web-ext-storage.dcloud.net.cn/uni-app/harmony/25329a0f-75bf-4812-8efc-3ada29e4ae23.png
)
### 3. 配置权限模版
### 3. 配置权限模版
鸿蒙元服务需要获取使用特定的能力,比如元服务登录、震动、获取网络状态等原生提供的能力,需要配置权限模版。
鸿蒙元服务需要获取使用特定的能力,比如元服务登录、震动、获取网络状态等原生提供的能力,需要配置权限模版。
项目根目录创建
`harmony-as-configs/entry/src/main/module.json5`
文件。将元服务原生项目中的
`entry/src/main/module.json5`
的内容复制填充。HBuilderX 在构建时候会识别替换相关文件。
项目根目录创建
`harmony-as-configs/entry/src/main/module.json5`
文件。将元服务原生项目中的
`entry/src/main/module.json5`
的内容复制填充。HBuilderX 在构建时候会识别替换相关文件。
![](
https://web-ext-storage.dcloud.net.cn/uni-app/harmony/1206d3f5-5789-4856-b1e3-3928e6c01995.png
)
具体的鸿蒙元服务权限列表可以参考
[
鸿蒙对所有应用开放的权限清单
](
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/permissions-for-all-V5
)
进行查询。
具体的鸿蒙元服务权限列表可以参考
[
鸿蒙对所有应用开放的权限清单
](
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/permissions-for-all-V5
)
进行查询。
### 4. 项目启动
### 4. 项目启动
选择
`运行 - 运行到小程序模拟器 - 鸿蒙元服务`
,在弹出的鸿蒙设置选择框中选择模拟器。
选择
`运行 - 运行到小程序模拟器 - 鸿蒙元服务`
,在弹出的鸿蒙设置选择框中选择模拟器或者真机。
![
运行鸿蒙元服务
](
https://web-ext-storage.dcloud.net.cn/uni-app/harmony/48d95bfd-418d-4dfd-8715-b03c8d9841f1.png
)
![
选择模拟器
](
https://web-ext-storage.dcloud.net.cn/uni-app/harmony/00014bd7-d578-4451-92d1-94f4cbbc52a3.png
)
等待构建完成后,即可进行元服务开发和运行。
等待构建完成后,控制台提示:
> 安装成功
>
> 在鸿蒙设备上启动运行 .hap ...
>
> 运行成功
同时模拟器或者真机页面更新,即可进行元服务开发和运行。
## 发行与上架
## 发行与上架
鸿蒙元服务的上架,依赖上一步骤
**运行与调试**
的运行。
在 HBuilderX 中开发 uni-app 上架到鸿蒙元服务需要下面 4 个步骤:
在 HBuilderX 中开发 uni-app 上架到鸿蒙元服务需要下面 4 个步骤:
1.
授权
uni-app 协助上架。
1.
授权
DCloud 完成上架流程
2.
配置发行签名证书。
2.
配置发行签名证书。
3.
应用打包。
3.
应用打包。
4.
等待上架审批通知。
4.
等待上架审批通知。
下面进行详细说明。
下面进行详细说明。
### 1. 授权 DCloud 完成上架流程
点击
[
鸿蒙第三方授权链接
](
https://developer.huawei.com/consumer/cn/service/josp/agc/index.html#/authorization?clientId=1553077832379297600&type=1
)
打开下面页面:
第一步:
![](
https://web-ext-storage.dcloud.net.cn/uni-app/harmony/f4f354d9-bfe0-4a75-aaa5-65ca66882316.png
)
第二步:
![](
https://web-ext-storage.dcloud.net.cn/uni-app/harmony/fd9c19a8-40e5-482f-a94c-b527cd8952f8.png
)
选择你要上架的元服务,授权 DCloud 完成后续的上架流程。
### 1. 配置发行签名证书
### 1. 配置发行签名证书
开发调试期间的证书不可用于应用上架。元服务发布证书的申请流程和鸿蒙应用开发类似,访问
[
鸿蒙发布元服务文档
](
https://developer.huawei.com/consumer/cn/doc/app/agc-help-harmonyos-releaseservice-0000001946273965
)
进行发布证书的获取。
开发调试期间的证书不可用于应用上架。元服务发布证书的申请流程和鸿蒙应用开发类似,访问
[
鸿蒙发布元服务文档
](
https://developer.huawei.com/consumer/cn/doc/app/agc-help-harmonyos-releaseservice-0000001946273965
)
进行发布证书的获取。
...
@@ -80,12 +115,18 @@
...
@@ -80,12 +115,18 @@
在 HBuilderX 中选择
`发行 - 鸿蒙元服务`
,进行元服务打包。等待打包完成,得到 app 后缀文件。
在 HBuilderX 中选择
`发行 - 鸿蒙元服务`
,进行元服务打包。等待打包完成,得到 app 后缀文件。
## 备注事项
## 备注事项
### 发布报错 `hvigor ERROR: Invalid storeFile value. Make sure it is not null or empty. The file must be included`
### 发布报错 `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
)
进行证书申请。
构建时候证书缺少或者配置不对。参考
[
鸿蒙发布元服务
](
https://developer.huawei.com/consumer/cn/doc/app/agc-help-harmonyos-releaseservice-0000001946273965
)
进行证书申请。
### 发行报错 hvigor ERROR: Unable to find the product 'release'.
调整
`build-profile.json5`
## 版本变更
## 版本变更
HBuilderX 4.34 适配鸿蒙元服务
HBuilderX 4.34 适配鸿蒙元服务
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录