@expo-harmony/expo-dev-launcher 55.0.36-harmony.1

package/README.md

@@ -0,0 +1,73 @@
+# @expo-harmony/expo-dev-launcher
+
+[**GitHub 仓库**](https://github.com/renbaoshuo/expo-harmony/tree/master/packages/expo-dev-launcher) | [官方文档](https://docs.expo.dev/versions/v55.0.0/sdk/dev-client/)
+
+为 HarmonyOS 上的 Expo 开发构建提供原生启动器，支持项目地址、最近项目、mDNS 发现、系统扫码和返回主页。与官方同版本的 `expo-dev-launcher` 配套使用。
+
+## 安装
+
+```bash
+npm install @expo-harmony/expo-dev-launcher expo-dev-launcher@55.0.36
+```
+
+本包适配 Expo SDK 55 的 `expo-dev-launcher`，提供鸿蒙端的原生启动器，原生模块通过 Expo Harmony 自动链接。启动器只在开发构建中生效，配置插件负责写入开发链接入口和所需权限，见下文。最低支持 HarmonyOS 5.0.1（API 13），宿主的 `compatibleSdkVersion` 也要满足这一要求。
+
+使用 `@expo-harmony/expo-dev-client` 时本包由其引入，无需单独安装，但仍需按下文显式注册本包的配置插件。`@expo-harmony/expo-dev-client` 只聚合依赖，不提供插件入口。
+
+## Config Plugin
+
+```json
+{
+  "expo": {
+    "plugins": [
+      [
+        "@expo-harmony/expo-dev-launcher",
+        {
+          "launchMode": "launcher",
+          "toolsButton": true
+        }
+      ]
+    ],
+    "harmony": {
+      "bundleName": "com.example.app"
+    }
+  }
+}
+```
+
+`launchMode` 取 `most-recent`（默认）或 `launcher`。前者尝试加载最近项目，失败时留在启动器并显示错误。后者跳过最近项目，始终显示启动器。`toolsButton` 控制开发菜单 FAB 的默认值，用户保存的偏好优先。
+
+插件在原生工程中添加 `expo-harmony://open?url=...` 的链接入口、网络权限和启动模式配置。开发链接在普通 Linking 分发前被消费，应用自身的深链接不受影响。扫码使用系统扫码界面，不额外申请应用相机权限。Release 构建保留链接入口，启动器不启用，开发链接也不被消费。
+
+## API 对照表
+
+### Methods
+
+#### `ExpoDevLauncher.loadApp(url)`
+
+返回 `Promise<void>`，加载并启动一个开发项目。接受 HTTP(S) 项目地址、`exp://`、`exps://` 地址和开发客户端链接（`expo-harmony://open?url=...`），带凭据、fragment 或编码无效的地址会被拒绝，错误也会显示在启动器界面。一次加载未完成时又收到新地址，以最新的为准。Release 构建中调用直接返回。
+
+以 `.bundle` 或 `.js` 结尾的地址按 Metro bundle 加载，其余地址按开发清单处理。清单会与客户端内置的运行时信息逐项比较，runtimeVersion、Expo / RNOH / Hermes 版本、已编入的原生模块和权限要求都要匹配，项目不能要求客户端没有编入的原生能力。已发布的项目需要客户端编入 `@expo-harmony/expo-updates`，由 Updates 下载并提供本地 bundle，没有 Updates 时这类项目拒绝加载。
+
+### Native Modules
+
+#### `EXDevLauncher.getConstants()`
+
+提供 `manifestString` 和 `manifestURL`，分别是当前项目清单的 JSON 字符串和清单地址。未选择项目时两者均为 `null`。只在开发构建中可用。
+
+### 启动器
+
+启动器界面列出最近项目和局域网内 mDNS 发现的开发服务，也可以手动输入地址或系统扫码。最近项目按地址去重，保存三天。扫码使用系统扫码界面，不申请相机权限，设备不支持时提示错误。
+
+开发菜单中的 Home 退出当前项目，回到启动器界面。上一次启动的运行时错误会记录下来，最多 32 KiB，保留三天。下次启动时读取一次并显示在启动器界面，应用停留在启动器，不自动重新进入失败的项目。系统原生崩溃不在此列。
+
+> **未实现的内容**
+>
+> - 账户登录、EAS 分支浏览。HarmonyOS 开发客户端没有接入 EAS 账户体系。
+
+## 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 [@renbaoshuo](https://twitter.com/renbaoshuo)

package/app.plugin.js

@@ -0,0 +1,3 @@
+'use strict';
+
+module.exports = require('./plugin/withDevLauncher');

package/expo-module.config.json

@@ -0,0 +1,10 @@
+{
+  "platforms": ["harmony"],
+  "harmony": {
+    "modules": ["ExpoDevLauncherModule"],
+    "runtimeBindings": ["ExpoDevLauncherDevMenuBinding"],
+    "reactNativeHostHandlers": ["ExpoDevLauncherReactNativeHostHandler"],
+    "reactActivityHandlers": ["ExpoDevLauncherReactActivityHandler"],
+    "abilityLifecycleSubscribers": ["ExpoDevLauncherLifecycleSubscriber"]
+  }
+}

package/harmony/library/oh-package.json5

@@ -0,0 +1,16 @@
+{
+  "name": "@expo-harmony/expo-dev-launcher",
+  "version": "55.0.36-harmony.1",
+  "description": "HarmonyOS port of expo-dev-launcher",
+  "main": "Index.ets",
+  "license": "MIT",
+  "dependencies": {
+    "@expo-harmony/expo-dev-menu": "55.0.30-harmony.1",
+    "@expo-harmony/expo-dev-menu-interface": "55.0.2-harmony.1",
+    "@expo-harmony/expo-modules-core": "55.0.25-harmony.4",
+    "@expo-harmony/expo-manifests": "55.0.17-harmony.2",
+    "@expo-harmony/expo-updates-interface": "55.1.6-harmony.2",
+    "@expo-harmony/expo-eas-client": "55.0.5-harmony.2",
+    "@rnoh/react-native-openharmony": "0.84.1"
+  }
+}

package/index.d.ts

@@ -0,0 +1 @@
+export {};

package/index.js

@@ -0,0 +1,3 @@
+'use strict';
+
+module.exports = Object.freeze({});

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@expo-harmony/expo-dev-launcher",
+  "version": "55.0.36-harmony.1",
+  "description": "HarmonyOS port of expo-dev-launcher",
+  "keywords": [
+    "react-native",
+    "expo",
+    "expo-harmony",
+    "harmonyos"
+  ],
+  "author": "Baoshuo <i@baoshuo.ren>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/renbaoshuo/expo-harmony.git",
+    "directory": "packages/expo-dev-launcher"
+  },
+  "homepage": "https://github.com/renbaoshuo/expo-harmony/tree/master/packages/expo-dev-launcher#readme",
+  "bugs": "https://github.com/renbaoshuo/expo-harmony/issues",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "scripts": {
+    "harmony:clean": "expo-harmony-module prepare --clean-only",
+    "harmony:build": "expo-harmony-module prepare",
+    "prepack": "expo-harmony-module prepack"
+  },
+  "peerDependencies": {
+    "@expo-harmony/expo-modules-core": "55.0.25-harmony.4",
+    "expo-dev-launcher": "55.0.36"
+  },
+  "devDependencies": {
+    "@expo-harmony/expo-module-scripts": "55.0.0-harmony.4",
+    "@expo-harmony/expo-modules-core": "55.0.25-harmony.4",
+    "@react-native-oh/react-native-harmony": "0.84.1",
+    "expo": "55.0.26",
+    "expo-dev-launcher": "55.0.36",
+    "expo-modules-core": "55.0.25",
+    "react": "19.2.3",
+    "react-native": "0.84.1"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@expo-harmony/config-plugins": "55.0.10-harmony.5",
+    "@expo-harmony/expo-dev-menu": "55.0.30-harmony.1",
+    "@expo-harmony/expo-dev-menu-interface": "55.0.2-harmony.1",
+    "@expo-harmony/expo-eas-client": "55.0.5-harmony.2",
+    "@expo-harmony/expo-manifests": "55.0.17-harmony.2",
+    "@expo-harmony/expo-updates-interface": "55.1.6-harmony.2",
+    "@expo/config-plugins": "55.0.10"
+  },
+  "harmony": {
+    "autolinking": {
+      "mainHarPath": "harmony",
+      "ohPackageName": "@expo-harmony/expo-dev-launcher",
+      "etsPackageClassName": "ExpoDevLauncherPackage",
+      "etsPackageImport": "named",
+      "cppPackageClassName": "ExpoDevLauncherPackage",
+      "cmakeLibraryTargetName": "expo_harmony__expo_dev_launcher"
+    }
+  }
+}

