feat(cloud): add --render-engine for the emulator software renderer

Android-only, lavapipe or swiftshader, validated client-side. Omitted leaves
the choice to the server, which detects the Flutter engine in the binary and
picks swiftshader for it; the flag is the override for when that guess is
wrong or an app needs the other renderer.

Author: finalerock44

src/commands/cloud.ts

@@ -86,6 +86,7 @@ const DOWNLOAD_OPTIONS = ['ALL', 'FAILED'] as const;
 const REPORT_OPTIONS = ['allure', 'html', 'html-detailed', 'junit'] as const;
 const ORIENTATION_OPTIONS = ['0', '90'] as const;
 const RUNNER_TYPE_OPTIONS = ['default', 'm4', 'm1', 'gpu1', 'cpu1'] as const;
+const RENDER_ENGINE_OPTIONS = ['lavapipe', 'swiftshader'] as const;
 
 /**
  * Primary CLI command for executing tests on DeviceCloud.
@@ -257,6 +258,11 @@ export const cloudCommand = defineCommand({
           RUNNER_TYPE_OPTIONS,
           'runner-type',
         ) ?? 'default';
+      const renderEngine = validateEnum(
+        args['render-engine'] as string | undefined,
+        RENDER_ENGINE_OPTIONS,
+        'render-engine',
+      );
       const showCrosshairs = Boolean(args['show-crosshairs']);
       const maestroChromeOnboarding = Boolean(args['maestro-chrome-onboarding']);
       const disableAnimations = Boolean(args['disable-animations']);
@@ -838,6 +844,7 @@ export const cloudCommand = defineCommand({
         showCrosshairs,
         maestroChromeOnboarding,
         disableAnimations,
+        renderEngine,
       });
 
       // Device-matrix cost preview: the server prices the exact fan-out (quote

src/config/flags/device.flags.ts

@@ -24,6 +24,11 @@ export const deviceFlags = {
     type: 'string',
     description: `[Android only] Android device to run your flow against (options: ${androidDevices})`,
   },
+  'render-engine': {
+    type: 'string',
+    description:
+      '[Android only] Software renderer the emulator boots with (options: lavapipe, swiftshader). Defaults to lavapipe; pick swiftshader if your app fails to render or the device drops out mid-run. Apps shipping the Flutter engine are detected and switched automatically, so this is only needed to override that.',
+  },
   'device-locale': {
     type: 'string',
     description:

src/services/test-submission.service.ts

@@ -44,6 +44,12 @@ export interface TestSubmissionConfig {
   name?: string;
   orientation?: string;
   raw?: unknown;
+  /**
+   * Which emulator software renderer to boot with (Android only). Omitted
+   * means the server decides: lavapipe by default, or swiftshader when the
+   * binary is detected as shipping the Flutter engine.
+   */
+  renderEngine?: 'lavapipe' | 'swiftshader';
   report?: string;
   retry?: number;
   runnerType?: string;
@@ -93,6 +99,7 @@ export class TestSubmissionService {
       orientation,
       retry,
       continueOnFailure = true,
+      renderEngine,
       report,
       showCrosshairs,
       maestroChromeOnboarding,
@@ -281,6 +288,7 @@ export class TestSubmissionService {
       maestroVersion,
       orientation,
       raw: JSON.stringify(raw),
+      renderEngine,
       report,
       showCrosshairs,
       maestroChromeOnboarding,