Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-zh
提交
cfa75f69
unidocs-zh
项目概览
DCloud
/
unidocs-zh
通知
3209
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看板
提交
cfa75f69
编写于
11月 25, 2024
作者:
辛宝Otto
🥊
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
feat: mp-harmony 访问线上依赖
上级
d03d5979
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
48 addition
and
36 deletion
+48
-36
docs/tutorial/mp-harmony/intro.md
docs/tutorial/mp-harmony/intro.md
+48
-36
未找到文件。
docs/tutorial/mp-harmony/intro.md
浏览文件 @
cfa75f69
...
...
@@ -19,6 +19,54 @@
-
HBuilderX 4.34+
[
下载地址
](
https://www.dcloud.io/hbuilderx.html
)
-
DevEco-Studio 5.0.5.200+
[
下载地址
](
https://developer.huawei.com/consumer/cn/download/
)
#### 主动安装元服务依赖
元服务在编译过程中,依赖鸿蒙提供的
`@atomicservice/ascf-toolkit`
npm 包,请确保已全局安装成功,安装命令如下:
```
shell
npm
install
-g
@atomicservice/ascf-toolkit
--registry
=
https://registry.npmmirror.com
```
这一步骤是为了规避下载 npm 失败,导致编译失败。
#### DevEco-Studio 5.0.5.200 临时修复错误
在 DevEco-Studio 5.0.5.200 版本中,运行元服务需要手动修改两个文件,后续等待 DevEco-Studio 修复此问题,在升级之前,目前需要手动修复。后续文档也会持续跟踪此问题。
首先打开 DevEco-Studio 安装目录。
1.
修改 process-profile.js 文件,位置定位
`tools/hvigor/hvigor-ohos-plugin/src/tasks/process-profile.js`
这是一个压缩混淆的文件,请备份后小心修改。
搜索
`e.module.dependencies=this._dependencies,`
替换为
`/* e.module.dependencies=this._dependencies, */`
也就是手动注释这一行代码。
2.
修改 task-service.js,位置定位
`tools/hvigor/hvigor-ohos-plugin/src/tasks/service/task-service.js`
这是一个压缩混淆的文件,请备份后小心修改。
搜索
```does not exist oh_modules.`);```
替换为
```does not exist oh_modules.`);if(!o){return;}```
也就是追加了一行
`if(!o){return;}`
代码。
修改完这两个文件,重启 DevEco 编辑器后生效。请注意这是临时兼容方案,后续 DevEco 会升级解决。
#### 确保存在 `com.huawei.hms.ascf`
在连接鸿蒙真机的情况下,执行
`hdc shell bm dump-shared -a`
观察返回值是否包含
`com.huawei.hms.ascf`
,这是一个 uni-app 运行元服务必需的一个基础包,目前鸿蒙真机还未内置此基础包。
如果返回值里不包含
`com.huawei.hms.ascf`
,你需要打开华为应用市场,搜索
`helloUniApp`
并打开应用,稍等片刻,重新执行
`hdc shell bm dump-shared -a`
观察返回值。此时应该已经存在
`com.huawei.hms.ascf`
了。
```
shell
hdc shell bm dump-shared
-a
# com.huawei.hms.ascf
```
访问线上 helloUniApp 的作用是下载相关基础依赖,确保本机存在相关基础包。后续鸿蒙系统升级后会解决该问题,本文档也会持续关注测问题。
### 元服务 appid 注册@register-app-id
元服务的开发和上架需要使用元服务的包名 BundleName,包名的形式
`com.atomicservice.[你的 APPID]`
。
...
...
@@ -69,40 +117,6 @@
1.
根目录
`build-profile.json5`
- 证书签名参数等。后续元服务的开发运行、发布上架依赖此文件。
2.
`entry/src/main/module.json5`
- 项目权限配置、metadata 信息配置,元服务设置权限,比如访问网络、位置定位、手机震动等功能依赖此文件。
### 主动安装元服务依赖
元服务在编译过程中,依赖鸿蒙提供的
`@atomicservice/ascf-toolkit`
npm 包,请确保已全局安装成功,安装命令如下:
```
shell
npm
install
-g
@atomicservice/ascf-toolkit
--registry
=
https://registry.npmmirror.com
```
这一步骤是为了规避下载 npm 失败,导致编译失败。
### DevEco-Studio 5.0.5.200 临时修复错误
在 DevEco-Studio 5.0.5.200 版本中,运行元服务需要手动修改两个文件,后续等待 DevEco-Studio 修复此问题,在升级之前,目前需要手动修复。后续文档也会持续跟踪此问题。
首先打开 DevEco-Studio 安装目录。
1.
修改 process-profile.js 文件,位置定位
`tools/hvigor/hvigor-ohos-plugin/src/tasks/process-profile.js`
这是一个压缩混淆的文件,请备份后小心修改。
搜索
`e.module.dependencies=this._dependencies,`
替换为
`/* e.module.dependencies=this._dependencies, */`
也就是手动注释这一行代码。
2.
修改 task-service.js,位置定位
`tools/hvigor/hvigor-ohos-plugin/src/tasks/service/task-service.js`
这是一个压缩混淆的文件,请备份后小心修改。
搜索
```does not exist oh_modules.`);```
替换为
```does not exist oh_modules.`);if(!o){return;}```
也就是追加了一行
`if(!o){return;}`
代码。
修改完这两个文件,重启 DevEco 编辑器后生效。请注意这是临时兼容方案,后续 DevEco 会升级解决。
## 运行与调试
在 HBuilderX 运行 uni-app 项目到元服务分成四个步骤:
...
...
@@ -208,8 +222,6 @@ npm install -g @atomicservice/ascf-toolkit --registry=https://registry.npmmirror
定位到
`app.signingConfigs[0]`
字段,修改
`material`
为发行证书路径。
### 3. 应用打包
在 HBuilderX 中选择
`发行 - 鸿蒙元服务`
,进行元服务打包。等待打包完成,会提示上传完成。接下来到 DCloud开发者中心完善上架资料。
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录