feat: Optional Jet Compose (#402)

## Summary

- Configure project so if customers didn't include Jet Compose library
then it wasn't activated
- Create flavor only XML Views test app

https://launchdarkly.atlassian.net/browse/O11Y-812
<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> **Medium Risk**
> Medium risk because it changes session-replay masking traversal and
Gradle dependency scoping to support apps without Compose; mistakes here
could break masking collection or cause runtime
`ClassNotFoundException`s in non-Compose apps.
> 
> **Overview**
> Makes Jetpack Compose support *optional* in the Android observability
SDK by switching Compose UI artifacts to `compileOnly`, splitting the
masking API so Compose-specific extensions live in a new
`ComposeMaskingAPI.kt`, and guarding Compose traversal in
`MaskCollector` behind a runtime classpath check.
> 
> Updates the Android E2E app to test both paths by adding
`compose`/`noCompose` product flavors, moving Compose
activities/launcher to a flavor manifest, and introducing a full
XML-based `MainActivity` + layout for the `noCompose` variant; CI is
adjusted to run the Compose-flavor unit tests.
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
b7d268c. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

Author: abelonogov-ld

.github/workflows/android-e2e.yml

@@ -40,7 +40,7 @@ jobs:
               uses: android-actions/setup-android@9fc6c4e9069bf8d3d10b2204b1fb8f6ef7065407 # v3.2.2 commit SHA - https://github.com/android-actions/setup-android/releases/tag/v3.2.2
 
             - name: Run unit tests
-              run: ./gradlew :app:testDebugUnitTest
+              run: ./gradlew :app:testComposeDebugUnitTest
 
             - name: Upload test reports
               if: always()

e2e/android/app/build.gradle.kts

@@ -52,6 +52,16 @@ android {
             )
         }
     }
