| name | add-ui-test |
| description | Create or update Android Compose instrumented UI tests for the CommonEx app. Use when asked to add or edit BasicInstrumentedTest flows, screen objects under android/app/src/androidTest, or Compose UI test helpers for end-to-end backend scenarios. |
Add UI Test
Overview
Write or modify Android Compose UI instrumented tests in android/app/src/androidTest using the existing screen-object and context-receiver pattern. Tests must be true backend end-to-end scenario flows; keep assertions focused and avoid duplicate checks.
Workflow
-
Confirm scenario and constraints.
Keep the test as end-to-end against the real backend and avoid mocks.
Prefer long, coherent user flows with assertions only at critical transitions.
Avoid hardcoded remote fixtures by creating required data within the test flow.
When the scenario depends on persisted timestamps or ordering, still create data through the real UI. If exact historical ordering is required, prefer a small @VisibleForTesting backdoor mutation-time seam at write time over DI/store seeding.
-
Reuse or extend screen objects.
Use or add classes in android/app/src/androidTest/kotlin/ru/commonex/screens/.
Keep methods context(rule: ComposeTestRule) and return the next screen to support chaining.
Prefer test tags for new selectors; if missing, add a tag in production Compose, otherwise use getString(Res.string...).
Use BaseScreen waits like waitForElementWithText and waitUntilNodeCount; avoid sleeps.
Use performScrollTo() for off-screen elements.
For horizontally scrollable rows nested inside another scrollable container, first bring the row itself on screen, then scroll inside that row with performScrollToNode(...) before clicking or asserting.
-
Add or update the test in BasicInstrumentedTest.
Stay on JUnit4 with AndroidJUnit4 for Marathon compatibility.
Use ComposeTestRule.runTest {} with the existing RuleChain and ConnectivityRule.
Factor repeated setup into helpers inside the test class, such as createLocalEvent.
For deeplinks, reuse waitForShareUrl and triggerActivityOnNewIntent patterns.
When replacing or merging an existing BasicInstrumentedTest case, preserve or update the leading KDoc step list so the scenario remains documented in the same style as neighboring tests.
-
Handle connectivity and offline paths.
Use @Offline to force offline tests and rely on ConnectivityRule.
If toggling network inside a test, wrap in try/finally and restore connectivity.
Conventions and Pitfalls
Prefer stable selectors in this order: test tags, resource strings, raw literals.
Keep long flows but avoid duplicated checks between steps or across tests.
If multiple chip/timeline interactions form one coherent user journey, prefer one instrumented scenario over split tests and keep each assertion tied to a visible transition in that flow.
Avoid TestScope or StandardTestDispatcher in instrumented Compose tests; keep the runTest wrapper.
Ensure clipboard or async actions are awaited before assertions.
For stateful chips, filters, and segmented controls, assert selected semantics in addition to destination content visibility only when the UI-level bug is about that selection state itself. If host/ViewModel tests already cover selection transitions and the instrumented scenario is about sticky positioning or navigation outcomes, prefer asserting the rendered destination instead of duplicating state-only checks in UI tests, unless the user explicitly asks to verify the selected UI state in that instrumented flow.
Key Files
android/app/src/androidTest/kotlin/ru/commonex/BasicInstrumentedTest.ktandroid/app/src/androidTest/kotlin/ru/commonex/testUtils.ktandroid/app/src/androidTest/kotlin/ru/commonex/ConnectivityRule.ktandroid/app/src/androidTest/kotlin/ru/commonex/screens/*.kt
