react-native-debug-toolkit 3.3.2 → 3.3.3

package/README.md

@@ -77,7 +77,13 @@ In the app, open Debug Panel -> `DevConnect` -> `Send Once` or `Start Live Sync`
 
 DevConnect auto-detects simulator/emulator and uses local host settings automatically. On real devices, enter your computer IP to connect.
 
-For Remote JS Bundle, run Metro on your computer, enter computer IP and Metro port in `DevConnect`, then tap `Use Metro Bundle`. DevConnect writes React Native's native dev-server host setting and reloads the app. The IP and ports are persisted through AsyncStorage when installed, or through the native module after rebuild.
+For Remote JS Bundle, run Metro on your computer, enter computer IP and Metro port in `DevConnect`, then tap `Use Metro Bundle`. DevConnect persists the host and hot-reloads from Metro.
+
+> **Debug builds only.** Metro host switching works in Debug builds. Release builds load the embedded bundle and the controls are disabled (`release: disabled` badge).
+
+**iOS — no AppDelegate changes required.** On install, DevConnect hooks `RCTBundleURLProvider` so the app **cold-starts from the embedded `main.jsbundle`** and only connects to Metro after you apply a host in the panel (fixes Expo `.expo/.virtual-metro-entry` red screens when Metro is off). Use **Reset** to go back to the embedded bundle.
+
+The IP and ports are persisted through AsyncStorage when installed, or through the native module after rebuild.
 
 QR scan is optional. Install `react-native-camera-kit` or `expo-camera` in the app to enable the scan button. The app must request camera permission before scanning.
 

package/README.zh-CN.md

@@ -77,7 +77,13 @@ App 内打开 Debug Panel -> `DevConnect` -> `Send Once` 或 `Start Live Sync`
 
 DevConnect 自动识别模拟器/真机，模拟器下自动使用本机 Metro/daemon 地址。真机需输入电脑 IP 地址。
 
-Remote JS Bundle：先在电脑启动 Metro，在 `DevConnect` 输入电脑 IP 和 Metro 端口，然后点 `Use Metro Bundle`。DevConnect 会写入 React Native 原生 dev-server host 设置并 reload App。IP 和端口会通过 AsyncStorage 持久化；如果没装 AsyncStorage，则在重建后通过本库原生模块持久化。
+Remote JS Bundle：先在电脑启动 Metro，在 `DevConnect` 输入电脑 IP 和 Metro 端口，然后点 `Use Metro Bundle`。DevConnect 会持久化 host 并从 Metro 热重载。
+
+> **仅 Debug 包可用。** Release 包控件会显示 `release: disabled` 并禁用。
+
+**iOS — 无需改 AppDelegate。** 安装本库后会 hook `RCTBundleURLProvider`：**未配置 IP 时冷启动走内置 `main.jsbundle`**，只有在面板里应用 host 后才连 Metro（可避免 Metro 未开时的 `.expo/.virtual-metro-entry` 红屏）。点 **Reset** 可回到内置 bundle。
+
+IP 和端口会通过 AsyncStorage 持久化；如果没装 AsyncStorage，则在重建后通过本库原生模块持久化。
 
 扫码是可选能力。App 安装 `react-native-camera-kit` 或 `expo-camera` 后，DevConnect 才显示扫码按钮。App 仍需自己配置相机权限文案，并在使用扫码前申请相机权限。
 

package/bin/debug-toolkit.js

@@ -27,10 +27,19 @@ function hasHelpFlag(args) {
 function printHelp() {
   process.stderr.write(
     'Usage: debug-toolkit [--host 0.0.0.0] [--port 3799] [--token dev-token] [--store ~/.react-native-debug-toolkit/daemon-devices.json] [--daemon-only]\n'
+  + '       debug-toolkit embed [--platform ios|android] [--undo] [--yes]\n'
   + '\n'
   + 'Starts the debug toolkit: daemon (HTTP + Web Console) and MCP stdio server.\n'
   + '\n'
-  + 'Options:\n'
+  + 'Commands:\n'
+  + '  embed           Embed JS bundle in debug builds (run in host app root)\n'
+  + '\n'
+  + 'Embed options:\n'
+  + '  --platform <p>  Target platform: ios or android (default: both)\n'
+  + '  --undo          Remove embed injections\n'
+  + '  --yes           Skip confirmations (CI/EAS)\n'
+  + '\n'
+  + 'Daemon options:\n'
   + '  --host <addr>   Host to bind (default: 0.0.0.0)\n'
     + '  --port <port>   Port to bind (default: 3799)\n'
   + '  --token <str>   Auth token for daemon endpoints\n'
@@ -57,6 +66,12 @@ async function main() {
     return;
   }
 
+  // Route embed subcommand
+  if (args[0] === 'embed') {
+    const { main: embedMain } = require('../scripts/embed');
+    return embedMain(args.slice(1));
+  }
+
   const host = readOption(args, '--host', process.env.DEBUG_TOOLKIT_DAEMON_HOST || DEFAULT_HOST);
   const port = Number(readOption(args, '--port', process.env.DEBUG_TOOLKIT_DAEMON_PORT || DEFAULT_PORT));
   const token = readOption(args, '--token', process.env.DEBUG_TOOLKIT_DAEMON_TOKEN || '');

package/ios/DebugToolkitDevConnect.h

@@ -0,0 +1,17 @@
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ Returns a Metro bundle URL when the user has applied a host via DevConnect; otherwise nil.
+
+ Zero-config: installing this pod hooks RCTBundleURLProvider so cold start uses the embedded
+ main.jsbundle until DevConnect applies a host. You do not need to change AppDelegate.
+
+ Optional override for custom bundleURL() implementations:
+
+     if let metro = DebugToolkitMetroBundleURL() { return metro }
+ */
+FOUNDATION_EXPORT NSURL * _Nullable DebugToolkitMetroBundleURL(void);
+
+NS_ASSUME_NONNULL_END