v1.9.1

Highlights / 亮点

中文

• v1.9.1 是 build-hap 安全补丁版本，解决需要让 ohpm 直接消费 file:*.har 依赖的项目场景。
• 新增 EXPO_HARMONY_SKIP_HAR_NORMALIZE=1 与 expo-harmony build-hap --no-har-normalize 两个入口，用于跳过 HAR normalize。
• 默认 verified build path 不变；不设置 opt-out 时仍会走原来的 normalized HAR 处理。
• 同步更新 v1.9.x roadmap 与 CLI build guide，并关闭 issue #1。

English

• v1.9.1 is a build-hap safety patch for projects that need ohpm to consume file:*.har dependencies directly.
• It adds both EXPO_HARMONY_SKIP_HAR_NORMALIZE=1 and expo-harmony build-hap --no-har-normalize as HAR normalize opt-outs.
• The default verified build path is unchanged; without the opt-out, normalized HAR handling remains the default.
• The v1.9.x roadmap and CLI build guide were updated, and issue #1 was closed.

Validation / 验证

中文

• 构建与测试：pnpm build、pnpm exec jest --runInBand tests/build.test.ts tests/buildHapCommand.test.ts、pnpm test。
• 打包与发布门禁：npm pack --dry-run、EXPO_HARMONY_RELEASE_SKIP_HAP=1 pnpm release:check。
• GitHub CI：stable-lane 与 next-lane 均通过。
• 发布验证：release workflow run 26808725072 成功，npm dist-tag 为 latest -> 1.9.1，provenance attestation 已存在。

English

• Build and tests: pnpm build, pnpm exec jest --runInBand tests/build.test.ts tests/buildHapCommand.test.ts, and pnpm test.
• Package and release gates: npm pack --dry-run and EXPO_HARMONY_RELEASE_SKIP_HAP=1 pnpm release:check.
• GitHub CI: both stable-lane and next-lane passed.
• Release validation: workflow run 26808725072 succeeded, npm resolved latest -> 1.9.1, and provenance attestation was present.

Notes / 说明

中文

• 这是 opt-in escape hatch，不是默认构建策略变更。
• 开启 opt-out 会跳过依赖于 normalized HAR 的 local registration / RNOH compatibility 步骤，适合明确知道自己 HAR 路径需求的项目。
• 本版本不扩大 verified 能力边界，也不改变 Wave A / preview / experimental 的 tier 语义。

English

• This is an opt-in escape hatch, not a change to the default build strategy.
• Enabling the opt-out skips normalized-HAR-dependent local registration and RNOH compatibility steps, so it is intended for projects that explicitly need direct HAR file handling.
• This release does not widen the verified capability boundary or change Wave A, preview, or experimental tier semantics.