From 59e041cdcd5458064574f6119bce5f608b408713 Mon Sep 17 00:00:00 2001 From: jixinbao Date: Fri, 20 Dec 2024 20:26:35 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E8=A1=A5=E5=85=85=E6=98=93=E9=94=99?= =?UTF-8?q?=E7=82=B9=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/tutorial/mp-harmony/intro.md | 40 +++++++++++++++++++++---------- 1 file changed, 27 insertions(+), 13 deletions(-) diff --git a/docs/tutorial/mp-harmony/intro.md b/docs/tutorial/mp-harmony/intro.md index d89099d1e..b9bd239c3 100644 --- a/docs/tutorial/mp-harmony/intro.md +++ b/docs/tutorial/mp-harmony/intro.md @@ -101,6 +101,8 @@ 在文件中搜索 `useNormalizedOHMUrl` 将值设置为 false。 +**注意：** 考虑到很多用户不会修改配置，这里提供一个模版，强烈建议新手用户基于 [这个模版](https://web-ext-storage.dcloud.net.cn/uni-app/harmony/build-profile.json5) 修改，只替换签名部分即可。 + ![配置签名证书](https://web-ext-storage.dcloud.net.cn/uni-app/harmony/116bc7de-00e0-4250-ac78-508b2dfa803f.png) ### 3. 配置 `module.json5` @@ -111,14 +113,14 @@ 确保在 `module` 字段内，存在下面三个字段，如果不存在需要添加，不添加可能会让元服务运行闪退。 -请务必注意：这三个字段添加到 module 内部，保证 `srcEntry` 出现里两次。 +请务必注意：这三个字段添加到 `module` 内部，保证 `srcEntry` 出现里两次。 ```json -"srcEntry": "./ets/abilitystage/AbilityStage.ets", +"srcEntry": "./ets/abilitystage/AbilityStage.ets", // 此时页面有两个 srcEntry "metadata": [ { "name": "appgallery_privacy_hosted", - "value": "1" + "value": "1" // 默认开启系统隐私弹窗，建议开启无需编写页面 }, { "name": "app_id", @@ -215,19 +217,17 @@ ### 2. 确认分享承诺 -点击 [鸿蒙原生应用激励分享承诺函](https://developer.huawei.com/consumer/cn/verified/incentiveAuth)，如下图选择本次计划上架的应用（元服务），服务商字段搜索“数字天堂”并选择，勾选“我已阅读”，点击提交，完成激励分享。 +点击 [鸿蒙原生应用激励分享承诺函](https://developer.huawei.com/consumer/cn/verified/incentiveAuth)，如下图选择本次计划上架的应用（元服务），服务商字段输入“数字天堂”并选择，勾选“我已阅读”，点击提交，完成激励分享。 ![](https://web-ext-storage.dcloud.net.cn/doc/harmony-os-next/harmony-incentiveAuth.png) -**注意：必须完成分享承诺，才有机会拿到奖励金；** +**注意：必须完成分享承诺，才有机会拿到奖励金；** ### 3. 配置发行签名证书 开发调试期间的证书不可用于应用上架。元服务发布证书的申请流程和鸿蒙应用开发类似，访问 [鸿蒙发布元服务文档](https://developer.huawei.com/consumer/cn/doc/app/agc-help-harmonyos-releaseservice-0000001946273965) 进行发布证书的获取。 -**注意**：目前发布上架暂不支持多产物，意思是手动调整 `harmony-mp-configs/build-profile.json5`： - -定位到 `app.signingConfigs[0]` 字段，修改 `material` 为发行证书路径，确保签名证书只有一出定义，也就是 default。后续版本会解决多产物处理。 +修改 `build-profile.json5` 里的 release 证书签名。务必注意调试和发行证书是两套，不能混用。 ### 4. 应用打包 @@ -328,7 +328,7 @@ 还需要在配置网络访问白名单： - 临时方案。进入手机 - 设置 - 系统 - 开发者选项（如果未开启 关于手机 - 软件版本连续点击开启） - 开发中元服务豁免管控，选择开启后，可以自由调试。 -- 稳定方案。整理 web-view 需要用到的相关域名，进入[华为AppGallery Connect 后台](https://developer.huawei.com/consumer/cn/service/josp/agc/index.html#/) - 我的项目 - 开发管理 - 域名设置 - 服务器域名 - httpRequest 合法域名。按照提示进行填写。 +- 稳定方案。整理 web-view 需要用到的相关域名，进入[华为AppGallery Connect 后台](https://developer.huawei.com/consumer/cn/service/josp/agc/index.html#/) - 我的项目 - 开发管理 - 域名设置 - 服务器域名 - httpRequest 合法域名。按照提示进行填写。填写完成后打开 手机设置 - 应用与元服务，删掉正在开发的元服务，重新启动应用。 ![](https://web-ext-storage.dcloud.net.cn/uni-app/harmony/49323643-31f5-4f95-80b2-87157c9a06d5.png) @@ -336,18 +336,28 @@ 同上，发送网络请求报错的解决方案。 -### 组件 打开 map 地图无法展示 +### 组件 打开 map 地图无法展示、API 位置相关使用报错 -Map 和相关定位需要 [华为AppGallery Connect 后台](https://developer.huawei.com/consumer/cn/service/josp/agc/index.html#/) 进行权限申请。具体可以参考 [鸿蒙 Map Kit 开发准备](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/map-config-agc-V5)，开通地图服务。 +Map 和相关定位需要 [华为AppGallery Connect 后台](https://developer.huawei.com/consumer/cn/service/josp/agc/index.html#/) 进行权限申请。具体可以参考 [鸿蒙 Map Kit 开发准备](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/map-config-agc-V5)，在 项目设置 - API 管理开启定位服务、位置服务、地图服务。 + +在 `harmony-mp-configs/entry/src/main/module.json5` 在 `requestPermissions` 字段里添加 `ohos.permission.LOCATION` 和 `ohos.permission.APPROXIMATELY_LOCATION` 两条记录。 ### API 登录 uni.login 获取 code 报错 -参考[鸿蒙 Account Kit 开发准备](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/account-config-permissions-V5#section132012717318) 设置相关权限，添加 scope 权限 +参考[鸿蒙 Account Kit 开发准备](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/account-config-permissions-V5#section132012717318) 设置相关权限，添加 scope 权限。 + +易错点： + 1. 签名证书不能是自动签名，设置的是 agc 上下载的调试证书 + 2. `mp-configs/entry/src/main/modueljson5` 里有个 metadata cliend_id 确保值正确。 + 3. AGC 后台配置了指纹，添加了证书。 + +具体写法可以参考 [华为元服务登录](https://gitcode.net/dcloud/hello_uni-id-pages/-/tree/dev/pages/index) 开源代码进行参考。欢迎使用 [uni-id-pages](https://doc.dcloud.net.cn/uniCloud/uni-id/app.html) 插件加速元服务开发落地。 ### API 获取网络类型失败、手机震动不等效 需要 `GET_NETWORK_INFO` 和 `vibrate` 权限。具体的鸿蒙元服务权限列表可以参考 [鸿蒙对所有应用开放的权限清单](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/permissions-for-all-V5) 进行查询。按照 **配置权限模版** 章节进行配置。 + ### 组件 rich-text 渲染空白不展示 已修复。动态更新 `rich-text` 的 `nodes` 数据时候，内容不会更新。可以临时通过给 rich-text 添加 v-if 控制显隐，在 nextTick 中动态切换生效。 @@ -476,4 +486,8 @@ XXX元服务当前正在进行鸿蒙化开发，由于样机不足等，特申 按照文档操作，简单来说可以分成三个步骤： 1. 确认插入了设备执行 `hdc shell "cat /proc/net/unix | grep devtools"` 记录返回数据尾部的数字部分 2. 转发端口 `hdc fport tcp:9222 localabstract:webview_devtools_remote_[刚才的数字部分]` 返回 OK - 3. 打开浏览器 `chrome://inspect/#devices` 观察 Remoet Target 进行调试。 \ No newline at end of file + 3. 打开浏览器 `chrome://inspect/#devices` 观察 Remoet Target 进行调试。 + +### API uploadFile 报错，其他端正常 + +已知问题，等下修复。观察上传参数里是否有数字类型参数，强转为字符串。 \ No newline at end of file -- GitLab