[dev-launcher] rename tryToLaunchLastOpenedBundle config plugin option to launchModeExperimental

packages/expo-dev-launcher/CHANGELOG.md

@@ -9,7 +9,7 @@
 ### 🎉 New features
 
 - Improve 'Development servers' and 'Recently opened' UX. ([#24665](https://github.com/expo/expo/pull/24665) by [@gabrieldonadel](https://github.com/gabrieldonadel))
-- Add support for skipping the launcher screen and launching directly into a previously opened project. ([#24614](https://github.com/expo/expo/pull/24614), [#24646](https://github.com/expo/expo/pull/24646) by [@gabrieldonadel](https://github.com/gabrieldonadel))
+- Add support for skipping the launcher screen and launching directly into a previously opened project. ([#24614](https://github.com/expo/expo/pull/24614), [#24646](https://github.com/expo/expo/pull/24646), [#24758](https://github.com/expo/expo/pull/24758) by [@gabrieldonadel](https://github.com/gabrieldonadel))
 
 ### 🐛 Bug fixes
 

packages/expo-dev-launcher/plugin/src/pluginConfig.ts

@@ -26,27 +26,45 @@ export type PluginConfigOptionsByPlatform = {
  */
 export type PluginConfigOptions = {
   /**
-   * Attempts to launch directly into a previously opened project. If unable to connect,
+   * **Experimental:** 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 'launcher'
    */
-  tryToLaunchLastOpenedBundle?: boolean;
+  launchModeExperimental?: 'most-recent' | 'launcher';
 };
 
 const schema: JSONSchemaType<PluginConfigType> = {
   type: 'object',
   properties: {
-    tryToLaunchLastOpenedBundle: { type: 'boolean', nullable: true },
+    launchModeExperimental: {
+      type: 'string',
+      enum: ['most-recent', 'launcher'],
+      nullable: true,
+    },
     android: {
       type: 'object',
       properties: {
-        tryToLaunchLastOpenedBundle: { type: 'boolean', nullable: true },
+        launchModeExperimental: {
+          type: 'string',
+          enum: ['most-recent', 'launcher'],
+          nullable: true,
+        },
       },
       nullable: true,
     },
     ios: {
       type: 'object',
       properties: {
-        tryToLaunchLastOpenedBundle: { type: 'boolean', nullable: true },
+        launchModeExperimental: {
+          type: 'string',
+          enum: ['most-recent', 'launcher'],
+          nullable: true,
+        },
       },
       nullable: true,
     },

packages/expo-dev-launcher/plugin/src/withDevLauncher.ts

@@ -13,14 +13,14 @@ export default createRunOncePlugin<PluginConfigType>(
   (config, props = {}) => {
     validateConfig(props);
 
-    if (props.ios?.tryToLaunchLastOpenedBundle ?? props.tryToLaunchLastOpenedBundle) {
+    if ((props.ios?.launchModeExperimental || props.launchModeExperimental) === 'most-recent') {
       config = withInfoPlist(config, (config) => {
         config.modResults['DEV_CLIENT_TRY_TO_LAUNCH_LAST_BUNDLE'] = true;
         return config;
       });
     }
 
-    if (props.android?.tryToLaunchLastOpenedBundle ?? props.tryToLaunchLastOpenedBundle) {
+    if ((props.android?.launchModeExperimental || props.launchModeExperimental) === 'most-recent') {
       config = withAndroidManifest(config, (config) => {
         const mainApplication = AndroidConfig.Manifest.getMainApplicationOrThrow(config.modResults);