Skip to content

README.md

Latest commit

 

History

History
545 lines (424 loc) · 25.5 KB

README.md

File metadata and controls

545 lines (424 loc) · 25.5 KB
Raw

hapsign

通过华为账号自动生成 HarmonyOS 调试签名，对未签名的 hap 包签名并安装到设备。

Important

本项目是非官方工具，与华为无隶属或背书关系。它依赖可能变化的在线接口，仅用于合法的 本机开发和调试。使用者应自行确认账号权限、数据安全以及相关服务条款。程序的数据流 和本地保存行为见 PRIVACY.md，第三方许可边界见 THIRD_PARTY_NOTICES.md。

工作原理

检测 HAP 是否已签名
  ├─ 已签名 → 按请求直接返回或 hdc install 安装
  └─ 未签名 →
       浏览器打开登录页（用户手动登录）
         → 拿 tempToken → 换 accessToken
         → 调华为云签名 API 生成 .cer / .p7b
         → hap-sign-tool 签名 hap
         → 按请求返回签名 HAP 或 hdc install 安装到设备

前置条件

  1. 签名/设备工具链：便携版已内置；源码运行可使用已准备的公开工具链或 DevEco Studio
  2. Python 3.11+（推荐使用 conda 或 venv 隔离环境）
  3. HarmonyOS 设备已通过 USB 连接并开启 USB 调试模式（安装或首次自动读取 UDID 时需要；仅签名也可显式提供 UDID）
  4. 华为开发者账号（需要已完成实名认证）

源码命令行支持 Windows、Linux 与 macOS。锁定的公开便携工具链目前覆盖 Windows x64 与 Linux x64；macOS 可使用本机 DevEco Studio 工具链构建，正式发布 前仍需补充独立的公开锁定项、代码签名和 notarization。

直接使用 Windows GUI 发布包（推荐）

普通使用者不需要安装 Python、DevEco Studio、Java 或 HDC。优先打开 GitHub Releases 选择适合当前平台的 现成包；该页面同时列出正式 Release 和标注为 Pre-release 的预发布版本。Windows x64 普通用户下载 HapSign-GUI-v<version>-windows-x64.zip 及同一版本的 SHA256SUMS。 只有没有适用的发布资产，或现成包在目标环境中确实无法使用时，才需要 从源码安装或自行构建。

下载后先在 PowerShell 中核对归档的 SHA-256：

$archive = Get-Item .\HapSign-GUI-v*-windows-x64.zip
Get-FileHash $archive.FullName -Algorithm SHA256
Select-String -Path .\SHA256SUMS -Pattern $archive.Name -SimpleMatch

确认哈希一致后，将 ZIP 解压到当前用户可写的目录（不要放入 Program Files）， 双击 HapSign.exe 即可。GUI 发布包内置 Chromium 与完整工具链。官方二进制不使用 可信发布者身份签名；如果系统或组织策略要求发布者签名，请勿绕过安全策略，改为从源码 构建并按组织要求自行签名。

GUI 目录同时包含 agent 可调用的 hapsign-cli.exe。只需要 agent/命令行时，可从同一 发布页下载 HapSign-CLI-Portable-v<version>-windows-x64.zip 或对应的 Linux x64 归档；Portable 版本已经内置所需工具链。它与源码安装后的 hapsign 使用同一组参数和 JSON 协议。

如果 Agent 不是从本仓库内运行、因而无法自动发现 .agents/skills，请同时下载并交给 Agent 与二进制版本一致的 Prompt：HapSign-Prompt-Portable-v<version>.md 会指导 Agent 下载、校验、解压 Portable 包并安全部署 HAP；已经有 DevEco Studio 或其他完整 外部工具链时，改用 HapSign-Prompt-ExternalToolchain-v<version>.md。在本仓库内运行 时，Agent 会直接发现 hapsign-hap-deploy/hapsign-signing 技能，不需要重复提供 Prompt。

首次使用时连接已开启 USB 调试的 HarmonyOS 设备，并在设备上确认调试授权；在窗口中 点击“检测设备”，然后拖入或选择 .hap，点击“开始签名并安装”。未签名 HAP 会打开 受控浏览器完成华为账号登录和验证码/二次验证，之后自动申请材料、签名并安装；已签名 HAP 会跳过登录和签名直接安装。签名材料、日志和可选的签名后 HAP 的位置见 便携版说明。

从源码安装

# 克隆仓库
git clone https://github.com/guantw/HapSign.git
cd HapSign

