expo-dev-launcher 6.0.18 → 6.0.20

package/CHANGELOG.md

@@ -10,6 +10,18 @@
 
 ### 💡 Others
 
+## 6.0.20 — 2025-12-05
+
+### 🐛 Bug fixes
+
+- [iOS] Fix port scanning on pysical devices. ([#40824](https://github.com/expo/expo/pull/40824) by [@alanjhughes](https://github.com/alanjhughes))
+
+## 6.0.19 — 2025-12-04
+
+### 🐛 Bug fixes
+
+- Restore config plugin `launchMode` support ([#41363](https://github.com/expo/expo/pull/41363) by [@gabrieldonadel](https://github.com/gabrieldonadel))
+
 ## 6.0.18 — 2025-11-17
 
 _This version does not introduce any user-facing changes._

package/android/build.gradle

@@ -20,21 +20,32 @@ expoModule {
 }
 
 group = "host.exp.exponent"
-version = "6.0.18"
+version = "6.0.20"
 
 android {
   namespace "expo.modules.devlauncher"
   defaultConfig {
     versionCode 9
-    versionName "6.0.18"
+    versionName "6.0.20"
   }
 
   buildTypes {
+    create("debugOptimized") {
+      initWith(buildTypes.debug)
+      matchingFallbacks += ["release"]
+    }
+
     buildTypes.each {
       it.buildConfigField 'String', 'VERSION', "\"${defaultConfig.versionName}\""
     }
   }
 
+  sourceSets {
+    debugOptimized {
+      setRoot 'src/debug'
+    }
+  }
+
   buildFeatures {
     buildConfig true
     viewBinding true

package/app.plugin.js

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

package/expo-dev-launcher-gradle-plugin/src/main/kotlin/expo/modules/devlauncher/DevLauncherPlugin.kt

@@ -51,7 +51,7 @@ abstract class DevLauncherPlugin : Plugin<Project> {
     return if (System.getenv("EX_UPDATES_NATIVE_DEBUG") != "1" && reactExtension != null) {
       reactExtension.debuggableVariants.get().any { it.equals(variant.name, ignoreCase = true) }
     } else {
-      variant.buildType == "debug"
+      variant.buildType == "debug" || variant.buildType == "debugOptimized"
     }
   }
 

package/ios/SwiftUI/DevLauncherViewModel.swift

@@ -125,12 +125,15 @@ class DevLauncherViewModel: ObservableObject {
       // swiftlint:disable number_separator
       let portsToCheck = [8081, 8082, 8_083, 8084, 8085, 19000, 19001, 19002]
       // swiftlint:enable number_separator
-      let baseAddress = "http://localhost"
 
+      let ipsToScan = NetworkUtilities.getIPAddressesToScan()
       await withTaskGroup(of: DevServer?.self) { group in
-        for port in portsToCheck {
-          group.addTask {
-            await self.checkDevServer(url: "\(baseAddress):\(port)")
+        for ip in ipsToScan {
+          for port in portsToCheck {
+            group.addTask {
+              let baseAddress = ip == "localhost" ? "http://localhost" : "http://\(ip)"
+              return await self.checkDevServer(url: "\(baseAddress):\(port)")
+            }
           }
         }
 

package/ios/SwiftUI/NetworkUtilities.swift

@@ -0,0 +1,73 @@
+// Copyright 2015-present 650 Industries. All rights reserved.
+
+import Foundation
+import Network
+
+class NetworkUtilities {
+  // Same approach as expo-network just without throwing.
+  static func getLocalIPAddress() -> String? {
+    var address: String?
+
+    var ifaddr: UnsafeMutablePointer<ifaddrs>?
+    guard getifaddrs(&ifaddr) == 0 else { return nil }
+    guard let firstAddr = ifaddr else { return nil }
+
+    defer { freeifaddrs(ifaddr) }
+
+    for ifptr in sequence(first: firstAddr, next: { $0.pointee.ifa_next }) {
+      let interface = ifptr.pointee
+
+      let addrFamily = interface.ifa_addr.pointee.sa_family
+      if addrFamily == UInt8(AF_INET) {
+        let name = String(cString: interface.ifa_name)
+
+        if name == "en0" || name == "en1" {
+          var hostname = [CChar](repeating: 0, count: Int(NI_MAXHOST))
+          getnameinfo(
+            interface.ifa_addr,
+            socklen_t(interface.ifa_addr.pointee.sa_len),
+            &hostname,
+            socklen_t(hostname.count),
+            nil,
+            socklen_t(0),
+            NI_NUMERICHOST
+          )
+          address = String(cString: hostname)
+          break
+        }
+      }
+    }
+
+    return address
+  }
+
+  static func isSimulator() -> Bool {
+    #if targetEnvironment(simulator)
+    return true
+    #else
+    return false
+    #endif
+  }
+
+  static func getIPAddressesToScan() -> [String] {
+    if isSimulator() {
+      return ["localhost"]
+    }
+
+    guard let localIP = getLocalIPAddress() else {
+      return ["localhost"]
+    }
+
+    let components = localIP.split(separator: ".")
+    guard components.count == 4 else {
+      return ["localhost"]
+    }
+
+    let subnet = components.prefix(3).joined(separator: ".")
+
+    return [
+      "localhost",
+      "\(subnet).1"
+    ]
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "expo-dev-launcher",
   "title": "Expo Development Launcher",
-  "version": "6.0.18",
+  "version": "6.0.20",
   "description": "Pre-release version of the Expo development launcher package for testing.",
   "repository": {
     "type": "git",
@@ -15,11 +15,12 @@
   "license": "MIT",
   "homepage": "https://docs.expo.dev",
   "dependencies": {
-    "expo-dev-menu": "7.0.17",
-    "expo-manifests": "~1.0.9"
+    "ajv": "^8.11.0",
+    "expo-dev-menu": "7.0.18",
+    "expo-manifests": "~1.0.10"
   },
   "peerDependencies": {
     "expo": "*"
   },
-  "gitHead": "36dd0d95ef851763ebe8c97c22afde3cb2f846cb"
+  "gitHead": "172a69f5f70c1d0e043e1532f924de97210cabc3"
 }

package/plugin/build/pluginConfig.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Type representing base dev launcher configuration.
+ */
+export type PluginConfigType = PluginConfigOptionsByPlatform & PluginConfigOptions;
+/**
+ * Type representing available configuration for each platform.
+ */
+export type PluginConfigOptionsByPlatform = {
+    /**
+     * Type representing available configuration for Android dev launcher.
+     * @platform android
+     */
+    android?: PluginConfigOptions;
+    /**
+     * Type representing available configuration for iOS dev launcher.
+     * @platform ios
+     */
+    ios?: PluginConfigOptions;
+};
+/**
+ * Type representing available configuration for dev launcher.
+ */
+export type PluginConfigOptions = {
+    /**
+     * Determines whether to launch the most recently opened project or navigate to the launcher screen.
+     *
+     * - `'most-recent'` - Attempt to launch directly into a previously opened project and if unable to connect,
+     * fall back to the launcher screen.
+     *
+     * - `'launcher'` - Opens the launcher screen.
+     *
+     * @default 'most-recent'
+     */
+    launchMode?: 'most-recent' | 'launcher';
+    /**
+     * @deprecated use the `launchMode` property instead
+     */
+    launchModeExperimental?: 'most-recent' | 'launcher';
+};
+/**
+ * @ignore
+ */
+export declare function validateConfig<T>(config: T): PluginConfigType;

package/plugin/build/pluginConfig.js

@@ -0,0 +1,76 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateConfig = validateConfig;
+const ajv_1 = __importDefault(require("ajv"));
+const schema = {
+    type: 'object',
+    properties: {
+        launchMode: {
+            type: 'string',
+            enum: ['most-recent', 'launcher'],
+            nullable: true,
+        },
+        launchModeExperimental: {
+            type: 'string',
+            enum: ['most-recent', 'launcher'],
+            nullable: true,
+        },
+        android: {
+            type: 'object',
+            properties: {
+                launchMode: {
+                    type: 'string',
+                    enum: ['most-recent', 'launcher'],
+                    nullable: true,
+                },
+                launchModeExperimental: {
+                    type: 'string',
+                    enum: ['most-recent', 'launcher'],
+                    nullable: true,
+                },
+            },
+            nullable: true,
+        },
+        ios: {
+            type: 'object',
+            properties: {
+                launchMode: {
+                    type: 'string',
+                    enum: ['most-recent', 'launcher'],
+                    nullable: true,
+                },
+                launchModeExperimental: {
+                    type: 'string',
+                    enum: ['most-recent', 'launcher'],
+                    nullable: true,
+                },
+            },
+            nullable: true,
+        },
+    },
+};
+/**
+ * @ignore
+ */
+function validateConfig(config) {
+    const validate = new ajv_1.default({ allowUnionTypes: true }).compile(schema);
+    if (!validate(config)) {
+        throw new Error('Invalid expo-dev-launcher config: ' + JSON.stringify(validate.errors));
+    }
+    if (config.launchModeExperimental ||
+        config.ios?.launchModeExperimental ||
+        config.android?.launchModeExperimental) {
+        warnOnce('The `launchModeExperimental` property of expo-dev-launcher config plugin is deprecated and will be removed in a future SDK release. Use `launchMode` instead.');
+    }
+    return config;
+}
+const warnMap = {};
+function warnOnce(message) {
+    if (!warnMap[message]) {
+        warnMap[message] = true;
+        console.warn(message);
+    }
+}

package/plugin/build/withDevLauncher.d.ts

@@ -0,0 +1,3 @@
+import { PluginConfigType } from './pluginConfig';
+declare const _default: import("expo/config-plugins").ConfigPlugin<PluginConfigType>;
+export default _default;

package/plugin/build/withDevLauncher.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const config_plugins_1 = require("expo/config-plugins");
+const pluginConfig_1 = require("./pluginConfig");
+const pkg = require('expo-dev-launcher/package.json');
+exports.default = (0, config_plugins_1.createRunOncePlugin)((config, props = {}) => {
+    (0, pluginConfig_1.validateConfig)(props);
+    const iOSLaunchMode = props.ios?.launchMode ??
+        props.launchMode ??
+        props.ios?.launchModeExperimental ??
+        props.launchModeExperimental;
+    if (iOSLaunchMode === 'launcher') {
+        config = (0, config_plugins_1.withInfoPlist)(config, (config) => {
+            config.modResults['DEV_CLIENT_TRY_TO_LAUNCH_LAST_BUNDLE'] = false;
+            return config;
+        });
+    }
+    const androidLaunchMode = props.android?.launchMode ??
+        props.launchMode ??
+        props.android?.launchModeExperimental ??
+        props.launchModeExperimental;
+    if (androidLaunchMode === 'launcher') {
+        config = (0, config_plugins_1.withAndroidManifest)(config, (config) => {
+            const mainApplication = config_plugins_1.AndroidConfig.Manifest.getMainApplicationOrThrow(config.modResults);
+            config_plugins_1.AndroidConfig.Manifest.addMetaDataItemToMainApplication(mainApplication, 'DEV_CLIENT_TRY_TO_LAUNCH_LAST_BUNDLE', false?.toString());
+            return config;
+        });
+    }
+    return config;
+}, pkg.name, pkg.version);

package/plugin/jest.config.js

@@ -0,0 +1 @@
+module.exports = {};

package/plugin/src/pluginConfig.ts

@@ -0,0 +1,121 @@
+import Ajv, { JSONSchemaType } from 'ajv';
+
+/**
+ * Type representing base dev launcher configuration.
+ */
+export type PluginConfigType = PluginConfigOptionsByPlatform & PluginConfigOptions;
+
+/**
+ * Type representing available configuration for each platform.
+ */
+export type PluginConfigOptionsByPlatform = {
+  /**
+   * Type representing available configuration for Android dev launcher.
+   * @platform android
+   */
+  android?: PluginConfigOptions;
+  /**
+   * Type representing available configuration for iOS dev launcher.
+   * @platform ios
+   */
+  ios?: PluginConfigOptions;
+};
+
+/**
+ * Type representing available configuration for dev launcher.
+ */
+export type PluginConfigOptions = {
+  /**
+   * Determines whether to launch the most recently opened project or navigate to the launcher screen.
+   *
+   * - `'most-recent'` - Attempt to launch directly into a previously opened project and if unable to connect,
+   * fall back to the launcher screen.
+   *
+   * - `'launcher'` - Opens the launcher screen.
+   *
+   * @default 'most-recent'
+   */
+  launchMode?: 'most-recent' | 'launcher';
+  /**
+   * @deprecated use the `launchMode` property instead
+   */
+  launchModeExperimental?: 'most-recent' | 'launcher';
+};
+
+const schema: JSONSchemaType<PluginConfigType> = {
+  type: 'object',
+  properties: {
+    launchMode: {
+      type: 'string',
+      enum: ['most-recent', 'launcher'],
+      nullable: true,
+    },
+    launchModeExperimental: {
+      type: 'string',
+      enum: ['most-recent', 'launcher'],
+      nullable: true,
+    },
+    android: {
+      type: 'object',
+      properties: {
+        launchMode: {
+          type: 'string',
+          enum: ['most-recent', 'launcher'],
+          nullable: true,
+        },
+        launchModeExperimental: {
+          type: 'string',
+          enum: ['most-recent', 'launcher'],
+          nullable: true,
+        },
+      },
+      nullable: true,
+    },
+    ios: {
+      type: 'object',
+      properties: {
+        launchMode: {
+          type: 'string',
+          enum: ['most-recent', 'launcher'],
+          nullable: true,
+        },
+        launchModeExperimental: {
+          type: 'string',
+          enum: ['most-recent', 'launcher'],
+          nullable: true,
+        },
+      },
+      nullable: true,
+    },
+  },
+};
+
+/**
+ * @ignore
+ */
+export function validateConfig<T>(config: T): PluginConfigType {
+  const validate = new Ajv({ allowUnionTypes: true }).compile(schema);
+  if (!validate(config)) {
+    throw new Error('Invalid expo-dev-launcher config: ' + JSON.stringify(validate.errors));
+  }
+
+  if (
+    config.launchModeExperimental ||
+    config.ios?.launchModeExperimental ||
+    config.android?.launchModeExperimental
+  ) {
+    warnOnce(
+      'The `launchModeExperimental` property of expo-dev-launcher config plugin is deprecated and will be removed in a future SDK release. Use `launchMode` instead.'
+    );
+  }
+
+  return config;
+}
+
+const warnMap: Record<string, boolean> = {};
+function warnOnce(message: string) {
+  if (!warnMap[message]) {
+    warnMap[message] = true;
+    console.warn(message);
+  }
+}

package/plugin/src/withDevLauncher.ts

@@ -0,0 +1,50 @@
+import {
+  createRunOncePlugin,
+  AndroidConfig,
+  withInfoPlist,
+  withAndroidManifest,
+} from 'expo/config-plugins';
+
+import { PluginConfigType, validateConfig } from './pluginConfig';
+
+const pkg = require('expo-dev-launcher/package.json');
+
+export default createRunOncePlugin<PluginConfigType>(
+  (config, props = {}) => {
+    validateConfig(props);
+
+    const iOSLaunchMode =
+      props.ios?.launchMode ??
+      props.launchMode ??
+      props.ios?.launchModeExperimental ??
+      props.launchModeExperimental;
+    if (iOSLaunchMode === 'launcher') {
+      config = withInfoPlist(config, (config) => {
+        config.modResults['DEV_CLIENT_TRY_TO_LAUNCH_LAST_BUNDLE'] = false;
+        return config;
+      });
+    }
+
+    const androidLaunchMode =
+      props.android?.launchMode ??
+      props.launchMode ??
+      props.android?.launchModeExperimental ??
+      props.launchModeExperimental;
+    if (androidLaunchMode === 'launcher') {
+      config = withAndroidManifest(config, (config) => {
+        const mainApplication = AndroidConfig.Manifest.getMainApplicationOrThrow(config.modResults);
+
+        AndroidConfig.Manifest.addMetaDataItemToMainApplication(
+          mainApplication,
+          'DEV_CLIENT_TRY_TO_LAUNCH_LAST_BUNDLE',
+          false?.toString()
+        );
+        return config;
+      });
+    }
+
+    return config;
+  },
+  pkg.name,
+  pkg.version
+);

package/plugin/tsconfig.json

@@ -0,0 +1,9 @@
+{
+	"extends": "expo-module-scripts/tsconfig.plugin",
+  "compilerOptions": {
+    "outDir": "build",
+    "rootDir": "src",
+  },
+  "include": ["./src"],
+  "exclude": ["**/__mocks__/*", "**/__tests__/*"],
+}