expo-dev-launcher 6.0.18 → 6.0.19

package/CHANGELOG.md

@@ -10,6 +10,12 @@
 
 ### 💡 Others
 
+## 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.19"
 
 android {
   namespace "expo.modules.devlauncher"
   defaultConfig {
     versionCode 9
-    versionName "6.0.18"
+    versionName "6.0.19"
   }
 
   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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "expo-dev-launcher",
   "title": "Expo Development Launcher",
-  "version": "6.0.18",
+  "version": "6.0.19",
   "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",
+    "ajv": "^8.11.0",
+    "expo-dev-menu": "7.0.18",
     "expo-manifests": "~1.0.9"
   },
   "peerDependencies": {
     "expo": "*"
   },
-  "gitHead": "36dd0d95ef851763ebe8c97c22afde3cb2f846cb"
+  "gitHead": "e8b838828e5e985379c07294dc932dba66c89562"
 }

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__/*"],
+}