feat(cli): add --android-app-path for clear-state reinstall

Wires the APK path from the test command through to the sidecar client so
Android clear-state can reset apps on OEM builds that deny pm clear.

cmd/sanderling/main.go

@@ -23,12 +23,13 @@ type testOptions struct {
 	platform   string
 	avd        string
 	device     string
-	iosDevice  string
-	iosAppPath string
-	duration   time.Duration
-	seed       int64
-	output     string
-	clearData  bool
+	iosDevice      string
+	iosAppPath     string
+	androidAppPath string
+	duration       time.Duration
+	seed           int64
+	output         string
+	clearData      bool
 }
 
 const topUsage = `sanderling is a property-based UI fuzzer for mobile apps.
@@ -56,6 +57,7 @@ func parseTestArgs(args []string, stderr io.Writer) (testOptions, error) {
 	flagSet.StringVar(&options.device, "device", "", "Android device serial (from `adb devices`) to target when several are connected")
 	flagSet.StringVar(&options.iosDevice, "ios-device", "", "iOS target: a simulator name/UDID to boot, or a connected device's name, UDID, or CoreDevice id")
 	flagSet.StringVar(&options.iosAppPath, "ios-app-path", "", "path to the .app bundle for iOS clear-state reinstall (simulator: simctl; device: devicectl)")
+	flagSet.StringVar(&options.androidAppPath, "android-app-path", "", "path to the .apk for Android clear-state reinstall; required to reset apps on OEM builds that deny `pm clear`")
 	flagSet.DurationVar(&options.duration, "duration", 5*time.Minute, "total test duration")
 	flagSet.Int64Var(&options.seed, "seed", 0, "RNG seed (0 = random)")
 	flagSet.StringVar(&options.output, "output", "./runs", "output directory for traces")

cmd/sanderling/test_run.go

@@ -9,16 +9,17 @@ import (
 
 func runTestPipeline(ctx context.Context, options testOptions, stdout io.Writer) error {
 	return testrun.Execute(ctx, testrun.Options{
-		Spec:       options.spec,
-		BundleID:   options.bundleID,
-		Platform:   options.platform,
-		AVD:        options.avd,
-		Device:     options.device,
-		IosDevice:  options.iosDevice,
-		IosAppPath: options.iosAppPath,
-		Duration:   options.duration,
-		Seed:       options.seed,
-		Output:     options.output,
-		ClearData:  options.clearData,
+		Spec:           options.spec,
+		BundleID:       options.bundleID,
+		Platform:       options.platform,
+		AVD:            options.avd,
+		Device:         options.device,
+		IosDevice:      options.iosDevice,
+		IosAppPath:     options.iosAppPath,
+		AndroidAppPath: options.androidAppPath,
+		Duration:       options.duration,
+		Seed:           options.seed,
+		Output:         options.output,
+		ClearData:      options.clearData,
 	}, stdout)
 }