# 安装项目（提供 hapsign 命令）
python -m pip install .

源码桌面版默认由 Playwright 控制本机 Edge（其次 Chrome），仍会预授予登录页访问 本地回调服务的权限，因此不同于直接调用系统默认浏览器的旧方案。Windows 10/11 通常已经包含 Edge，不需要额外下载 Chromium。

如需使用内置 Chromium 兼容模式：

$env:PLAYWRIGHT_BROWSERS_PATH = "0"
python -m playwright install --no-shell chromium

桌面设置提供“受控系统浏览器”“内置 Chromium”和“非受控系统默认浏览器”三种 模式；环境变量 HAPSIGN_BROWSER 可使用 system_controlled、playwright 或 system 覆盖桌面默认值。CLI 默认使用 auto：SSH、CI 或无桌面 Linux 会话不会 尝试启动不可见的浏览器，而会显示外部浏览器交接信息；也可显式使用 external。

可选：配置 DevEco Studio 回退路径

正式便携版不需要 DevEco Studio。源码运行时程序会优先使用已准备的公开工具链，只有 在排查特定 DevEco 版本兼容性时才需要本机 DevEco 回退。程序会查找系统常见安装目录 和各平台常见目录：

  • Windows: D:\Program Files\Huawei\DevEco Studio
  • macOS: /Applications/DevEco-Studio.app/Contents
  • Linux: /opt/DevEco-Studio、/opt/Huawei/DevEco-Studio、 ~/DevEco-Studio 或 ~/Huawei/DevEco-Studio

若安装在其他位置，设置环境变量：

# macOS shell
export DEVECO_HOME="/Applications/DevEco-Studio.app/Contents"

# Linux shell
export DEVECO_HOME="$HOME/DevEco-Studio"

# Windows CMD
set DEVECO_HOME=E:\DevEco Studio

# Windows PowerShell
$env:DEVECO_HOME = "E:\DevEco Studio"

也可以不安装 DevEco Studio，把 Java/keytool 放进 JAVA_HOME 或 PATH，把 HDC 放进 PATH，并显式给出签名器：

export JAVA_HOME="/opt/jdk-21"
export HAPSIGN_HAP_SIGN_TOOL="/opt/ohos-sdk/toolchains/lib/hap-sign-tool.jar"
export HAPSIGN_HDC="/opt/ohos-sdk/toolchains/hdc"
hapsign doctor

HAPSIGN_JAVA、HAPSIGN_KEYTOOL、HAPSIGN_HAP_SIGN_TOOL 和 HAPSIGN_HDC 均可逐项覆盖自动发现结果。

调试密钥库默认使用兼容 DevEco 调试流程的固定密码。如需覆盖，请设置：

:: Windows CMD
set HAPSIGN_KEYSTORE_PASSWORD=使用你自己的强密码
# Windows PowerShell
$env:HAPSIGN_KEYSTORE_PASSWORD = "使用你自己的强密码"
# macOS / Linux shell
export HAPSIGN_KEYSTORE_PASSWORD="使用你自己的强密码"

配置 Python 路径（Windows bat 脚本用）

sign_install.bat 默认使用系统 PATH 中的 python。如果使用 conda/venv，设置环境变量：

:: Windows CMD
set HAPSIGN_PYTHON=C:\path\to\your\python.exe

:: PowerShell
$env:HAPSIGN_PYTHON = "C:\path\to\your\python.exe"

拖拽脚本还需要明确的 HDC 目标序列号，可设 HAPSIGN_SERIAL，也可把序列号作为 第二个参数传入。运行 hapsign devices list 可以查看候选设备。

使用

方式一：桌面应用（推荐）

安装 GUI 依赖后运行：

python -m pip install -e ".[gui]"
hapsign-app

桌面版支持点击选择或拖入 .hap 文件，也可以点击右侧文件卡片的“×”移除误选 文件。可随时点击“检测设备”确认 HDC 连接状态，并在后台完成登录、签名和安装。 进度条会按设备检测、账号授权、证书申请、签名和安装等实际阶段推进。执行期间 可以点击“取消”；关闭窗口时会询问是否中断，完成子进程和 HDC 清理后再退出， 取消后的同一窗口可以直接重新开始完整流程。 开始流程时还会自动执行一次设备可用性检查，未连接、未授权或同时连接多台设备 时不会继续。运行记录和错误会直接显示在窗口中。

