Skip to content

README.md

Latest commit

 

History

History
48 lines (32 loc) · 1.65 KB

README.md

File metadata and controls

48 lines (32 loc) · 1.65 KB
Raw

loop (Android Compose)

Runtime mode: Embedded - public Kotlin TraverseEmbedder (dev.traverse.embedder) with digest-pinned runtime/runtime.wasm. No traverse-cli serve sidecar is required.

Native Android client for the loop reference app.

Prerequisites

  • Android Studio Ladybug+ (or compatible AGP 8.7 / Kotlin 2.0)
  • Android emulator API 28+ (or physical device)
  • Traverse checkout with the Kotlin embedder package and certified runtime artifact:
export TRAVERSE_REPO=/path/to/Traverse
bash scripts/ci/sync_android_loop_bundle.sh

settings.gradle.kts composites $TRAVERSE_REPO/packages/kotlin/TraverseEmbedder as :traverse-embedder.

Bundle configuration

Assets live under app/src/main/assets/bundles/loop/ (including runtime/runtime.wasm + runtime-release.json after sync). The app copies them into filesDir on launch.

Settings -> Workspace only (no sidecar URL). Default workspace is local-default.

Build and test

export TRAVERSE_REPO=/path/to/Traverse
cd apps/loop/android-compose
./gradlew test
./gradlew :app:assembleDebug

Unit tests inject InMemoryTraverseEmbedder via InMemoryLoopHost; fixtures use only the runtime-owned LoopOutput fields.

Architecture

File Role
EmbeddedHost.kt Production + in-memory embedded hosts
ExecutionViewModel.kt Submit transcript -> render runtime-owned output
BundleAssets.kt Materialize asset bundle into filesDir
ui/MainScreen.kt Embedded runtime status, transcript input, output, trace

Design language

Follow docs/design-language.md. Zone 1 shows Embedded runtime mode.