feat: add UI tests and CI workflow for example app

Introduce Compose-based UI tests for MainScreen and ColorVotingScreen. Add GitHub Actions workflow to run tests on pull requests and pushes to `main`.

Author: ttypic

.github/workflows/example-app.yml

@@ -0,0 +1,42 @@
+name: Example App
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        android-api-level: [ 29 ]
+
+    steps:
+      - name: checkout
+        uses: actions/checkout@v4
+
+      - name: Set up the JDK
+        uses: actions/setup-java@v3
+        with:
+          java-version: '17'
+          distribution: 'temurin'
+
+      - name: Set up Gradle
+        uses: gradle/actions/setup-gradle@v3
+
+      - name: Enable KVM
+        run: |
+          echo 'KERNEL=="kvm", GROUP="kvm", MODE="0666", OPTIONS+="static_node=kvm"' | sudo tee /etc/udev/rules.d/99-kvm4all.rules
+          sudo udevadm control --reload-rules
+          sudo udevadm trigger --name-match=kvm
+
+      - uses: reactivecircus/android-emulator-runner@v2
+        with:
+          api-level: ${{ matrix.android-api-level }}
+          emulator-options: -no-snapshot-save -no-window -gpu swiftshader_indirect -noaudio -no-boot-anim -camera-back none
+          disable-animations: true
+          # Print emulator logs if tests fail
+          script: ./gradlew :examples:connectedAndroidTest || (adb logcat -d System.out:I && exit 1)

examples/build.gradle.kts

@@ -14,7 +14,7 @@ android {
 
     defaultConfig {
         applicationId = "com.ably.example"
-        minSdk = 30
+        minSdk = 29
         targetSdk = 35
         versionCode = 1
         versionName = "1.0"

examples/src/androidTest/kotlin/com/ably/example/ColorVotingScreenTest.kt

@@ -0,0 +1,51 @@
+package com.ably.example
+
+import androidx.compose.ui.semantics.SemanticsProperties
+import androidx.compose.ui.test.assertIsDisplayed
+import androidx.compose.ui.test.junit4.createAndroidComposeRule
+import androidx.compose.ui.test.onAllNodesWithText
+import androidx.compose.ui.test.onNodeWithTag
+import androidx.compose.ui.test.onNodeWithText
+import androidx.compose.ui.test.performClick
+import androidx.test.ext.junit.runners.AndroidJUnit4
+import org.junit.Rule
+import org.junit.Test
+import org.junit.runner.RunWith
+
+@RunWith(AndroidJUnit4::class)
+class ColorVotingScreenTest {
+
+  @get:Rule
+  val composeTestRule = createAndroidComposeRule<MainActivity>()
+
+  @Test
+  fun incrementRedColor() {
+    // Navigate to Color Voting tab
+    composeTestRule.onNodeWithText("Color Voting").performClick()
+
+    // Wait for the screen to load
+    composeTestRule.waitForIdle()
+
+    // Find and click the Vote button for Red color
+    val redVoteButton = composeTestRule.onNodeWithTag("vote_button_red")
+
+    // Capture initial count
+    val initial = composeTestRule.onNodeWithTag("counter_red")
+      .fetchSemanticsNode()
+      .config[SemanticsProperties.Text].first().text.toInt()
+
+    composeTestRule.waitUntil(timeoutMillis = 10_000) {
+      SemanticsProperties.Disabled !in redVoteButton.fetchSemanticsNode().config
+    }
+
+    redVoteButton.performClick()
+
+    // Wait for the counter to update with 5-seconds timeout
+    composeTestRule.waitUntil(timeoutMillis = 5_000) {
+      val updated = composeTestRule.onNodeWithTag("counter_red")
+          .fetchSemanticsNode()
+          .config[SemanticsProperties.Text].first().text.toInt()
+      updated == initial + 1
+    }
+  }
+}

examples/src/androidTest/kotlin/com/ably/example/MainScreenTest.kt

@@ -0,0 +1,23 @@
+package com.ably.example
+
+import androidx.compose.ui.test.assertIsDisplayed
+import androidx.compose.ui.test.junit4.createAndroidComposeRule
+import androidx.compose.ui.test.onNodeWithText
+import androidx.test.ext.junit.runners.AndroidJUnit4
+import org.junit.Rule
+import org.junit.Test
+import org.junit.runner.RunWith
+
+@RunWith(AndroidJUnit4::class)
+class MainScreenTest {
+
+    @get:Rule
+    val composeTestRule = createAndroidComposeRule<MainActivity>()
+
+    @Test
+    fun tabsAreDisplayed() {
+        // Verify both tabs are displayed
+        composeTestRule.onNodeWithText("Color Voting").assertIsDisplayed()
+        composeTestRule.onNodeWithText("Task Management").assertIsDisplayed()
+    }
+}

examples/src/main/kotlin/com/ably/example/screen/ColorVotingScreen.kt

@@ -8,6 +8,7 @@ import androidx.compose.runtime.*
 import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.graphics.Color
+import androidx.compose.ui.platform.testTag
 import androidx.compose.ui.text.font.FontWeight
 import androidx.compose.ui.text.style.TextAlign
 import androidx.compose.ui.unit.dp
@@ -146,11 +147,13 @@ fun ColorVoteCard(
         Text(
           text = count.toString(),
           fontSize = 24.sp,
-          fontWeight = FontWeight.Bold
+          fontWeight = FontWeight.Bold,
+          modifier = Modifier.testTag("counter_${colorName.lowercase()}")
         )
         OutlinedButton(
           onClick = onVote,
           enabled = enabled,
+          modifier = Modifier.testTag("vote_button_${colorName.lowercase()}")
         ) {
           Text(
             text = "Vote",