hpack 简介

h-pack 是一个针对 HarmonyOS 的内测分发工具，一行命令完成鸿蒙应用的构建打包、签名、上传到阿里云 OSS 进行内测分发。

设计流程

1. 使用 hvigorw 构建出 hap 和 hsp 包
2. 使用 hap-sign-tool.jar 工具对 hap 和 hsp 包进行签名
3. 读取打包信息，生成一个未签名的manifest.json5文件
4. 使用manifest-sign-tool-1.0.0.jar工具对 manifest.json5文件验签生成新的文件
5. 生成一个index.html安装页面
6. 将上面生成的文件全部上传到 OSS, 分享https://xxx.oss.com/index.html进行分发测试

整个过程和 iOS 上差不多, 使用 Python 编写的脚本，代码也比较简单。

如何使用

1、预置环境：

DevEco-Studio 开发工具

JDK 17+： 签名工具需要。 java --version

python3.5+ ： hpack使用python

pip3：python的依赖包工具

阅读官方文档 - 搭建流水线

2 使用 hpack

直接拷贝 pack 文件夹到你的工程根目录下

在终端切换到 pack 目录，安装依赖

pack> pip3 install -r requirements.txt

3、修改默认配置

在 pack/sign 目录更换你的打包证书，如何申请内部测试证书

修改 config.py 配置文件

# 阿里云OSS配置
Access_key_id = 'your Access_key_id'
Access_key_secret = 'your Access_key_secret'
Endpoint = 'your Endpoint'
Bucket_name = 'your Bucket_name'
Bucket_dir = 'hpack'
Cname = 'your cname'

# 应用名称和图标
AppName = 'hpack'
AppIcon = f"https://{Cname}/xx/AppIcon.png"

# 打包签名配置 
PackDir = 'pack'
SignDir = 'sign'
Cert = os.path.join(PackDir, SignDir, 'release.cer') 
Profile = os.path.join(PackDir, SignDir, 'test_release.p7b')  
Keystore =  os.path.join(PackDir, SignDir, 'harmony.p12') 
Alias = 'your key alias'
KeyPwd = 'your key password'
KeystorePwd = 'your store password'

4、在工程根目录执行脚本

需要使用 DevEco-Studio 自带的自终端， 其他的得去配置 hvigorw 的环境变量

Linux / Mac :

> python3 ./pack/main.py 这里写您的更新说明可空

Windows :

> python3 .\pack\main.py 这写您的更新说明可空

5、运行

• 终端运行

• 执行成功

• 分发的 index.html 页面

• 在oss中查看上传的包

Tips:

1、如果已安装的 App 和准备要安装的 App 打包证书不一致，需先卸载已安装的 App 。

2、安装时鸿蒙会进行联网校验，手机如果开了代理需要注意下。

3、安装出错时会有提示，根据错误码找原因。错误码说明。

4、如果您直接使用本工程做测试，还需要修改 app.json5 里的 bundleName。

5、hap/hsp 包签名工具 和 manifest.json5 验签工具，如果官方有更新，需自行替换。

6、python 执行生成缓存的文件，可在 .gitigore 文件中添加忽略，或者使用python3 -B pack/main.py

.gitigore 文件
# 忽略 __pycache__ 目录
__pycache__/

如果有帮助到您，欢迎 star