mirror of
https://github.com/priyanshujain/sanderling.git
synced 2026-10-02 11:07:10 +00:00
* 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
99 lines
2.8 KiB
Makefile
99 lines
2.8 KiB
Makefile
SHELL := /bin/bash
|
|
|
|
ANDROID_HOME ?= /opt/homebrew/share/android-commandlinetools
|
|
GRADLE := ./gradlew
|
|
GO := go
|
|
BUF := buf
|
|
|
|
GO_PACKAGES := ./...
|
|
SIDECAR_JAR := sidecar/build/libs/sidecar-all.jar
|
|
SIDECAR_EMBED := internal/sidecar/assets/sidecar-all.jar
|
|
SDK_AAR := sdk/android/build/outputs/aar/sdk-android-release.aar
|
|
UATU_BIN := bin/uatu
|
|
|
|
DOCS_SRC := $(shell find docs -type f -name '*.md' -not -path 'docs/_*')
|
|
DOCS_OUT := $(patsubst docs/%.md,build/site/%.html,$(DOCS_SRC))
|
|
DOCS_TEMPLATE := docs/_template/page.html
|
|
|
|
.PHONY: bootstrap proto sidecar sdk-android sdk-android-publish uatu install test test-go test-kotlin test-spec-api docs clean release-cli release-android-local release-npm-dry
|
|
|
|
bootstrap:
|
|
$(GO) mod download
|
|
$(BUF) generate
|
|
cd pkg/spec-api && npm install --silent
|
|
|
|
proto:
|
|
$(BUF) lint
|
|
$(BUF) generate
|
|
|
|
sidecar:
|
|
ANDROID_HOME=$(ANDROID_HOME) $(GRADLE) :sidecar:shadowJar
|
|
|
|
sdk-android:
|
|
ANDROID_HOME=$(ANDROID_HOME) $(GRADLE) :sdk-android:assembleRelease
|
|
|
|
sdk-android-publish:
|
|
ANDROID_HOME=$(ANDROID_HOME) $(GRADLE) :sdk-android:publishToMavenLocal
|
|
|
|
uatu: $(UATU_BIN)
|
|
|
|
$(UATU_BIN): $(SIDECAR_JAR)
|
|
mkdir -p bin $(dir $(SIDECAR_EMBED))
|
|
cp $(SIDECAR_JAR) $(SIDECAR_EMBED)
|
|
$(GO) build -tags withsidecar -o $(UATU_BIN) ./cmd/uatu
|
|
|
|
# Installs `uatu` into $GOBIN (or $GOPATH/bin) so it's directly on PATH for
|
|
# anyone with a standard Go toolchain setup.
|
|
install: $(SIDECAR_JAR)
|
|
mkdir -p $(dir $(SIDECAR_EMBED))
|
|
cp $(SIDECAR_JAR) $(SIDECAR_EMBED)
|
|
$(GO) install -tags withsidecar ./cmd/uatu
|
|
@dest="$$($(GO) env GOBIN)"; [ -n "$$dest" ] || dest="$$($(GO) env GOPATH)/bin"; echo "installed uatu to $$dest"
|
|
|
|
$(SIDECAR_JAR):
|
|
$(MAKE) sidecar
|
|
|
|
test: test-go test-kotlin test-spec-api
|
|
|
|
test-go:
|
|
$(GO) test $(GO_PACKAGES)
|
|
|
|
test-kotlin:
|
|
ANDROID_HOME=$(ANDROID_HOME) $(GRADLE) :sidecar:test :sdk-android:testDebugUnitTest
|
|
|
|
test-spec-api:
|
|
cd pkg/spec-api && npm test --silent
|
|
|
|
docs: $(DOCS_OUT) build/site/_assets
|
|
@echo "built $(words $(DOCS_OUT)) pages to build/site"
|
|
|
|
build/site/_assets: docs/_assets
|
|
@mkdir -p build/site
|
|
@rm -rf $@
|
|
@cp -R $< $@
|
|
|
|
build/site/%.html: docs/%.md $(DOCS_TEMPLATE)
|
|
@mkdir -p $(dir $@)
|
|
@pandoc $< --from=gfm --to=html5 --standalone \
|
|
--highlight-style=tango --template=$(DOCS_TEMPLATE) -o $@
|
|
@rel=$$(echo $(patsubst build/site/%,%,$@) | awk -F/ '{for(i=1;i<NF;i++)printf "../"}'); \
|
|
sed -i.bak "s|__ROOT__|$$rel|g" $@ && rm $@.bak
|
|
|
|
clean:
|
|
$(GO) clean
|
|
rm -rf bin dist pkg/spec-api/dist build/site
|
|
$(GRADLE) clean
|
|
|
|
# Local release dry-runs. None of these touch remote registries.
|
|
|
|
release-cli:
|
|
$(MAKE) sidecar
|
|
goreleaser release --snapshot --clean
|
|
|
|
release-android-local:
|
|
@if [ -f .env.local ]; then set -a; . ./.env.local; set +a; fi; \
|
|
ANDROID_HOME=$(ANDROID_HOME) $(GRADLE) :sdk-android:publishToMavenLocal -Puatu.version=0.0.0-local
|
|
|
|
release-npm-dry:
|
|
cd pkg/spec-api && npm ci && npm run build && npm pack --dry-run
|