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: [ 34 ]
+
+    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/src/androidTest/kotlin/com/ably/example/ColorVotingScreenTest.kt

@@ -0,0 +1,49 @@
+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.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()
+
+    // Get initial red count (should be 0 initially or some value)
+    composeTestRule.onNodeWithText("Red")
+
+    // Find and click the Vote button for Red color
+    // The Vote button should be near the Red text
+    // Use the first Vote button which corresponds to Red (first ColorVoteCard)
+    val redVoteButton = composeTestRule.onAllNodesWithText("Vote")[0]
+
+    composeTestRule.waitUntil(timeoutMillis = 10_000) {
+      SemanticsProperties.Disabled !in redVoteButton.fetchSemanticsNode().config
+    }
+
+    redVoteButton.performClick()
+
+    // Wait for the counter to update with 1 second timeout
+    composeTestRule.waitUntil(timeoutMillis = 1_000) {
+      composeTestRule.onAllNodesWithText("1").fetchSemanticsNodes().isNotEmpty()
+    }
+
+    composeTestRule.onNodeWithText("1").assertIsDisplayed()
+  }
+}

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()
+    }
+}