@expo-harmony/prebuild-config 55.0.0-harmony.6 → 55.0.0-harmony.7

package/README.md

@@ -2,7 +2,7 @@
 
 [**GitHub 仓库**](https://github.com/renbaoshuo/expo-harmony/tree/master/packages/prebuild-config)
 
-为 Expo 项目提供 HarmonyOS 默认预构建配置，将 `expo.harmony` 转换为可重复生成的原生工程状态。它基于 `@expo-harmony/template` 配置 AppScope、Entry 模块、资源、Hvigor、CMake 和 RNOH 宿主代码，同时完成 Expo 原生模块自动链接并生成 CNG 清单。
+为 Expo 项目生成 HarmonyOS 原生工程。读取 `expo.harmony` 配置，写入 AppScope、Entry 模块、资源、Hvigor 配置、CMake 和 RNOH 宿主代码，并完成原生模块自动链接。
 
 ## 安装
 
@@ -10,9 +10,11 @@
 npm install @expo-harmony/prebuild-config
 ```
 
-## 基础用法
+应用还需要 `@react-native-oh/react-native-harmony` 和 `@react-native-oh/react-native-harmony-cli`，以及用来运行和构建的 `@expo-harmony/cli`。
 
-在 `app.json` 中启用插件并声明 HarmonyOS 配置：
+## 快速开始
+
+在 `app.json` 里注册插件：
 
 ```json
 {
@@ -20,6 +22,7 @@ npm install @expo-harmony/prebuild-config
     "name": "Example",
     "slug": "example",
     "version": "1.0.0",
+    "platforms": ["ios", "android", "harmony"],
     "plugins": ["@expo-harmony/prebuild-config"],
     "harmony": {
       "bundleName": "com.example.app",
@@ -30,13 +33,79 @@ npm install @expo-harmony/prebuild-config
 }
 ```
 
-使用 Expo Harmony CLI 生成或更新原生工程：
+`bundleName` 必填，其余字段有默认值。完整列表见 [@expo-harmony/config-plugins](../config-plugins/README.md)。
+
+生成或更新原生工程：
 
 ```sh
 npx expo-harmony prebuild
 ```
 
-需要使用字体、启动屏或其他 HarmonyOS 配置插件时，应将这些插件放在 `@expo-harmony/prebuild-config` 之前，由本包最后注册 Harmony Base Mods：
+工程写入项目根目录下的 `harmony`。`--clean` 先删除再重新生成，`--check` 只比较差异，不修改文件。
+
+## 生成内容
+
+| 文件                                   | 内容                                                |
+| -------------------------------------- | --------------------------------------------------- |
+| `AppScope/app.json5`                   | 包名、版本号、vendor、应用名和图标引用              |
+| `build-profile.json5`                  | product、module、SDK 版本、ABI 和签名配置           |
+| `entry/build-profile.json5`            | Entry 模块的 CMake 路径和 ABI                       |
+| `entry/src/main/module.json5`          | module、Ability、设备类型、权限和 querySchemes      |
+| `entry/src/main/resources/`            | 字符串、颜色和 media 资源                           |
+| `oh-package.json5`                     | RNOH 运行时依赖                                     |
+| `hvigor/hvigor-config.json5`           | RNOH Hvigor 插件依赖                                |
+| `hvigorfile.ts`、`entry/hvigorfile.ts` | Hvigor 构建脚本                                     |
+| `entry/src/main/ets/`                  | EntryAbility、Index 页面、Worker 和 PackageProvider |
+| `entry/src/main/cpp/`                  | PackageProvider.cpp 和 CMakeLists.txt               |
+| `react-native.config.js`               | RNOH 的 link-harmony 命令                           |
+
+## 应用图标
+
+`harmony.icon` 指定图标文件，支持 PNG、JPG、SVG 和 WebP。文件写入 AppScope 和 Entry 模块的 media 资源，替换同基本名的 `app_icon`。不设置时用模板自带的图标。
+
+## 权限
+
+`harmony.permissions` 里的权限写入 `module.json5` 的 `requestPermissions`，权限名用 `ohos.permission.*`。同名权限合并 `usedScene.abilities`，后写入的 `reason` 覆盖旧值。`reason` 写成 `$string:...` 引用，文案放在字符串资源里。
+
+## 自动链接
+
+prebuild 发现项目里支持 Harmony 的 Expo 模块，把模块信息和依赖写进工程，构建时由 Hvigor 和 CMake 链接。`buildType` 选项选择自动链接的构建模式：
+
+```json
+{
+  "expo": {
+    "plugins": [["@expo-harmony/prebuild-config", { "buildType": "release" }]]
+  }
+}
+```
+
+未指定时读取 `EXPO_HARMONY_BUILD_TYPE`，默认 `debug`。自动链接始终启用。
+
+## 签名配置
+
+`harmony.signingConfigFile` 指向一个 JSON5 文件，内容是一个签名配置对象，或一个 `signingConfigs` 数组。数组有多项时，其中一项要命名为 `default`。
+
+```json5
+{
+  name: 'default',
+  type: 'HarmonyOS',
+  material: {
+    certpath: './signing/app.cer',
+    storePassword: '...',
+    keyAlias: '...',
+    keyPassword: '...',
+    profile: './signing/app.p7b',
+    signAlg: 'SHA256withECDSA',
+    storeFile: './signing/app.p12',
+  },
+}
+```
+
+`material` 的七个字段都是必填的非空字符串，`signAlg` 固定为 `SHA256withECDSA`，`certpath`、`profile` 和 `storeFile` 指向真实文件。这些文件和签名配置文件本身要放在 `harmony` 目录之外，否则 `prebuild --clean` 会删掉它们。配置里的相对路径按签名配置文件所在目录解析。生成的 `build-profile.json5` 引用配置的 `name`，没有配置时不写签名。
+
+## 插件顺序
+
+默认配置在执行阶段读取最终的 app config，其他 Harmony 配置插件可以放在本包前面或后面。要覆盖默认值，把本包放到插件列表最后：
 
 ```json
 {
@@ -52,14 +121,37 @@ npx expo-harmony prebuild
       ],
       "@expo-harmony/expo-system-ui",
       "@expo-harmony/prebuild-config"
-    ],
-    "harmony": {
-      "bundleName": "com.example.app"
-    }
+    ]
   }
 }
 ```
 
+默认导出和具名导出 `withHarmonyPrebuildConfig` 是同一个插件，重复注册只生效一次。
+
+## 文件清理
+
+再次 prebuild 时，插件不再声明的文件会被删除；卸载插件后，它管理的文件也会清理。
+
+## 原生补丁
+
+用 [`@expo-harmony/patch-project`](https://github.com/renbaoshuo/expo-harmony/tree/master/packages/patch-project) 保存原生修改，并在 prebuild 时自动恢复。
+
+## 读取配置
+
+`getPrebuildConfigAsync(projectRoot)` 读取静态或动态 app config，执行已声明的配置插件，返回 `HarmonyProjectConfig`。它不生成原生工程。
+
+```ts
+import { getPrebuildConfigAsync } from '@expo-harmony/prebuild-config';
+
+const project = await getPrebuildConfigAsync(projectRoot);
+```
+
+`withHarmonyPrebuildConfig` 是插件本身，可以带 `HarmonyPrebuildOptions` 手动组合。`HarmonyPrebuildError` 带有 `code`、`operation` 和 `file`，用于识别预构建失败的原因。
+
+## 与上游 Expo 的分工
+
+HarmonyOS 的工程生成由本包负责，iOS 和 Android 仍使用 Expo 上游的预构建。此外，上游面向旧版应用的自动插件列表不适用于 HarmonyOS，模块插件要在应用里显式声明。
+
 ## Author
 
 **expo-harmony** © [Baoshuo](https://github.com/renbaoshuo), Released under the MIT License.<br>

package/build/api/template.d.ts

@@ -0,0 +1 @@
+export { ROOT_ENV, resolveBundled } from '../template';

package/build/api/template.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveBundled = exports.ROOT_ENV = void 0;
+var template_1 = require("../template");
+Object.defineProperty(exports, "ROOT_ENV", { enumerable: true, get: function () { return template_1.ROOT_ENV; } });
+Object.defineProperty(exports, "resolveBundled", { enumerable: true, get: function () { return template_1.resolveBundled; } });

package/build/buildDescriptor.js

@@ -10,6 +10,7 @@ exports.resolveHarmonyBuildPath = resolveHarmonyBuildPath;
 exports.validateHarmonyBuildDescriptor = validateHarmonyBuildDescriptor;
 const node_path_1 = __importDefault(require("node:path"));
 const config_plugins_1 = require("@expo-harmony/config-plugins");
+const internal_1 = require("@expo-harmony/config-plugins/internal");
 const BuildDescriptorSchemaVersion = 2;
 exports.BuildDescriptorSchemaVersion = BuildDescriptorSchemaVersion;
 const BuildModes = Object.freeze(['debug', 'release']);
@@ -61,8 +62,8 @@ function validateHarmonyBuildDescriptor(value) {
         || !isStrictDescendant(value.harmonyRoot, value.moduleRoot)) {
         throw new TypeError('Harmony build descriptor contains invalid project roots.');
     }
-    const harmonyRoot = value.harmonyRoot;
-    const moduleRoot = value.moduleRoot;
+    const harmony = value.harmonyRoot;
+    const module = value.moduleRoot;
     const identity = value.identity;
     if (!isRecord(identity)
         || ['abilityName', 'bundleName', 'moduleName', 'productName', 'targetName']
@@ -73,17 +74,17 @@ function validateHarmonyBuildDescriptor(value) {
     if (!isRecord(inputs)
         || !isSafeRelativePath(inputs.manifest)
         || !isSafeRelativePath(inputs.lockfile)
-        || !isStrictDescendant(harmonyRoot, inputs.manifest)
-        || !isStrictDescendant(harmonyRoot, inputs.lockfile)) {
+        || !isStrictDescendant(harmony, inputs.manifest)
+        || !isStrictDescendant(harmony, inputs.lockfile)) {
         throw new TypeError('Harmony build descriptor contains invalid native input paths.');
     }
     const cache = value.nativeCache;
     if (!isRecord(cache)
         || !isSafeRelativePath(cache.stateFile)
-        || !isStrictDescendant(moduleRoot, cache.stateFile)
+        || !isStrictDescendant(module, cache.stateFile)
         || !Array.isArray(cache.invalidationRoots)
         || cache.invalidationRoots.length === 0
-        || cache.invalidationRoots.some(item => (!isSafeRelativePath(item) || !isStrictDescendant(moduleRoot, item)))) {
+        || cache.invalidationRoots.some(item => (!isSafeRelativePath(item) || !isStrictDescendant(module, item)))) {
         throw new TypeError('Harmony build descriptor contains invalid native cache paths.');
     }
     const files = value.projectFiles;
@@ -97,8 +98,8 @@ function validateHarmonyBuildDescriptor(value) {
     const modules = ['moduleHvigor', 'moduleJson'];
     if (!isRecord(files)
         || [...roots, ...modules].some(field => !isSafeRelativePath(files[field]))
-        || roots.some(field => !isStrictDescendant(harmonyRoot, files[field]))
-        || modules.some(field => !isStrictDescendant(moduleRoot, files[field]))) {
+        || roots.some(field => !isStrictDescendant(harmony, files[field]))
+        || modules.some(field => !isStrictDescendant(module, files[field]))) {
         throw new TypeError('Harmony build descriptor contains invalid project file paths.');
     }
     const output = value.export;
@@ -108,7 +109,7 @@ function validateHarmonyBuildDescriptor(value) {
     const invalid = ['bundle', 'manifest', 'metadataRoot', 'rawfileRoot', 'sourceMap']
         .some(field => !isSafeRelativePath(output[field]));
     if (invalid
-        || !isStrictDescendant(moduleRoot, output.rawfileRoot)
+        || !isStrictDescendant(module, output.rawfileRoot)
         || !isStrictDescendant(output.rawfileRoot, output.bundle)
         || !isStrictDescendant(output.metadataRoot, output.sourceMap)) {
         throw new TypeError('Harmony build descriptor contains invalid export paths.');
@@ -120,7 +121,7 @@ function validateHarmonyBuildDescriptor(value) {
     }
     for (const mode of BuildModes) {
         const variant = validateVariant(value.variants[mode]);
-        if (!isStrictDescendant(moduleRoot, variant.expectedHap)) {
+        if (!isStrictDescendant(module, variant.expectedHap)) {
             throw new TypeError(`Harmony ${mode} HAP output must be inside the module root.`);
         }
     }
@@ -173,7 +174,7 @@ function createHarmonyBuildDescriptor(config, signing) {
             hvigorConfig: `${harmony}/${paths.hvigorConfig}`,
             moduleHvigor: `${harmony}/${paths.entryHvigor}`,
             moduleJson: `${harmony}/${paths.moduleJson}`,
-            nativeInputsStamp: `${harmony}/${paths.nativeInputsStamp}`,
+            nativeInputsStamp: `${harmony}/${internal_1.NativeInputsStampPath}`,
             projectBuildProfile: `${harmony}/${paths.projectBuildProfile}`,
             rootHvigor: `${harmony}/${paths.rootHvigor}`,
             templateMarker: `${harmony}/${HarmonyTemplateMarker}`,

package/build/check.js

@@ -10,19 +10,14 @@ exports.stageAsync = stageAsync;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const node_util_1 = require("node:util");
-const config_1 = require("@expo/config");
 const config_plugins_1 = require("@expo-harmony/config-plugins");
 const expo_modules_autolinking_1 = require("@expo-harmony/expo-modules-autolinking");
 const json5_1 = __importDefault(require("json5"));
 const errors_1 = require("./errors");
+const getPrebuildConfig_1 = require("./getPrebuildConfig");
 const buildDescriptor_1 = require("./buildDescriptor");
 const manifest_1 = require("./manifest");
 const signing_1 = require("./signing");
-function isInside(root, target) {
-    const relative = node_path_1.default.relative(root, target);
-    return relative === ''
-        || (!relative.startsWith(`..${node_path_1.default.sep}`) && relative !== '..' && !node_path_1.default.isAbsolute(relative));
-}
 function mirrorPath(temp, source) {
     const absolute = node_path_1.default.resolve(source);
     const parsed = node_path_1.default.parse(absolute);
@@ -126,10 +121,7 @@ async function stageManifestAsync(project, target) {
     catch (cause) {
         throw new errors_1.HarmonyPrebuildError('ERR_HARMONY_MANIFEST_DRIFT', `Cannot stage the CNG manifest for isolated --check: ${source}`, { cause, file: source, operation: 'check' });
     }
-    const config = (0, config_1.getConfig)(project, {
-        isModdedConfig: true,
-        skipSDKVersionRequirement: true,
-    }).exp;
+    const { exp: config } = await (0, getPrebuildConfig_1.getPrebuildConfigAsync)(project);
     const harmony = (0, config_plugins_1.normalizeHarmonyConfig)(config);
     const hash = (0, manifest_1.hashSha256)((0, config_plugins_1.stableHarmonyJson)(harmony));
     let identity = cng.managedIdentity;
@@ -162,20 +154,17 @@ async function stageManifestAsync(project, target) {
     }));
 }
 async function stageSigningAsync(project, temp) {
-    const config = (0, config_1.getConfig)(project, {
-        isModdedConfig: true,
-        skipSDKVersionRequirement: true,
-    }).exp;
+    const { exp: config } = await (0, getPrebuildConfig_1.getPrebuildConfigAsync)(project);
     const reference = config.harmony?.signingConfigFile;
     if (!reference)
         return;
     const signing = await (0, signing_1.validateHarmonySigningConfigFile)(project, reference);
     const inputs = [signing.file, ...Object.values(signing.materialFiles)];
     for (const source of inputs) {
-        if (isInside(project, source))
+        if (config_plugins_1.HarmonyPaths.isInside(project, source))
             continue;
         const target = mirrorPath(temp, source);
-        if (!isInside(temp, target)) {
+        if (!config_plugins_1.HarmonyPaths.isInside(temp, target)) {
             throw new errors_1.HarmonyPrebuildError('ERR_HARMONY_SIGNING_INVALID', `External Harmony signing input escapes the isolated --check workspace: ${source}`, { operation: 'check-signing' });
         }
         await node_fs_1.default.promises.mkdir(node_path_1.default.dirname(target), { recursive: true });

package/build/getPrebuildConfig.d.ts

@@ -0,0 +1,6 @@
+import { type ProjectConfig } from '@expo/config';
+import { type ExpoConfigWithHarmony } from '@expo-harmony/config-plugins';
+export type HarmonyProjectConfig = Omit<ProjectConfig, 'exp'> & {
+    exp: ExpoConfigWithHarmony;
+};
+export declare function getPrebuildConfigAsync(root: string): Promise<HarmonyProjectConfig>;

package/build/getPrebuildConfig.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPrebuildConfigAsync = getPrebuildConfigAsync;
+const config_1 = require("@expo/config");
+const config_plugins_1 = require("@expo-harmony/config-plugins");
+const withHarmonyPrebuildConfig_1 = require("./withHarmonyPrebuildConfig");
+async function getPrebuildConfigAsync(root) {
+    const project = (0, config_1.getConfig)(root, {
+        skipSDKVersionRequirement: true,
+        isModdedConfig: true,
+    });
+    const config = (0, withHarmonyPrebuildConfig_1.withHarmonyPrebuildConfig)(project.exp);
+    (0, config_plugins_1.normalizeHarmonyConfig)(config);
+    return { ...project, exp: config };
+}

package/build/index.d.ts

@@ -1,8 +1,6 @@
-export { HarmonyPrebuildPlugin as default } from './plugin';
-export { BuildDescriptorSchemaVersion, BuildModes, HarmonyPlatformDirectory, HarmonyTemplateMarker, createHarmonyBuildDescriptor, harmonyModuleSourcePath, resolveHarmonyBuildPath, validateHarmonyBuildDescriptor, type HarmonyBuildDescriptor, type HarmonyBuildMode, type HarmonyBuildVariantDescriptor, } from './buildDescriptor';
-export { HarmonyPrebuildError } from './errors';
-export { CngManifestPath, createCngManifest, validateCngManifest, type CngManifest, } from './manifest';
-export { isRnohAutolinkingDisabled } from './native';
-export { validateHarmonySigningConfigFile, type HarmonySigningConfig } from './signing';
-export { withHarmonyPrebuildConfig } from './withHarmonyPrebuildConfig';
+export { withHarmonyPrebuildConfig as default, withHarmonyPrebuildConfig } from './withHarmonyPrebuildConfig';
 export type { HarmonyPrebuildOptions } from './withHarmonyPrebuildConfig';
+export { getPrebuildConfigAsync } from './getPrebuildConfig';
+export type { HarmonyProjectConfig } from './getPrebuildConfig';
+export { HarmonyPrebuildError } from './errors';
+export type { HarmonyPrebuildErrorOptions } from './errors';

package/build/index.js

@@ -1,26 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.withHarmonyPrebuildConfig = exports.validateHarmonySigningConfigFile = exports.isRnohAutolinkingDisabled = exports.validateCngManifest = exports.createCngManifest = exports.CngManifestPath = exports.HarmonyPrebuildError = exports.validateHarmonyBuildDescriptor = exports.resolveHarmonyBuildPath = exports.harmonyModuleSourcePath = exports.createHarmonyBuildDescriptor = exports.HarmonyTemplateMarker = exports.HarmonyPlatformDirectory = exports.BuildModes = exports.BuildDescriptorSchemaVersion = exports.default = void 0;
-var plugin_1 = require("./plugin");
-Object.defineProperty(exports, "default", { enumerable: true, get: function () { return plugin_1.HarmonyPrebuildPlugin; } });
-var buildDescriptor_1 = require("./buildDescriptor");
-Object.defineProperty(exports, "BuildDescriptorSchemaVersion", { enumerable: true, get: function () { return buildDescriptor_1.BuildDescriptorSchemaVersion; } });
-Object.defineProperty(exports, "BuildModes", { enumerable: true, get: function () { return buildDescriptor_1.BuildModes; } });
-Object.defineProperty(exports, "HarmonyPlatformDirectory", { enumerable: true, get: function () { return buildDescriptor_1.HarmonyPlatformDirectory; } });
-Object.defineProperty(exports, "HarmonyTemplateMarker", { enumerable: true, get: function () { return buildDescriptor_1.HarmonyTemplateMarker; } });
-Object.defineProperty(exports, "createHarmonyBuildDescriptor", { enumerable: true, get: function () { return buildDescriptor_1.createHarmonyBuildDescriptor; } });
-Object.defineProperty(exports, "harmonyModuleSourcePath", { enumerable: true, get: function () { return buildDescriptor_1.harmonyModuleSourcePath; } });
-Object.defineProperty(exports, "resolveHarmonyBuildPath", { enumerable: true, get: function () { return buildDescriptor_1.resolveHarmonyBuildPath; } });
-Object.defineProperty(exports, "validateHarmonyBuildDescriptor", { enumerable: true, get: function () { return buildDescriptor_1.validateHarmonyBuildDescriptor; } });
-var errors_1 = require("./errors");
-Object.defineProperty(exports, "HarmonyPrebuildError", { enumerable: true, get: function () { return errors_1.HarmonyPrebuildError; } });
-var manifest_1 = require("./manifest");
-Object.defineProperty(exports, "CngManifestPath", { enumerable: true, get: function () { return manifest_1.CngManifestPath; } });
-Object.defineProperty(exports, "createCngManifest", { enumerable: true, get: function () { return manifest_1.createCngManifest; } });
-Object.defineProperty(exports, "validateCngManifest", { enumerable: true, get: function () { return manifest_1.validateCngManifest; } });
-var native_1 = require("./native");
-Object.defineProperty(exports, "isRnohAutolinkingDisabled", { enumerable: true, get: function () { return native_1.isRnohAutolinkingDisabled; } });
-var signing_1 = require("./signing");
-Object.defineProperty(exports, "validateHarmonySigningConfigFile", { enumerable: true, get: function () { return signing_1.validateHarmonySigningConfigFile; } });
+exports.HarmonyPrebuildError = exports.getPrebuildConfigAsync = exports.withHarmonyPrebuildConfig = exports.default = void 0;
 var withHarmonyPrebuildConfig_1 = require("./withHarmonyPrebuildConfig");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return withHarmonyPrebuildConfig_1.withHarmonyPrebuildConfig; } });
 Object.defineProperty(exports, "withHarmonyPrebuildConfig", { enumerable: true, get: function () { return withHarmonyPrebuildConfig_1.withHarmonyPrebuildConfig; } });
+var getPrebuildConfig_1 = require("./getPrebuildConfig");
+Object.defineProperty(exports, "getPrebuildConfigAsync", { enumerable: true, get: function () { return getPrebuildConfig_1.getPrebuildConfigAsync; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "HarmonyPrebuildError", { enumerable: true, get: function () { return errors_1.HarmonyPrebuildError; } });

package/build/internal.d.ts

@@ -0,0 +1,6 @@
+export { compareAsync, readManifestIfPresentAsync, stageAsync } from './check';
+export type { Change, Result } from './check';
+export { HarmonyPlatformDirectory, resolveHarmonyBuildPath } from './buildDescriptor';
+export type { HarmonyBuildDescriptor } from './buildDescriptor';
+export { isRnohAutolinkingDisabled } from './native';
+export { validateHarmonySigningConfigFile } from './signing';

package/build/internal.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateHarmonySigningConfigFile = exports.isRnohAutolinkingDisabled = exports.resolveHarmonyBuildPath = exports.HarmonyPlatformDirectory = exports.stageAsync = exports.readManifestIfPresentAsync = exports.compareAsync = void 0;
+var check_1 = require("./check");
+Object.defineProperty(exports, "compareAsync", { enumerable: true, get: function () { return check_1.compareAsync; } });
+Object.defineProperty(exports, "readManifestIfPresentAsync", { enumerable: true, get: function () { return check_1.readManifestIfPresentAsync; } });
+Object.defineProperty(exports, "stageAsync", { enumerable: true, get: function () { return check_1.stageAsync; } });
+var buildDescriptor_1 = require("./buildDescriptor");
+Object.defineProperty(exports, "HarmonyPlatformDirectory", { enumerable: true, get: function () { return buildDescriptor_1.HarmonyPlatformDirectory; } });
+Object.defineProperty(exports, "resolveHarmonyBuildPath", { enumerable: true, get: function () { return buildDescriptor_1.resolveHarmonyBuildPath; } });
+var native_1 = require("./native");
+Object.defineProperty(exports, "isRnohAutolinkingDisabled", { enumerable: true, get: function () { return native_1.isRnohAutolinkingDisabled; } });
+var signing_1 = require("./signing");
+Object.defineProperty(exports, "validateHarmonySigningConfigFile", { enumerable: true, get: function () { return signing_1.validateHarmonySigningConfigFile; } });

package/build/manifest.js

@@ -12,6 +12,8 @@ const node_crypto_1 = require("node:crypto");
 const node_fs_1 = require("node:fs");
 const node_path_1 = __importDefault(require("node:path"));
 const config_plugins_1 = require("@expo-harmony/config-plugins");
+const internal_1 = require("@expo-harmony/config-plugins/internal");
+const json5_1 = __importDefault(require("json5"));
 const errors_1 = require("./errors");
 const buildDescriptor_1 = require("./buildDescriptor");
 const packageMetadata_1 = require("./packageMetadata");
@@ -62,7 +64,7 @@ function validateCngManifest(manifest, options = {}) {
         throw new errors_1.HarmonyPrebuildError('ERR_HARMONY_MANIFEST_INVALID', 'Harmony CNG manifest managedFiles must be an array.', { file, operation: 'validate-manifest' });
     }
     try {
-        manifest.configPlugins = (0, config_plugins_1.normalizeHarmonyConfigPlugins)(manifest.configPlugins);
+        manifest.configPlugins = (0, internal_1.normalizeHarmonyConfigPlugins)(manifest.configPlugins);
     }
     catch (cause) {
         throw new errors_1.HarmonyPrebuildError('ERR_HARMONY_MANIFEST_INVALID', `Harmony CNG manifest has invalid config-plugin ownership: ${cause.message}`, { cause, file, operation: 'validate-manifest' });
@@ -127,29 +129,36 @@ async function hashFile(file) {
     return hashSha256(Uint8Array.from(await node_fs_1.promises.readFile(file)));
 }
 async function createCngManifest(root, config, managed, modules = [], signing = null, plugins = []) {
-    const build = (0, buildDescriptor_1.createHarmonyBuildDescriptor)(config, signing);
+    const file = node_path_1.default.join(root, 'harmony', config_plugins_1.HarmonyPaths.HARMONY_PATHS.projectBuildProfile);
+    const profile = json5_1.default.parse(await node_fs_1.promises.readFile(file, 'utf8'));
+    const product = profile.app?.products?.find(item => item.name === config.productName);
+    const build = (0, buildDescriptor_1.createHarmonyBuildDescriptor)(config, product?.signingConfig ?? null);
     const files = [];
     for (const item of managed) {
         const target = node_path_1.default.join(root, ...item.path.split('/'));
         try {
             files.push({ owner: item.owner, path: item.path, sha256: await hashFile(target) });
         }
-        catch (error) {
-            if (error.code !== 'ENOENT')
-                return Promise.reject(error);
+        catch (cause) {
+            if (cause.code !== 'ENOENT') {
+                throw new errors_1.HarmonyPrebuildError(cause.code || 'ERR_HARMONY_MANIFEST_INVALID', cause.message || `Cannot hash managed file ${target}.`, { cause, file: target, operation: 'create-manifest' });
+            }
         }
     }
     files.sort((left, right) => left.path.localeCompare(right.path, 'en'));
-    const autolinkingFile = node_path_1.default.join(root, '.expo/harmony/autolinking.json');
-    const autolinkingHash = await hashFile(autolinkingFile)
-        .catch(error => error.code === 'ENOENT' ? hashSha256('') : Promise.reject(error));
+    const autolinking = node_path_1.default.join(root, '.expo/harmony/autolinking.json');
+    const hash = await hashFile(autolinking).catch((cause) => {
+        if (cause.code === 'ENOENT')
+            return hashSha256('');
+        throw new errors_1.HarmonyPrebuildError(cause.code || 'ERR_HARMONY_MANIFEST_INVALID', cause.message || `Cannot hash autolinking manifest ${autolinking}.`, { cause, file: autolinking, operation: 'create-manifest' });
+    });
     return validateCngManifest({
         build,
         generatedAt: null,
-        configPlugins: (0, config_plugins_1.normalizeHarmonyConfigPlugins)(plugins),
+        configPlugins: (0, internal_1.normalizeHarmonyConfigPlugins)(plugins),
         generator: { package: '@expo-harmony/prebuild-config', version: GeneratorVersion },
         inputs: {
-            autolinkingHash,
+            autolinkingHash: hash,
             configHash: hashSha256((0, config_plugins_1.stableHarmonyJson)(config)),
         },
         managedFiles: files,

package/build/mods/withAutolinkingMods.d.ts

@@ -1 +1,2 @@
-export declare function withAutolinkingMods(config: any, harmony: any, options: any): any;
+import type { HarmonyPrebuildOptions } from '../withHarmonyPrebuildConfig';
+export declare function withAutolinkingMods(config: any, options: HarmonyPrebuildOptions): any;

package/build/mods/withAutolinkingMods.js

@@ -8,6 +8,7 @@ const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const expo_modules_autolinking_1 = require("@expo-harmony/expo-modules-autolinking");
 const config_plugins_1 = require("@expo-harmony/config-plugins");
+const internal_1 = require("@expo-harmony/config-plugins/internal");
 const errors_1 = require("../errors");
 const buildDescriptor_1 = require("../buildDescriptor");
 const manifest_1 = require("../manifest");
@@ -16,14 +17,20 @@ function formatAutolinkingDiagnostics(cause) {
         ? ` ${cause.diagnostics.map(item => `[${item.code}] ${item.message}`).join(' ')}`
         : '';
 }
-function withAutolinkingMods(config, harmony, options) {
+function withAutolinkingMods(config, options) {
     config = (0, config_plugins_1.withHarmonyAutolinking)(config, async (mod) => {
+        if (mod.modRequest.introspect)
+            return mod;
+        const harmony = (0, config_plugins_1.normalizeHarmonyConfig)(mod.modRawConfig);
+        const mode = options.buildType ?? process.env.EXPO_HARMONY_BUILD_TYPE ?? 'debug';
+        if (mode !== 'debug' && mode !== 'release') {
+            throw new errors_1.HarmonyPrebuildError('ERR_HARMONY_CONFIG_INVALID', 'EXPO_HARMONY_BUILD_TYPE must be debug or release.', { operation: 'autolinking' });
+        }
         try {
             const root = mod.modRequest.projectRoot;
             const project = await node_fs_1.default.promises.realpath(root);
             const build = (0, buildDescriptor_1.createHarmonyBuildDescriptor)(harmony, mod._internal?.harmonySigningConfig?.name ?? null);
             const platform = (0, buildDescriptor_1.resolveHarmonyBuildPath)(project, build.harmonyRoot);
-            const mode = (options.buildType || process.env.EXPO_HARMONY_BUILD_TYPE || 'debug');
             const result = await (0, expo_modules_autolinking_1.linkModulesAsync)({
                 projectRoot: project,
                 harmonyProjectPath: platform,
@@ -44,9 +51,12 @@ function withAutolinkingMods(config, harmony, options) {
             throw new errors_1.HarmonyPrebuildError('ERR_HARMONY_AUTOLINK_FAILED', `Harmony autolinking failed: ${cause.message}${formatAutolinkingDiagnostics(cause)}`, { cause, operation: 'autolinking' });
         }
     });
-    config = (0, config_plugins_1.withCngManifest)(config, async (mod) => {
+    config = (0, internal_1.withCngManifest)(config, async (mod) => {
+        if (mod.modRequest.introspect)
+            return mod;
+        const harmony = (0, config_plugins_1.normalizeHarmonyConfig)(mod.modRawConfig);
         const managed = mod._internal?.harmonyManagedFiles || [];
-        const manifest = await (0, manifest_1.createCngManifest)(mod.modRequest.projectRoot, harmony, managed, mod._internal?.harmonyAutolinkingModules || [], mod._internal?.harmonySigningConfig?.name ?? null, (0, config_plugins_1.getHarmonyConfigPlugins)(mod));
+        const manifest = await (0, manifest_1.createCngManifest)(mod.modRequest.projectRoot, harmony, managed, mod._internal?.harmonyAutolinkingModules || [], mod._internal?.harmonySigningConfig?.name ?? null, (0, internal_1.getHarmonyConfigPlugins)(mod));
         const file = (0, buildDescriptor_1.resolveHarmonyBuildPath)(mod.modRequest.projectRoot, manifest_1.CngManifestPath);
         await node_fs_1.default.promises.mkdir(node_path_1.default.dirname(file), { recursive: true });
         await node_fs_1.default.promises.writeFile(file, (0, config_plugins_1.stableHarmonyJson)(manifest));

package/build/mods/withEntryMods.d.ts

@@ -1,2 +1,2 @@
-declare function withEntryMods(config: any, harmony: any): any;
+declare function withEntryMods(config: any): any;
 export { withEntryMods };

package/build/mods/withEntryMods.js

@@ -40,19 +40,13 @@ exports.withEntryMods = withEntryMods;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const config_plugins_1 = require("@expo-harmony/config-plugins");
+const internal_1 = require("@expo-harmony/config-plugins/internal");
 const buildDescriptor_1 = require("../buildDescriptor");
 const dependencies_1 = require("../dependencies");
 const errors_1 = require("../errors");
 const reconcile_1 = require("../reconcile");
 const render = __importStar(require("../renderers"));
 const stale_1 = require("../stale");
-function setResource(items, name, value) {
-    const resources = (Array.isArray(items) ? items : [])
-        .filter(item => item?.name !== name);
-    resources.push({ name, value });
-    resources.sort((left, right) => left.name.localeCompare(right.name, 'en'));
-    return resources;
-}
 function replaceMediaBase(files, base, descriptor) {
     for (const name of Object.keys(files)) {
         if (node_path_1.default.parse(name).name === base)
@@ -100,8 +94,9 @@ function resolveInputFile(root, value) {
     }
     return file;
 }
-function withEntryMods(config, harmony) {
+function withEntryMods(config) {
     config = (0, config_plugins_1.withEntryBuildProfile)(config, (mod) => {
+        const harmony = (0, config_plugins_1.normalizeHarmonyConfig)(mod.modRawConfig);
         const build = (0, reconcile_1.readRecord)(mod.modResults.buildOption);
         const native = (0, reconcile_1.readRecord)(build.externalNativeOptions);
         mod.modResults = {
@@ -124,6 +119,7 @@ function withEntryMods(config, harmony) {
         return mod;
     });
     config = (0, config_plugins_1.withEntryOhPackage)(config, (mod) => {
+        const harmony = (0, config_plugins_1.normalizeHarmonyConfig)(mod.modRawConfig);
         mod.modResults = {
             ...mod.modResults,
             name: harmony.moduleName,
@@ -135,19 +131,21 @@ function withEntryMods(config, harmony) {
         return mod;
     });
     config = (0, config_plugins_1.withEntryHvigor)(config, async (mod) => {
+        const harmony = (0, config_plugins_1.normalizeHarmonyConfig)(mod.modRawConfig);
         const build = (0, buildDescriptor_1.createHarmonyBuildDescriptor)(harmony, mod._internal?.harmonySigningConfig?.name ?? null);
         const relative = node_path_1.default.posix.relative(build.harmonyRoot, build.projectFiles.moduleHvigor);
         mod.modResults = render.renderCanonical(await (0, dependencies_1.readTemplateSource)(relative), build.projectFiles.moduleHvigor);
         return mod;
     });
     config = (0, config_plugins_1.withModuleJson)(config, (mod) => {
+        const harmony = (0, config_plugins_1.normalizeHarmonyConfig)(mod.modRawConfig);
         const home = {
             entities: ['entity.system.home'],
             actions: ['action.system.home'],
         };
         const module = (0, stale_1.removeStaleExtensionAbilities)((0, reconcile_1.readRecord)(mod.modResults.module), config_plugins_1.HarmonyPaths.toPosixRelative(mod.modRequest.projectRoot, node_path_1.default.join(mod.modRequest.platformProjectRoot, config_plugins_1.HarmonyPaths.HARMONY_PATHS.moduleJson)), mod._internal?.harmonyStalePluginFiles || []);
         const previous = mod._internal?.harmonyPreviousManagedIdentity;
-        const plugins = (0, config_plugins_1.getHarmonyConfigPlugins)(mod);
+        const plugins = (0, internal_1.getHarmonyConfigPlugins)(mod);
         const abilities = (0, reconcile_1.upsertManagedNamed)(module.abilities, harmony.abilityName, previous?.abilityName, 'EntryAbility', existing => ({
             ...existing,
             name: harmony.abilityName,
@@ -188,25 +186,29 @@ function withEntryMods(config, harmony) {
         return mod;
     });
     config = (0, config_plugins_1.withStrings)(config, (mod) => {
+        const harmony = (0, config_plugins_1.normalizeHarmonyConfig)(mod.modRawConfig);
         mod.modResults = (0, stale_1.removeStaleResources)(mod.modResults, 'strings', mod._internal?.harmonyStaleConfigPlugins || []);
-        mod.modResults.app ??= {};
-        mod.modResults.entry ??= {};
-        mod.modResults.app.string = setResource(mod.modResults.app.string, 'app_name', harmony.label);
-        let strings = mod.modResults.entry.string || [];
-        strings = setResource(strings, 'expo_harmony_ability_desc', `${harmony.label} main ability`);
-        strings = setResource(strings, 'expo_harmony_ability_label', harmony.label);
-        strings = setResource(strings, 'expo_harmony_module_desc', `${harmony.label} entry module`);
-        mod.modResults.entry.string = strings;
+        const app = mod.modResults.app ??= {};
+        const entry = mod.modResults.entry ??= {};
+        config_plugins_1.HarmonyResources.setString(app, { name: 'app_name', value: harmony.label });
+        config_plugins_1.HarmonyResources.setString(entry, { name: 'expo_harmony_ability_desc', value: `${harmony.label} main ability` });
+        config_plugins_1.HarmonyResources.setString(entry, { name: 'expo_harmony_ability_label', value: harmony.label });
+        config_plugins_1.HarmonyResources.setString(entry, { name: 'expo_harmony_module_desc', value: `${harmony.label} entry module` });
+        for (const file of [app, entry])
+            file.string.sort((left, right) => left.name.localeCompare(right.name, 'en'));
         return mod;
     });
     config = (0, config_plugins_1.withColors)(config, (mod) => {
+        const harmony = (0, config_plugins_1.normalizeHarmonyConfig)(mod.modRawConfig);
         mod.modResults = (0, stale_1.removeStaleResources)(mod.modResults, 'colors', mod._internal?.harmonyStaleConfigPlugins || []);
-        mod.modResults.entry ??= {};
+        const entry = mod.modResults.entry ??= {};
         mod.modResults.entryDark ??= {};
-        mod.modResults.entry.color = setResource(mod.modResults.entry.color, 'expo_harmony_start_window_background', harmony.backgroundColor);
+        config_plugins_1.HarmonyResources.setColor(entry, { name: 'expo_harmony_start_window_background', value: harmony.backgroundColor });
+        entry.color.sort((left, right) => left.name.localeCompare(right.name, 'en'));
         return mod;
     });
     config = (0, config_plugins_1.withMedia)(config, (mod) => {
+        const harmony = (0, config_plugins_1.normalizeHarmonyConfig)(mod.modRawConfig);
         mod.modResults = (0, stale_1.removeStaleResources)(mod.modResults, 'media', mod._internal?.harmonyStaleConfigPlugins || []);
         const icon = harmony.icon
             ? resolveInputFile(mod.modRequest.projectRoot, harmony.icon)

package/build/mods/withPreparationMod.d.ts

@@ -1,2 +1,2 @@
-declare function withPreparationMod(config: any, harmony: any): import("@expo/config-types").ExpoConfig;
+declare function withPreparationMod(config: any): any;
 export { withPreparationMod };