标题栏的“设置”可选择登录浏览器、签名文件保存位置和日志级别，并能直接打开 签名目录或日志目录。诊断日志默认写到程序目录的 logs/hapsign.log，单个文件 最多 4 MiB，保留 3 份轮转备份。敏感诊断默认关闭；主动开启并选择 DEBUG 后， 日志可能包含 token、用户标识和完整 API 请求/响应，但始终不会记录密钥库密码。 “保留最新一个签名后的 HAP”默认开启：最终 HAP 默认写到程序目录的 signed_haps/（可用 HAPSIGN_SIGNED_HAPS_DIR 覆盖），新文件成功生成后只清理 HapSign 清单记录的旧产物，不会删除目录中未记录的用户 HAP；当前输入文件也会受到 保护。关闭后程序使用临时文件安装，任务结束即删除。

如果 HDC server 原本未运行，程序会在本次任务结束时关闭自己拉起的后台服务； 如果 DevEco Studio 或其他工具已经启动 HDC server，则会保留该既有服务。

方式二：bat 拖拽

先设置 HAPSIGN_SERIAL，再将 .hap 文件拖到 sign_install.bat 上；或从 CMD 显式传入 HAP 和设备序列号：

set HAPSIGN_SERIAL=5XQ0225613000233
sign_install.bat path\to\app-unsigned.hap 5XQ0225613000233

方式三：命令行（Windows / Linux / macOS）

hapsign devices list --connected-only --json
hapsign auth status --json
hapsign auth --json
hapsign sign --hap path/to/app-unsigned.hap --serial <serial> --json
hapsign install --hap path/to/app-signed.hap --serial <serial> --json
hapsign deploy --hap path/to/app-unsigned.hap --serial <serial> --json

sign 只签名并返回签名 HAP 的绝对路径；install 只接受已有 Hap Signing Block 的 HAP；deploy 端到端签名并安装，输入已经签名时会直接安装。包名默认从 HAP 里的 module.json 提取。源码目录中可用 python3 main.py <command> ...。

所有执行命令都支持 --json。此模式下 stdout 只输出单行 JSON，日志写到 stderr， 且不会输出 Token、密码或 UDID。Agent 应先从 devices list 中选择 connected=true 的目标，优先选择 physical_candidate=true 的 USB 真机，再把其 serial 原样传给后续命令。serial 是 HDC 连接标识，不是签名 Profile 中的 UDID。

auth 可以单独调用并持久化 Token。同一份 Token 缓存不绑定目标设备，在同一 台运行 HapSign 的电脑上可继续给不同 HarmonyOS 手机、平板或 PC 目标签名；每台 目标设备的 Profile 仍绑定自己的 UDID，切换设备会重新申请 Profile。Token 不会在 多台运行 HapSign 的电脑之间自动同步，也不建议手工复制缓存。Token 缓存不会按日期 主动失效；只有携带 Token 的 API 请求被服务端拒绝时才会尝试刷新。auth status 只 检查本地缓存，因此 JSON 中 online_verified 固定为 false。

Agent / 半自动仅签名

CLI 的标准输出可以保持为单个 JSON 文档，普通运行日志写入标准错误。agent 可按 “诊断 → 检查 HAP → 发起签名 → 等待用户完成浏览器授权 → 读取产物路径”的顺序调用：

hapsign doctor --json
hapsign inspect --hap app.hap --json
hapsign sign --hap app.hap --output artifacts/app-signed.hap \
  --state-dir .hapsign-state --browser auto --json

在 SSH、CI 或无桌面 Linux 上，auto 会保持命令运行并输出一次性登录地址与回调端口。 在有浏览器的电脑另开终端，把提示中的同一端口转发到运行 HapSign 的 SSH 目标，再打开 地址：

ssh -N -L 127.0.0.1:<端口>:127.0.0.1:<端口> <同一SSH目标>

容器等环境应使用对应的私有端口转发能力。回调服务始终只监听 loopback，不应改为公网 监听。--events json 会在 stderr 输出带 HAPSIGN_EVENT= 前缀的结构化交接事件；最终 stdout 仍只有原有单行 JSON。登录地址 包含一次性状态值，不要分享或写入持久日志。

首次为某个应用申请 Profile 时仍需要设备 UDID。默认会通过 HDC 从已连接设备读取； 如果 agent 已从可信来源获得 UDID，可以跳过本机设备探测：

hapsign sign --hap app.hap --device-udid <64位十六进制UDID> \
  --browser auto --json

