@expo-harmony/template 55.0.0-harmony.0

package/README.md

@@ -0,0 +1,26 @@
+# @expo-harmony/template
+
+[**GitHub 仓库**](https://github.com/renbaoshuo/expo-harmony/tree/master/packages/template)
+
+为 Expo 项目提供 HarmonyOS 原生工程模板，包含 AppScope、Entry 模块、Hvigor、CMake 和 RNOH 宿主代码，适配 Expo SDK 55、React Native 0.84.1 和 RNOH 0.84.1。
+
+该模板由 `@expo-harmony/prebuild-config` 和 `@expo-harmony/cli` 管理，通常无需在应用中直接使用。配置好预构建插件后，运行以下命令生成或更新 `harmony` 原生工程：
+
+```sh
+npx expo-harmony prebuild
+```
+
+## 说明
+
+模板只包含 Expo Modules Core 和 HarmonyOS 构建所需的基础依赖。应用使用其他 Expo 功能时，需要同时安装对应的官方 JavaScript 包和 `@expo-harmony/*` 原生包，预构建阶段会自动发现并链接这些模块。
+
+模板中的应用名称、包名和 Ability 等内容均为占位值，最终结果由 `@expo-harmony/prebuild-config` 根据 Expo 配置生成。签名密钥、密码、绝对路径、OHPM 缓存、Bundle 和 HAP 等本地或构建产物不会包含在模板中。
+
+原生构建需要 Node.js 20 或更高版本，以及可用的 HarmonyOS SDK/NDK、OHPM 和 Hvigor。Release 构建会通过项目本地的 `@expo-harmony/cli` 生成 Hermes Bundle；如需指定 Node.js 可执行文件，可设置 `EXPO_HARMONY_NODE`。
+
+## Author
+
+**expo-harmony** © [Baoshuo](https://github.com/renbaoshuo), Released under the MIT License.<br>
+Authored and maintained by Baoshuo with help from [contributors](https://github.com/renbaoshuo/expo-harmony/contributors).
+
+> [Personal Website](https://baoshuo.ren) · [Blog](https://blog.baoshuo.ren) · GitHub [@renbaoshuo](https://github.com/renbaoshuo) · Twitter [@baoshuo](https://twitter.com/baoshuo)

package/harmony/.expo-harmony-template

@@ -0,0 +1,8 @@
+{
+  "schemaVersion": 2,
+  "placeholders": {
+    "abilityName": "__EXPO_HARMONY_ABILITY_NAME__",
+    "appLabel": "__EXPO_HARMONY_APP_LABEL__",
+    "bundlePath": "__EXPO_HARMONY_BUNDLE_PATH__"
+  }
+}

package/harmony/AppScope/app.json5

@@ -0,0 +1,10 @@
+{
+  "app": {
+    "bundleName": "com.placeholder.app",
+    "vendor": "expo-harmony",
+    "versionCode": 1,
+    "versionName": "1.0.0",
+    "icon": "$media:app_icon",
+    "label": "$string:app_name"
+  }
+}

package/harmony/AppScope/resources/base/element/string.json

@@ -0,0 +1,8 @@
+{
+  "string": [
+    {
+      "name": "app_name",
+      "value": "expo-harmony"
+    }
+  ]
+}

package/harmony/AppScope/resources/base/media/app_icon.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="512" height="512" viewBox="0 0 512 512">
+  <rect width="512" height="512" rx="112" fill="#111827"/>
+  <path d="M139 342 229 151c11-24 43-24 54 0l90 191h-56l-19-43h-84l-19 43h-56Zm96-92h42l-21-50-21 50Z" fill="#F9FAFB"/>
+</svg>

package/harmony/build-profile.json5

@@ -0,0 +1,32 @@
+{
+  "app": {
+    "products": [
+      {
+        "name": "default",
+        "compatibleSdkVersion": "6.1.0(23)",
+        "targetSdkVersion": "6.1.1(24)",
+        "runtimeOS": "HarmonyOS",
+        "buildOption": {
+          "nativeCompiler": "BiSheng"
+        }
+      }
+    ],
+    "buildModeSet": [
+      { "name": "debug" },
+      { "name": "release" }
+    ],
+    "signingConfigs": []
+  },
+  "modules": [
+    {
+      "name": "entry",
+      "srcPath": "./entry",
+      "targets": [
+        {
+          "name": "default",
+          "applyToProducts": ["default"]
+        }
+      ]
+    }
+  ]
+}

package/harmony/entry/build-profile.json5

@@ -0,0 +1,19 @@
+{
+  "apiType": "stageMode",
+  "buildOption": {
+    "externalNativeOptions": {
+      "path": "./src/main/cpp/CMakeLists.txt",
+      "arguments": "",
+      "abiFilters": ["arm64-v8a", "x86_64"]
+    }
+  },
+  "targets": [
+    {
+      "name": "default",
+      "runtimeOS": "HarmonyOS"
+    },
+    {
+      "name": "ohosTest"
+    }
+  ]
+}

package/harmony/entry/hvigorfile.ts

@@ -0,0 +1,31 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { hapTasks } from '@ohos/hvigor-ohos-plugin';
+import { createRNOHModulePlugin } from '@rnoh/hvigor-plugin';
+
+const projectRoot = path.resolve('..');
+function resolveNodeModulesPath() {
+  let directory = projectRoot;
+  while (true) {
+    const candidate = path.join(directory, 'node_modules');
+    if (fs.existsSync(candidate)) return candidate;
+    const parent = path.dirname(directory);
+    if (parent === directory) throw new Error('Unable to find node_modules for the Harmony project.');
+    directory = parent;
+  }
+}
+const nodeModulesPath = resolveNodeModulesPath();
+
+export default {
+  system: hapTasks,
+  plugins: [
+    createRNOHModulePlugin({
+      nodeModulesPath,
+      codegen: {
+        rnohModulePath: './oh_modules/@rnoh/react-native-openharmony',
+        cppOutputPath: './entry/src/main/cpp/rnoh_codegen/generated',
+      },
+      autolinking: null,
+    }),
+  ],
+};

package/harmony/entry/oh-package.json5

@@ -0,0 +1,13 @@
+{
+  "name": "entry",
+  "version": "1.0.0",
+  "description": "expo-harmony entry module",
+  "license": "MIT",
+  "author": {
+    "name": "Baoshuo",
+    "email": "i@baoshuo.ren"
+  },
+  "homepage": "https://github.com/renbaoshuo/expo-harmony",
+  "repository": "https://github.com/renbaoshuo/expo-harmony.git",
+  "dependencies": {}
+}

package/harmony/entry/src/main/cpp/CMakeLists.txt

@@ -0,0 +1,43 @@
+cmake_minimum_required(VERSION 3.13)
+project(expo_harmony_app LANGUAGES CXX)
+
+set(CMAKE_CXX_STANDARD 20)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_POSITION_INDEPENDENT_CODE ON)
+set(OH_MODULES_DIR "${CMAKE_CURRENT_SOURCE_DIR}/../../../../oh_modules")
+set(RNOH_CPP_DIR "${OH_MODULES_DIR}/@rnoh/react-native-openharmony/src/main/cpp")
+set(RNOH_CODEGEN_ROOT "${CMAKE_CURRENT_SOURCE_DIR}/rnoh_codegen")
+set(RNOH_GENERATED_DIR "${RNOH_CODEGEN_ROOT}/generated")
+set(LOG_VERBOSITY_LEVEL 1)
+set(CMAKE_ASM_FLAGS "-Wno-error=unused-command-line-argument -Qunused-arguments")
+set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fstack-protector-strong -Wl,-z,relro,-z,now,-z,noexecstack")
+
+# Hvigor rewrites this ignored stamp only when the bytes of a linked HAR change.
+# The digest is part of every native compile command, so deterministic archives
+# with normalized old mtimes cannot make Ninja reuse stale objects.
+set(EXPO_HARMONY_NATIVE_INPUTS_STAMP
+  "${CMAKE_CURRENT_SOURCE_DIR}/../../../../.hvigor/expo-harmony/native-inputs.cmake")
+if(NOT EXISTS "${EXPO_HARMONY_NATIVE_INPUTS_STAMP}")
+  message(FATAL_ERROR "Harmony native input fingerprint is missing; build through the root Hvigor project.")
+endif()
+include("${EXPO_HARMONY_NATIVE_INPUTS_STAMP}")
+
+if(CMAKE_HOST_SYSTEM_NAME STREQUAL "Darwin" AND DEFINED OHOS_SDK_NATIVE)
+  set(CMAKE_CXX_FLAGS
+    "${CMAKE_CXX_FLAGS} -include ${OHOS_SDK_NATIVE}/sysroot/usr/include/assert.h")
+endif()
+
+add_subdirectory("${RNOH_CPP_DIR}" "${CMAKE_CURRENT_BINARY_DIR}/rnoh")
+include("${CMAKE_CURRENT_SOURCE_DIR}/autolinking.cmake")
+
+file(GLOB GENERATED_CPP_FILES "${RNOH_GENERATED_DIR}/*.cpp")
+add_library(rnoh_app SHARED
+  ${GENERATED_CPP_FILES}
+  "./PackageProvider.cpp"
+  "${RNOH_CPP_DIR}/RNOHAppNapiBridge.cpp")
+
+target_link_libraries(rnoh_app PUBLIC rnoh)
+target_include_directories(rnoh_app PRIVATE "${RNOH_CODEGEN_ROOT}")
+target_include_directories(rnoh_app PRIVATE
+  "${OH_MODULES_DIR}/@expo-harmony/expo-modules-core/src/main/cpp/package")
+autolink_libraries(rnoh_app)

package/harmony/entry/src/main/cpp/PackageProvider.cpp

@@ -0,0 +1,19 @@
+#include <RNOH/PackageProvider.h>
+
+#include <package/ExpoModulesCorePackage.h>
+
+namespace rnoh {
+using ExpoModulesCorePackage = expo::harmony::ExpoModulesCorePackage;
+}
+
+#include <memory>
+#include <vector>
+
+#include "RNOHPackagesFactory.h"
+#include "rnoh_codegen/generated/RNOHGeneratedPackage.h"
+
+std::vector<std::shared_ptr<rnoh::Package>> rnoh::PackageProvider::getPackages(rnoh::Package::Context context) {
+  auto packages = createRNOHPackages(context);
+  packages.push_back(std::make_shared<rnoh::RNOHGeneratedPackage>(context));
+  return packages;
+}

package/harmony/entry/src/main/ets/PackageProvider.ets

@@ -0,0 +1,6 @@
+import type { RNPackage, RNPackageContext } from '@rnoh/react-native-openharmony';
+import { createRNOHPackages } from './RNOHPackagesFactory';
+
+export function getRNOHPackages(context: RNPackageContext): RNPackage[] {
+  return createRNOHPackages(context);
+}

package/harmony/entry/src/main/ets/entryability/EntryAbility.ets

@@ -0,0 +1,21 @@
+/**
+ * Automatically generated by @expo-harmony/prebuild-config.
+ */
+
+import type { ExpoHarmonyHostProvider } from '@expo-harmony/expo-modules-core/Autolinking';
+import { ExpoRNAbility } from '@expo-harmony/expo-modules-core/Autolinking';
+import { expoHarmonyHostProvider } from '../generated/ExpoHarmonyHostProvider';
+
+export default class __EXPO_HARMONY_ABILITY_NAME__ extends ExpoRNAbility {
+  override getPagePath(): string {
+    return 'pages/Index';
+  }
+
+  protected override getExpoHarmonyHostProvider(): ExpoHarmonyHostProvider {
+    return expoHarmonyHostProvider;
+  }
+
+  protected override getExpoHarmonyWorkerScriptUrl(): string {
+    return 'entry/ets/workers/RNOHWorker.ets';
+  }
+}

package/harmony/entry/src/main/ets/pages/Index.ets

@@ -0,0 +1,68 @@
+/**
+ * Automatically generated by @expo-harmony/prebuild-config.
+ */
+
+import type resmgr from '@ohos.resourceManager';
+import {
+  MetroJSBundleProvider,
+  RNOHCoreContext,
+  RNOHErrorDialog,
+  ResourceJSBundleProvider,
+} from '@rnoh/react-native-openharmony';
+import { ExpoRNApp } from '@expo-harmony/expo-modules-core';
+import { getRNOHPackages } from '../PackageProvider';
+import { ExpoHarmonyRootView } from '../generated/ExpoHarmonyHostProvider';
+
+class InMemoryResourceJSBundleProvider extends ResourceJSBundleProvider {
+  private readonly ownedResourceManager: resmgr.ResourceManager;
+  private readonly ownedResourcePath: string;
+
+  constructor(resourceManager: resmgr.ResourceManager, resourcePath: string) {
+    super(resourceManager, resourcePath);
+    this.ownedResourceManager = resourceManager;
+    this.ownedResourcePath = resourcePath;
+  }
+
+  override async getBundle(): Promise<ArrayBuffer> {
+    const bytes = await this.ownedResourceManager.getRawFileContent(this.ownedResourcePath);
+    return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+  }
+}
+
+@Entry
+@Component
+struct Index {
+  @StorageLink('RNOHCoreContext') private rnohCoreContext: RNOHCoreContext | undefined = undefined;
+
+  build(): void {
+    Stack() {
+      ExpoHarmonyRootView()
+      Column() {
+        if (this.rnohCoreContext !== undefined) {
+          if (this.rnohCoreContext.isDebugModeEnabled) {
+            RNOHErrorDialog({ ctx: this.rnohCoreContext });
+          }
+          ExpoRNApp({
+            rnInstanceConfig: {
+              name: "__EXPO_HARMONY_APP_LABEL__",
+              createRNPackages: getRNOHPackages,
+              fontResourceByFontFamily: {},
+              enableDebugger: this.rnohCoreContext.isDebugModeEnabled,
+            },
+            appKey: 'main',
+            jsBundleProvider: this.rnohCoreContext.isDebugModeEnabled
+              ? new MetroJSBundleProvider()
+              : new InMemoryResourceJSBundleProvider(
+                this.rnohCoreContext.uiAbilityContext.resourceManager,
+                'hermes_bundle.hbc',
+              ),
+          });
+        }
+      }
+      .height('100%')
+      .width('100%');
+    }
+    .height('100%')
+    .width('100%');
+  }
+}

package/harmony/entry/src/main/ets/workers/RNOHWorker.ets

@@ -0,0 +1,8 @@
+import { setupRNOHWorker } from '@rnoh/react-native-openharmony/src/main/ets/setupRNOHWorker';
+import { getRNOHPackages } from '../PackageProvider';
+
+setupRNOHWorker({
+  createWorkerRNInstanceConfig: () => ({
+    thirdPartyPackagesFactory: getRNOHPackages,
+  }),
+});

package/harmony/entry/src/main/module.json5

@@ -0,0 +1,43 @@
+{
+  "module": {
+    "name": "entry",
+    "type": "entry",
+    "description": "$string:expo_harmony_module_desc",
+    "mainElement": "EntryAbility",
+    "deviceTypes": ["phone", "tablet"],
+    "deliveryWithInstall": true,
+    "installationFree": false,
+    "pages": "$profile:main_pages",
+    "requestPermissions": [
+      {
+        "name": "ohos.permission.INTERNET"
+      }
+    ],
+    "metadata": [
+      {
+        "name": "expo.harmony.userInterfaceStyle",
+        "value": "light"
+      }
+    ],
+    "abilities": [
+      {
+        "name": "EntryAbility",
+        "srcEntry": "./ets/entryability/EntryAbility.ets",
+        "description": "$string:expo_harmony_ability_desc",
+        "icon": "$media:app_icon",
+        "label": "$string:expo_harmony_ability_label",
+        "startWindowIcon": "$media:app_icon",
+        "startWindowBackground": "$color:expo_harmony_start_window_background",
+        "exported": true,
+        "visible": true,
+        "orientation": "unspecified",
+        "skills": [
+          {
+            "entities": ["entity.system.home"],
+            "actions": ["action.system.home"]
+          }
+        ]
+      }
+    ]
+  }
+}

package/harmony/entry/src/main/resources/base/element/color.json

@@ -0,0 +1,8 @@
+{
+  "color": [
+    {
+      "name": "expo_harmony_start_window_background",
+      "value": "#FFFFFF"
+    }
+  ]
+}

package/harmony/entry/src/main/resources/base/element/string.json

@@ -0,0 +1,7 @@
+{
+  "string": [
+    { "name": "expo_harmony_ability_desc", "value": "Expo Harmony main ability" },
+    { "name": "expo_harmony_ability_label", "value": "Expo Harmony App" },
+    { "name": "expo_harmony_module_desc", "value": "Expo Harmony entry module" }
+  ]
+}

package/harmony/entry/src/main/resources/base/media/app_icon.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="512" height="512" viewBox="0 0 512 512">
+  <rect width="512" height="512" rx="112" fill="#111827"/>
+  <path d="M139 342 229 151c11-24 43-24 54 0l90 191h-56l-19-43h-84l-19 43h-56Zm96-92h42l-21-50-21 50Z" fill="#F9FAFB"/>
+</svg>

package/harmony/entry/src/main/resources/base/profile/main_pages.json

@@ -0,0 +1,3 @@
+{
+  "src": ["pages/Index"]
+}

package/harmony/gitignore

@@ -0,0 +1,12 @@
+oh_modules/
+.hvigor/
+build/
+**/build/
+local.properties
+oh-package-lock.json5
+*.hap
+*.app
+*.hsp
+*.har
+entry/src/main/resources/rawfile/*.hbc
+entry/src/main/resources/rawfile/*.map

package/harmony/hvigor/hvigor-config.json5

@@ -0,0 +1,8 @@
+{
+  "modelVersion": "5.0.0",
+  "dependencies": {},
+  "execution": {},
+  "logging": {},
+  "debugging": {},
+  "nodeOptions": {}
+}

package/harmony/hvigorfile.ts

@@ -0,0 +1,240 @@
+import { spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { hvigor } from '@ohos/hvigor';
+import { appTasks, OhosPluginId } from '@ohos/hvigor-ohos-plugin';
+import { createRNOHProjectPlugin } from '@rnoh/hvigor-plugin';
+
+import { writeStamp } from './native-inputs-stamp';
+
+process.env.HERMES_V1_ENABLED = 'true';
+
+const ProjectRoot = path.resolve('..');
+const HarmonyRoot = path.join(ProjectRoot, 'harmony');
+const NodeModules = findNodeModules();
+const ProjectRequire = createRequire(path.join(ProjectRoot, 'package.json'));
+const EmbeddedBundle = path.join(ProjectRoot, '__EXPO_HARMONY_BUNDLE_PATH__');
+const HermesMagic = 'c61fbc03c103191f';
+
+let restoreBundle: (() => void) | null = null;
+
+writeStamp(ProjectRoot, HarmonyRoot);
+hvigor.nodesEvaluated(async () => {
+  await refreshExpoConstantsResource();
+});
+
+async function refreshExpoConstantsResource(): Promise<void> {
+  let plugin: { refreshExpoConstantsResourceAsync?: (projectRoot: string, harmonyRoot: string) => Promise<string> };
+  try {
+    plugin = ProjectRequire('@expo-harmony/expo-constants/plugin/withConstants');
+  } catch (error: unknown) {
+    if (error && typeof error === 'object' && 'code' in error && error.code === 'MODULE_NOT_FOUND') return;
+    throw error;
+  }
+
+  await plugin.refreshExpoConstantsResourceAsync?.(ProjectRoot, HarmonyRoot);
+}
+
+function findNodeModules(): string {
+  let directory = ProjectRoot;
+
+  while (true) {
+    const candidate = path.join(directory, 'node_modules');
+    if (fs.existsSync(candidate)) return candidate;
+
+    const parent = path.dirname(directory);
+    if (parent === directory) throw new Error('Unable to find node_modules for the Harmony project.');
+    directory = parent;
+  }
+}
+
+function stashBundle() {
+  if (!fs.existsSync(EmbeddedBundle) || restoreBundle) return;
+
+  const backupRoot = path.join(ProjectRoot, '.expo', 'harmony');
+  fs.mkdirSync(backupRoot, { recursive: true });
+
+  const backupDir = fs.mkdtempSync(path.join(backupRoot, 'debug-build-'));
+  const backup = path.join(backupDir, path.basename(EmbeddedBundle));
+  fs.renameSync(EmbeddedBundle, backup);
+
+  restoreBundle = () => {
+    if (!fs.existsSync(backup)) {
+      fs.rmSync(backupDir, { recursive: true, force: true });
+      restoreBundle = null;
+      throw new Error('Cannot restore the release Harmony bundle because its debug-build backup is missing.');
+    }
+
+    if (fs.existsSync(EmbeddedBundle)) {
+      throw new Error('Cannot restore the release Harmony bundle because its destination changed during the debug build.');
+    }
+
+    fs.renameSync(backup, EmbeddedBundle);
+    fs.rmSync(backupDir, { recursive: true, force: true });
+    restoreBundle = null;
+  };
+
+  const restoreOnExit = () => {
+    try {
+      restoreBundle?.();
+    } catch (error) {
+      process.stderr.write(`[expo-harmony] Failed to restore the release bundle: ${String(error)}\n`);
+    }
+  };
+
+  process.once('exit', restoreOnExit);
+  hvigor.buildFinished(() => {
+    try {
+      restoreBundle?.();
+    } finally {
+      if (!restoreBundle) process.removeListener('exit', restoreOnExit);
+    }
+  });
+}
+
+function readNodeVersion(executable: string): string | null {
+  const result = spawnSync(executable, ['-p', 'process.versions.node'], { encoding: 'utf8' });
+  if (result.error || result.status !== 0) return null;
+  return String(result.stdout).trim();
+}
+
+function supportsMetro(executable: string): boolean {
+  const version = readNodeVersion(executable);
+  return version !== null && Number.parseInt(version, 10) >= 20;
+}
+
+function resolveMetroNode(): string {
+  const configured = process.env.EXPO_HARMONY_NODE;
+  if (configured) {
+    if (supportsMetro(configured)) return configured;
+
+    throw new Error(
+      `EXPO_HARMONY_NODE must point to Node.js 20 or newer; received ${readNodeVersion(configured) || 'an unusable executable'}.`
+    );
+  }
+
+  const executable = process.platform === 'win32' ? 'node.exe' : 'node';
+  const candidates = (process.env.PATH || '')
+    .split(path.delimiter)
+    .filter(Boolean)
+    .map(directory => path.join(directory, executable));
+  const seen = new Set();
+
+  for (const candidate of [...candidates, process.execPath]) {
+    if (seen.has(candidate)) continue;
+
+    seen.add(candidate);
+    if (supportsMetro(candidate)) return candidate;
+  }
+
+  throw new Error(
+    'Release bundling requires Node.js 20 or newer. Set EXPO_HARMONY_NODE to its executable.'
+  );
+}
+
+function isHermesBytecode(file: string): boolean {
+  if (!fs.existsSync(file) || fs.statSync(file).size <= 12) return false;
+
+  const descriptor = fs.openSync(file, 'r');
+
+  try {
+    const header = Buffer.alloc(8);
+    const bytesRead = fs.readSync(descriptor, header, 0, header.length, 0);
+
+    return bytesRead === header.length && header.toString('hex') === HermesMagic;
+  } finally {
+    fs.closeSync(descriptor);
+  }
+}
+
+function assertBundle() {
+  if (!isHermesBytecode(EmbeddedBundle)) {
+    throw new Error('The prebuilt Harmony bundle is missing or is not Hermes bytecode.');
+  }
+}
+
+function resolveCliPath(): string {
+  try {
+    return ProjectRequire.resolve('@expo-harmony/cli/bin/expo-harmony');
+  } catch (cause) {
+    throw new Error('Release bundling requires the project-local @expo-harmony/cli package.', {
+      cause,
+    });
+  }
+}
+
+function bundleRelease() {
+  if (process.env.EXPO_HARMONY_BUNDLE_PREBUILT === '1') {
+    assertBundle();
+    return;
+  }
+
+  const executable = resolveMetroNode();
+  const cliPath = resolveCliPath();
+
+  const result = spawnSync(executable, [cliPath, 'export:embed', ProjectRoot, '--json'], {
+    cwd: ProjectRoot,
+    encoding: 'utf8',
+    env: {
+      ...process.env,
+      EXPO_METRO_TARGET: 'harmony',
+      HERMES_V1_ENABLED: 'true',
+    },
+    maxBuffer: 64 * 1024 * 1024,
+  });
+
+  if (result.error) {
+    throw new Error(result.error.message, { cause: result.error });
+  }
+
+  if (result.status !== 0) {
+    const diagnostics = (result.stderr || result.stdout || '').slice(-4000);
+
+    throw new Error(
+      `Harmony bundle failed with exit code ${result.status ?? 'unknown'}.\n${diagnostics}`
+    );
+  }
+
+  assertBundle();
+}
+
+const BundlerPlugin = {
+  pluginId: 'expo-harmony-bundler',
+  apply(node) {
+    hvigor.nodesEvaluated(() => {
+      const appContext = node.getContext(OhosPluginId.OHOS_APP_PLUGIN);
+      const buildMode = appContext.getBuildMode();
+
+      if (buildMode !== 'release') stashBundle();
+
+      node.subNodes((moduleNode) => {
+        const hapContext = moduleNode.getContext(OhosPluginId.OHOS_HAP_PLUGIN);
+
+        hapContext?.targets((target) => {
+          const targetName = target.getTargetName();
+
+          moduleNode.registerTask({
+            name: `${targetName}@ExpoHarmonyBundle`,
+            run: () => {
+              if (buildMode === 'release') bundleRelease();
+            },
+            dependencies: [`${targetName}@ProcessResource`],
+            postDependencies: [`${targetName}@CompileResource`],
+          });
+        });
+      });
+    });
+  },
+};
+
+export default {
+  system: appTasks,
+  plugins: [
+    createRNOHProjectPlugin({
+      nodeModulesPath: NodeModules,
+      bundler: { enabled: false },
+    }),
+    BundlerPlugin,
+  ],
+};

package/harmony/native-inputs-stamp.ts

@@ -0,0 +1,45 @@
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+
+import { fingerprintHarmonyNativeInputsSync } from '@expo-harmony/config-plugins/native-inputs';
+
+const StampPath = '.hvigor/expo-harmony/native-inputs.cmake';
+
+function readFileIfPresent(file: string): Buffer | null {
+  try {
+    return fs.readFileSync(file);
+  } catch (error: unknown) {
+    if (error && typeof error === 'object' && 'code' in error && error.code === 'ENOENT') return null;
+
+    throw new Error(error instanceof Error ? error.message : String(error), { cause: error });
+  }
+}
+
+export function writeStamp(projectRoot: string, harmonyRoot: string): void {
+  const { artifactCount, fingerprint } = fingerprintHarmonyNativeInputsSync({
+    lockfile: path.join(harmonyRoot, 'oh-package-lock.json5'),
+    manifest: path.join(harmonyRoot, 'oh-package.json5'),
+    projectRoot,
+  });
+  const file = path.join(harmonyRoot, ...StampPath.split('/'));
+  const content = [
+    '# Generated by @expo-harmony/template. Do not edit.',
+    `# Native HAR artifacts: ${artifactCount}`,
+    `add_compile_definitions(EXPO_HARMONY_NATIVE_INPUTS_SHA256_${fingerprint}=1)`,
+    '',
+  ].join('\n');
+
+  const current = readFileIfPresent(file);
+  if (current?.toString('utf8') === content) return;
+
+  fs.mkdirSync(path.dirname(file), { recursive: true });
+  const temp = `${file}.${process.pid}.${crypto.randomUUID()}.tmp`;
+
+  try {
+    fs.writeFileSync(temp, content);
+    fs.renameSync(temp, file);
+  } finally {
+    if (fs.existsSync(temp)) fs.rmSync(temp, { force: true });
+  }
+}

package/harmony/oh-package.json5

@@ -0,0 +1,12 @@
+{
+  "modelVersion": "5.0.0",
+  "name": "com.placeholder.app",
+  "version": "1.0.0",
+  "license": "MIT",
+  "dependencies": {
+    "@rnoh/react-native-openharmony": "0.84.1"
+  },
+  "overrides": {
+    "@rnoh/react-native-openharmony": "0.84.1"
+  }
+}

package/index.js

@@ -0,0 +1,5 @@
+'use strict';
+
+const path = require('node:path');
+
+module.exports = path.join(__dirname, 'harmony');

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@expo-harmony/template",
+  "version": "55.0.0-harmony.0",
+  "keywords": [
+    "react-native",
+    "expo",
+    "expo-harmony",
+    "harmonyos"
+  ],
+  "homepage": "https://github.com/renbaoshuo/expo-harmony/tree/master/packages/template#readme",
+  "bugs": "https://github.com/renbaoshuo/expo-harmony/issues",
+  "author": "Baoshuo <i@baoshuo.ren>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/renbaoshuo/expo-harmony.git",
+    "directory": "packages/template"
+  },
+  "main": "index.js",
+  "scripts": {
+    "start": "expo start --dev-client",
+    "harmony": "expo-harmony run",
+    "harmony:doctor": "expo-harmony doctor",
+    "harmony:export": "expo-harmony export:embed",
+    "harmony:prebuild": "expo-harmony prebuild"
+  },
+  "dependencies": {
+    "@babel/core": "7.29.7",
+    "@expo-harmony/config-plugins": "55.0.10-harmony.1",
+    "@expo-harmony/expo-modules-core": "55.0.25-harmony.1",
+    "@expo/metro-config": "55.0.26",
+    "@expo/metro-runtime": "55.0.12",
+    "@react-native-oh/react-native-harmony": "0.84.1",
+    "@react-native-oh/react-native-harmony-cli": "0.84.1",
+    "expo": "55.0.26",
+    "expo-modules-core": "55.0.25",
+    "metro": "0.83.3",
+    "metro-config": "0.83.7",
+    "react": "19.2.3",
+    "react-dom": "19.2.3",
+    "react-native": "0.84.1"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}