# 清华源
pip install -i https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple harmony-hpack

# 阿里源
pip install -i https://mirrors.aliyun.com/pypi/simple harmony-hpack

# 腾讯源
pip install -i https://mirrors.cloud.tencent.com/pypi/simple harmony-hpack

# 官方源
pip install -i https://pypi.org/simple harmony-hpack

# 验证安装
hpack -h

# 升级
pip install --upgrade harmony-hpack

# 卸载
pip uninstall harmony-hpack

# 配置镜像源
pip config set global.index-url https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple

class Config: 
    # 安装包存放的服务器的域名 
    DeployDomain =  static.hpack.com 

    # 安装包存放的服务器地址，必须是 https
    BaseURL = f"https://{DeployDomain}/hpack"
    
    # 应用信息 
    AppIcon = f"{BaseURL}/AppIcon.png"
    AppName =  hpack 
    Badge =  鸿蒙版 
    
    # index模板选择, 可选值为 [default, simple, tech, cartoon, tradition, custom]
    # 如果是 custom，则表明自定义模板，需要自己在 hpack 目录写一个 index.html，
    # 打包完成后进行内容填充，再写入 hpack/build/{product} 目录
    IndexTemplate = "default" 
    
    # 打包签名配置 
    Alias =  your key alias 
    KeyPwd =  your key password 
    KeystorePwd =  your store password 
    # 替换 hapck/sign 目录下的证书文件
    SignDir =  sign 
    Cert = os.path.join(SignDir,  release.cer ) 
    Profile = os.path.join(SignDir,  test_release.p7b )  
    Keystore =  os.path.join(SignDir,  harmony.p12 )
  
    # 以下是 v1.0.1 新增自定义构建配置 ===================
    # 从v1.0.0升级上来的，可自行加上
    
    # 设置默认打包 product
    # 优先使用这个指定的 product。
    # 不设置，则通过读 build-prodile.json5 获取，存在多个时，打包前会提示选择
    Product = ""  
    
    # 编译模式，默认是 debug 模式，release 模式需要设置为False
    Debug = True  
    
    # 用于完全自定义 hvigorw 构建命令，配置后 Product、Debug 无效
    # hvigorw 使用 https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-hvigor-commandline
    # 使用示例：
    # [
    #     hvigorw ,  assembleHap ,  assembleHsp , 
    #     --mode ,  module , 
    #     -p ,  product=default , 
    #     -p ,  debuggable=true ,
    #     --no-daemon 
    # ]
    HvigorwCommand = []

安装依赖：
​“`bash
pip3 install oss2

**配置 OSS：**
打开 `Packfile.py` 完成配置：

​```python
class OSSConfig: 
    # 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 

如果使用其他服务器，需要在didPack中编写上传代码：

def didPack(packInfo):
    """打包后回调，一般在这里上传打包结果到服务器"""
    # 打包结果在 hpack/build/{product}，编写你的上传逻辑
    pass

hpack -h  # 或 hpack help

命令分类：

查看命令

执行命令

安装打包产物

# 安装指定 product 的产物
hpack i -myproduct  # 注意加上横杠(-)

安装已签名包

# 安装 .app 文件
hpack i ./xx.app

# 安装 .hap 文件  
hpack i ./xx.hap

# 安装目录下所有包
hpack i ./build/default

基本语法

hpack sign,s <unsignedPath> <certPath>

使用示例

# 签名 .app 文件
hpack s ./xx.app ./sign/cert.py

# 签名 .hap 文件
hpack s ./xx.hap ./sign/cert.py

# 签名目录
hpack s ./build/default ./sign/cert.py

证书目录结构

sign/
├── cert.py          # 签名配置文件
├── certFile.cer     # 证书文件
├── keystore.p12     # 公私钥文件
└── profile.p7b      # Profile 文件

cert.py 配置示例

# -*- coding: utf-8 -*-
Alias =  key alias  
KeyPwd =  key password  
KeystorePwd =  store password  
Cert =  ./certFile.cer       # 相对于cert.py的路径
Profile =  ./profile.p7b     # 相对于cert.py的路径
Keystore =  ./keystore.p12   # 相对于cert.py的路径

配置环境变量

在非 DevEco-Studio 终端中使用时需要配置：

# macOS
# .zshrc 文件
export DEVECO_SDK_HOME=/Applications/DevEco-Studio.app/Contents/sdk

# 验证配置
hvigorw -v


# Windows
# 参考官方文档：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-hvigor-commandline

Git 忽略配置

在 .gitignore 文件中添加：

# 忽略 Python 临时文件
__pycache__/

证书相关

• 证书不一致：如果已安装的 App 和准备安装的 App 打包证书不一致，需先卸载已安装的 App
• Profile 类型：
  • 使用调试.p7b：只能本地命令安装
  • 使用内部测试 Profile.p7b：才能通过 DeepLink (链接) 形式安装

网络相关

• 联网校验：安装时鸿蒙会进行联网校验，如果验证失败，尝试关闭代理
• 错误码：安装出错时会有提示，可根据 错误码说明 查找缘由