同一天已有与包名、能力模式及已知设备匹配的可用签名材料缓存时，仅签名模式不要求 设备连接。--output 默认拒绝覆盖已有文件；只有调用方明确传入 --overwrite-output 才会原子替换。输入已经签名时不会重复签名；传入 --output 时 仍会发布到指定路径，否则返回原 HAP 路径。完整的 agent 调用约定和 JSON 字段见 Agent 签名协议。

doctor --json 会同时返回本次解析出的 paths 和带稳定编号的 breaking_changes；inspect --json 会把当前 HAP 适用的项目放入 migration_warnings。升级已有安装前请按迁移指南处理。

Codex 从本仓库运行时会自动发现 hapsign-signing 技能。该技能覆盖三平台 CLI 定位、受控浏览器授权、JSON 判定、签名后复检和脱敏故障诊断；仓库副本是个人 安装版本的权威来源。

便携版把上述命令名替换为 Windows 的 hapsign-cli.exe 或 Linux/macOS 的 ./hapsign-cli，无需目标机器安装 Python。

构建便携版

便携版是一个可直接解压运行的目录，不要求目标电脑安装 Python 或 DevEco Studio。 Windows/Linux 正式包使用锁定并校验的 OpenHarmony 6.1 公共工具链和 Eclipse Temurin 21。首次构建先在目标平台准备工具链，再打包：

python -m pip install -e ".[gui,bundle]"
python scripts/prepare_toolchain.py
python scripts/build_portable.py

prepare_toolchain.py 会校验 toolchain.lock.json 中的大小和 SHA-256，只从 OpenHarmony 公共 SDK 提取 HDC、libusb、hap-sign-tool 和 NOTICE，再用 Temurin JDK 的 jlink 生成精简 Java 运行时。Linux JDK 的 tar.gz 权限和链接会经过安全 提取，并确保 HDC 保留可执行位。公共 SDK 下载约 2.5 GB，但只在构建缓存中 保留；最终工具链约 66 MiB。已有下载可用 --sdk-archive 和 --jdk-archive 传入，仍会执行相同校验。

默认产物复用系统 Edge/Chrome，不包含 Chromium。要生成包含内置 Chromium 的兼容 包，PowerShell 中执行：

$env:PLAYWRIGHT_BROWSERS_PATH = "0"
python -m playwright install --no-shell chromium
python scripts/build_portable.py --keep-bundled-browser

Windows/macOS 输出 dist/HapSign-portable-<platform>.zip，Linux 输出 dist/HapSign-portable-linux.tar.gz 以保留可执行位。三个目标都需要在各自平台 分别构建，并同时包含 GUI 与 agent CLI。便携版使用说明见 PORTABLE.md， 完整构建步骤见 docs/PACKAGING.md。

Note

当前锁定的 OpenHarmony 公共工具链是 6.1.0.31 / API 23（HDC 3.2.0c）， 并非 DevEco 6.1.1.125 中较新的 API 24 版本。现有签名产物验证、实际重签名和 设备识别已经通过；正式发布仍应按 开源发布门禁 完成真实设备安装回归。 --allow-deveco-toolchain 只用于排障回退，其产物不得冒充锁定的公开构建。

Agent CLI 接口

hapsign doctor [--state-dir DIR] [--output-dir DIR] [--json]
hapsign inspect --hap HAP [--bundle-name NAME] [--state-dir DIR] [--enable-capability] [--json]
hapsign migrate-cache --hap HAP --profile-type normal|system-basic [--state-dir DIR] [--json]
hapsign auth [login|status] [--refresh] [认证交互选项] [--state-dir DIR] [--json]
hapsign devices [list] [--connected-only] [--json]
hapsign sign --hap HAP [--serial SERIAL | --device-udid UDID] [签名选项] [--json]
hapsign install --hap SIGNED_HAP --serial SERIAL [--bundle-name NAME] [--json]
hapsign deploy --hap HAP --serial SERIAL [签名选项] [--json]

sign / deploy 签名选项:
  --bundle-name NAME   覆盖 HAP 中的包名
  --country CODE       华为账号国家码，默认 CN
  --device-type TYPE   签名平台注册的设备类型码，默认 4
  --state-dir DIR      Token 与默认签名材料根目录
  --work-dir DIR       当前 bundle 签名材料目录，默认 <state-dir>/<bundle>
  --output-dir DIR     未指定 --output 时的签名产物目录
  --output FILE        签名 HAP 的精确输出路径
  --overwrite-output  允许覆盖 --output 指定的已有文件
  --browser MODE       auto、external、system、system_controlled 或 playwright
  --callback-port PORT loopback 回调端口，默认 0 自动分配
  --auth-timeout SEC   浏览器授权等待时间，默认 600 秒
  --events FORMAT      中间事件格式：human 或 json（写入 stderr）
  --enable-capability  使用 Real Profile（APL=system_basic）
  --refresh-token      强制浏览器认证，同时刷新签名材料
  --refresh-signing    只重新申请证书/Profile，复用有效 Token
  -v, --verbose        将 DEBUG 日志写到 stderr

