OpenTelemetry-based Real User Monitoring SDK for Kotlin/Android (and, in progress, iOS), conforming to the Base14 Scout semantics.md contract. This is the monorepo for the Scout mobile SDK family: a shared Kotlin Multiplatform core (scout-core) plus thin per-platform bindings (scout-android today, scout-ios next), built on top of opentelemetry-kotlin with a custom OTLP/JSON exporter.

All CI checks run behind a single make target — this is exactly what the GitHub Actions workflow runs:

make ci          # fmt-check + lint + test + build (the full CI gate)
make fmt         # auto-format all Kotlin (Spotless + ktlint)
make test        # KMP core unit + semantics-conformance tests
make build       # assemble the library AAR + core jar
make help        # list all targets

Toolchain: JDK 17, Android SDK 35 + NDK 27.1.12297006 + CMake 3.22.1.

class MyApp : Application() {
    override fun onCreate() {
        super.onCreate()
        Scout.initialize(
            this,
            ScoutConfig(
                serviceName = "my-app",
                endpoint = "https://collector.example",  // /v1/traces is appended
                headers = mapOf("Authorization" to "Bearer …"),  // optional auth
            ),
        )
    }
}

That single call wires up transport, session management, resource attributes, and all auto-instrumentation. For HTTP, add the interceptor to your OkHttp client:

OkHttpClient.Builder().addInterceptor(ScoutOkHttpInterceptor()).build()

Optional API: Scout.setUser, clearUser, logEvent, addBreadcrumb, reportError.

./gradlew :scout-core:jvmTest                       # core unit + conformance tests
./gradlew :scout-android:connectedDebugAndroidTest  # on-device instrumented tests (needs emulator/device)
./gradlew :scout-android:assembleRelease            # produce the library AAR

Tests: scout-core commonTest covers the sampler, session manager, identity, breadcrumbs, the OTLP/JSON serializer (golden), and a semantics.md conformance harness (SemanticsConformanceTest) that freezes the scope, span names, error-class set, and every attribute/resource key against the spec. scout-android androidTest (ScoutInstrumentedTest) runs the real on-device pipeline against a local MockWebServer: device-resource conformance, init idempotency, session persistence, and an end-to-end emit asserting the exported OTLP/JSON payload is spec-conformant (scope base14.scout.android, common session/identity attrs, os.name=Android resource, CLIENT span kind for HTTP).

Build toolchain: JDK 17+, Android SDK 35 + NDK 27.1 + CMake 3.22.1, Kotlin 2.1.10, AGP 8.7.3, Gradle 8.11.1. Consumer compatibility: the published artifact targets minSdk 21+, AGP 8.0+, Gradle 7+, Kotlin 2.1+ (languageVersion = 2.0), so stock apps consume it without forcing a newer toolchain. Consume via mavenLocal() + implementation("io.base14:scout-android:<version>").

• Wire encoding is OTLP/JSON (the library only ships protobuf; we serialize JSON ourselves).
• Instrumentation scope is base14.scout.android (semantics.md §8).

• iOS — scout-ios bindings over the shared scout-core (in progress).
• Hybrid bridge — first-class Flutter/native session sharing (see examples/flutter-android-example).
• Symbolication pipeline — build-time mapping/symbol upload for obfuscated native stacks.