package/plugin/withDevLauncher.js

@@ -0,0 +1,89 @@
+'use strict';
+
+const { createRunOncePlugin } = require('@expo/config-plugins');
+const {
+  HarmonyManifest,
+  registerHarmonyConfigPlugin,
+  withModuleJson,
+} = require('@expo-harmony/config-plugins');
+
+const pkg = require('../package.json');
+
+const INTERNET_PERMISSION = 'ohos.permission.INTERNET';
+const NETWORK_INFO_PERMISSION = 'ohos.permission.GET_NETWORK_INFO';
+const LAUNCH_MODE_METADATA = 'expo.devLauncher.launchMode';
+const TOOLS_BUTTON_METADATA = 'EXDevMenuShowFloatingActionButton';
+const DEEP_LINK_SCHEME = 'expo-harmony';
+const DEEP_LINK_HOST = 'open';
+const VIEW_ACTION = 'ohos.want.action.viewData';
+const BROWSABLE_ENTITY = 'entity.system.browsable';
+
+function launchMode(options) {
+  const value = options.launchMode ?? options.launchModeExperimental ?? 'most-recent';
+  if (value !== 'most-recent' && value !== 'launcher') {
+    throw new TypeError('expo-dev-launcher launchMode must be \'most-recent\' or \'launcher\'.');
+  }
+  return value;
+}
+
+function selectedAbility(module) {
+  const name = module.mainElement;
+  return Array.isArray(module.abilities)
+    ? module.abilities.find((ability, index) => ability?.name === name || (!name && index === 0))
+    : undefined;
+}
+
+function isLauncherSkill(skill) {
+  return Array.isArray(skill?.entities) && skill.entities.length === 1 && skill.entities[0] === BROWSABLE_ENTITY
+    && Array.isArray(skill?.actions) && skill.actions.length === 1 && skill.actions[0] === VIEW_ACTION
+    && Array.isArray(skill?.uris) && skill.uris.length === 1
+    && skill.uris[0]?.scheme === DEEP_LINK_SCHEME && skill.uris[0]?.host === DEEP_LINK_HOST;
+}
+
+function updateManifest(json, options = {}) {
+  const module = json.module;
+  if (!module || typeof module !== 'object') throw new TypeError('expo-dev-launcher requires a Harmony module manifest.');
+
+  const ability = selectedAbility(module);
+  if (!ability) throw new TypeError('expo-dev-launcher requires an entry UIAbility.');
+
+  const target = { metadata: module.metadata };
+  HarmonyManifest.setMetadata(target, { name: LAUNCH_MODE_METADATA, value: launchMode(options) });
+  if (typeof options.toolsButton === 'boolean') {
+    HarmonyManifest.setMetadata(target, { name: TOOLS_BUTTON_METADATA, value: String(options.toolsButton) });
+  }
+
+  const permissions = Array.isArray(module.requestPermissions) ? module.requestPermissions : [];
+  const managedPermissions = new Set([INTERNET_PERMISSION, NETWORK_INFO_PERMISSION]);
+  const requestPermissions = [
+    ...permissions.filter(permission => !managedPermissions.has(permission?.name)),
+    permissions.find(permission => permission?.name === INTERNET_PERMISSION) ?? { name: INTERNET_PERMISSION },
+    permissions.find(permission => permission?.name === NETWORK_INFO_PERMISSION) ?? { name: NETWORK_INFO_PERMISSION },
+  ];
+  const skills = Array.isArray(ability.skills) ? ability.skills : [];
+  const launcherSkill = {
+    entities: [BROWSABLE_ENTITY],
+    actions: [VIEW_ACTION],
+    uris: [{ scheme: DEEP_LINK_SCHEME, host: DEEP_LINK_HOST }],
+  };
+  const abilities = module.abilities.map(item => item === ability
+    ? { ...item, skills: [...skills.filter(skill => !isLauncherSkill(skill)), launcherSkill] }
+    : item);
+
+  return { ...json, module: { ...module, metadata: target.metadata, requestPermissions, abilities } };
+}
+
+function withHarmonyDevLauncher(config, options = {}) {
+  const enabled = config.harmony?.bundleName || config.platforms?.includes('harmony');
+  if (!enabled) return config;
+
+  config = registerHarmonyConfigPlugin(config, pkg.name);
+  config = withModuleJson(config, (mod) => {
+    mod.modResults = updateManifest(mod.modResults, options);
+    return mod;
+  });
+
+  return config;
+}
+
+module.exports = createRunOncePlugin(withHarmonyDevLauncher, pkg.name, pkg.version);