@expo-harmony/config-plugins 55.0.10-harmony.4 → 55.0.11-harmony.2

package/README.md

@@ -40,9 +40,9 @@ module.exports = defineExpoHarmonyConfig({
 | `vendor` | `expo-harmony` |
 | `versionCode` | `1` |
 | `versionName` | 配置里的 `version`，没有则 `1.0.0` |
-| `targetApiVersion` | `24` |
-| `targetSdkVersion` | 数字或 SDK 标签，默认跟随 `targetApiVersion` |
-| `compatibleSdkVersion` | `13`，不能低于 13，也不能大于 `targetApiVersion` |
+| `targetApiVersion` | 旧版别名，建议改用 `expo-build-properties` 的 `targetSdkVersion` |
+| `targetSdkVersion` | 数字或 SDK 字符串，默认 `24`，兼容旧 `targetApiVersion` |
+| `compatibleSdkVersion` | `20`，不能低于 20，也不能大于 target |
 | `deviceTypes` | `['phone', 'tablet']` |
 | `permissions` | 权限列表，默认包含 `ohos.permission.INTERNET` |
 | `skills` | 技能列表，`scheme` 会追加对应项 |
@@ -56,7 +56,7 @@ module.exports = defineExpoHarmonyConfig({
 | `abiFilters` | `['arm64-v8a', 'x86_64']` |
 | `signingConfigFile` | 签名配置文件路径，不设置则忽略 |
 
-`targetSdkVersion` 和 `compatibleSdkVersion` 可以写数字或带 API 级别的 SDK 标签。内置标签覆盖 API 13、14、20、21、23、24，其他版本写成 `6.1.1(24)` 这样的形式。`backgroundColor` 写 `#RRGGBB` 或 `#RRGGBBAA`，写入原生工程时转成 ARGB。`jsEngine` 目前只能是 `hermes`。
+SDK/ABI 的这些旧字段继续兼容，新项目建议使用 `@expo-harmony/expo-build-properties`。`targetSdkVersion` 和 `compatibleSdkVersion` 可以写数字或带 API 级别的 SDK 标签；API 26 起使用 `26.0.0` 这样的分段版本。内置旧标签覆盖 API 13、14、20、21、23、24，已知 API 不接受错误的标签。`targetApiVersion` 与 `targetSdkVersion` 同时存在时须一致。`backgroundColor` 写 `#RRGGBB` 或 `#RRGGBBAA`，写入原生工程时转成 ARGB。`jsEngine` 目前只能是 `hermes`。
 
 `normalizeHarmonyConfig(config)` 返回补齐默认值并校验后的配置。
 

package/build/config.d.ts

@@ -26,6 +26,10 @@ export interface HarmonyConfig {
     vendor?: string;
     versionCode?: number;
     versionName?: string;
+    runtimeVersion?: string | {
+        policy: 'nativeVersion' | 'sdkVersion' | 'appVersion' | 'fingerprint';
+    };
+    /** @deprecated Configure targetSdkVersion in @expo-harmony/expo-build-properties. */
     targetApiVersion?: number;
     targetSdkVersion?: number | string;
     compatibleSdkVersion?: number | string;
@@ -41,6 +45,8 @@ export interface HarmonyConfig {
     jsEngine?: 'hermes';
     abiFilters?: string[];
     signingConfigFile?: string;
+    /** Native module build options supplied by config plugins. */
+    moduleBuilds?: Record<string, Record<string, string | number | boolean>>;
 }
 export type ExpoConfigWithHarmony = Omit<ExpoConfig, 'platforms'> & {
     platforms?: ExpoHarmonyPlatform[];

package/build/index.d.ts

@@ -25,3 +25,5 @@ export type { HarmonyResourceFile, HarmonyResourceItem } from './resources';
 export { withHarmonyGeneratedFiles, withRawfile } from './generatedFiles';
 export type { HarmonyFileDescriptor, HarmonyFileMap, HarmonyGeneratedFilesOptions } from './generatedFiles';
 export { HarmonyPermissions, withHarmonyPermissions } from './permissions';
+export { parseHarmonySdkVersion, compareHarmonyApiVersions } from './sdkVersion';
+export type { HarmonySdkVersion } from './sdkVersion';

package/build/index.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.withHarmonyPermissions = exports.HarmonyPermissions = exports.withRawfile = exports.withHarmonyGeneratedFiles = exports.HarmonyResources = exports.HarmonyManifest = exports.HarmonyPaths = exports.registerHarmonyConfigPlugin = exports.withWorker = exports.withStrings = exports.withRootOhPackage = exports.withRootHvigor = exports.withReactNativeConfig = exports.withProjectBuildProfile = exports.withProfiles = exports.withModuleJson = exports.withMedia = exports.withIndexPage = exports.withHvigorConfig = exports.withHarmonyResources = exports.withHarmonyMod = exports.withHarmonyDangerousMod = exports.withHarmonyBaseMods = exports.withHarmonyAutolinking = exports.withEntryOhPackage = exports.withEntryHvigor = exports.withEntryBuildProfile = exports.withEntryAbility = exports.withAbilityStage = exports.withCppPackageProvider = exports.withColors = exports.withCMakeLists = exports.withArkTSPackageProvider = exports.withAppJson = exports.recordManagedFile = exports.HARMONY_MOD_NAMES = exports.normalizeHarmonyConfig = exports.stableHarmonyJson = exports.atomicWrite = exports.HarmonyConfigPluginError = exports.withHarmonyJsonFile = exports.createHarmonyFileMod = exports.compileHarmonyModsAsync = exports.withStaticPlugin = exports.withRunOnce = exports.withPlugins = exports.createRunOncePlugin = exports.defineExpoHarmonyConfig = void 0;
+exports.compareHarmonyApiVersions = exports.parseHarmonySdkVersion = exports.withHarmonyPermissions = exports.HarmonyPermissions = exports.withRawfile = exports.withHarmonyGeneratedFiles = exports.HarmonyResources = exports.HarmonyManifest = exports.HarmonyPaths = exports.registerHarmonyConfigPlugin = exports.withWorker = exports.withStrings = exports.withRootOhPackage = exports.withRootHvigor = exports.withReactNativeConfig = exports.withProjectBuildProfile = exports.withProfiles = exports.withModuleJson = exports.withMedia = exports.withIndexPage = exports.withHvigorConfig = exports.withHarmonyResources = exports.withHarmonyMod = exports.withHarmonyDangerousMod = exports.withHarmonyBaseMods = exports.withHarmonyAutolinking = exports.withEntryOhPackage = exports.withEntryHvigor = exports.withEntryBuildProfile = exports.withEntryAbility = exports.withAbilityStage = exports.withCppPackageProvider = exports.withColors = exports.withCMakeLists = exports.withArkTSPackageProvider = exports.withAppJson = exports.recordManagedFile = exports.HARMONY_MOD_NAMES = exports.normalizeHarmonyConfig = exports.stableHarmonyJson = exports.atomicWrite = exports.HarmonyConfigPluginError = exports.withHarmonyJsonFile = exports.createHarmonyFileMod = exports.compileHarmonyModsAsync = exports.withStaticPlugin = exports.withRunOnce = exports.withPlugins = exports.createRunOncePlugin = exports.defineExpoHarmonyConfig = void 0;
 var config_1 = require("./config");
 Object.defineProperty(exports, "defineExpoHarmonyConfig", { enumerable: true, get: function () { return config_1.defineExpoHarmonyConfig; } });
 var composition_1 = require("./composition");
@@ -94,3 +94,6 @@ Object.defineProperty(exports, "withRawfile", { enumerable: true, get: function
 var permissions_1 = require("./permissions");
 Object.defineProperty(exports, "HarmonyPermissions", { enumerable: true, get: function () { return permissions_1.HarmonyPermissions; } });
 Object.defineProperty(exports, "withHarmonyPermissions", { enumerable: true, get: function () { return permissions_1.withHarmonyPermissions; } });
+var sdkVersion_1 = require("./sdkVersion");
+Object.defineProperty(exports, "parseHarmonySdkVersion", { enumerable: true, get: function () { return sdkVersion_1.parseHarmonySdkVersion; } });
+Object.defineProperty(exports, "compareHarmonyApiVersions", { enumerable: true, get: function () { return sdkVersion_1.compareHarmonyApiVersions; } });

package/build/normalizeConfig.d.ts

@@ -10,13 +10,14 @@ interface NormalizedHarmonyConfig {
     icon?: string;
     label: string;
     moduleName: string;
+    moduleBuilds?: NonNullable<HarmonyConfig['moduleBuilds']>;
     nativeOrientation: Exclude<NonNullable<HarmonyConfig['orientation']>, 'default'> | 'unspecified';
     permissions: NonNullable<HarmonyConfig['permissions']>;
     productName: string;
     querySchemes: string[];
     signingConfigFile?: string;
     skills: NonNullable<HarmonyConfig['skills']>;
-    targetApiVersion: number;
+    targetApiVersion: number | string;
     targetSdkVersionString: string;
     vendor: string;
     versionCode: number;

package/build/normalizeConfig.js

@@ -4,6 +4,7 @@ exports.normalizePermission = normalizePermission;
 exports.normalizeHarmonyConfig = normalizeHarmonyConfig;
 const errors_1 = require("./errors");
 const resources_1 = require("./resources");
+const sdkVersion_1 = require("./sdkVersion");
 const BundlePattern = /^[A-Za-z][A-Za-z0-9_]*(\.[A-Za-z][A-Za-z0-9_]*){2,}$/;
 const IdentifierPattern = /^[A-Za-z][A-Za-z0-9_]*$/;
 const ColorPattern = /^(#[0-9A-Fa-f]{6}|#[0-9A-Fa-f]{8})$/;
@@ -18,14 +19,6 @@ const Orientations = new Set([
 const DeviceTypes = new Set(['phone', 'tablet', '2in1']);
 const MinimumApi = 20;
 const TargetApi = 24;
-const SdkVersions = new Map([
-    [13, '5.0.1(13)'],
-    [14, '5.0.2(14)'],
-    [20, '6.0.0(20)'],
-    [21, '6.0.1(21)'],
-    [23, '6.1.0(23)'],
-    [24, '6.1.1(24)'],
-]);
 class HarmonyConfigError extends errors_1.HarmonyConfigPluginError {
     constructor(message) {
         super('ERR_HARMONY_CONFIG_INVALID', message, { operation: 'normalize-config' });
@@ -56,43 +49,6 @@ function normalizeColor(value, field, fallback) {
     }
     return (0, resources_1.toArgb)(color);
 }
-function parseSdkApi(value, field) {
-    if (value === undefined)
-        return null;
-    if (typeof value === 'number' && Number.isSafeInteger(value) && value > 0)
-        return value;
-    if (typeof value !== 'string') {
-        throw new HarmonyConfigError(`harmony.${field} must be a positive API number or an SDK label.`);
-    }
-    const match = /\((\d+)\)$/u.exec(value.trim());
-    const api = Number(match?.[1]);
-    if (!match || !Number.isSafeInteger(api) || api <= 0) {
-        throw new HarmonyConfigError(`harmony.${field} must end with its API level in parentheses, for example "6.0.0(20)".`);
-    }
-    return api;
-}
-function resolveSdkVersion(api, field, value) {
-    if (value !== undefined) {
-        if (typeof value === 'number' && Number.isSafeInteger(value) && value > 0) {
-            if (value !== api) {
-                throw new HarmonyConfigError(`harmony.${field} is API ${value}, but the configured API level is ${api}.`);
-            }
-        }
-        else {
-            const version = readString(value, `harmony.${field}`);
-            const parsed = parseSdkApi(version, field);
-            if (parsed !== api) {
-                throw new HarmonyConfigError(`harmony.${field} describes API ${parsed}, but the configured API level is ${api}.`);
-            }
-            return version;
-        }
-    }
-    const version = SdkVersions.get(api);
-    if (!version) {
-        throw new HarmonyConfigError(`Harmony API ${api} has no built-in SDK label. Set harmony.${field} explicitly so new SDK releases do not require a package update.`);
-    }
-    return version;
-}
 function normalizeStringArray(value, field, allowed) {
     if (!Array.isArray(value) || value.length === 0) {
         throw new HarmonyConfigError(`${field} must be a non-empty array.`);
@@ -190,13 +146,19 @@ function normalizeHarmonyConfig(config) {
     }
     const version = readString(harmony.versionName, 'harmony.versionName', config.version || '1.0.0');
     const code = readPositiveInteger(harmony.versionCode, 'versionCode', 1);
-    const target = readPositiveInteger(harmony.targetApiVersion, 'targetApiVersion', parseSdkApi(harmony.targetSdkVersion, 'targetSdkVersion') ?? TargetApi);
-    const compatible = readPositiveInteger(parseSdkApi(harmony.compatibleSdkVersion, 'compatibleSdkVersion') ?? undefined, 'compatibleSdkVersion', MinimumApi);
-    if (compatible < MinimumApi) {
+    const target = (0, sdkVersion_1.parseHarmonySdkVersion)(harmony.targetSdkVersion ?? harmony.targetApiVersion ?? TargetApi, 'harmony.targetSdkVersion');
+    if (harmony.targetApiVersion !== undefined) {
+        const alias = (0, sdkVersion_1.parseHarmonySdkVersion)(harmony.targetApiVersion, 'harmony.targetApiVersion');
+        if ((0, sdkVersion_1.compareHarmonyApiVersions)(alias.api, target.api) !== 0) {
+            throw new HarmonyConfigError('harmony.targetApiVersion conflicts with harmony.targetSdkVersion.');
+        }
+    }
+    const compatible = (0, sdkVersion_1.parseHarmonySdkVersion)(harmony.compatibleSdkVersion ?? MinimumApi, 'harmony.compatibleSdkVersion');
+    if ((0, sdkVersion_1.compareHarmonyApiVersions)(compatible.api, MinimumApi) < 0) {
         throw new HarmonyConfigError(`Harmony compatible API must be ${MinimumApi} or newer.`);
     }
-    if (compatible > target) {
-        throw new HarmonyConfigError('Harmony compatibleSdkVersion cannot exceed targetApiVersion.');
+    if ((0, sdkVersion_1.compareHarmonyApiVersions)(compatible.api, target.api) > 0) {
+        throw new HarmonyConfigError('Harmony compatibleSdkVersion cannot exceed targetSdkVersion.');
     }
     const orientation = harmony.orientation || config.orientation || 'default';
     if (!Orientations.has(orientation)) {
@@ -211,7 +173,7 @@ function normalizeHarmonyConfig(config) {
         ? ['arm64-v8a', 'x86_64']
         : normalizeStringArray(harmony.abiFilters, 'harmony.abiFilters');
     for (const abi of abis) {
-        if (!/^[A-Za-z0-9_-]+$/.test(abi)) {
+        if (!['arm64-v8a', 'x86_64'].includes(abi)) {
             throw new HarmonyConfigError(`Invalid Harmony ABI filter: ${abi}`);
         }
     }
@@ -249,12 +211,27 @@ function normalizeHarmonyConfig(config) {
     const devices = harmony.deviceTypes === undefined
         ? ['phone', 'tablet']
         : normalizeStringArray(harmony.deviceTypes, 'harmony.deviceTypes', DeviceTypes);
+    const moduleBuilds = harmony.moduleBuilds;
+    if (moduleBuilds !== undefined) {
+        if (!moduleBuilds || typeof moduleBuilds !== 'object' || Array.isArray(moduleBuilds)) {
+            throw new HarmonyConfigError('harmony.moduleBuilds must be an object.');
+        }
+        for (const [name, options] of Object.entries(moduleBuilds)) {
+            if (!/^(@[a-z0-9._~-]+\/)?[a-z0-9._~-]+$/u.test(name)
+                || !options || typeof options !== 'object' || Array.isArray(options)
+                || Object.values(options).some(value => !['boolean', 'string', 'number'].includes(typeof value)
+                    || (typeof value === 'number' && !Number.isFinite(value)))) {
+                throw new HarmonyConfigError(`Invalid native module build options for ${name}.`);
+            }
+        }
+    }
     return Object.freeze({
+        ...(moduleBuilds && Object.keys(moduleBuilds).length ? { moduleBuilds: structuredClone(moduleBuilds) } : {}),
         abiFilters: abis,
         abilityName: ability,
         backgroundColor: background,
         bundleName: bundle,
-        compatibleSdkVersionString: resolveSdkVersion(compatible, 'compatibleSdkVersion', harmony.compatibleSdkVersion),
+        compatibleSdkVersionString: compatible.native,
         deviceTypes: devices,
         icon: harmony.icon || config.icon,
         label: readString(harmony.label, 'harmony.label', config.name),
@@ -265,8 +242,8 @@ function normalizeHarmonyConfig(config) {
         querySchemes: queries,
         signingConfigFile: signing,
         skills,
-        targetApiVersion: target,
-        targetSdkVersionString: resolveSdkVersion(target, 'targetSdkVersion', harmony.targetSdkVersion),
+        targetApiVersion: target.api,
+        targetSdkVersionString: target.native,
         vendor: readString(harmony.vendor, 'harmony.vendor', 'expo-harmony'),
         versionCode: code,
         versionName: version,

package/build/sdkVersion.d.ts

@@ -0,0 +1,6 @@
+export interface HarmonySdkVersion {
+    api: number | string;
+    native: string;
+}
+export declare function parseHarmonySdkVersion(value: unknown, field?: string): HarmonySdkVersion;
+export declare function compareHarmonyApiVersions(left: number | string, right: number | string): number;

package/build/sdkVersion.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseHarmonySdkVersion = parseHarmonySdkVersion;
+exports.compareHarmonyApiVersions = compareHarmonyApiVersions;
+const errors_1 = require("./errors");
+const Labels = new Map([
+    [13, '5.0.1(13)'], [14, '5.0.2(14)'], [20, '6.0.0(20)'],
+    [21, '6.0.1(21)'], [23, '6.1.0(23)'], [24, '6.1.1(24)'],
+]);
+function parseHarmonySdkVersion(value, field = 'SDK version') {
+    if (typeof value === 'number') {
+        if (!Number.isSafeInteger(value) || value < 1 || value > 999) {
+            throw new errors_1.HarmonyConfigPluginError('ERR_HARMONY_CONFIG_INVALID', `${field}: expected a positive API level.`);
+        }
+        if (value >= 26)
+            return { api: `${value}.0.0`, native: `${value}.0.0` };
+        const native = Labels.get(value);
+        if (!native) {
+            throw new errors_1.HarmonyConfigPluginError('ERR_HARMONY_CONFIG_INVALID', `${field}: API ${value} requires an explicit HarmonyOS SDK label.`);
+        }
+        return { api: value, native };
+    }
+    if (typeof value !== 'string') {
+        throw new errors_1.HarmonyConfigPluginError('ERR_HARMONY_CONFIG_INVALID', `${field}: expected an API number or HarmonyOS SDK version.`);
+    }
+    const version = value.trim();
+    const dotted = /^(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/.exec(version);
+    if (dotted && Number(dotted[1]) >= 26
+        && dotted.slice(1).every(part => String(Number(part)) === part)) {
+        return { api: version, native: version };
+    }
+    const label = /^\d+\.\d+\.\d+\(([1-9]\d*)\)$/.exec(version);
+    if (label && Number(label[1]) < 26) {
+        const api = Number(label[1]);
+        const known = Labels.get(api);
+        if (known && known !== version) {
+            throw new errors_1.HarmonyConfigPluginError('ERR_HARMONY_CONFIG_INVALID', `${field}: API ${api} uses SDK label ${known}.`);
+        }
+        return { api, native: version };
+    }
+    throw new errors_1.HarmonyConfigPluginError('ERR_HARMONY_CONFIG_INVALID', `${field}: expected an SDK label such as "6.1.1(24)", or a dotted API version such as "26.0.0".`);
+}
+function compareHarmonyApiVersions(left, right) {
+    const a = String(left).split('.').map(Number);
+    const b = String(right).split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        const delta = (a[i] ?? 0) - (b[i] ?? 0);
+        if (delta)
+            return delta;
+    }
+    return 0;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expo-harmony/config-plugins",
-  "version": "55.0.10-harmony.4",
+  "version": "55.0.11-harmony.2",
   "keywords": [
     "react-native",
     "expo",
@@ -42,13 +42,10 @@
     }
   },
   "dependencies": {
-    "@expo/config-plugins": "55.0.10",
+    "@expo/config-plugins": "55.0.11",
     "@expo/config-types": "^55.0.5",
     "json5": "2.2.3"
   },
-  "peerDependencies": {
-    "@expo/config": "55.0.17"
-  },
   "devDependencies": {
     "@types/node": "18.19.0",
     "typescript": "^6.0.3"

package/src/config.ts

@@ -34,6 +34,10 @@ export interface HarmonyConfig {
   vendor?: string;
   versionCode?: number;
   versionName?: string;
+  runtimeVersion?: string | {
+    policy: 'nativeVersion' | 'sdkVersion' | 'appVersion' | 'fingerprint';
+  };
+  /** @deprecated Configure targetSdkVersion in @expo-harmony/expo-build-properties. */
   targetApiVersion?: number;
   targetSdkVersion?: number | string;
   compatibleSdkVersion?: number | string;
@@ -49,6 +53,8 @@ export interface HarmonyConfig {
   jsEngine?: 'hermes';
   abiFilters?: string[];
   signingConfigFile?: string;
+  /** Native module build options supplied by config plugins. */
+  moduleBuilds?: Record<string, Record<string, string | number | boolean>>;
 }
 
 export type ExpoConfigWithHarmony = Omit<ExpoConfig, 'platforms'> & {

package/src/index.ts

@@ -78,3 +78,6 @@ export type { HarmonyResourceFile, HarmonyResourceItem } from './resources';
 export { withHarmonyGeneratedFiles, withRawfile } from './generatedFiles';
 export type { HarmonyFileDescriptor, HarmonyFileMap, HarmonyGeneratedFilesOptions } from './generatedFiles';
 export { HarmonyPermissions, withHarmonyPermissions } from './permissions';
+
+export { parseHarmonySdkVersion, compareHarmonyApiVersions } from './sdkVersion';
+export type { HarmonySdkVersion } from './sdkVersion';

package/src/normalizeConfig.ts

@@ -7,6 +7,7 @@ import type {
 } from './config';
 import { HarmonyConfigPluginError } from './errors';
 import { toArgb } from './resources';
+import { compareHarmonyApiVersions, parseHarmonySdkVersion } from './sdkVersion';
 
 type HarmonyExpoConfig = ExpoConfigWithHarmony;
 
@@ -20,13 +21,14 @@ interface NormalizedHarmonyConfig {
   icon?: string;
   label: string;
   moduleName: string;
+  moduleBuilds?: NonNullable<HarmonyConfig['moduleBuilds']>;
   nativeOrientation: Exclude<NonNullable<HarmonyConfig['orientation']>, 'default'> | 'unspecified';
   permissions: NonNullable<HarmonyConfig['permissions']>;
   productName: string;
   querySchemes: string[];
   signingConfigFile?: string;
   skills: NonNullable<HarmonyConfig['skills']>;
-  targetApiVersion: number;
+  targetApiVersion: number | string;
   targetSdkVersionString: string;
   vendor: string;
   versionCode: number;
@@ -47,14 +49,6 @@ const Orientations = new Set([
 const DeviceTypes = new Set<HarmonyDeviceType>(['phone', 'tablet', '2in1']);
 const MinimumApi = 20;
 const TargetApi = 24;
-const SdkVersions = new Map([
-  [13, '5.0.1(13)'],
-  [14, '5.0.2(14)'],
-  [20, '6.0.0(20)'],
-  [21, '6.0.1(21)'],
-  [23, '6.1.0(23)'],
-  [24, '6.1.1(24)'],
-]);
 
 class HarmonyConfigError extends HarmonyConfigPluginError {
   constructor(message: string) {
@@ -96,58 +90,6 @@ function normalizeColor(value: unknown, field: string, fallback: string): string
   return toArgb(color);
 }
 
-function parseSdkApi(value: unknown, field: string): number | null {
-  if (value === undefined) return null;
-  if (typeof value === 'number' && Number.isSafeInteger(value) && value > 0) return value;
-  if (typeof value !== 'string') {
-    throw new HarmonyConfigError(`harmony.${field} must be a positive API number or an SDK label.`);
-  }
-
-  const match = /\((\d+)\)$/u.exec(value.trim());
-  const api = Number(match?.[1]);
-
-  if (!match || !Number.isSafeInteger(api) || api <= 0) {
-    throw new HarmonyConfigError(
-      `harmony.${field} must end with its API level in parentheses, for example "6.0.0(20)".`
-    );
-  }
-
-  return api;
-}
-
-function resolveSdkVersion(api: number, field: string, value?: unknown): string {
-  if (value !== undefined) {
-    if (typeof value === 'number' && Number.isSafeInteger(value) && value > 0) {
-      if (value !== api) {
-        throw new HarmonyConfigError(
-          `harmony.${field} is API ${value}, but the configured API level is ${api}.`
-        );
-      }
-    } else {
-      const version = readString(value, `harmony.${field}`);
-      const parsed = parseSdkApi(version, field);
-
-      if (parsed !== api) {
-        throw new HarmonyConfigError(
-          `harmony.${field} describes API ${parsed}, but the configured API level is ${api}.`
-        );
-      }
-
-      return version;
-    }
-  }
-
-  const version = SdkVersions.get(api);
-
-  if (!version) {
-    throw new HarmonyConfigError(
-      `Harmony API ${api} has no built-in SDK label. Set harmony.${field} explicitly so new SDK releases do not require a package update.`
-    );
-  }
-
-  return version;
-}
-
 function normalizeStringArray<T extends string = string>(
   value: unknown,
   field: string,
@@ -286,24 +228,25 @@ function normalizeHarmonyConfig(config: HarmonyExpoConfig): NormalizedHarmonyCon
   const version = readString(harmony.versionName, 'harmony.versionName', config.version || '1.0.0');
   const code = readPositiveInteger(harmony.versionCode, 'versionCode', 1);
 
-  const target = readPositiveInteger(
-    harmony.targetApiVersion,
-    'targetApiVersion',
-    parseSdkApi(harmony.targetSdkVersion, 'targetSdkVersion') ?? TargetApi
-  );
-  const compatible = readPositiveInteger(
-    parseSdkApi(harmony.compatibleSdkVersion, 'compatibleSdkVersion') ?? undefined,
-    'compatibleSdkVersion',
-    MinimumApi
+  const target = parseHarmonySdkVersion(
+    harmony.targetSdkVersion ?? harmony.targetApiVersion ?? TargetApi, 'harmony.targetSdkVersion'
   );
 
-  if (compatible < MinimumApi) {
-    throw new HarmonyConfigError(
-      `Harmony compatible API must be ${MinimumApi} or newer.`
-    );
+  if (harmony.targetApiVersion !== undefined) {
+    const alias = parseHarmonySdkVersion(harmony.targetApiVersion, 'harmony.targetApiVersion');
+
+    if (compareHarmonyApiVersions(alias.api, target.api) !== 0) {
+      throw new HarmonyConfigError('harmony.targetApiVersion conflicts with harmony.targetSdkVersion.');
+    }
   }
-  if (compatible > target) {
-    throw new HarmonyConfigError('Harmony compatibleSdkVersion cannot exceed targetApiVersion.');
+
+  const compatible = parseHarmonySdkVersion(harmony.compatibleSdkVersion ?? MinimumApi, 'harmony.compatibleSdkVersion');
+
+  if (compareHarmonyApiVersions(compatible.api, MinimumApi) < 0) {
+    throw new HarmonyConfigError(`Harmony compatible API must be ${MinimumApi} or newer.`);
+  }
+  if (compareHarmonyApiVersions(compatible.api, target.api) > 0) {
+    throw new HarmonyConfigError('Harmony compatibleSdkVersion cannot exceed targetSdkVersion.');
   }
 
   const orientation = harmony.orientation || config.orientation || 'default';
@@ -327,7 +270,7 @@ function normalizeHarmonyConfig(config: HarmonyExpoConfig): NormalizedHarmonyCon
     : normalizeStringArray(harmony.abiFilters, 'harmony.abiFilters');
 
   for (const abi of abis) {
-    if (!/^[A-Za-z0-9_-]+$/.test(abi)) {
+    if (!['arm64-v8a', 'x86_64'].includes(abi)) {
       throw new HarmonyConfigError(`Invalid Harmony ABI filter: ${abi}`);
     }
   }
@@ -378,16 +321,28 @@ function normalizeHarmonyConfig(config: HarmonyExpoConfig): NormalizedHarmonyCon
         DeviceTypes
       );
 
+  const moduleBuilds = harmony.moduleBuilds;
+  if (moduleBuilds !== undefined) {
+    if (!moduleBuilds || typeof moduleBuilds !== 'object' || Array.isArray(moduleBuilds)) {
+      throw new HarmonyConfigError('harmony.moduleBuilds must be an object.');
+    }
+    for (const [name, options] of Object.entries(moduleBuilds)) {
+      if (!/^(@[a-z0-9._~-]+\/)?[a-z0-9._~-]+$/u.test(name)
+        || !options || typeof options !== 'object' || Array.isArray(options)
+        || Object.values(options).some(value => !['boolean', 'string', 'number'].includes(typeof value)
+          || (typeof value === 'number' && !Number.isFinite(value)))) {
+        throw new HarmonyConfigError(`Invalid native module build options for ${name}.`);
+      }
+    }
+  }
+
   return Object.freeze({
+    ...(moduleBuilds && Object.keys(moduleBuilds).length ? { moduleBuilds: structuredClone(moduleBuilds) } : {}),
     abiFilters: abis,
     abilityName: ability,
     backgroundColor: background,
     bundleName: bundle,
-    compatibleSdkVersionString: resolveSdkVersion(
-      compatible,
-      'compatibleSdkVersion',
-      harmony.compatibleSdkVersion
-    ),
+    compatibleSdkVersionString: compatible.native,
     deviceTypes: devices,
     icon: harmony.icon || config.icon,
     label: readString(harmony.label, 'harmony.label', config.name),
@@ -398,12 +353,8 @@ function normalizeHarmonyConfig(config: HarmonyExpoConfig): NormalizedHarmonyCon
     querySchemes: queries,
     signingConfigFile: signing,
     skills,
-    targetApiVersion: target,
-    targetSdkVersionString: resolveSdkVersion(
-      target,
-      'targetSdkVersion',
-      harmony.targetSdkVersion
-    ),
+    targetApiVersion: target.api,
+    targetSdkVersionString: target.native,
     vendor: readString(harmony.vendor, 'harmony.vendor', 'expo-harmony'),
     versionCode: code,
     versionName: version,

package/src/sdkVersion.ts

@@ -0,0 +1,69 @@
+import { HarmonyConfigPluginError } from './errors';
+
+export interface HarmonySdkVersion {
+  api: number | string;
+  native: string;
+}
+
+const Labels = new Map([
+  [13, '5.0.1(13)'], [14, '5.0.2(14)'], [20, '6.0.0(20)'],
+  [21, '6.0.1(21)'], [23, '6.1.0(23)'], [24, '6.1.1(24)'],
+]);
+
+export function parseHarmonySdkVersion(value: unknown, field = 'SDK version'): HarmonySdkVersion {
+  if (typeof value === 'number') {
+    if (!Number.isSafeInteger(value) || value < 1 || value > 999) {
+      throw new HarmonyConfigPluginError('ERR_HARMONY_CONFIG_INVALID', `${field}: expected a positive API level.`);
+    }
+    if (value >= 26) return { api: `${value}.0.0`, native: `${value}.0.0` };
+
+    const native = Labels.get(value);
+
+    if (!native) {
+      throw new HarmonyConfigPluginError('ERR_HARMONY_CONFIG_INVALID', `${field}: API ${value} requires an explicit HarmonyOS SDK label.`);
+    }
+
+    return { api: value, native };
+  }
+  if (typeof value !== 'string') {
+    throw new HarmonyConfigPluginError('ERR_HARMONY_CONFIG_INVALID', `${field}: expected an API number or HarmonyOS SDK version.`);
+  }
+
+  const version = value.trim();
+  const dotted = /^(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/.exec(version);
+
+  if (dotted && Number(dotted[1]) >= 26
+    && dotted.slice(1).every(part => String(Number(part)) === part)) {
+    return { api: version, native: version };
+  }
+
+  const label = /^\d+\.\d+\.\d+\(([1-9]\d*)\)$/.exec(version);
+
+  if (label && Number(label[1]) < 26) {
+    const api = Number(label[1]);
+    const known = Labels.get(api);
+
+    if (known && known !== version) {
+      throw new HarmonyConfigPluginError('ERR_HARMONY_CONFIG_INVALID', `${field}: API ${api} uses SDK label ${known}.`);
+    }
+
+    return { api, native: version };
+  }
+
+  throw new HarmonyConfigPluginError(
+    'ERR_HARMONY_CONFIG_INVALID',
+    `${field}: expected an SDK label such as "6.1.1(24)", or a dotted API version such as "26.0.0".`
+  );
+}
+
+export function compareHarmonyApiVersions(left: number | string, right: number | string): number {
+  const a = String(left).split('.').map(Number);
+  const b = String(right).split('.').map(Number);
+
+  for (let i = 0; i < 3; i++) {
+    const delta = (a[i] ?? 0) - (b[i] ?? 0);
+    if (delta) return delta;
+  }
+
+  return 0;
+}