@blotch/angular-lynx-build 22.2.4 → 22.2.6

package/README.md

@@ -42,6 +42,7 @@ It is the only build dependency an AngularLynx app needs, as `@angular/build` is
 | `application`  | `ng build`                | Builds the Lynx bundle (and the web preview bundle) into `dist/` with [rspeedy](https://lynxjs.org/rspeedy/) |
 |                | `ng build --watch`        | Rebuilds the bundle whenever a file changes                                                                  |
 |                | `ng build --platform ios` | Then builds the iOS app (`--platform android` or `all` for the others) into `dist/<platform>/`               |
+|                | `... --run`               | Then installs the app on a simulator, emulator or phone and opens it (`--device` to choose one)              |
 | `dev-server`   | `ng serve`                | Runs rspeedy's dev server for Lynx Explorer and the web preview, and prints the QR code Lynx Explorer scans  |
 | `unit-test`    | `ng test`                 | Runs the unit tests with Angular's own unit-test builder (Vitest), set up for Lynx                           |
 | `extract-i18n` | `ng extract-i18n`         | Extracts the i18n messages with Angular's own extract-i18n builder, set up for Lynx                          |

package/builders/application/index.js

@@ -56,6 +56,11 @@ const runApplication = async function* (options, context, deps = defaultDeps) {
         };
         return;
     }
+    const runError = checkRunOptions(options, platforms);
+    if (runError) {
+        yield { success: false, error: runError };
+        return;
+    }
     let rspeedy;
     let native;
     let workDir = '';
@@ -112,6 +117,7 @@ const runApplication = async function* (options, context, deps = defaultDeps) {
                 bundleDir,
                 outputDir: node_path_1.default.join(bundleDir, platform),
                 app: options,
+                run: options.run ? { device: options.device } : undefined,
                 log: (message) => context.logger.info(message),
             });
             for (const artifact of artifacts) {
@@ -125,6 +131,22 @@ const runApplication = async function* (options, context, deps = defaultDeps) {
     }
 };
 exports.runApplication = runApplication;
+/**
+ * Checks that `--run` and `--device` come with what they need, so a mistake
+ * fails before a minute of building rather than after it.
+ */
+const checkRunOptions = (options, platforms) => {
+    if (options.device && !options.run) {
+        return '--device picks where --run opens the app. Add --run.';
+    }
+    if (options.run && platforms.length === 0) {
+        return '--run installs and opens the app that --platform builds. Add --platform ios or --platform android.';
+    }
+    if (options.device && platforms.length > 1) {
+        return '--device names one simulator, emulator or phone. Use it with --platform ios or --platform android, not all.';
+    }
+    return undefined;
+};
 /**
  * `ng build --watch`: rspeedy's watch build, reporting each compile's result.
  * Compile errors fail that result but keep watching, as in Angular, so the

package/builders/application/schema.json

@@ -11,6 +11,15 @@
       "enum": ["ios", "android", "all"],
       "description": "Also build native binaries into dist/<platform>/. Without it, only the bundle is built, as `rspeedy build` does."
     },
+    "run": {
+      "type": "boolean",
+      "default": false,
+      "description": "After --platform builds the app, install it on a simulator, emulator or phone and open it. iOS uses the running simulator, or else starts the newest iPhone simulator; Android uses the running emulator or connected phone, or else starts the first virtual device."
+    },
+    "device": {
+      "type": "string",
+      "description": "With --run, where to open the app: on iOS a simulator's name (e.g. \"iPhone 18 Pro\") or UDID, on Android a virtual device's name or an adb serial (e.g. emulator-5554)."
+    },
     "watch": {
       "type": "boolean",
       "default": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blotch/angular-lynx-build",
-  "version": "22.2.4",
+  "version": "22.2.6",
   "description": "Angular CLI builders for AngularLynx: ng build, ng serve and ng test for Lynx, and native iOS and Android apps",
   "homepage": "https://github.com/Blotch-Smart-Frames/AngularLynx#readme",
   "bugs": {
@@ -51,8 +51,8 @@
     "publish:local": "yalc publish --push"
   },
   "dependencies": {
-    "@blotch/angular-lynx-native": "22.2.4",
-    "@blotch/rsbuild-plugin-angular-lynx": "22.2.4",
+    "@blotch/angular-lynx-native": "22.2.6",
+    "@blotch/rsbuild-plugin-angular-lynx": "22.2.6",
     "@lynx-js/qrcode-rsbuild-plugin": "^0.7.3",
     "@lynx-js/rspeedy": "^0.18.0"
   },