justfile

set shell := ["bash", "-eu", "-o", "pipefail", "-c"]

# detect platform
_os := os()
_arch := arch()
_is_macos := if _os == "macos" { "true" } else { "false" }
_is_linux := if _os == "linux" { "true" } else { "false" }

# environment variables with platform-aware defaults
export JAVA_HOME := env_var_or_default('JAVA_HOME', if _is_macos == "true" { "/opt/homebrew/opt/openjdk@21/" } else { "/usr/lib/jvm/java-21-openjdk-amd64" })
export ANDROID_SDK_ROOT := env_var_or_default('ANDROID_SDK_ROOT', if _is_macos == "true" { "/opt/homebrew/share/android-commandlinetools" } else { env_var_or_default('ANDROID_HOME', "/usr/local/lib/android/sdk") })
export ANDROID_NDK_HOME := env_var_or_default('ANDROID_NDK_HOME', ANDROID_SDK_ROOT + "/ndk/26.3.11579264")
# some tools expect these aliases
export ANDROID_NDK_ROOT := ANDROID_NDK_HOME
export ANDROID_NDK := ANDROID_NDK_HOME

# platform-specific PATH setup
_platform_tools := ANDROID_SDK_ROOT + "/platform-tools"
_emulator_tools := ANDROID_SDK_ROOT + "/emulator"
export PATH := _platform_tools + ":" + _emulator_tools + ":" + env_var('PATH')

# platform-specific NDK paths
_host_lib_ext := if _is_macos == "true" { "dylib" } else { "so" }
_host_lib_name := "libchroma_jni." + _host_lib_ext

# Full build: setup targets, build for host, test all
build: setup-targets build-for-host test

# Build optimized for host testing (macOS/Linux)
build-for-host: setup-targets _build-rust-host _build-android
    @echo "✅ Build for host complete - ready for local testing"

# Build for Android deployment only
build-for-android: setup-targets _build-rust-android _build-android
    @echo "✅ Build for Android complete - ready for device deployment"

# Build optimized for CI environment
build-for-ci: setup-targets _build-rust-ci _build-android
    @echo "✅ Build for CI complete"

# Install Rust Android targets
setup-targets:
    @echo "🔧 Setting up build targets..."
    rustup target add aarch64-linux-android
    @echo "✅ Build targets ready"

_build-rust-host:
    @echo "🖥️ Building Rust JNI library for host ({{_os}})..."
    mkdir -p src/test/resources/natives
    cd rust && cargo build --release
    cp rust/target/release/{{_host_lib_name}} src/test/resources/natives/libchroma_jni.{{_host_lib_ext}}
    @echo "  ✅ Host library built ({{_host_lib_name}})"

_build-rust-android:
    @echo "🤖 Building Rust JNI library for Android via Gradle plugin..."
    ./gradlew cargoBuild
    @echo "  ✅ Android library built"

_build-rust-ci: _build-rust-android
    @echo "🖥️ Building Rust JNI library for CI host..."
    mkdir -p src/test/resources/natives
    (cd rust && cargo build --release --lib)
    cp rust/target/release/{{_host_lib_name}} src/test/resources/natives/libchroma_jni.{{_host_lib_ext}}
    @echo "  ✅ CI host library built ({{_host_lib_name}} -> libchroma_jni.{{_host_lib_ext}})"

_build-android:
    @echo "📱 Building Android library..."
    ./gradlew build --build-cache --parallel
    @echo "✅ Android library built successfully"

# Run all tests (Rust + Android unit tests)
test: test-host test-android
    @echo "✅ All tests passed!"

# Run Rust tests on host platform
test-host:
    @echo "🦀 Running Rust tests on host..."
    (cd rust && cargo test --lib)
    @echo "✅ Host tests passed"

# Run Android unit tests with smart library loading
test-android:
    @echo "🧪 Running Android unit tests..."
    ./gradlew test --build-cache --parallel
    @echo "✅ Android unit tests passed"

# Clean all build artifacts
clean:
    (cd rust && cargo clean)
    ./gradlew clean
    @echo "🧹 All build artifacts cleaned"

# Format all code (Java + Rust)
format:
    @echo "✨ Formatting Java code..."
    ./gradlew spotlessApply
    @echo "✨ Formatting Rust code..."
    (cd rust && cargo fmt)
    @echo "✅ Code formatting complete"

# Check code formatting without applying changes
format-check:
    @echo "🔍 Checking Java code formatting..."
    ./gradlew spotlessCheck
    @echo "🔍 Checking Rust code formatting..."
    (cd rust && cargo fmt --check)
    @echo "✅ Code formatting check complete"

# Development workflow: clean, build, test
dev: clean build test

# Show built AAR and native library files
show-outputs:
    @echo "📦 Build outputs:"
    @ls -la build/outputs/aar/ 2>/dev/null || echo "No AAR files yet"
    @echo ""
    @echo "🔧 Native libraries:"
    @ls -la src/main/jniLibs/*/lib*.so 2>/dev/null || echo "No native libraries yet"

# Open Android unit test report in browser
open-test-report:
    open build/reports/tests/testDebugUnitTest/index.html

# Build hello-world example app
build-hello-world: build-for-android
    ./gradlew :examples:hello-world:assembleDebug
    @echo "✅ Hello World app built successfully"

# Install hello-world app on connected device
install-hello-world: build-hello-world
    adb install -r examples/hello-world/build/outputs/apk/debug/hello-world-debug.apk
    @echo "✅ Hello World app installed on device"

# Launch hello-world app on device
run-hello-world: install-hello-world
    adb shell am start -n com.trychroma.android.helloworld/.MainActivity
    @echo "🚀 Hello World app launched"

# Build Android release AAR
build-android-release:
    ./gradlew clean cargoBuildArm64 :assembleRelease --no-daemon --parallel
    @echo "✅ Android .aar built successfully"

# List available Android Virtual Devices
list-avds:
    @echo "📱 Available Android Virtual Devices:"
    avdmanager list avd

# Create new Android Virtual Device
create-avd:
    @echo "🔧 Creating Android emulator..."
    avdmanager create avd -n Pixel_3a_API_34_arm64 -k "system-images;android-34;google_apis;arm64-v8a" --device "pixel_3a"
    @echo "✅ AVD created"

# Start Android emulator and wait for boot
emulator-start:
    @echo "🤖 Starting Android emulator..."
    emulator -avd Pixel_3a_API_34_arm64 -no-snapshot-save &
    @echo "⏳ Waiting for emulator to boot..."
    adb wait-for-device
    @echo "✅ Emulator ready"

# Full demo: start emulator and run hello-world
demo: emulator-start run-hello-world

# View filtered Android logs (Chroma-related only)
adb-logs:
    @echo "📱 Viewing Android logs (Ctrl+C to stop)..."
    adb logcat | grep -E "(chroma|ChromaNative|com.trychroma.android.helloworld|AndroidRuntime)"

# View all Android logs
adb-logs-all:
    @echo "📱 Viewing all Android logs (Ctrl+C to stop)..."
    adb logcat

# Look for recent crash logs
adb-logs-crash:
    @echo "💥 Looking for recent crash logs..."
    adb logcat -d | grep -E "(FATAL|AndroidRuntime|chroma|ChromaNative)" | tail -50

# Clear Android log buffer
adb-logs-clear:
    @echo "🧹 Clearing Android log buffer..."
    adb logcat -c
    @echo "✅ Android logs cleared"