expo-harmony-toolkit 1.8.0 → 1.8.2

package/build/data/uiStack.d.ts

@@ -24,6 +24,7 @@ export declare const UI_STACK_VALIDATED_ADAPTERS: readonly [{
     readonly adapterRepository: "react-native-oh-library/react-native-harmony-svg";
     readonly adapterPath: "react-native-harmony-svg";
     readonly adapterCommit: "97c31d2f72559931d62fa84a9c86e86d343753d3";
+    readonly npmSpecifier: "15.0.1-rc.11";
     readonly harmonyHarFileName: "svg.har";
     readonly supportsAutolinking: false;
     readonly managedAutolinking: {
@@ -36,7 +37,172 @@ export declare const UI_STACK_VALIDATED_ADAPTERS: readonly [{
     readonly docsUrl: "https://github.com/react-native-oh-library/react-native-harmony-svg";
 }];
 export type UiStackValidatedAdapter = (typeof UI_STACK_VALIDATED_ADAPTERS)[number];
+export declare const HARMONY_NATIVE_ADAPTERS: readonly [{
+    readonly canonicalPackageName: "react-native-reanimated";
+    readonly canonicalVersion: "3.6.0";
+    readonly adapterPackageName: "@react-native-oh-tpl/react-native-reanimated";
+    readonly adapterVersion: "3.6.4-rc.5";
+    readonly adapterRepository: "react-native-oh-library/react-native-harmony-reanimated";
+    readonly adapterPath: "react-native-harmony-reanimated";
+    readonly adapterCommit: "9fdbe676209937383907be0592291223c6ca7ad7";
+    readonly harmonyHarFileName: "reanimated.har";
+    readonly supportsAutolinking: false;
+    readonly managedAutolinking: {
+        readonly etsImportPath: "@react-native-oh-tpl/react-native-reanimated/ts";
+        readonly etsPackageName: "ReanimatedPackage";
+        readonly cppHeaderName: "ReanimatedPackage.h";
+        readonly cppPackageName: "ReanimatedPackage";
+        readonly cmakeTargetName: "rnoh_reanimated";
+    };
+    readonly docsUrl: "https://github.com/react-native-oh-library/react-native-harmony-reanimated";
+}, {
+    readonly canonicalPackageName: "react-native-svg";
+    readonly canonicalVersion: "15.0.0";
+    readonly adapterPackageName: "@react-native-oh-tpl/react-native-svg";
+    readonly adapterVersion: "15.0.1-rc.12";
+    readonly adapterRepository: "react-native-oh-library/react-native-harmony-svg";
+    readonly adapterPath: "react-native-harmony-svg";
+    readonly adapterCommit: "97c31d2f72559931d62fa84a9c86e86d343753d3";
+    readonly npmSpecifier: "15.0.1-rc.11";
+    readonly harmonyHarFileName: "svg.har";
+    readonly supportsAutolinking: false;
+    readonly managedAutolinking: {
+        readonly etsImportPath: "@react-native-oh-tpl/react-native-svg/ts";
+        readonly etsPackageName: "SvgPackage";
+        readonly cppHeaderName: "SVGPackage.h";
+        readonly cppPackageName: "SVGPackage";
+        readonly cmakeTargetName: "rnoh_svg";
+    };
+    readonly docsUrl: "https://github.com/react-native-oh-library/react-native-harmony-svg";
+}, {
+    readonly canonicalPackageName: "@react-native-async-storage/async-storage";
+    readonly adapterPackageName: "@react-native-oh-tpl/async-storage";
+    readonly adapterVersion: "1.21.0-0.2.2";
+    readonly harmonyHarFileName: "async_storage.har";
+    readonly supportsAutolinking: true;
+    readonly managedAutolinking: {
+        readonly etsImportPath: "@react-native-oh-tpl/async-storage/ts";
+        readonly etsPackageName: "AsyncStoragePackage";
+        readonly cppHeaderName: "AsyncStoragePackage.h";
+        readonly cppPackageName: "AsyncStoragePackage";
+        readonly cmakeTargetName: "rnoh_async_storage";
+    };
+    readonly docsUrl: "https://github.com/react-native-oh-library/usage-docs";
+}, {
+    readonly canonicalPackageName: "react-native-webview";
+    readonly adapterPackageName: "@react-native-oh-tpl/react-native-webview";
+    readonly adapterVersion: "13.10.3";
+    readonly harmonyHarFileName: "rn_webview.har";
+    readonly supportsAutolinking: true;
+    readonly managedAutolinking: {
+        readonly etsImportPath: "@react-native-oh-tpl/react-native-webview/ts";
+        readonly etsPackageName: "WebViewPackage";
+        readonly cppHeaderName: "WebViewPackage.h";
+        readonly cppPackageName: "WebViewPackage";
+        readonly cmakeTargetName: "rnoh_webview";
+    };
+    readonly docsUrl: "https://github.com/react-native-oh-library/usage-docs/blob/master/en/react-native-webview.md";
+}, {
+    readonly canonicalPackageName: "react-native-screens";
+    readonly adapterPackageName: "@react-native-oh-tpl/react-native-screens";
+    readonly adapterVersion: "4.8.1-rc.3";
+    readonly harmonyHarFileName: "screens.har";
+    readonly supportsAutolinking: true;
+    readonly docsUrl: "https://github.com/react-native-oh-library";
+}, {
+    readonly canonicalPackageName: "react-native-gesture-handler";
+    readonly adapterPackageName: "@react-native-oh-tpl/react-native-gesture-handler";
+    readonly adapterVersion: "2.14.17-rc.0";
+    readonly harmonyHarFileName: "gesture_handler.har";
+    readonly supportsAutolinking: true;
+    readonly docsUrl: "https://github.com/react-native-oh-library/react-native-harmony-gesture-handler";
+}, {
+    readonly canonicalPackageName: "lottie-react-native";
+    readonly adapterPackageName: "@react-native-oh-tpl/lottie-react-native";
+    readonly adapterVersion: "6.4.1-0.1.9-1";
+    readonly harmonyHarFileName: "lottie.har";
+    readonly supportsAutolinking: true;
+    readonly managedAutolinking: {
+        readonly cppHeaderName: "LottieAnimationViewPackage.h";
+        readonly cppPackageName: "LottieAnimationViewPackage";
+        readonly cmakeTargetName: "rnoh_lottie";
+    };
+    readonly docsUrl: "https://github.com/react-native-oh-library";
+}, {
+    readonly canonicalPackageName: "react-native-safe-area-context";
+    readonly adapterPackageName: "@react-native-oh-tpl/react-native-safe-area-context";
+    readonly adapterVersion: "4.7.4-0.2.1";
+    readonly harmonyHarFileName: "safe_area.har";
+    readonly supportsAutolinking: true;
+    readonly managedAutolinking: {
+        readonly etsImportPath: "@react-native-oh-tpl/react-native-safe-area-context/ts";
+        readonly etsPackageName: "SafeAreaViewPackage";
+        readonly cppHeaderName: "SafeAreaViewPackage.h";
+        readonly cppPackageName: "SafeAreaViewPackage";
+        readonly cmakeTargetName: "rnoh_safe_area";
+    };
+    readonly docsUrl: "https://github.com/react-native-oh-library";
+}, {
+    readonly canonicalPackageName: "@react-native-camera-roll/camera-roll";
+    readonly adapterPackageName: "@react-native-oh-tpl/camera-roll";
+    readonly adapterVersion: "7.8.4-rc.2";
+    readonly harmonyHarFileName: "camera_roll.har";
+    readonly supportsAutolinking: true;
+    readonly managedAutolinking: {
+        readonly etsImportPath: "@react-native-oh-tpl/camera-roll/ts";
+        readonly etsPackageName: "CameraRollPackage";
+    };
+    readonly docsUrl: "https://github.com/react-native-oh-library";
+}, {
+    readonly canonicalPackageName: "@react-native-clipboard/clipboard";
+    readonly adapterPackageName: "@react-native-oh-tpl/clipboard";
+    readonly adapterVersion: "1.13.2-0.0.9";
+    readonly harmonyHarFileName: "clipboard.har";
+    readonly supportsAutolinking: true;
+    readonly managedAutolinking: {
+        readonly etsImportPath: "@react-native-oh-tpl/clipboard/ts";
+        readonly etsPackageName: "ClipboardPackage";
+        readonly cppHeaderName: "ClipboardPackage.h";
+        readonly cppPackageName: "ClipboardPackage";
+        readonly cmakeTargetName: "rnoh_clipboard";
+    };
+    readonly docsUrl: "https://github.com/react-native-oh-library";
+}, {
+    readonly canonicalPackageName: "react-native-image-picker";
+    readonly adapterPackageName: "@react-native-oh-tpl/react-native-image-picker";
+    readonly adapterVersion: "7.0.3-0.1.7";
+    readonly harmonyHarFileName: "image_picker.har";
+    readonly supportsAutolinking: true;
+    readonly managedAutolinking: {
+        readonly etsImportPath: "@react-native-oh-tpl/react-native-image-picker/ts";
+        readonly etsPackageName: "ImagePickerViewPackage";
+        readonly cppHeaderName: "RNImagePickerPackage.h";
+        readonly cppPackageName: "RNImagePickerPackage";
+        readonly cmakeTargetName: "rnoh_image_picker";
+    };
+    readonly docsUrl: "https://github.com/react-native-oh-library/usage-docs/blob/master/en/react-native-image-picker.md";
+}, {
+    readonly canonicalPackageName: "react-native-fs";
+    readonly adapterPackageName: "@react-native-oh-tpl/react-native-fs";
+    readonly adapterVersion: "2.20.0-0.1.14";
+    readonly harmonyHarFileName: "fs.har";
+    readonly supportsAutolinking: true;
+    readonly managedAutolinking: {
+        readonly etsImportPath: "@react-native-oh-tpl/react-native-fs/ts";
+        readonly etsPackageName: "FsPackage";
+    };
+    readonly docsUrl: "https://github.com/react-native-oh-library/usage-docs/blob/master/en/react-native-fs.md";
+}, {
+    readonly canonicalPackageName: "@shopify/react-native-skia";
+    readonly adapterPackageName: "@react-native-oh-tpl/react-native-skia";
+    readonly adapterVersion: "1.3.8-rc.1";
+    readonly harmonyHarFileName: "skia.har";
+    readonly supportsAutolinking: false;
+    readonly docsUrl: "https://github.com/react-native-oh-library";
+}];
+export type HarmonyNativeAdapter = (typeof HARMONY_NATIVE_ADAPTERS)[number];
 export declare const UI_STACK_CANONICAL_TO_ADAPTER: Record<string, string>;
 export declare const UI_STACK_ADAPTER_TO_CANONICAL: Record<string, string>;
 export declare const UI_STACK_ADAPTER_PACKAGE_NAMES: ("@react-native-oh-tpl/react-native-reanimated" | "@react-native-oh-tpl/react-native-svg")[];
+export declare const HARMONY_NATIVE_ADAPTER_PACKAGE_NAMES: ("@react-native-oh-tpl/react-native-reanimated" | "@react-native-oh-tpl/react-native-svg" | "@react-native-oh-tpl/async-storage" | "@react-native-oh-tpl/react-native-webview" | "@react-native-oh-tpl/react-native-screens" | "@react-native-oh-tpl/react-native-gesture-handler" | "@react-native-oh-tpl/lottie-react-native" | "@react-native-oh-tpl/react-native-safe-area-context" | "@react-native-oh-tpl/camera-roll" | "@react-native-oh-tpl/clipboard" | "@react-native-oh-tpl/react-native-image-picker" | "@react-native-oh-tpl/react-native-fs" | "@react-native-oh-tpl/react-native-skia")[];
 export declare function getUiStackAdapterSpecifier(adapter: UiStackValidatedAdapter): string;

package/build/data/uiStack.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UI_STACK_ADAPTER_PACKAGE_NAMES = exports.UI_STACK_ADAPTER_TO_CANONICAL = exports.UI_STACK_CANONICAL_TO_ADAPTER = exports.UI_STACK_VALIDATED_ADAPTERS = void 0;
+exports.HARMONY_NATIVE_ADAPTER_PACKAGE_NAMES = exports.UI_STACK_ADAPTER_PACKAGE_NAMES = exports.UI_STACK_ADAPTER_TO_CANONICAL = exports.UI_STACK_CANONICAL_TO_ADAPTER = exports.HARMONY_NATIVE_ADAPTERS = exports.UI_STACK_VALIDATED_ADAPTERS = void 0;
 exports.getUiStackAdapterSpecifier = getUiStackAdapterSpecifier;
 exports.UI_STACK_VALIDATED_ADAPTERS = [
     {
@@ -30,6 +30,7 @@ exports.UI_STACK_VALIDATED_ADAPTERS = [
         adapterRepository: 'react-native-oh-library/react-native-harmony-svg',
         adapterPath: 'react-native-harmony-svg',
         adapterCommit: '97c31d2f72559931d62fa84a9c86e86d343753d3',
+        npmSpecifier: '15.0.1-rc.11',
         harmonyHarFileName: 'svg.har',
         supportsAutolinking: false,
         managedAutolinking: {
@@ -42,9 +43,149 @@ exports.UI_STACK_VALIDATED_ADAPTERS = [
         docsUrl: 'https://github.com/react-native-oh-library/react-native-harmony-svg',
     },
 ];
+exports.HARMONY_NATIVE_ADAPTERS = [
+    ...exports.UI_STACK_VALIDATED_ADAPTERS,
+    {
+        canonicalPackageName: '@react-native-async-storage/async-storage',
+        adapterPackageName: '@react-native-oh-tpl/async-storage',
+        adapterVersion: '1.21.0-0.2.2',
+        harmonyHarFileName: 'async_storage.har',
+        supportsAutolinking: true,
+        managedAutolinking: {
+            etsImportPath: '@react-native-oh-tpl/async-storage/ts',
+            etsPackageName: 'AsyncStoragePackage',
+            cppHeaderName: 'AsyncStoragePackage.h',
+            cppPackageName: 'AsyncStoragePackage',
+            cmakeTargetName: 'rnoh_async_storage',
+        },
+        docsUrl: 'https://github.com/react-native-oh-library/usage-docs',
+    },
+    {
+        canonicalPackageName: 'react-native-webview',
+        adapterPackageName: '@react-native-oh-tpl/react-native-webview',
+        adapterVersion: '13.10.3',
+        harmonyHarFileName: 'rn_webview.har',
+        supportsAutolinking: true,
+        managedAutolinking: {
+            etsImportPath: '@react-native-oh-tpl/react-native-webview/ts',
+            etsPackageName: 'WebViewPackage',
+            cppHeaderName: 'WebViewPackage.h',
+            cppPackageName: 'WebViewPackage',
+            cmakeTargetName: 'rnoh_webview',
+        },
+        docsUrl: 'https://github.com/react-native-oh-library/usage-docs/blob/master/en/react-native-webview.md',
+    },
+    {
+        canonicalPackageName: 'react-native-screens',
+        adapterPackageName: '@react-native-oh-tpl/react-native-screens',
+        adapterVersion: '4.8.1-rc.3',
+        harmonyHarFileName: 'screens.har',
+        supportsAutolinking: true,
+        docsUrl: 'https://github.com/react-native-oh-library',
+    },
+    {
+        canonicalPackageName: 'react-native-gesture-handler',
+        adapterPackageName: '@react-native-oh-tpl/react-native-gesture-handler',
+        adapterVersion: '2.14.17-rc.0',
+        harmonyHarFileName: 'gesture_handler.har',
+        supportsAutolinking: true,
+        docsUrl: 'https://github.com/react-native-oh-library/react-native-harmony-gesture-handler',
+    },
+    {
+        canonicalPackageName: 'lottie-react-native',
+        adapterPackageName: '@react-native-oh-tpl/lottie-react-native',
+        adapterVersion: '6.4.1-0.1.9-1',
+        harmonyHarFileName: 'lottie.har',
+        supportsAutolinking: true,
+        managedAutolinking: {
+            cppHeaderName: 'LottieAnimationViewPackage.h',
+            cppPackageName: 'LottieAnimationViewPackage',
+            cmakeTargetName: 'rnoh_lottie',
+        },
+        docsUrl: 'https://github.com/react-native-oh-library',
+    },
+    {
+        canonicalPackageName: 'react-native-safe-area-context',
+        adapterPackageName: '@react-native-oh-tpl/react-native-safe-area-context',
+        adapterVersion: '4.7.4-0.2.1',
+        harmonyHarFileName: 'safe_area.har',
+        supportsAutolinking: true,
+        managedAutolinking: {
+            etsImportPath: '@react-native-oh-tpl/react-native-safe-area-context/ts',
+            etsPackageName: 'SafeAreaViewPackage',
+            cppHeaderName: 'SafeAreaViewPackage.h',
+            cppPackageName: 'SafeAreaViewPackage',
+            cmakeTargetName: 'rnoh_safe_area',
+        },
+        docsUrl: 'https://github.com/react-native-oh-library',
+    },
+    {
+        canonicalPackageName: '@react-native-camera-roll/camera-roll',
+        adapterPackageName: '@react-native-oh-tpl/camera-roll',
+        adapterVersion: '7.8.4-rc.2',
+        harmonyHarFileName: 'camera_roll.har',
+        supportsAutolinking: true,
+        managedAutolinking: {
+            etsImportPath: '@react-native-oh-tpl/camera-roll/ts',
+            etsPackageName: 'CameraRollPackage',
+        },
+        docsUrl: 'https://github.com/react-native-oh-library',
+    },
+    {
+        canonicalPackageName: '@react-native-clipboard/clipboard',
+        adapterPackageName: '@react-native-oh-tpl/clipboard',
+        adapterVersion: '1.13.2-0.0.9',
+        harmonyHarFileName: 'clipboard.har',
+        supportsAutolinking: true,
+        managedAutolinking: {
+            etsImportPath: '@react-native-oh-tpl/clipboard/ts',
+            etsPackageName: 'ClipboardPackage',
+            cppHeaderName: 'ClipboardPackage.h',
+            cppPackageName: 'ClipboardPackage',
+            cmakeTargetName: 'rnoh_clipboard',
+        },
+        docsUrl: 'https://github.com/react-native-oh-library',
+    },
+    {
+        canonicalPackageName: 'react-native-image-picker',
+        adapterPackageName: '@react-native-oh-tpl/react-native-image-picker',
+        adapterVersion: '7.0.3-0.1.7',
+        harmonyHarFileName: 'image_picker.har',
+        supportsAutolinking: true,
+        managedAutolinking: {
+            etsImportPath: '@react-native-oh-tpl/react-native-image-picker/ts',
+            etsPackageName: 'ImagePickerViewPackage',
+            cppHeaderName: 'RNImagePickerPackage.h',
+            cppPackageName: 'RNImagePickerPackage',
+            cmakeTargetName: 'rnoh_image_picker',
+        },
+        docsUrl: 'https://github.com/react-native-oh-library/usage-docs/blob/master/en/react-native-image-picker.md',
+    },
+    {
+        canonicalPackageName: 'react-native-fs',
+        adapterPackageName: '@react-native-oh-tpl/react-native-fs',
+        adapterVersion: '2.20.0-0.1.14',
+        harmonyHarFileName: 'fs.har',
+        supportsAutolinking: true,
+        managedAutolinking: {
+            etsImportPath: '@react-native-oh-tpl/react-native-fs/ts',
+            etsPackageName: 'FsPackage',
+        },
+        docsUrl: 'https://github.com/react-native-oh-library/usage-docs/blob/master/en/react-native-fs.md',
+    },
+    {
+        canonicalPackageName: '@shopify/react-native-skia',
+        adapterPackageName: '@react-native-oh-tpl/react-native-skia',
+        adapterVersion: '1.3.8-rc.1',
+        harmonyHarFileName: 'skia.har',
+        supportsAutolinking: false,
+        docsUrl: 'https://github.com/react-native-oh-library',
+    },
+];
 exports.UI_STACK_CANONICAL_TO_ADAPTER = Object.fromEntries(exports.UI_STACK_VALIDATED_ADAPTERS.map((entry) => [entry.canonicalPackageName, entry.adapterPackageName]));
 exports.UI_STACK_ADAPTER_TO_CANONICAL = Object.fromEntries(exports.UI_STACK_VALIDATED_ADAPTERS.map((entry) => [entry.adapterPackageName, entry.canonicalPackageName]));
 exports.UI_STACK_ADAPTER_PACKAGE_NAMES = exports.UI_STACK_VALIDATED_ADAPTERS.map((entry) => entry.adapterPackageName);
+exports.HARMONY_NATIVE_ADAPTER_PACKAGE_NAMES = exports.HARMONY_NATIVE_ADAPTERS.map((entry) => entry.adapterPackageName);
 function getUiStackAdapterSpecifier(adapter) {
     return `github:${adapter.adapterRepository}#${adapter.adapterCommit}&path:${adapter.adapterPath}`;
 }

package/build/data/validatedMatrices.js

@@ -93,7 +93,10 @@ exports.VALIDATED_RELEASE_MATRICES = {
                 [
                     entry.adapterPackageName,
                     {
-                        specifier: (0, uiStack_1.getUiStackAdapterSpecifier)(entry),
+                        specifiers: [
+                            (0, uiStack_1.getUiStackAdapterSpecifier)(entry),
+                            'npmSpecifier' in entry ? entry.npmSpecifier : entry.adapterVersion,
+                        ],
                     },
                 ],
             ])),

package/build/plugin.js

@@ -16,9 +16,13 @@ const project_2 = require("./core/project");
 const withExpoHarmony = (config, props = {}) => {
     validatePluginProps(props);
     const identifiers = (0, project_1.deriveHarmonyIdentifiers)(config, undefined, props);
+    const existingExpoHarmonyConfig = config.extra && typeof config.extra.expoHarmony === 'object' && config.extra.expoHarmony
+        ? config.extra.expoHarmony
+        : {};
     config.extra = {
         ...(config.extra ?? {}),
         expoHarmony: {
+            ...existingExpoHarmonyConfig,
             bundleName: identifiers.bundleName,
             entryModuleName: identifiers.entryModuleName,
             templateVersion: props.templateVersion ?? constants_1.TEMPLATE_VERSION,

package/build/types.d.ts

@@ -8,6 +8,16 @@ export type DependencyBuildabilityRisk = 'known' | 'js-only-unknown' | 'native-r
 export type CoverageProfile = 'managed-core' | 'managed-native-heavy' | 'bare' | 'third-party-native-heavy';
 export type GapCategory = 'matrix-drift' | 'official-module-gap' | 'third-party-native-gap' | 'bare-workflow-gap';
 export type DependencySource = 'dependency' | 'devDependency' | 'peerDependency' | 'expo-plugin';
+export interface ExpoHarmonyDoctorConfig {
+    excludeDependencies?: string[];
+    excludePlugins?: string[];
+    coverageProfile?: CoverageProfile;
+}
+export interface ExpoHarmonyResolvedDoctorConfig {
+    excludeDependencies: string[];
+    excludePlugins: string[];
+    coverageProfile: CoverageProfile | null;
+}
 export interface ExpoHarmonyPluginProps {
     bundleName?: string;
     entryModuleName?: string;
@@ -29,6 +39,7 @@ export interface BlockingIssue {
 export interface ValidatedDependencyRule {
     version?: string;
     specifier?: string;
+    specifiers?: string[];
     required?: boolean;
 }
 export interface ValidatedReleaseMatrix {
@@ -236,6 +247,7 @@ export interface ToolkitConfig {
     bundleName: string;
     entryModuleName: string;
     coverageProfile: CoverageProfile;
+    doctorConfig: ExpoHarmonyResolvedDoctorConfig;
     capabilities: ManagedCapabilityRecord[];
     requestedHarmonyPermissions: string[];
     nextActions: string[];

package/docs/npm-release.md

@@ -60,6 +60,7 @@ pnpm release:check
 
 - hosted CI 默认仍可通过 `EXPO_HARMONY_RELEASE_SKIP_HAP=1` 跳过真实 DevEco HAP 构建
 - debug / release HAP gate 继续由 capability acceptance、带工具链环境的 CI 或本地验收补齐
+- `v1.8.2` 已补一条 ccnubox release HAP 的本地签名、模拟器安装与启动记录；该记录不替代真机 device acceptance，也不把 preview capability 标为 release-ready
 - preview capability 若在报告里显示 `device=yes`，必须同时以 `evidenceSource.device=manual-doc` 对外说明其来源，不得表述成 CI 自动设备验证
 
 ## 手动发布

package/docs/signing-and-release.md

@@ -11,6 +11,36 @@
 - `harmony/build-profile.json5` 中存在可用的 `signingConfigs`
 - AppGallery Connect / 本地签名材料与工程配置一致
 
+`.expo-harmony/signing.local.json` 的最小结构与 `.expo-harmony/signing.local.example.json` 一致：
+
+```json
+{
+  "signingConfigs": [
+    {
+      "name": "default",
+      "type": "HarmonyOS",
+      "material": {
+        "storeFile": "./signing/release.p12",
+        "storePassword": "<replace-with-store-password>",
+        "keyAlias": "<replace-with-key-alias>",
+        "keyPassword": "<replace-with-key-password>",
+        "signAlg": "SHA256withECDSA",
+        "profile": "./signing/release.p7b",
+        "certpath": "./signing/release.cer"
+      }
+    }
+  ],
+  "products": [
+    {
+      "name": "default",
+      "signingConfig": "default"
+    }
+  ]
+}
+```
+
+真实发布时，这些材料应来自 DevEco / AppGallery Connect。OpenHarmony 本地自签材料只适合模拟器或内部验证，不能当作生产发布凭据。
+
 ## 如何检查
 
 在项目根目录执行：
@@ -51,6 +81,18 @@ expo-harmony build-hap --mode release
 
 - `env-report.json` 不再提示 `env.signing.missing`
 - DevEco / AppGallery Connect 的 release profile 已准备完成
+- release profile 覆盖了 HAP 中申请的 restricted permission；否则模拟器或设备可能在安装阶段报 `grant request permissions failed`
+
+## v1.8.2 本地模拟器证据
+
+`v1.8.2` 已在 ccnubox 本地验证目标上记录：
+
+- `expo-harmony env`：`Signing: configured`
+- `expo-harmony build-hap --mode release`：release signed HAP 构建成功
+- `hdc install -r <release-hap>`：模拟器安装成功
+- `aa start -a EntryAbility -b com.muxixyz.ccnubox`：启动成功
+
+这条记录只说明 release HAP 的本地签名、安装、启动链路可走通。它不代表 AppGallery 生产签名、不代表真机通过，也不关闭 preview capability 的 release runtime acceptance。
 
 ## 关系说明
 

package/docs/support-matrix.md

@@ -113,6 +113,7 @@
 - 当前四项 preview capability 都已经完成 preview baseline 的 bundle / debug build / route walkthrough
 - 四项 preview capability 都已经进入 `adapter` 路径；`device=yes[manual-doc]` 只表示已有人工设备验收记录，仍不代表 verified 或 release-ready
 - 当前 preview baseline 的默认 evidenceSource 固定为：`bundle/debugBuild=automated`、`device=manual-doc`、`release=none`
+- `v1.8.2` 的 ccnubox release HAP 模拟器安装/启动记录只证明 app-shell release 构建链路，不改变上述 per-capability `release=no[none]`
 - `v1.8.x` 开始，combined sample smoke 只负责总回归；每项 capability 还必须单独维护 device / release acceptance 记录，见 [acceptance/v1.8.x-capability-board.md](../acceptance/v1.8.x-capability-board.md)
 - `expo-file-system`
   - `🟡` 当前主路径是 UTF-8/base64 sandbox I/O、append/partial read、`getInfoAsync({ md5: true })` 与 `downloadAsync`
@@ -252,6 +253,8 @@ toolkit 受管的核心产物仍包括：
 - release signing / release HAP 验收完成
 - 文档、矩阵、roadmap、acceptance 记录同 PR 更新
 
+`v1.8.2` 记录的 simulator release-HAP evidence 只覆盖 ccnubox app-shell 的 signed HAP 构建、安装和启动；单 capability 的 release acceptance 仍必须按各自记录单独关闭。
+
 ## 当前仍未进入正式公开承诺
 
 - bare Expo

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-harmony-toolkit",
-  "version": "1.8.0",
+  "version": "1.8.2",
   "description": "面向 Managed/CNG Expo 项目的 HarmonyOS 迁移、准入检查与 UI-stack 构建工具链",
   "main": "app.plugin.js",
   "types": "build/index.d.ts",

package/templates/harmony/entry/build-profile.json5

@@ -4,6 +4,17 @@
     "externalNativeOptions": {
       "path": "./src/main/cpp/CMakeLists.txt",
       "arguments": ""
+    },
+    "nativeLib": {
+      "filter": {
+        "pickFirsts": [
+          "**/libhermestooling.so",
+          "**/libjsi.so",
+          "**/libreactnative.so",
+          "**/librnoh_core.so",
+          "**/librnoh_core_package.so"
+        ]
+      }
     }
   },
   "targets": [