@expo-harmony/cli 55.0.26-harmony.10 → 55.0.26-harmony.11

package/README.md

@@ -14,7 +14,7 @@ npm install --save-dev @expo-harmony/cli
 
 通过 Expo 配置生成原生工程的项目（CNG），还需要在 Expo 配置中注册 `@expo-harmony/prebuild-config` 插件。
 
-手工维护 `harmony/` 工程的项目可以使用 bare 模式，按原生工程中的配置构建和运行，无需注册 prebuild 插件。接入步骤见 [bare 文档](../../docs/BARE_WORKFLOW.md)。
+手工维护 `harmony/` 工程的项目可以使用 bare 模式，按原生工程中的配置构建和运行，无需注册 prebuild 插件。
 
 构建 HAP 需要 HarmonyOS SDK（含 HMS 和 OpenHarmony 组件）、OHPM 和 Hvigor。连接设备或模拟器还需要 HDC。可以运行 `npx expo-harmony doctor` 检查环境。
 

package/build/development/manifest.js

@@ -26,7 +26,7 @@ async function createManifestResponseAsync(middleware, options, require) {
     bundle.searchParams.set('lazy', 'false');
     const name = exp.harmony?.bundleName || (await (0, project_1.resolveHarmonyBuildPlanAsync)(middleware.projectRoot)).bundleName;
     const id = exp.extra?.eas?.projectId;
-    const address = `${bundle.origin}${protocol_1.HarmonyManifestPath}?platform=harmony`;
+    const address = (0, protocol_1.canonicalHarmonyManifestURL)(`${bundle.origin}${options.harmonyManifestPath ?? `${protocol_1.HarmonyManifestPath}?platform=harmony`}`);
     const manifest = JSON.stringify({
         id: node_crypto_1.default.randomUUID(),
         createdAt: new Date().toISOString(),
@@ -77,6 +77,23 @@ function installHarmonyManifest(root) {
     const { BundlerDevServer } = require('./build/src/start/server/BundlerDevServer');
     const { parsePlatformHeader } = require('./build/src/start/server/middleware/resolvePlatform');
     const create = BundlerDevServer.prototype.getManifestMiddlewareAsync;
+    // Reuse Expo's terminal QR renderer and dev-session publishing with our
+    // registered link, rather than emitting a second, incompatible QR code.
+    const nativeURL = BundlerDevServer.prototype.getNativeRuntimeUrl;
+    const redirectURL = BundlerDevServer.prototype.getRedirectUrl;
+    BundlerDevServer.prototype.getNativeRuntimeUrl = function (options = {}) {
+        const address = this.getUrlCreator().constructUrl({ ...options, scheme: 'http' });
+        if (!address)
+            return nativeURL.call(this, options);
+        const manifest = new URL(protocol_1.HarmonyManifestPath, address);
+        manifest.searchParams.set('platform', 'harmony');
+        return (0, protocol_1.createHarmonyLaunchLink)(manifest.toString());
+    };
+    BundlerDevServer.prototype.getRedirectUrl = function (platform = null) {
+        return platform === null || platform === 'harmony'
+            ? this.getNativeRuntimeUrl()
+            : redirectURL.call(this, platform);
+    };
     // Expo installs the manifest before Metro's enhancer; adapt only the created instance.
     BundlerDevServer.prototype.getManifestMiddlewareAsync = async function (...args) {
         const middleware = await create.apply(this, args);
@@ -87,10 +104,14 @@ function installHarmonyManifest(root) {
                 return parse.call(middleware, request);
             // Bypass only the upstream platform assertion without changing the actual request.
             const url = new URL(request.url, 'http://localhost');
+            url.searchParams.delete('platform');
+            url.searchParams.append('platform', 'harmony');
+            const manifest = new URL((0, protocol_1.canonicalHarmonyManifestURL)(url.toString()));
+            const harmonyManifestPath = manifest.pathname + manifest.search;
             url.searchParams.set('platform', 'ios');
             const copy = Object.create(request);
             copy.url = url.pathname + url.search;
-            return { ...parse.call(middleware, copy), platform: 'harmony' };
+            return { ...parse.call(middleware, copy), platform: 'harmony', harmonyManifestPath };
         };
         middleware._getManifestResponseAsync = options => options.platform === 'harmony'
             ? createManifestResponseAsync(middleware, options, require)

package/build/development/protocol.d.ts

@@ -1,2 +1,3 @@
 export declare const HarmonyManifestPath = "/manifest";
+export declare function canonicalHarmonyManifestURL(value: string): string;
 export declare function createHarmonyLaunchLink(manifest: string): string;

package/build/development/protocol.js

@@ -1,26 +1,33 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HarmonyManifestPath = void 0;
+exports.canonicalHarmonyManifestURL = canonicalHarmonyManifestURL;
 exports.createHarmonyLaunchLink = createHarmonyLaunchLink;
 const errors_1 = require("../errors");
 exports.HarmonyManifestPath = '/manifest';
-function validateManifestUrl(value) {
+function canonicalHarmonyManifestURL(value) {
     let url;
     try {
         url = new URL(value);
+        decodeURIComponent(url.search);
     }
     catch (cause) {
         throw new errors_1.HarmonyCliError('ERR_HARMONY_MANIFEST_URL', 'Expected an absolute HTTP(S) Harmony manifest URL.', { cause, operation: 'development-manifest' });
     }
     if (!['http:', 'https:'].includes(url.protocol) || url.username || url.password || url.hash
-        || !['/', '/manifest', '/index.exp'].includes(url.pathname) || url.searchParams.toString() !== 'platform=harmony') {
+        || !['/', exports.HarmonyManifestPath, '/index.exp'].includes(url.pathname)
+        || url.searchParams.getAll('platform').length !== 1 || url.searchParams.get('platform') !== 'harmony') {
         throw new errors_1.HarmonyCliError('ERR_HARMONY_MANIFEST_URL', 'Expected an HTTP(S) Expo manifest URL with platform=harmony and without credentials or a fragment.', { operation: 'development-manifest' });
     }
-    return url;
+    url.pathname = exports.HarmonyManifestPath;
+    // Keep all other query values (including repetitions) in order. Platform has
+    // one canonical position, and URLSearchParams normalizes equivalent encoding.
+    url.searchParams.delete('platform');
+    url.searchParams.append('platform', 'harmony');
+    return url.toString();
 }
 function createHarmonyLaunchLink(manifest) {
-    validateManifestUrl(manifest);
     const url = new URL('expo-harmony://open');
-    url.searchParams.set('url', manifest);
+    url.searchParams.set('url', canonicalHarmonyManifestURL(manifest));
     return url.toString();
 }

package/build/run/devices.js

@@ -159,6 +159,13 @@ async function installHapAsync(hdc, device, hap, options = {}) {
     });
 }
 async function configureMetroPortAsync(hdc, device, port, options = {}) {
+    if (options.devicePort === undefined && port !== 8081) {
+        // RNOH's default provider uses 8081; launcher manifests retain Metro's
+        // advertised port for the bundle, assets, HMR and inspector URLs.
+        await configureMetroPortAsync(hdc, device, port, { ...options, devicePort: 8081 });
+        await configureMetroPortAsync(hdc, device, port, { ...options, devicePort: port });
+        return;
+    }
     const deviceEndpoint = `tcp:${options.devicePort || 8081}`;
     const hostEndpoint = `tcp:${port}`;
     const forwards = await runHdcAsync(hdc, ['-t', device.id, 'fport', 'ls'], {

package/build/runtime/config.d.ts

@@ -11,8 +11,9 @@ export declare function readNativeRuntime(plan: HarmonyBuildPlan): {
     app: any;
     config: {
         nativeCompiler: string;
-        targetApiVersion: number;
-        compatibleApiVersion: number;
+        targetApiVersion: number | string;
+        compatibleApiVersion: number | string;
+        nativeLibFilterHash?: string;
         permissions: string[];
         querySchemes: string[];
         backgroundModes: string[];
@@ -24,8 +25,9 @@ export declare function readProjectRuntimeAsync(root: string): Promise<{
     bundleName: string;
     native: {
         nativeCompiler: string;
-        targetApiVersion: number;
-        compatibleApiVersion: number;
+        targetApiVersion: number | string;
+        compatibleApiVersion: number | string;
+        nativeLibFilterHash?: string;
         permissions: string[];
         querySchemes: string[];
         backgroundModes: string[];

package/build/runtime/config.js

@@ -8,6 +8,7 @@ exports.readMetroRuntimeAsync = readMetroRuntimeAsync;
 exports.readNativeRuntime = readNativeRuntime;
 exports.readProjectRuntimeAsync = readProjectRuntimeAsync;
 const node_fs_1 = __importDefault(require("node:fs"));
+const node_crypto_1 = require("node:crypto");
 const node_module_1 = require("node:module");
 const node_path_1 = __importDefault(require("node:path"));
 const config_1 = require("@expo/config");
@@ -56,6 +57,55 @@ async function readMetroRuntimeAsync(root) {
     }
     return config?.resolver?.resolveRequest?.harmonyRuntime;
 }
+function onlyKeys(value, keys) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value)
+        && Object.keys(value).every(key => keys.includes(key));
+}
+function optionalStrings(value) {
+    return value === undefined || (Array.isArray(value) && value.every(item => typeof item === 'string' && item.length > 0));
+}
+function supportedReleaseOptions(modes) {
+    if (modes === undefined)
+        return true;
+    if (!Array.isArray(modes) || modes.length > 1)
+        return false;
+    return modes.every((mode) => {
+        if (!onlyKeys(mode, ['name', 'arkOptions', 'nativeLib']) || mode.name !== 'release')
+            return false;
+        if (mode.nativeLib !== undefined) {
+            const symbol = mode.nativeLib?.debugSymbol;
+            if (!onlyKeys(mode.nativeLib, ['debugSymbol']) || !onlyKeys(symbol, ['strip', 'exclude'])
+                || typeof symbol.strip !== 'boolean' || !optionalStrings(symbol.exclude))
+                return false;
+        }
+        if (mode.arkOptions !== undefined) {
+            const obfuscation = mode.arkOptions?.obfuscation;
+            const rules = obfuscation?.ruleOptions;
+            if (!onlyKeys(mode.arkOptions, ['obfuscation']) || !onlyKeys(obfuscation, ['ruleOptions'])
+                || !onlyKeys(rules, ['enable', 'files']) || typeof rules.enable !== 'boolean'
+                || !optionalStrings(rules.files))
+                return false;
+        }
+        return true;
+    });
+}
+function nativeLibFilterHash(filter) {
+    if (filter === undefined)
+        return undefined;
+    if (!onlyKeys(filter, ['excludes', 'pickFirsts', 'pickLasts', 'enableOverride'])
+        || !['excludes', 'pickFirsts', 'pickLasts'].every(key => optionalStrings(filter[key]))
+        || (filter.enableOverride !== undefined && typeof filter.enableOverride !== 'boolean')) {
+        throw new errors_1.HarmonyCliError('ERR_HARMONY_RUNTIME_CONFIG', 'Unsupported nativeLib.filter configuration.', { operation: 'runtime-contract' });
+    }
+    const values = {};
+    for (const key of ['excludes', 'pickFirsts', 'pickLasts']) {
+        if (filter[key]?.length)
+            values[key] = [...new Set(filter[key])].sort();
+    }
+    if (filter.enableOverride)
+        values['enableOverride'] = true;
+    return Object.keys(values).length ? (0, node_crypto_1.createHash)('sha256').update(JSON.stringify(values)).digest('hex') : undefined;
+}
 function nativeConfig(profile, module, build, product, ability) {
     const selected = profile?.app?.products?.find(item => item.name === product);
     const entry = module?.abilities?.find(item => item.name === ability);
@@ -63,14 +113,15 @@ function nativeConfig(profile, module, build, product, ability) {
         || /(?:USE_HERMES|HERMES_V1_ENABLED)(?::BOOL)?=(?:OFF|FALSE|0)/i.test(build.buildOption?.externalNativeOptions?.arguments || '')
         || Object.keys(selected.buildOption || {}).some(key => key !== 'nativeCompiler')
         || profile.app.buildModeSet?.some(mode => mode.buildOption)
-        || build.buildOptionSet?.length || build.targets?.some(target => target.buildOption)) {
-        throw new errors_1.HarmonyCliError('ERR_HARMONY_RUNTIME_CONFIG', 'Runtime contracts require an existing Harmony product and ability, Hermes v1, and native options without per-target or per-mode overrides.', { operation: 'runtime-contract' });
+        || !supportedReleaseOptions(build.buildOptionSet) || build.targets?.some(target => target.buildOption)) {
+        throw new errors_1.HarmonyCliError('ERR_HARMONY_RUNTIME_CONFIG', 'Runtime contracts require an existing Harmony product and ability, Hermes v1, and no per-target or per-mode overrides except release debugSymbol and ArkTS obfuscation rules.', { operation: 'runtime-contract' });
     }
-    const api = (value) => typeof value === 'number' ? value : Number(/\((\d+)\)$/.exec(String(value))?.[1] ?? value);
+    const hash = nativeLibFilterHash(build.buildOption?.nativeLib?.filter);
     return {
         nativeCompiler: selected.buildOption?.nativeCompiler,
-        targetApiVersion: api(selected.targetSdkVersion),
-        compatibleApiVersion: api(selected.compatibleSdkVersion),
+        targetApiVersion: (0, config_plugins_1.parseHarmonySdkVersion)(selected.targetSdkVersion, 'targetSdkVersion').api,
+        compatibleApiVersion: (0, config_plugins_1.parseHarmonySdkVersion)(selected.compatibleSdkVersion, 'compatibleSdkVersion').api,
+        ...(hash ? { nativeLibFilterHash: hash } : {}),
         permissions: [...new Set((module.requestPermissions || []).map(item => item.name))].sort(),
         querySchemes: [...new Set(module.querySchemes || [])].sort(),
         backgroundModes: [...new Set(entry.backgroundModes || [])].sort(),

package/build/runtime/contract.js

@@ -25,7 +25,7 @@ async function createRuntimeContractAsync(root, project, modules, metro) {
     const version = (name) => require(`${name}/package.json`).version;
     const native = (0, node_module_1.createRequire)(require.resolve(resolution.harmonyPackage + '/package.json'));
     const contract = {
-        schemaVersion: 1,
+        schemaVersion: (0, runtime_1.harmonyRuntimeSchemaVersion)(project.native),
         platform: 'harmony',
         runtimeVersion: project.runtimeVersion,
         development: true,
@@ -92,6 +92,7 @@ async function publishRuntimeContractAsync(root, plan) {
     requirements.development = plan.buildMode === 'debug';
     const contract = {
         ...requirements,
+        schemaVersion: (0, runtime_1.harmonyRuntimeSchemaVersion)(native.config),
         runtimeVersion: await (0, config_1.resolveRuntimeVersionAsync)(root, project.config, native.app),
         config: native.config,
     };

package/build/runtime/fingerprint.js

@@ -7,6 +7,7 @@ exports.fingerprintHarmonyAsync = fingerprintHarmonyAsync;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const node_module_1 = require("node:module");
+const config_1 = require("@expo/config");
 const fingerprint_1 = require("@expo/fingerprint");
 const expo_modules_autolinking_1 = require("@expo-harmony/expo-modules-autolinking");
 const errors_1 = require("../errors");
@@ -15,18 +16,22 @@ async function fingerprintHarmonyAsync(root) {
     if (!result.valid)
         throw new errors_1.HarmonyCliError('ERR_HARMONY_FINGERPRINT', 'Build and verify Harmony native modules before calculating the runtime fingerprint.', { operation: 'fingerprint' });
     const require = (0, node_module_1.createRequire)(node_path_1.default.join(root, 'package.json'));
-    const dependencies = (0, expo_modules_autolinking_1.createNativeModuleContracts)(result.modules);
+    const modules = (0, expo_modules_autolinking_1.createNativeModuleContracts)(result.modules);
+    const { exp } = (0, config_1.getConfig)(root, { skipSDKVersionRequirement: true, isModdedConfig: true });
     const generated = [];
     const previous = node_path_1.default.join(root, '.expo/harmony/export-manifest.json');
     if (node_fs_1.default.existsSync(previous)) {
         const manifest = JSON.parse(node_fs_1.default.readFileSync(previous, 'utf8'));
         generated.push(...manifest.assets.map(asset => `**/harmony/**/src/main/resources/rawfile/${asset.path}`));
     }
-    const sources = [{ type: 'contents', id: 'harmonyAutolinking', contents: JSON.stringify(dependencies), reasons: ['harmonyAutolinking'] }];
-    for (const name of ['@react-native-oh/react-native-harmony', '@expo-harmony/template', '@expo-harmony/config-plugins', '@expo-harmony/prebuild-config']) {
+    const sources = [{ type: 'contents', id: 'harmonyAutolinking', contents: JSON.stringify(modules), reasons: ['harmonyAutolinking'] }];
+    for (const name of ['@react-native-oh/react-native-harmony', '@expo-harmony/template', '@expo-harmony/config-plugins', '@expo-harmony/prebuild-config', '@expo-harmony/expo-build-properties']) {
         const file = require.resolve(name + '/package.json');
         sources.push({ type: 'dir', filePath: node_path_1.default.relative(root, node_path_1.default.dirname(file)), reasons: ['harmonyNativeToolchain'] });
     }
+    for (const file of exp._internal?.harmonyBuildProperties?.release?.obfuscation?.files ?? []) {
+        sources.push({ type: 'file', filePath: file, reasons: ['harmonyObfuscationRules'] });
+    }
     if (node_fs_1.default.existsSync(node_path_1.default.join(root, 'harmony')))
         sources.push({ type: 'dir', filePath: 'harmony', reasons: ['harmonyNativeProject'] });
     return (0, fingerprint_1.createFingerprintAsync)(root, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expo-harmony/cli",
-  "version": "55.0.26-harmony.10",
+  "version": "55.0.26-harmony.11",
   "keywords": [
     "react-native",
     "expo",
@@ -51,9 +51,9 @@
     "expo-harmony": "build/bin/expo-harmony.js"
   },
   "dependencies": {
-    "@expo-harmony/config-plugins": "55.0.10-harmony.4",
-    "@expo-harmony/expo-modules-autolinking": "55.0.25-harmony.4",
-    "@expo-harmony/prebuild-config": "55.0.0-harmony.8",
+    "@expo-harmony/config-plugins": "55.0.10-harmony.5",
+    "@expo-harmony/expo-modules-autolinking": "55.0.25-harmony.5",
+    "@expo-harmony/prebuild-config": "55.0.0-harmony.9",
     "@expo/config": "55.0.17",
     "@expo/fingerprint": "0.16.7",
     "cross-spawn": "^7.0.6",

package/src/development/manifest.ts

@@ -5,7 +5,7 @@ import { HarmonyCliError } from '../errors';
 import { resolveExpoCli } from '../expo';
 import { resolveHarmonyBuildPlanAsync } from '../native/project';
 import { resolveRuntimeRequirementsAsync } from '../runtime/contract';
-import { createHarmonyLaunchLink, HarmonyManifestPath } from './protocol';
+import { canonicalHarmonyManifestURL, createHarmonyLaunchLink, HarmonyManifestPath } from './protocol';
 
 async function createManifestResponseAsync(middleware, options, require: NodeRequire) {
   const { ExpoGoManifestHandlerMiddleware: Manifest, ResponseContentType: Types } = require('./build/src/start/server/middleware/ExpoGoManifestHandlerMiddleware');
@@ -24,7 +24,7 @@ async function createManifestResponseAsync(middleware, options, require: NodeReq
 
   const name = exp.harmony?.bundleName || (await resolveHarmonyBuildPlanAsync(middleware.projectRoot)).bundleName;
   const id = exp.extra?.eas?.projectId;
-  const address = `${bundle.origin}${HarmonyManifestPath}?platform=harmony`;
+  const address = canonicalHarmonyManifestURL(`${bundle.origin}${options.harmonyManifestPath ?? `${HarmonyManifestPath}?platform=harmony`}`);
   const manifest = JSON.stringify({
     id: crypto.randomUUID(),
     createdAt: new Date().toISOString(),
@@ -80,6 +80,23 @@ export function installHarmonyManifest(root: string) {
   const { parsePlatformHeader } = require('./build/src/start/server/middleware/resolvePlatform');
   const create = BundlerDevServer.prototype.getManifestMiddlewareAsync;
 
+  // Reuse Expo's terminal QR renderer and dev-session publishing with our
+  // registered link, rather than emitting a second, incompatible QR code.
+  const nativeURL = BundlerDevServer.prototype.getNativeRuntimeUrl;
+  const redirectURL = BundlerDevServer.prototype.getRedirectUrl;
+  BundlerDevServer.prototype.getNativeRuntimeUrl = function (options = {}) {
+    const address = this.getUrlCreator().constructUrl({ ...options, scheme: 'http' });
+    if (!address) return nativeURL.call(this, options);
+    const manifest = new URL(HarmonyManifestPath, address);
+    manifest.searchParams.set('platform', 'harmony');
+    return createHarmonyLaunchLink(manifest.toString());
+  };
+  BundlerDevServer.prototype.getRedirectUrl = function (platform = null) {
+    return platform === null || platform === 'harmony'
+      ? this.getNativeRuntimeUrl()
+      : redirectURL.call(this, platform);
+  };
+
   // Expo installs the manifest before Metro's enhancer; adapt only the created instance.
   BundlerDevServer.prototype.getManifestMiddlewareAsync = async function (this: object, ...args) {
     const middleware = await create.apply(this, args);
@@ -91,11 +108,15 @@ export function installHarmonyManifest(root: string) {
 
       // Bypass only the upstream platform assertion without changing the actual request.
       const url = new URL(request.url, 'http://localhost');
+      url.searchParams.delete('platform');
+      url.searchParams.append('platform', 'harmony');
+      const manifest = new URL(canonicalHarmonyManifestURL(url.toString()));
+      const harmonyManifestPath = manifest.pathname + manifest.search;
       url.searchParams.set('platform', 'ios');
       const copy = Object.create(request);
       copy.url = url.pathname + url.search;
 
-      return { ...parse.call(middleware, copy), platform: 'harmony' };
+      return { ...parse.call(middleware, copy), platform: 'harmony', harmonyManifestPath };
     };
     middleware._getManifestResponseAsync = options => options.platform === 'harmony'
       ? createManifestResponseAsync(middleware, options, require)

package/src/development/protocol.ts

@@ -2,11 +2,12 @@ import { HarmonyCliError } from '../errors';
 
 export const HarmonyManifestPath = '/manifest';
 
-function validateManifestUrl(value: string): URL {
+export function canonicalHarmonyManifestURL(value: string): string {
   let url: URL;
 
   try {
     url = new URL(value);
+    decodeURIComponent(url.search);
   } catch (cause) {
     throw new HarmonyCliError(
       'ERR_HARMONY_MANIFEST_URL',
@@ -16,7 +17,8 @@ function validateManifestUrl(value: string): URL {
   }
 
   if (!['http:', 'https:'].includes(url.protocol) || url.username || url.password || url.hash
-    || !['/', '/manifest', '/index.exp'].includes(url.pathname) || url.searchParams.toString() !== 'platform=harmony') {
+    || !['/', HarmonyManifestPath, '/index.exp'].includes(url.pathname)
+    || url.searchParams.getAll('platform').length !== 1 || url.searchParams.get('platform') !== 'harmony') {
     throw new HarmonyCliError(
       'ERR_HARMONY_MANIFEST_URL',
       'Expected an HTTP(S) Expo manifest URL with platform=harmony and without credentials or a fragment.',
@@ -24,14 +26,17 @@ function validateManifestUrl(value: string): URL {
     );
   }
 
-  return url;
+  url.pathname = HarmonyManifestPath;
+  // Keep all other query values (including repetitions) in order. Platform has
+  // one canonical position, and URLSearchParams normalizes equivalent encoding.
+  url.searchParams.delete('platform');
+  url.searchParams.append('platform', 'harmony');
+  return url.toString();
 }
 
 export function createHarmonyLaunchLink(manifest: string): string {
-  validateManifestUrl(manifest);
-
   const url = new URL('expo-harmony://open');
-  url.searchParams.set('url', manifest);
+  url.searchParams.set('url', canonicalHarmonyManifestURL(manifest));
 
   return url.toString();
 }

package/src/run/devices.ts

@@ -233,6 +233,14 @@ async function configureMetroPortAsync(
   port: number,
   options: HdcOptions = {}
 ): Promise<void> {
+  if (options.devicePort === undefined && port !== 8081) {
+    // RNOH's default provider uses 8081; launcher manifests retain Metro's
+    // advertised port for the bundle, assets, HMR and inspector URLs.
+    await configureMetroPortAsync(hdc, device, port, { ...options, devicePort: 8081 });
+    await configureMetroPortAsync(hdc, device, port, { ...options, devicePort: port });
+    return;
+  }
+
   const deviceEndpoint = `tcp:${options.devicePort || 8081}`;
   const hostEndpoint = `tcp:${port}`;
 

package/src/runtime/config.ts

@@ -1,11 +1,12 @@
 import fs from 'node:fs';
+import { createHash } from 'node:crypto';
 import { createRequire } from 'node:module';
 import path from 'node:path';
 
 import { getConfig } from '@expo/config';
-import { compileHarmonyModsAsync, normalizeHarmonyConfig, type ExpoConfigWithHarmony } from '@expo-harmony/config-plugins';
-import { withHarmonyPrebuildConfig } from '@expo-harmony/prebuild-config';
+import { compileHarmonyModsAsync, normalizeHarmonyConfig, parseHarmonySdkVersion, type ExpoConfigWithHarmony } from '@expo-harmony/config-plugins';
 import type { HarmonyRuntimeContract } from '@expo-harmony/expo-modules-autolinking/runtime';
+import { withHarmonyPrebuildConfig } from '@expo-harmony/prebuild-config';
 import JSON5 from 'json5';
 
 import { fingerprintHarmonyAsync } from './fingerprint';
@@ -72,27 +73,83 @@ export async function readMetroRuntimeAsync(root: string): Promise<HarmonyMetroR
   return config?.resolver?.resolveRequest?.harmonyRuntime;
 }
 
+function onlyKeys(value, keys: string[]): boolean {
+  return value !== null && typeof value === 'object' && !Array.isArray(value)
+    && Object.keys(value).every(key => keys.includes(key));
+}
+
+function optionalStrings(value): boolean {
+  return value === undefined || (Array.isArray(value) && value.every(item => typeof item === 'string' && item.length > 0));
+}
+
+function supportedReleaseOptions(modes): boolean {
+  if (modes === undefined) return true;
+  if (!Array.isArray(modes) || modes.length > 1) return false;
+
+  return modes.every((mode) => {
+    if (!onlyKeys(mode, ['name', 'arkOptions', 'nativeLib']) || mode.name !== 'release') return false;
+
+    if (mode.nativeLib !== undefined) {
+      const symbol = mode.nativeLib?.debugSymbol;
+
+      if (!onlyKeys(mode.nativeLib, ['debugSymbol']) || !onlyKeys(symbol, ['strip', 'exclude'])
+        || typeof symbol.strip !== 'boolean' || !optionalStrings(symbol.exclude)) return false;
+    }
+
+    if (mode.arkOptions !== undefined) {
+      const obfuscation = mode.arkOptions?.obfuscation;
+      const rules = obfuscation?.ruleOptions;
+
+      if (!onlyKeys(mode.arkOptions, ['obfuscation']) || !onlyKeys(obfuscation, ['ruleOptions'])
+        || !onlyKeys(rules, ['enable', 'files']) || typeof rules.enable !== 'boolean'
+        || !optionalStrings(rules.files)) return false;
+    }
+
+    return true;
+  });
+}
+
+function nativeLibFilterHash(filter): string | undefined {
+  if (filter === undefined) return undefined;
+  if (!onlyKeys(filter, ['excludes', 'pickFirsts', 'pickLasts', 'enableOverride'])
+    || !['excludes', 'pickFirsts', 'pickLasts'].every(key => optionalStrings(filter[key]))
+    || (filter.enableOverride !== undefined && typeof filter.enableOverride !== 'boolean')) {
+    throw new HarmonyCliError('ERR_HARMONY_RUNTIME_CONFIG', 'Unsupported nativeLib.filter configuration.', { operation: 'runtime-contract' });
+  }
+
+  const values = {};
+
+  for (const key of ['excludes', 'pickFirsts', 'pickLasts']) {
+    if (filter[key]?.length) values[key] = [...new Set(filter[key])].sort();
+  }
+  if (filter.enableOverride) values['enableOverride'] = true;
+
+  return Object.keys(values).length ? createHash('sha256').update(JSON.stringify(values)).digest('hex') : undefined;
+}
+
 function nativeConfig(profile, module, build, product: string, ability: string): HarmonyRuntimeContract['config'] {
   const selected = profile?.app?.products?.find(item => item.name === product);
   const entry = module?.abilities?.find(item => item.name === ability);
+
   if (!selected || !entry || !build
     || /(?:USE_HERMES|HERMES_V1_ENABLED)(?::BOOL)?=(?:OFF|FALSE|0)/i.test(build.buildOption?.externalNativeOptions?.arguments || '')
     || Object.keys(selected.buildOption || {}).some(key => key !== 'nativeCompiler')
     || profile.app.buildModeSet?.some(mode => mode.buildOption)
-    || build.buildOptionSet?.length || build.targets?.some(target => target.buildOption)) {
+    || !supportedReleaseOptions(build.buildOptionSet) || build.targets?.some(target => target.buildOption)) {
     throw new HarmonyCliError(
       'ERR_HARMONY_RUNTIME_CONFIG',
-      'Runtime contracts require an existing Harmony product and ability, Hermes v1, and native options without per-target or per-mode overrides.',
+      'Runtime contracts require an existing Harmony product and ability, Hermes v1, and no per-target or per-mode overrides except release debugSymbol and ArkTS obfuscation rules.',
       { operation: 'runtime-contract' }
     );
   }
 
-  const api = (value: unknown) => typeof value === 'number' ? value : Number(/\((\d+)\)$/.exec(String(value))?.[1] ?? value);
+  const hash = nativeLibFilterHash(build.buildOption?.nativeLib?.filter);
 
   return {
     nativeCompiler: selected.buildOption?.nativeCompiler,
-    targetApiVersion: api(selected.targetSdkVersion),
-    compatibleApiVersion: api(selected.compatibleSdkVersion),
+    targetApiVersion: parseHarmonySdkVersion(selected.targetSdkVersion, 'targetSdkVersion').api,
+    compatibleApiVersion: parseHarmonySdkVersion(selected.compatibleSdkVersion, 'compatibleSdkVersion').api,
+    ...(hash ? { nativeLibFilterHash: hash } : {}),
     permissions: [...new Set<string>((module.requestPermissions || []).map(item => item.name))].sort(),
     querySchemes: [...new Set<string>(module.querySchemes || [])].sort(),
     backgroundModes: [...new Set<string>(entry.backgroundModes || [])].sort(),

package/src/runtime/contract.ts

@@ -3,7 +3,7 @@ import { createRequire } from 'node:module';
 import path from 'node:path';
 
 import { createNativeModuleContracts, ohpmDependenciesFromManifest, verifyModulesAsync, type Manifest, type ModuleDescriptor } from '@expo-harmony/expo-modules-autolinking';
-import { assertHarmonyCompatibility, validateHarmonyRuntime, type HarmonyRuntimeContract } from '@expo-harmony/expo-modules-autolinking/runtime';
+import { assertHarmonyCompatibility, harmonyRuntimeSchemaVersion, validateHarmonyRuntime, type HarmonyRuntimeContract } from '@expo-harmony/expo-modules-autolinking/runtime';
 import JSON5 from 'json5';
 
 import { publishUpdatesConfigurationAsync } from '../updates/export';
@@ -33,7 +33,7 @@ async function createRuntimeContractAsync(
   const native = createRequire(require.resolve(resolution.harmonyPackage + '/package.json'));
 
   const contract: HarmonyRuntimeContract = {
-    schemaVersion: 1,
+    schemaVersion: harmonyRuntimeSchemaVersion(project.native),
     platform: 'harmony',
     runtimeVersion: project.runtimeVersion,
     development: true,
@@ -143,8 +143,10 @@ export async function publishRuntimeContractAsync(
 
   const native = readNativeRuntime(plan);
   requirements.development = plan.buildMode === 'debug';
+
   const contract: HarmonyRuntimeContract = {
     ...requirements,
+    schemaVersion: harmonyRuntimeSchemaVersion(native.config),
     runtimeVersion: await resolveRuntimeVersionAsync(root, project.config, native.app),
     config: native.config,
   };

package/src/runtime/fingerprint.ts

@@ -1,6 +1,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { createRequire } from 'node:module';
+import { getConfig } from '@expo/config';
 import { createFingerprintAsync, type HashSource } from '@expo/fingerprint';
 import { createNativeModuleContracts, verifyModulesAsync } from '@expo-harmony/expo-modules-autolinking';
 import { HarmonyCliError } from '../errors';
@@ -10,18 +11,27 @@ export async function fingerprintHarmonyAsync(root: string) {
   if (!result.valid) throw new HarmonyCliError('ERR_HARMONY_FINGERPRINT', 'Build and verify Harmony native modules before calculating the runtime fingerprint.', { operation: 'fingerprint' });
 
   const require = createRequire(path.join(root, 'package.json'));
-  const dependencies = createNativeModuleContracts(result.modules);
+  const modules = createNativeModuleContracts(result.modules);
+  const { exp } = getConfig(root, { skipSDKVersionRequirement: true, isModdedConfig: true });
   const generated: string[] = [];
   const previous = path.join(root, '.expo/harmony/export-manifest.json');
+
   if (fs.existsSync(previous)) {
     const manifest = JSON.parse(fs.readFileSync(previous, 'utf8'));
     generated.push(...manifest.assets.map(asset => `**/harmony/**/src/main/resources/rawfile/${asset.path}`));
   }
-  const sources: HashSource[] = [{ type: 'contents', id: 'harmonyAutolinking', contents: JSON.stringify(dependencies), reasons: ['harmonyAutolinking'] }];
-  for (const name of ['@react-native-oh/react-native-harmony', '@expo-harmony/template', '@expo-harmony/config-plugins', '@expo-harmony/prebuild-config']) {
+
+  const sources: HashSource[] = [{ type: 'contents', id: 'harmonyAutolinking', contents: JSON.stringify(modules), reasons: ['harmonyAutolinking'] }];
+
+  for (const name of ['@react-native-oh/react-native-harmony', '@expo-harmony/template', '@expo-harmony/config-plugins', '@expo-harmony/prebuild-config', '@expo-harmony/expo-build-properties']) {
     const file = require.resolve(name + '/package.json');
     sources.push({ type: 'dir', filePath: path.relative(root, path.dirname(file)), reasons: ['harmonyNativeToolchain'] });
   }
+
+  for (const file of exp._internal?.harmonyBuildProperties?.release?.obfuscation?.files ?? []) {
+    sources.push({ type: 'file', filePath: file, reasons: ['harmonyObfuscationRules'] });
+  }
+
   if (fs.existsSync(path.join(root, 'harmony'))) sources.push({ type: 'dir', filePath: 'harmony', reasons: ['harmonyNativeProject'] });
 
   return createFingerprintAsync(root, {