设备类型码:
  4  手机/平板/2in1（默认）
  2  穿戴设备
  8  智慧屏
  9  路由器
  1  轻量级穿戴设备

退出码:
  0    命令成功
  1    认证、签名、HDC 或安装运行失败
  2    参数或输入 HAP 无效
  130  用户取消

成功 JSON 至少包含 ok=true 和 command。sign / deploy 还包含 input_hap、 signed_hap、bundle_name、serial、input_signed、installed、请求/实际能力模式 和 capability_fallback；devices list 包含 count、connected_count 与 targets。失败 JSON 使用 {"ok":false,"command":"...","error":{"type":"...","message":"..."}}。 完整、随版本同步的帮助以 hapsign --help 和各子命令 --help 为准。

首次运行

有可见桌面时会打开华为登录页；SSH、CI 或无桌面 Linux 会给出外部浏览器和安全 loopback 转发指引。账号密码、验证码和二次验证始终由用户在浏览器中处理。登录成功后 继续完成签名和安装。

Real Profile（system_basic 权限）

默认创建的 Test Profile APL 为 normal。大多数需要 ACL 预授权的权限（如 CUSTOM_SANDBOX、READ_WRITE_USER_FILE 等）在 Test Profile 下即可授予。

如果应用需要 system_basic 级别的 APL，加 --enable-capability 参数走 Real Provision 路径：

hapsign deploy --hap app.hap --serial <serial> --enable-capability

此模式通过 add.real.provision API 创建 Real Profile（provisionType=1），对应 DevEco Studio 6.1+ 的 enableCapability 路径。需要应用已在 AGC（AppGallery Connect）注册且当前账号有访问权限，否则自动回退到 Test Profile。

CLI 会在结果中分别返回 requested_capability_mode 和 capability_mode。如果发生回退， capability_fallback=true；相同请求会复用该 Test Profile，显式传入 --refresh-signing 才会重新尝试申请 Real Profile。

签名文件和缓存位置

桌面版和便携版默认把签名材料保存在程序目录旁，解压目录可以整体移动：

HapSign/
├── HapSign.exe
├── signing_files/
    ├── .token_cache.json
    └── <bundle_name>/
└── signed_haps/                 # 最新一个签名 HAP（可在设置中关闭）

源码 CLI 默认保存在应用目录（源码仓库根目录）的 signing_files/<bundle_name>/，不依赖启动命令时所在目录。--state-dir 可配置 token 与全部 bundle 缓存的根目录；--work-dir 只覆盖本次 HAP 的材料目录； --output-dir 配置默认产物目录，--output 则指定精确文件。对应环境变量是 HAPSIGN_SIGNING_DIR 与 HAPSIGN_SIGNED_HAPS_DIR，命令行参数优先。 程序目录必须可写，不建议把便携版解压到 Program Files 等受保护目录。 桌面版“设置”中还可以改为用户 AppData Local 或任意自定义目录。

成功完成一次未签名 HAP 的签名后，默认目录内容如下：

signing_files/com.example.myapp/
├── auto_debug_com.example.myapp.p12   # 密钥库
├── auto_debug_com.example.myapp.csr   # CSR
├── auto_debug_com.example.myapp.cer   # 调试证书
├── auto_debug_com.example.myapp.p7b   # 调试 Profile
└── metadata.json                       # 缓存元数据

signed_haps/
├── .hapsign-signed-haps.json           # HapSign 生成产物清单
└── entry-default-unsigned_signed.hap   # 签名后的 HAP

如果输入 HAP 本身已经签名，程序会直接安装原文件，不会生成上述签名材料。

缓存策略

Token 缓存持续复用；签名文件只在当天且 bundle 和目标 UDID 都相同时复用：

  • Token 缓存：<state-dir>/.token_cache.json，不按日期失效，可跨目标设备复用
  • 签名文件缓存：<state-dir>/{bundle_name}/metadata.json，当天仅为匹配的 bundle 和设备 UDID 复用
  • 跨天仅签名文件缓存失效，申请新材料时仍先复用已有 Token
  • 携带 Token 的 API 请求被服务端判定失效时自动刷新，刷新失败才回退到重新登录

