mirror of
https://github.com/priyanshujain/sanderling.git
synced 2026-10-02 11:07:10 +00:00
pj
6b1c17328c
* fix(cli): fall back to node_modules for @uatu/spec resolution
Drop the hard failure when the uatu source tree is not reachable from
the spec file. Users integrating uatu in their own app have @uatu/spec
installed via npm; esbuild now resolves it from node_modules.
* build(gradle): drop :sample-app include from root settings
The sample now has its own Gradle project in examples/sample-app/android.
* build(sample-app): vendor gradle wrapper
Users running the sample build the APK via ./gradlew from inside the
sample-app's own android/ directory, no repo-root wrapper required.
* build(sample-app): make gradle project standalone
Drop the project(':sdk-android') dependency in favor of the Maven
Central coordinate io.github.priyanshujain:sdk-android. The sample now
owns its settings.gradle.kts and gradle.properties, so it builds
without any pieces of the uatu source tree.
* chore(sample-app): declare @uatu/spec npm dependency
Mirrors what a downstream user would put in their own package.json.
Uses file: for pre-release development; becomes a normal semver pin
once @uatu/spec ships to npm.
* docs(sample-app): rewrite justfile and add README
Justfile drops repo_root; all recipes run against the local gradle
wrapper and uatu from PATH. README is scoped to what a user needs to
run the sample against their own device.
* docs(manual): update sample install steps to standalone layout
./gradlew :sample-app:installDebug no longer exists; the sample owns
its own wrapper under android/.
* feat(sdk): log when Uatu.start succeeds
Silent SDK start makes the "SDK didn't connect" failure mode
impossible to debug. One INFO line at start time is enough.
* fix(sidecar): launch via am start -W instead of monkey
monkey -p <pkg> -c LAUNCHER 1 is unreliable on API 36+: it reports no
error but silently fails to start the activity, so the SDK never runs
and the CLI times out on the SDK-accept handshake.
Resolve the launcher activity via `cmd package resolve-activity
--brief` and launch it with `am start -W -n`. -W makes the call block
until the activity is up, which also makes the subsequent SDK
accept timing deterministic.
* feat(cli): auto-resolve Android device; boot AVD if none connected
--avd becomes optional. Resolution order:
- use any already-connected adb device;
- else if --avd names an existing AVD, boot it and wait for boot;
- else if --avd is missing or names no AVD, error with a clear message.
Falls back to $ANDROID_HOME/emulator/emulator when the binary is not on
PATH, so a standard Android SDK install works without extra shell setup.
* docs(sample-app): AVD is optional; document both paths
just test runs against any connected device. If none, pass AVD=<name>
to have uatu boot the emulator for you.
* feat(cli): auto-discover Android SDK; auto-pick the lone AVD
adb and emulator are looked up via PATH, then $ANDROID_HOME,
$ANDROID_SDK_ROOT, ~/Library/Android/sdk, ~/Android/Sdk, and the
Homebrew cask path. The discovered platform-tools directory is
prepended to the sidecar's PATH so its adb subprocess calls work too.
When --avd isn't passed and no device is connected, the CLI picks the
sole local AVD and boots it. Multiple AVDs → error listing them.
* build(make): add `make install` that go-installs uatu onto PATH
Puts `uatu` into $GOBIN (or $GOPATH/bin) so the sample and any local
dev flow can call it without PATH= prefixes.
* docs(sample-app): zero-config just test; dotenv-load for persistence
Drop the expectation that users prefix commands with PATH=, ANDROID_HOME=,
or AVD=. `just test` now works as-is; optional knobs can be pinned in a
.env file alongside the justfile.
* fix(sample-app): auto-detect ANDROID_HOME for Gradle tasks
The Go CLI finds the SDK itself, but AGP still needs ANDROID_HOME to
resolve `sdk.dir`. The justfile now resolves it from env or canonical
install paths before invoking ./gradlew, so `just install` works out
of the box on a standard Android SDK setup.
* gitignore runs directory for sample app
106 lines
3.1 KiB
Go
106 lines
3.1 KiB
Go
package main
|
|
|
|
import (
|
|
"context"
|
|
"errors"
|
|
"flag"
|
|
"fmt"
|
|
"io"
|
|
"os"
|
|
"time"
|
|
)
|
|
|
|
// Version is stamped at build time via goreleaser ldflags.
|
|
// Default "dev" marks untagged local builds.
|
|
var Version = "dev"
|
|
|
|
type testOptions struct {
|
|
spec string
|
|
bundleID string
|
|
launcherActivity string
|
|
platform string
|
|
avd string
|
|
duration time.Duration
|
|
seed int64
|
|
output string
|
|
}
|
|
|
|
const topUsage = `uatu is a property-based UI fuzzer for mobile apps.
|
|
|
|
Usage:
|
|
uatu <command> [flags]
|
|
|
|
Commands:
|
|
test Run a spec against an app for a fixed duration.
|
|
doctor Check that the host environment is ready to run uatu.
|
|
version Print the uatu version.
|
|
|
|
Run "uatu <command> -h" for command-specific flags.
|
|
`
|
|
|
|
func parseTestArgs(args []string, stderr io.Writer) (testOptions, error) {
|
|
flagSet := flag.NewFlagSet("test", flag.ContinueOnError)
|
|
flagSet.SetOutput(stderr)
|
|
var options testOptions
|
|
flagSet.StringVar(&options.spec, "spec", "", "path to the TypeScript spec (required)")
|
|
flagSet.StringVar(&options.bundleID, "bundle-id", "", "target app bundle ID (required)")
|
|
flagSet.StringVar(&options.launcherActivity, "launcher-activity", "", "optional <pkg>/<activity> to launch (overrides default resolution)")
|
|
flagSet.StringVar(&options.platform, "platform", "android", "target platform: android (ios deferred)")
|
|
flagSet.StringVar(&options.avd, "avd", "", "Android AVD name to boot if no device is connected")
|
|
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")
|
|
if err := flagSet.Parse(args); err != nil {
|
|
return testOptions{}, err
|
|
}
|
|
if options.spec == "" {
|
|
return testOptions{}, errors.New("--spec is required")
|
|
}
|
|
if options.bundleID == "" {
|
|
return testOptions{}, errors.New("--bundle-id is required")
|
|
}
|
|
if options.platform != "android" {
|
|
return testOptions{}, fmt.Errorf("unsupported platform: %q (only android in v0.1)", options.platform)
|
|
}
|
|
return options, nil
|
|
}
|
|
|
|
func runTest(options testOptions, stdout io.Writer) error {
|
|
ctx, cancel := context.WithCancel(context.Background())
|
|
defer cancel()
|
|
return runTestPipeline(ctx, options, stdout)
|
|
}
|
|
|
|
func runDoctor(stdout io.Writer) error {
|
|
return runDoctorChecks(context.Background(), defaultDoctorChecks(), stdout)
|
|
}
|
|
|
|
func run(args []string, stdout, stderr io.Writer) error {
|
|
if len(args) < 2 || args[1] == "-h" || args[1] == "--help" || args[1] == "help" {
|
|
fmt.Fprint(stdout, topUsage)
|
|
return nil
|
|
}
|
|
switch args[1] {
|
|
case "test":
|
|
options, err := parseTestArgs(args[2:], stderr)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
return runTest(options, stdout)
|
|
case "doctor":
|
|
return runDoctor(stdout)
|
|
case "version", "-v", "--version":
|
|
fmt.Fprintln(stdout, Version)
|
|
return nil
|
|
default:
|
|
return fmt.Errorf("unknown command: %q (try 'uatu help')", args[1])
|
|
}
|
|
}
|
|
|
|
func main() {
|
|
if err := run(os.Args, os.Stdout, os.Stderr); err != nil {
|
|
fmt.Fprintf(os.Stderr, "error: %v\n", err)
|
|
os.Exit(1)
|
|
}
|
|
}
|