0.2.0 — com.offline.tool

OHPM/ArkTS 包名改为 com.offline.tool。GitHub HAR 已可下载；OHPM 单独提交并以中心仓实际可见状态为准。

import { PackageInstaller, ResourceInterceptor } from "com.offline.tool";

本地依赖："com.offline.tool": "file:../libs/com.offline.tool-0.2.0.har"。移除旧 SDK 依赖。31 项主机测试与 HAR/HAP 构建通过。HAP 未签名；真机请用源码自行签名。

Demo 标识为 com.offline.tool.sample，示例资源由本地脚本生成。包名/模块改名需要更新接入代码，离线包格式和安装逻辑不变。

迁移说明

OHPM 元数据修复：HAR 内 CHANGELOG 已补齐 0.2.0，附件已更新。SDK 代码未变。源码修复见 bc1d19f，从源码重新发布请使用 main 的此修复或后续提交；原 v0.2.0 标签保留。

v0.1.4 — Android-compatible cache layout

缓存目录对齐 Android，SDK 为 harmony-offline-sdk@0.1.4。

• 正式资源目录：<root>/<version>/。
• 下载/复制临时 ZIP：<root>/<version>.zip.tmp。
• 解压临时目录：<root>/<version>_temp/。
• ZIP 的 dist/ 内容直接发布到版本目录；失败和取消后清理临时路径。
• 冷启动清理识别旧 version-hash / .install- 遗留目录。宿主必须在尚无页面绑定时清理，并串行协调同一 root 的操作。
• 同版本目录不覆盖。SHA-256 继续校验，宿主保存激活记录并拒绝同版本不同摘要。
• 本地 ZIP 输入应位于 SDK root 之外；工作目录内输入返回 INVALID_SOURCE。
• Demo root 为 filesDir/offline/packages，与 Android 示例一致。业务宿主可继续使用 filesDir/offline/webview。

OHPM 0.1.4 已上架，在宿主模块执行：

ohpm install harmony-offline-sdk@0.1.4

也可用本页 HAR，通过 "harmony-offline-sdk": "file:../libs/harmony-offline-sdk-0.1.4.har" 接入。Import 名称不变。

完整接入说明 · Demo 说明

升级提醒：0.1.3 的版本号加摘要缓存需重新安装；已使用纯版本目录的业务测试包可复用。Demo 下载 Source code 后用 DevEco 打开根目录，配置个人 debug 签名并运行 entry；未签名 HAP 不能直接安装。

验证：31 项主机测试通过，SDK HAR、Demo 和无 SDK 源码的独立 HAR 消费工程构建通过。尚未重复真机交互验收。附件 HAR 与 OHPM 提交文件一致，附 SHA256SUMS。

v0.1.3 — harmony-offline-sdk

SDK 正式名称统一为 harmony-offline-sdk，版本 0.1.3。Demo 的应用包名 com.offline.demo.sample 保持不变，SDK 不依赖 Demo。

使用方式

OHPM 已提交，提交结果为审核中。审核上架后，在宿主模块（例如 entry）目录执行：

ohpm install harmony-offline-sdk@0.1.3

import { PackageInstaller, ResourceInterceptor, usablePackage } from 'harmony-offline-sdk';

审核期间可下载本页 harmony-offline-sdk-0.1.3.har，放入宿主工程 libs 目录，在宿主模块配置 "harmony-offline-sdk": "file:../libs/harmony-offline-sdk-0.1.3.har" 后 Sync。

旧包用户需移除 com.offline.demo 依赖并替换 SDK import；API 和运行逻辑保持不变。

Demo

Demo 源码 · 运行说明 · SDK 接入文档

下载本版本 Source code，使用 DevEco Studio 打开完整工程根目录，配置自己的 debug 签名，运行 entry。Demo 默认依赖 SDK 源码模块；需要验证远程版本时，按文档将依赖值改为 0.1.3。未签名 HAP 不能直接安装到真机。

