# harmony-installer-script

**Repository Path**: samhula/harmony-installer-script

## Basic Information

- **Project Name**: harmony-installer-script
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-18
- **Last Updated**: 2026-05-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Harmony Installer Scripts

安装包发布工具脚本，通过七牛云分片上传（断点续传 v2）将 HAP/HSP 文件上传并注册到 Harmony Installer API。

## 环境要求

```bash
pip install -r requirements.txt
```

## 环境变量

| 变量 | 说明 | 默认值 |
|------|------|--------|
| `INSTALLER_API_BASE` | API 服务地址 | `https://www.harmonyinstaller.cn` |
| `INSTALLER_API_KEY` | API 密钥（必填），也可在脚本调用时通过--api-key参数设置 | - |

## 参数说明

| 参数 | 必填 | 类型 | 说明 |
|------|------|------|------|
| `--app-id` | 是 | int | 应用 ID（在管理后台创建应用后获得） |
| `--version` | 是 | str | 版本号，如 `1.0.2` |
| `--hap` | 是 | str | `.hap` 文件本地路径 |
| `--hsp` | 是 | str | `.hsp` 文件本地路径 |
| `--version-no` | 否 | int | 版本构建序号，用于排序（默认：Unix 时间戳） |
| `--release-date` | 否 | str | 发布日期 `YYYY-MM-DD`（默认：当天） |
| `--description` | 否 | str | 版本描述（默认：空） |
| `--deploy-path` | 否 | str | 设备部署路径（默认：`/data/local/tmp`） |
| `--set-as-current` | 否 | bool | 是否设为应用当前版本（默认：true） |
| `--part-size-mb` | 否 | int | 七牛分片大小 MB（默认：16） |
| `--base-url` | 否 | str | 同 `INSTALLER_API_BASE` 环境变量 |
| `--api-key` | 否 | str | 同 `INSTALLER_API_KEY` 环境变量 |

## 重复提交行为

当 `app_id` + `version` + `version_no` 三者完全相同时，**不会**创建新版本，而是**更新已有版本并替换 hap/hsp 文件**（幂等更新）。

可用于重新上传或修复已发布的版本。

## 使用示例

### 基本用法

```powershell
$env:INSTALLER_API_BASE = "https://www.harmonyinstaller.cn"
$env:INSTALLER_API_KEY = "YOUR_API_KEY"

python publish_version_direct.py `
  --app-id 1 `
  --version 1.0.2 `
  --hap C:\path\to\debug.hap `
  --hsp C:\path\to\tztzfnetwork-signed.hsp `
  --description "release"
```

### 指定版本序号和日期

```powershell
python publish_version_direct.py `
  --app-id 1 `
  --version 1.0.2 `
  --version-no 3 `
  --release-date 2026-05-18 `
  --hap D:\debug.hap `
  --hsp D:\tztzfnetwork-signed.hsp `
  --description "正式发布"
```

### 仅上传不设为当前版本

```powershell
python publish_version_direct.py `
  --app-id 1 `
  --version 1.0.2-rc1 `
  --no-set-as-current `
  --hap D:\debug.hap `
  --hsp D:\tztzfnetwork-signed.hsp
```

## 更多

完整参数说明：`python publish_version_direct.py --help`