这些文件包含敏感信息。Windows token 缓存使用当前用户 DPAPI 保护；Linux/macOS token 缓存是权限限制为 0o600 的明文文件，签名私钥等材料仍需按敏感文件保护。 不要上传、分享或放入云同步目录。共享电脑使用完毕后应删除 signing_files/。详细 说明见 SECURITY.md。

已验证平台与规格限制

已实机验证的登录环境

下表只描述本次源码 CLI 的真实登录验证范围，不代表 GUI、USB、HAP 签名安装或所有 同类操作系统版本均已验证。

CLI 运行环境 浏览器路径 已验证结果
Windows 11 专业版 64 位 auto 启动隔离的 Edge 用户可见登录页、loopback 回调、Token 换取、DPAPI 缓存及缓存复用均通过
Ubuntu 24.04.4 LTS x86_64（WSL2） auto 调用 Windows 默认浏览器 用户可见登录页、跨 WSL loopback 回调、Token 换取、0o600 缓存及缓存复用均通过

WSL2 结果不能替代原生 Linux 发行版或远程 SSH 环境的实机验证；这些环境应在发布前 按其网络、浏览器交接和权限配置单独回归。未列入上表的平台不等同于不支持，只表示 尚未完成同等范围的真实登录验证。

认证规格边界

  • 首次认证以及缓存失效后的重新认证，不支持“全程只有纯命令行、任何电脑都没有可用 浏览器”的运行方式。OAuth 登录必须由用户在一台能运行现代浏览器的电脑上完成
  • SSH、CI 或无桌面 Linux 可以运行 CLI；auto/external 会输出一次性登录地址和 callback 端口，通过安全的同端口 loopback 转发把浏览器回调送回 CLI。因此“不要求 Linux 主机有桌面”不等于“不需要浏览器”
  • 已有且仍被服务端接受的 Token 缓存可以直接复用，此时本次调用无需再次打开浏览器
  • 登录验证码 / 二次验证需要用户在浏览器中手动处理

其他限制

  • 拖拽安装脚本仅支持 Windows（sign_install.bat）；Linux/macOS 请使用 hapsign 命令行
  • Windows 便携版已经过完整构建和实机流程验证；Linux x64 已有锁定公开工具链、 CI 和构建路径，但发布前仍应在目标发行版执行 GUI、USB/udev 和真实设备安装回归
  • macOS 源码命令行可使用 DevEco Studio；正式便携发布仍需锁定公开工具链并完成 应用签名/notarization
  • 签名流程依赖华为云 API，需要有网络连接和华为开发者账号

开发与贡献

python -m pip install -r requirements-dev.txt
python -m ruff format .
python -m ruff check .
python -m pytest --cov

测试不需要真实账号、网络、DevEco Studio 或 HarmonyOS 设备。贡献流程见 CONTRIBUTING.md，安全问题请按 SECURITY.md 报告。

项目结构

hapsign/
├── cli.py                # 命令行参数和入口
├── config.py             # 配置常量（域名、SDK 路径、API 端点、密钥参数）
├── gui.py                # PySide6 桌面界面
├── models.py             # 数据模型
├── pipeline.py           # 全流程编排（缓存、登录、签名、安装）
├── runtime.py            # 用户数据目录与跨平台工具链发现
├── login/
│   └── browser_login.py  # 受控系统浏览器、内置 Chromium 与普通浏览器备用后端
├── token/
│   └── token_exchange.py # tempToken → JWT → accessToken
├── api/
│   ├── client.py         # HTTP 客户端（认证 header 封装）
│   ├── cert_api.py       # 证书 API (cert/add, cert/list, cert/delete)
│   ├── device_api.py     # 设备 API (device/add, device/list)
│   ├── provision_api.py  # Profile API (test/real provision add, delete)
│   └── capability_api.py # 应用信息 API (app brief info)
└── signing/
    ├── keytool_util.py   # keytool 生成 EC 密钥对 + CSR
    ├── hap_inspect.py    # 检测 HAP 是否已签名
    ├── hap_signer.py     # hap-sign-tool 签名 hap
    └── installer.py     # hdc install / 获取 UDID

License

HapSign 自身源代码使用 MIT License。第三方依赖和便携包工具链保持各自 许可，不因本项目采用 MIT 而改变，详见 THIRD_PARTY_NOTICES.md。隐私与本地数据说明见 PRIVACY.md，参与项目需遵守 Code of Conduct。

Powered by BitFun