+    flavorDimensions += "uiFramework"
+    productFlavors {
+        create("compose") {
+            dimension = "uiFramework"
+        }
+        create("noCompose") {
+            dimension = "uiFramework"
+            applicationIdSuffix = ".nocompose"
+        }
+    }
     compileOptions {
         sourceCompatibility = JavaVersion.VERSION_11
         targetCompatibility = JavaVersion.VERSION_11
@@ -103,29 +113,34 @@ dependencies {
     implementation("androidx.recyclerview:recyclerview:1.3.2")
     implementation(libs.androidx.core.ktx)
     implementation(libs.androidx.lifecycle.runtime.ktx)
-    implementation(libs.androidx.activity.compose)
+
+    // Compose runtime is needed by the Kotlin Compose compiler plugin (applied project-wide).
+    // It does NOT contain any UI classes like AbstractComposeView, so the SDK's
+    // isComposeAvailable runtime check still returns false in the noCompose variant.
     implementation(platform(libs.androidx.compose.bom))
-    implementation(libs.androidx.ui)
-    implementation(libs.androidx.ui.graphics)
-    implementation(libs.androidx.ui.tooling.preview)
-    implementation(libs.androidx.material3)
+    implementation("androidx.compose.runtime:runtime")
+
+    // Compose UI dependencies -- only for the compose flavor
+    "composeImplementation"(libs.androidx.activity.compose)
+    "composeImplementation"(libs.androidx.ui)
+    "composeImplementation"(libs.androidx.ui.graphics)
+    "composeImplementation"(libs.androidx.ui.tooling.preview)
+    "composeImplementation"(libs.androidx.material3)
+
+    // noCompose uses AppCompatActivity for proper Material Components theme resolution
+    "noComposeImplementation"("androidx.appcompat:appcompat:1.7.0")
 
     testImplementation(libs.junit)
-    testImplementation(libs.androidx.ui.test.junit4)
     testImplementation(libs.core.ktx)
     testImplementation(libs.robolectric)
     testImplementation("com.squareup.okhttp3:mockwebserver:4.12.0")
     testImplementation("io.opentelemetry:opentelemetry-sdk-testing:1.51.0")
+    testImplementation("org.jetbrains.kotlinx:kotlinx-coroutines-test:1.10.2")
     testImplementation(testFixtures(project(":observability-android")))
 
     // Used for testing webviews masking
     implementation("org.mozilla.geckoview:geckoview:130.0.20240913135723")
 
     androidTestImplementation(libs.androidx.junit)
     androidTestImplementation(libs.androidx.espresso.core)
-    androidTestImplementation(platform(libs.androidx.compose.bom))
-    androidTestImplementation(libs.androidx.ui.test.junit4)
-
-    debugImplementation(libs.androidx.ui.tooling)
-    debugImplementation(libs.androidx.ui.test.manifest)
 }

e2e/android/app/src/compose/AndroidManifest.xml

@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+
+    <application>
+        <activity
+            android:name=".masking.ComposeUserFormActivity"
+            android:exported="false"
+            android:label="@string/title_activity_secondary"
+            android:theme="@style/Theme.AndroidObservability" />
+        <activity
+            android:name=".masking.ComposeMaskingActivity"
+            android:exported="false"
+            android:label="Compose Masking"
+            android:theme="@style/Theme.AndroidObservability" />
+        <activity
+            android:name=".masking.ComposeWebActivity"
+            android:exported="false" />
+
+        <activity
+            android:name=".MainActivity"
+            android:exported="true"
+            android:theme="@style/Theme.AndroidObservability" >
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+        </activity>
+    </application>
+
+</manifest>

…ple/androidobservability/MainActivity.kt …ple/androidobservability/MainActivity.kte2e/android/app/src/main/java/com/example/androidobservability/MainActivity.kt renamed to e2e/android/app/src/compose/java/com/example/androidobservability/MainActivity.kt e2e/android/app/src/main/java/com/example/androidobservability/MainActivity.kt renamed to e2e/android/app/src/compose/java/com/example/androidobservability/MainActivity.kt

@@ -39,9 +39,14 @@ import androidx.compose.ui.unit.dp
 import androidx.compose.foundation.layout.PaddingValues
 import androidx.compose.foundation.layout.FlowRow
 import androidx.compose.foundation.layout.ExperimentalLayoutApi
+import androidx.compose.material3.ExperimentalMaterial3Api
 import androidx.compose.material3.HorizontalDivider
+import androidx.compose.material3.Icon
+import androidx.compose.material3.TopAppBar
+import androidx.compose.material3.TopAppBarDefaults
 import androidx.compose.ui.platform.LocalContext
 import androidx.compose.ui.graphics.Color
+import androidx.compose.ui.res.painterResource
 import com.example.androidobservability.masking.ComposeMaskingActivity
 import com.example.androidobservability.masking.ComposeUserFormActivity
 import com.example.androidobservability.masking.ComposeWebActivity
@@ -65,10 +70,33 @@ class MainActivity : ComponentActivity() {
         enableEdgeToEdge()
         setContent {
             AndroidObservabilityTheme {
+                @OptIn(ExperimentalMaterial3Api::class)
                 Scaffold(
                     modifier = Modifier
                         .fillMaxSize()
-                        .imePadding()
+                        .imePadding(),
+                    topBar = {
+                        TopAppBar(
+                            title = {
+                                Text(
+                                    "Android Observability",
+                                    modifier = Modifier.padding(start = 8.dp)
+                                )
+                            },
+                            navigationIcon = {
+                                Icon(
+                                    painter = painterResource(id = R.drawable.ic_launchdarkly_logo),
+                                    contentDescription = "LaunchDarkly",
+                                    modifier = Modifier.padding(start = 12.dp),
+                                    tint = Color.White
+                                )
+                            },
+                            colors = TopAppBarDefaults.topAppBarColors(
+                                containerColor = Color.Black,
+                                titleContentColor = Color.White
+                            )
+                        )
+                    }
                 ) { innerPadding ->
                     MainScreen(viewModel, innerPadding)
                 }