> 技术文档 > 鸿蒙应用开发—鸿蒙app一键安装脚本_通过指令命令安装鸿蒙app

鸿蒙应用开发—鸿蒙app一键安装脚本_通过指令命令安装鸿蒙app


背景

鸿蒙App开发完后需要提测,如何将App文件发给QA安装测试,是一件麻烦事,因为鸿蒙App并不能像Android Apk那样可以直接安装到设备中,能想到的方式有:

  • 直接叫测试拿手机过来安装
  • 让测试安装DevEco Studio 拉代码编译安装

上面的方式显然是不可取的,鸿蒙App的安装过程相对复杂,需要手动执行一系列命令行操作,为了简化这个过程,可以通过一个脚本从而实现一键安装。如果再结合构建脚本,可以实现打包、发布、安装一条龙,减少中间手动环节。

当然官方也提供了邀请链接和DeepLink链接方式,但这两种方式是需要审核或者专业的>组织内部发布证书,对及时响应并不友好。

鸿蒙app一键安装脚本

可以像安卓一样在电脑上执行命令行来安装鸿蒙应用,支持在windows和mac上运行。

准备工作

使用前请确保你的电脑上已经安装并配置了环境变量:

  • Windows:Java JDK 17 或更高版本; Mac: Java JDK 11 或更高版本
  • Python 3

使用方法

安装脚本

命令:

python ohos-app-install.py   [签名文件下载链接]

参数:

  • 第1个参数:应用包名
  • 第2个参数:app文件路径,可以是网络链接,也可以是本地文件路径
  • 第3个参数:签名文件的下载链接,可选的,首次使用或更新签名时需要,有固定的格式。

例子:

python ohos-app-install.py com.hzw.dsbridge dsbrige-demo-default-unsigned.app https://gitee.com/common-apps/ohos_tools/raw/master/sign.zip

或者直接通过网络链接安装:

python ohos-app-install.py com.hzw.dsbridge https://gitee.com/common-apps/ohos-py/raw/master/dsbrige-demo-default-unsigned.app

sign.zip 的文件格式如下:

ohos-app-install.pysign├── sign-config.json # 配置文件└── yyy/ # 证书目录 └── xxx.cer └── xxx.p7b └── xxx.p12

sign-config.json 的文件格式如下:

{ \"configs\": [ { \"package_name\": \"com.hzw.dsbridge\", \"app_cert_file\": \"sign/yyy/xxx.cer\", \"profile_file\": \"sign/yyy/xxx.p7b\", \"keystore_file\": \"sign/yyy/xxx.p12\", \"key_alias\": \"hzw\", \"key_pwd\": \"h123456789\", \"keystore_pwd\": \"h123456789\" } ]}

注意:测试环境仅提供测试签名文件。在正式环境中,应用签名应该在服务器端完成以确保安全性。 签名文件除了命令行链接下载,还可以按照格式放在脚本同目录下 。

生成exe/unix执行文件 - 可选

如果想更方便的使用,可以将脚本转换为可执行文件,Windows和Mac都支持。

创建配置,在根目录创建confog.json,内容如下:

{ \"app_url\": \"\", \"package_name\": \"\", \"sign_url\": \"\"}

生成执行文件命令:

pyinstaller ohos-gen-app.spec

如果在执行pyinstaller命令时报错command not found: pyinstaller,则需要安装pyinstaller 执行pip3 install pyinstaller,在安装过程报错 error: externally-managed-environmen,可以在虚拟环境中安装,如下:

# 创建虚拟环境python3 -m venv venv# 激活虚拟环境source venv/bin/activate# 安装 pyinstallerpip install pyinstaller

源码

https://gitee.com/common-apps/ohos-py