set shell := ["bash", "-cu"] set dotenv-load := true sanderling := env_var_or_default("SANDERLING", "sanderling") avd := env_var_or_default("AVD", "") android_device := env_var_or_default("ANDROID_DEVICE", "") duration := env_var_or_default("DURATION", "1m") seed := env_var_or_default("SEED", "0") output := env_var_or_default("OUTPUT", justfile_directory() / "sanderling" / "runs") ios_device := env_var_or_default("IOS_DEVICE", "iPhone 17 Pro") ios_app := justfile_directory() / "app" / "iosApp" / "build" / "Build" / "Products" / "Debug-iphonesimulator" / "iosApp.app" ios_app_device := justfile_directory() / "app" / "iosApp" / "build" / "Build" / "Products" / "Debug-iphoneos" / "iosApp.app" default: @just --list # Resolve ANDROID_HOME from the env or a short list of canonical install # locations, so Gradle can find the Android SDK without the user having to # export anything. _android-home: #!/usr/bin/env bash set -euo pipefail if [[ -n "${ANDROID_HOME:-}" && -d "$ANDROID_HOME" ]]; then echo "$ANDROID_HOME"; exit 0 fi if [[ -n "${ANDROID_SDK_ROOT:-}" && -d "$ANDROID_SDK_ROOT" ]]; then echo "$ANDROID_SDK_ROOT"; exit 0 fi for candidate in \ "$HOME/Library/Android/sdk" \ "$HOME/Android/Sdk" \ "/opt/homebrew/share/android-commandlinetools" \ "/usr/local/share/android-commandlinetools"; do if [[ -d "$candidate" ]]; then echo "$candidate"; exit 0 fi done echo "could not locate Android SDK (set ANDROID_HOME)" >&2 exit 1 # Ensure an Android device is online. If none is connected and no AVD is # provided, boot the first AVD whose system image is actually installed # (headless) and wait for it to finish booting. _ensure-device: #!/usr/bin/env bash set -euo pipefail sdk="$(just _android-home)" adb="$sdk/platform-tools/adb" if "$adb" devices | awk 'NR>1 && $2=="device"{f=1} END{exit !f}'; then exit 0 fi if [[ -n "{{avd}}" ]]; then exit 0 # sanderling boots the named AVD itself fi emulator="$sdk/emulator/emulator" avd="" for candidate in $("$emulator" -list-avds); do # The AVD directory is named in .ini's path= field, which is not # always ".avd" (e.g. Medium_Phone_API_36.0 -> Medium_Phone.avd). avddir="$(sed -n 's/^path=//p' "$HOME/.android/avd/$candidate.ini" 2>/dev/null || true)" [[ -n "$avddir" ]] || avddir="$HOME/.android/avd/$candidate.avd" sysdir="$(sed -n 's/^image\.sysdir\.1=//p' "$avddir/config.ini" 2>/dev/null || true)" if [[ -n "$sysdir" && -d "$sdk/$sysdir" ]]; then avd="$candidate"; break; fi done if [[ -z "$avd" ]]; then echo "no bootable AVD found (no installed system image); create one or set AVD=" >&2 exit 1 fi echo "booting emulator: $avd" ANDROID_SDK_ROOT="$sdk" ANDROID_HOME="$sdk" nohup "$emulator" -avd "$avd" \ -no-window -no-snapshot -gpu swiftshader_indirect -no-audio >/tmp/folio-emulator.log 2>&1 & for _ in $(seq 1 150); do if [[ "$("$adb" shell getprop sys.boot_completed 2>/dev/null | tr -d '\r')" == "1" ]]; then echo "emulator ready"; exit 0 fi sleep 2 done echo "emulator did not finish booting in time (see /tmp/folio-emulator.log)" >&2 exit 1 # Run folio's own unit tests. Named test-unit because `test` is the fuzz run. test-unit: #!/usr/bin/env bash set -euo pipefail export ANDROID_HOME="$(just _android-home)" ./gradlew :core:testDebugUnitTest :app:shared:testDebugUnitTest # Build the folio debug APK without installing it. build: #!/usr/bin/env bash set -euo pipefail export ANDROID_HOME="$(just _android-home)" ./gradlew :app:androidApp:assembleDebug # Build and install the folio APK on a running emulator/device. install: _ensure-device #!/usr/bin/env bash set -euo pipefail export ANDROID_HOME="$(just _android-home)" # ANDROID_SERIAL routes the install to the chosen device when several attach. [[ -n "{{android_device}}" ]] && export ANDROID_SERIAL="{{android_device}}" ./gradlew :app:androidApp:installDebug # Remove the folio APK from the connected device. uninstall: #!/usr/bin/env bash set -euo pipefail export ANDROID_HOME="$(just _android-home)" ./gradlew :app:androidApp:uninstallDebug # Remove gradle + iOS build directories. clean: #!/usr/bin/env bash set -euo pipefail export ANDROID_HOME="$(just _android-home)" ./gradlew clean rm -rf app/iosApp/build # Regenerate iosApp.xcodeproj from project.yml. ios-gen: #!/usr/bin/env bash set -euo pipefail cd app/iosApp && xcodegen generate # Build + install + launch on a booted iOS simulator (boots IOS_DEVICE if none). ios: #!/usr/bin/env bash set -euo pipefail export ANDROID_HOME="$(just _android-home)" if ! xcrun simctl list devices booted | grep -q Booted; then xcrun simctl boot "{{ios_device}}" open -a Simulator sleep 3 fi just ios-gen xcodebuild -project app/iosApp/iosApp.xcodeproj -scheme iosApp \ -destination 'platform=iOS Simulator,name={{ios_device}}' \ -derivedDataPath app/iosApp/build \ build | tail -5 xcrun simctl install booted "{{ios_app}}" xcrun simctl launch booted app.folio # Build the folio app for a connected physical iOS device (signed via .env creds). # Signing reads ASC_API_* and DEVELOPMENT_TEAM/SANDERLING_IOS_TEAM from .env; # sanderling installs the build on the device per run via devicectl. ios-device: #!/usr/bin/env bash set -euo pipefail export ANDROID_HOME="$(just _android-home)" just ios-gen xcodebuild -project app/iosApp/iosApp.xcodeproj -scheme iosApp \ -destination 'generic/platform=iOS' \ -derivedDataPath app/iosApp/build \ -allowProvisioningUpdates \ -authenticationKeyPath "$ASC_API_KEY_PATH" \ -authenticationKeyID "$ASC_API_KEY_ID" \ -authenticationKeyIssuerID "$ASC_API_ISSUER_ID" \ CODE_SIGN_STYLE=Automatic \ DEVELOPMENT_TEAM="${SANDERLING_IOS_TEAM:-${DEVELOPMENT_TEAM:-}}" \ build | tail -5 # Run 'sanderling test' against the folio app. Uses a connected device if one is # online; otherwise boots AVD= when provided, or auto-boots a bootable AVD. # Depends on install so the run always fuzzes the current build, matching # test-ios which rebuilds and reinstalls the app first. test: install #!/usr/bin/env bash set -euo pipefail avd_flag=() if [[ -n "{{avd}}" ]]; then avd_flag=(--avd "{{avd}}") fi if [[ -n "{{android_device}}" ]]; then avd_flag+=(--device "{{android_device}}") fi apk="{{justfile_directory()}}/app/androidApp/build/outputs/apk/debug/androidApp-debug.apk" "{{sanderling}}" test \ --spec "{{justfile_directory()}}/sanderling/spec.ts" \ --bundle-id app.folio \ "${avd_flag[@]}" \ --android-app-path "$apk" \ --duration "{{duration}}" \ --seed "{{seed}}" \ --output "{{output}}" # Run 'sanderling test' with the LLM action generator instead of the seeded # fuzzer. Needs OPENROUTER_API_KEY (or OPENAI_API_KEY) in the environment; the # model is configured by generator = llm({...}) in spec.ts. test-llm: install #!/usr/bin/env bash set -euo pipefail avd_flag=() if [[ -n "{{avd}}" ]]; then avd_flag=(--avd "{{avd}}") fi if [[ -n "{{android_device}}" ]]; then avd_flag+=(--device "{{android_device}}") fi apk="{{justfile_directory()}}/app/androidApp/build/outputs/apk/debug/androidApp-debug.apk" "{{sanderling}}" test \ --spec "{{justfile_directory()}}/sanderling/spec.ts" \ --bundle-id app.folio \ --generator llm \ "${avd_flag[@]}" \ --android-app-path "$apk" \ --duration "{{duration}}" \ --seed "{{seed}}" \ --output "{{output}}" # Serve the wasmJs web app from a webpack dev server with COOP/COEP headers. web: #!/usr/bin/env bash set -euo pipefail export ANDROID_HOME="$(just _android-home)" ./gradlew :app:webApp:wasmJsBrowserDevelopmentRun --continuous # Produce a webpack distributable bundle for the web app. web-build: #!/usr/bin/env bash set -euo pipefail export ANDROID_HOME="$(just _android-home)" ./gradlew :app:webApp:wasmJsBrowserDevelopmentExecutableDistribution # Build + install + run sanderling spec on iOS simulator. test-ios: #!/usr/bin/env bash set -euo pipefail just ios ios_device_flag=() if [[ -n "{{ios_device}}" ]]; then ios_device_flag=(--ios-device "{{ios_device}}") fi "{{sanderling}}" test \ --platform ios \ --spec "{{justfile_directory()}}/sanderling/spec.ts" \ --bundle-id app.folio \ --ios-app-path "{{ios_app}}" \ "${ios_device_flag[@]}" \ --duration "{{duration}}" \ --seed "{{seed}}" \ --output "{{output}}" # Requires App Store Connect signing creds in .env and IOS_DEVICE set to the # connected device's name (or UDID / CoreDevice id). # Build + install + run sanderling spec on a connected physical iOS device. test-ios-device: #!/usr/bin/env bash set -euo pipefail just ios-device "{{sanderling}}" test \ --platform ios \ --spec "{{justfile_directory()}}/sanderling/spec.ts" \ --bundle-id app.folio \ --ios-app-path "{{ios_app_device}}" \ --ios-device "{{ios_device}}" \ --duration "{{duration}}" \ --seed "{{seed}}" \ --output "{{output}}"