验证：clean 后 SDK HAR / Demo 构建通过，25 项主机测试通过，移除 SDK 源码的独立 HAR 消费工程完整构建通过，OHPM prepublish 通过。0.1.3 未重复真机交互验收。

附件 HAR 与 OHPM 提交内容相同，另附未签名 Demo HAP 和 SHA256SUMS；不含个人签名或发布密钥。

v0.1.2 — OHPM publication metadata fix

修复 OHPM 发布时缺少作者网址或邮箱导致的 HTTP 400：补充 GitHub 作者网址，并更新安装说明。SDK API 与运行逻辑保持一致。

• SDK：com.offline.demo@0.1.2；Demo：com.offline.demo.sample。
• OHPM 已提交，2026-09-18 核对状态为审核中；审核上架后可执行 ohpm install com.offline.demo@0.1.2。审核期间可下载本 Release 的 HAR 通过 file 依赖接入。
• 验证：SDK release HAR 和 Demo 构建通过，25 项主机测试通过，OHPM prepublish 通过。
• 附件包含与 OHPM 提交相同的 HAR、未签名 Demo HAP 和 SHA256SUMS。真机运行请打开源码项目配置个人 debug 签名；未签名 HAP 不能直接安装。0.1.2 未重复真机交互验收。

v0.1.1 — Align package names and debug signing

修正 SDK / Demo 命名，并验证个人账号 debug 签名的真机安装启动。

• SDK 包名和 ArkTS import：com.offline.demo，对应 Android SDK 的公开包名。
• Demo 应用包名：com.offline.demo.sample，与 Android Demo 一致。
• 个人华为开发者团队可用于调试签名；本机已生成 signed HAP，在 Mate 60 Pro / HarmonyOS 6.1.1 上安装和启动成功。
• 补充 no signature file 排查，以及 default 产品绑定 signingConfig 的说明。

接入依赖改为：

"dependencies": {
  "com.offline.demo": "file:../libs/com.offline.demo-0.1.1.har"
}

import { PackageInstaller, ResourceInterceptor } from 'com.offline.demo';

25 项主机测试通过，源码 Demo 和独立 HAR 消费工程构建通过，OHPM prepublish 本地预检通过。真机安装启动已验证，完整离线交互仍需按 docs/DEMO.md 验收。

公开仓库和附件不含个人证书或本地签名配置。附件 HAP 仍为 unsigned 构建参考，不能直接安装到真机；请打开源码并配置自己的自动调试签名后 Run。OHPM 中心仓尚未发布。

v0.1.0 — Harmony Offline SDK

首个独立 HarmonyOS 离线 SDK 和 Splash Demo。

• 官方 ZIP API、SHA-256、CRC 和路径/大小校验，TaskPool 后台安装。
• HTTPS 下载与本地 ZIP 安装、取消、固定版本 ArkWeb 资源映射。
• Demo 内置示例 ZIP，首次启动也无需联网，包含阶段文本、进度条、完成入口、真实校验失败和重试。
• 包名 harmony-offline-sdk；GitHub 发布者和源码作者为 mobilewhj。

使用：下载 HAR 放到宿主 libs/，在模块 oh-package.json5 中配置：

"dependencies": {
  "harmony-offline-sdk": "file:../libs/harmony-offline-sdk-0.1.0.har"
}

DevEco Sync 或运行 ohpm install --all。OHPM 中心仓暂未发布。

验证：25 项主机测试通过，SDK HAR 和源码 Demo HAP 构建通过；移除 SDK 源码、仅依赖最终 HAR 的独立 Demo 也构建通过；OHPM prepublish 本地预检通过。

Demo 真机交互尚未验收。附件 HAP 未签名，不能直接安装到真机；请用 DevEco 打开源码，选择 entry，配置自己的自动签名后 Run。已验证编译环境为 DevEco Studio 26.0.0.821 / HarmonyOS SDK 26，最低兼容 API 12。

SHA256SUMS 可用于核对附件。开源源码 HAR，Apache-2.0。