提交 26846a08 编写于 作者: D DCloud_MQ

docs: 修改 tutorial/run/run-app-harmony.md

上级 a644e536
......@@ -12,22 +12,27 @@ HX 里面有两个与鸿蒙相关的功能入口:
只有正确配置了这个选项,后续的功能才能正常执行。
## 操作过程
## 执行过程
在一个 uni-app 项目中点击鸿蒙的运行或发行菜单后,HX 会检查 `harmony-configs` 目录内容的完整性,如果目录不存在或者里面缺少文件,会自动添加进去作为默认配置,已有的文件不会被覆盖。
在构建过程中,会在 `unpackage` 目录下生成鸿蒙工程目录,并把 `harmony-configs` 目录下的所有文件覆盖到这里,uni-app 项目编译的结果也会输出到这里。
然后 HX 会对这个鸿蒙工程目录进行构建、打包、签名,如果是运行的话,会把生成的 `.hap` 安装到选定的鸿蒙设备上并启动运行,如果是发行则最终生成 `.app` 安装包。
在一个 uni-app 项目中点击鸿蒙的运行或发行菜单后,HX 在完成对 uni-app 项目的编译后,会根据内置的鸿蒙工程模板在 `unpackage` 目录下游准备好一个鸿蒙工程目录,
并把 `harmony-configs` 目录下的所有文件覆盖到这里,再把编译产物按要求组装到这里,然后再调用鸿蒙工具链对这个鸿蒙工程目录进行构建、打包、签名等操作。
如果是运行的话,会把生成的 `.hap` 安装到选定的鸿蒙设备上并启动运行,如果是发行则最终生成 `.app` 安装包。
## 配置@configs
项目的根目录下有一个 `harmony-configs` 目录,每当执行跟鸿蒙相关的操作时,HX 都会检查这个目录,如果目录不存在则会自动创建。
新版本(4.29+)还会检查与 HX 当前版本的内置鸿蒙工程模板是否匹配,如果版本不匹配(比如 HX 升级到新版本时)则会提示用户把需要更新的内容合并到目录中。
所有属于鸿蒙工程的配置调整,都可以写在 `harmony-configs` 目录下,具体内容可以参照鸿蒙的相关文档。其中常用内容有:
- 应用包名
在 `harmony-configs/AppScrope/app.json5` 中修改 `app.bundleName`
- 运行权限
在 `harmony-configs/entry/src/main/module.json5` 中修改 `module.requestPermissions`
- 数字签名证书相关信息
在 `harmony-configs/build-profile.json5` 中修改 `signingConfigs`
......@@ -85,7 +90,7 @@ HX 里面有两个与鸿蒙相关的功能入口:
有记录显示,在 Windows 系统下,运行到鸿蒙时如果选择模拟器作为运行设备,可能会出现超时的情况,原因尚不清楚,有可能与模拟器系统里存在以前安装的相同包名的应用有关,
如遇这种情况,可以尝试手工在模拟器里面删除旧的应用然后重试。
## 关于数字签名证书的配置@singing
## 关于数字签名证书的配置@signing
如前所述,如果业务代码用到了 ACL 权限,那么就需要申请并配置一个**调试证书**用于数字签名。
另外,在发行安装包的时候,一定需要配置一个**发布证书**,否则只能拿到一个未签名的安装包,是无法实际使用的。
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册