First commit for Espresso test

.github/workflows/bank-sdk.check.ui-tests.yml

@@ -0,0 +1,90 @@
+name: Check Bank SDK - UI Tests
+
+# TODO: Update triggers to execute only on workflow_call (from the release workflow) and via manual triggering
+#       (UI tests are slow and we should not run them on every push)
+on:
+  push:
+    paths:
+      - 'bank-sdk/**'
+      - 'capture-sdk/**'
+      - 'bank-api-library/**'
+      - 'core-api-library/**'
+      - 'gradle/**'
+    branches:
+      - '**'
+    tags-ignore:
+      - '**'
+  pull_request:
+    types: [opened, edited, reopened]
+    paths:
+      - 'bank-sdk/**'
+      - 'capture-sdk/**'
+      - 'bank-api-library/**'
+      - 'core-api-library/**'
+      - 'gradle/**'
+  workflow_call:
+    secrets:
+      GINI_MOBILE_TEST_CLIENT_SECRET:
+        required: true
+
+jobs:
+  ui-tests:
+    runs-on: ubuntu-latest
+    steps:
+      - name: checkout
+        uses: actions/checkout@v3
+
+      - name: setup java
+        uses: actions/setup-java@v3
+        with:
+          distribution: 'temurin'
+          java-version: '17'
+          cache: 'gradle'
+
+      - name: enable KVM group perms for emulator
+        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
+
+      - name: avd cache
+        uses: actions/cache@v4
+        id: avd-cache
+        with:
+          path: |
+            ~/.android/avd/*
+            ~/.android/adb*
+          key: avd-x86_64-34-${{ github.ref_name }}
+
+      - name: create avd and generate snapshot for caching
+        if: steps.avd-cache.outputs.cache-hit != 'true'
+        uses: reactivecircus/android-emulator-runner@v2
+        with:
+          api-level: 34
+          arch: x86_64
+          force-avd-creation: false
+          emulator-options: -no-window -gpu swiftshader_indirect -no-audio -no-boot-anim -camera-back emulated
+          disable-animations: true
+          script: echo "Generated AVD snapshot for caching."
+
+      - name: run example app instrumented tests
+        timeout-minutes: 20
+        uses: reactivecircus/android-emulator-runner@v2
+        with:
+          api-level: 34
+          arch: x86_64
+          force-avd-creation: false
+          emulator-options: -no-snapshot-save -no-window -gpu swiftshader_indirect -noaudio -no-boot-anim -camera-back emulated
+          disable-animations: true
+          script: >
+            adb uninstall net.gini.android.bank.sdk.exampleapp.test ;
+            ./gradlew bank-sdk:example-app:connectedDevExampleAppDebugAndroidTest
+            -PclientId="gini-mobile-test"
+            -PclientSecret="${{ secrets.GINI_MOBILE_TEST_CLIENT_SECRET }}"
+
+      - name: archive instrumented test results
+        if: always()
+        uses: actions/upload-artifact@v3
+        with:
+          name: bank-sdk-example-app-instrumented-test-results
+          path: bank-sdk/example-app/build/outputs/androidTest-results/connected

.github/workflows/bank-sdk.check.yml

@@ -126,21 +126,6 @@ jobs:
           name: bank-sdk-instrumented-test-results
           path: bank-sdk/sdk/build/outputs/androidTest-results/connected
 
-      - name: run example app instrumented tests
-        timeout-minutes: 20
-        uses: reactivecircus/android-emulator-runner@v2
-        with:
-          api-level: 33
-          arch: x86_64
-          force-avd-creation: false
-          emulator-options: -no-snapshot-save -no-window -gpu swiftshader_indirect -noaudio -no-boot-anim -camera-back none
-          disable-animations: true
-          script: >
-            adb uninstall net.gini.android.bank.sdk.exampleapp.test ;
-            ./gradlew bank-sdk:example-app:connectedDevExampleAppDebugAndroidTest
-            -PclientId="gini-mobile-test"
-            -PclientSecret="${{ secrets.GINI_MOBILE_TEST_CLIENT_SECRET }}"
-
       - name: archive instrumented test results
         if: always()
         uses: actions/upload-artifact@v3

.github/workflows/bank-sdk.release.yml

@@ -12,9 +12,14 @@ jobs:
     secrets:
       GINI_MOBILE_TEST_CLIENT_SECRET: ${{ secrets.GINI_MOBILE_TEST_CLIENT_SECRET }}
       BANK_SDK_EXAMPLE_APP_KEYSTORE_PASSWORD: ${{ secrets.BANK_SDK_EXAMPLE_APP_KEYSTORE_PASSWORD }}
+
+  check-ui-tests:
+    uses: ./.github/workflows/bank-sdk.check.ui-tests.yml
+    secrets:
+      GINI_MOBILE_TEST_CLIENT_SECRET: ${{ secrets.GINI_MOBILE_TEST_CLIENT_SECRET }}
 
   release:
-    needs: check
+    needs: [check, check-ui-tests]
     runs-on: ubuntu-latest
     steps:
       - name: checkout

bank-sdk/example-app/build.gradle.kts

@@ -72,6 +72,7 @@ android {
 
         // Use the test runner with JUnit4 support
         testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
+        testInstrumentationRunnerArguments["clearPackageData"] = "true"
 
         multiDexEnabled = true
     }
@@ -189,25 +190,28 @@ dependencies {
     implementation(libs.hilt.library)
     implementation(libs.navigation.fragment.ktx)
     implementation(libs.navigation.ui.ktx)
+    implementation(libs.androidx.test.junit.ktx)
     kapt(libs.hilt.compiler)
 
     implementation(libs.androidx.lifecycle.runtime.ktx)
     implementation(libs.androidx.test.espresso.idlingresource)
 
     testImplementation(libs.junit)
 
-    androidTestImplementation(libs.androidx.test.runner)
     androidTestImplementation(libs.truth)
-    androidTestImplementation(libs.androidx.test.rules)
     androidTestImplementation(libs.androidx.test.espresso.core)
     androidTestImplementation(libs.androidx.test.espresso.intents)
+    androidTestImplementation(libs.androidx.test.runner)
+    androidTestImplementation(libs.androidx.test.core)
+    androidTestImplementation(libs.androidx.test.junit)
+    androidTestImplementation(libs.androidx.test.rules)
     androidTestImplementation(libs.androidx.test.uiautomator)
     androidTestImplementation(libs.mockito.core)
     androidTestImplementation(libs.mockito.android)
     androidTestImplementation(libs.androidx.multidex)
-    androidTestImplementation(libs.androidx.test.junit)
 
     androidTestUtil(libs.androidx.test.orchestrator)
+
 }
 
 // this is needed because of Dagger-Hilt

bank-sdk/example-app/src/androidTest/java/net/gini/android/bank/sdk/exampleapp/ui/resources/ImageUploader.kt

@@ -0,0 +1,35 @@
+package net.gini.android.bank.sdk.exampleapp.ui.resources
+import androidx.test.platform.app.InstrumentationRegistry
+import androidx.test.uiautomator.UiDevice
+import androidx.test.uiautomator.UiSelector
+
+
+class ImageUploader {
+    private val device = UiDevice.getInstance(InstrumentationRegistry.getInstrumentation())
+    fun uploadImageFromPhotos() {
+       device.waitForIdle()
+        val selectPhoto = device.findObject(
+            UiSelector()
+                .className("android.widget.ImageView")
+                .resourceId("com.google.android.providers.media.module:id/icon_thumbnail")
+        )
+        if (selectPhoto != null) {
+            selectPhoto.click()
+        } else {
+            throw Exception("First photo not found")
+        }
+    }
+
+    fun clickAddButton() {
+        val addButton = device.findObject(
+            UiSelector()
+                .className("android.widget.Button")
+                .resourceId("com.google.android.providers.media.module:id/button_add")
+        )
+    if (addButton.exists()) {
+        addButton.click()
+    } else {
+        throw java.lang.Exception("Add button not found")
+    }
+    }
+}

bank-sdk/example-app/src/androidTest/java/net/gini/android/bank/sdk/exampleapp/ui/resources/PdfUploader.kt

@@ -0,0 +1,35 @@
+package net.gini.android.bank.sdk.exampleapp.ui.resources
+
+import androidx.test.platform.app.InstrumentationRegistry
+import androidx.test.uiautomator.UiDevice
+import androidx.test.uiautomator.UiSelector
+
+class PdfUploader {
+    private val device = UiDevice.getInstance(InstrumentationRegistry.getInstrumentation())
+    fun uploadPdfFromFiles() {
+        device.waitForIdle()
+        val tabTitle = device.findObject(UiSelector().className("android.widget.TextView").text("Recent"))
+        if (tabTitle.exists()) {
+            //Interact with hamburger menu
+            val hamburgerMenu = device.findObject(UiSelector().className("android.widget.ImageButton"))
+            hamburgerMenu.exists()
+            hamburgerMenu.click()
+
+            // Click the 'Downloads' option
+            val downloadsOption = device.findObject(UiSelector()
+                .className("android.widget.TextView")
+                .text("Downloads"))
+            downloadsOption.exists()
+            downloadsOption.click()
+
+            //Select desired pdf file
+            val selectPdfFile = device.findObject(UiSelector().text("sample.pdf"))
+            selectPdfFile.click()
+        }
+        else {
+            //Select desired pdf file
+            val selectPdfFile = device.findObject(UiSelector().text("sample.pdf"))
+            selectPdfFile.click()
+        }
+    }
+}

bank-sdk/example-app/src/androidTest/java/net/gini/android/bank/sdk/exampleapp/ui/resources/SimpleIdlingResource.kt

@@ -0,0 +1,36 @@
+package net.gini.android.bank.sdk.exampleapp.ui.resources
+import androidx.test.espresso.IdlingResource
+
+class SimpleIdlingResource(private val waitTime: Long) : IdlingResource {
+
+    @Volatile
+    private var isIdleNow = true
+    private var callback: IdlingResource.ResourceCallback? = null
+
+    override fun getName() = SimpleIdlingResource::class.java.name
+
+    override fun isIdleNow() = isIdleNow
+
+    override fun registerIdleTransitionCallback(callback: IdlingResource.ResourceCallback) {
+        this.callback = callback
+    }
+
+    fun setIdleState(isIdleNow: Boolean) {
+        this.isIdleNow = isIdleNow
+        if (isIdleNow && callback != null) {
+            callback!!.onTransitionToIdle()
+        }
+    }
+
+    fun waitForIdle() {
+        isIdleNow = false
+        Thread {
+            try {
+                Thread.sleep(waitTime)
+            } catch (e: InterruptedException) {
+                e.printStackTrace()
+            }
+            setIdleState(true)
+        }.start()
+    }
+}

bank-sdk/example-app/src/androidTest/java/net/gini/android/bank/sdk/exampleapp/ui/screens/CaptureScreen.kt

@@ -0,0 +1,85 @@
+package net.gini.android.bank.sdk.exampleapp.ui.screens
+
+import android.app.Activity
+import android.app.Instrumentation
+import android.content.Intent
+import android.net.Uri
+import androidx.test.espresso.Espresso.onView
+import androidx.test.espresso.action.ViewActions.click
+import androidx.test.espresso.matcher.ViewMatchers.withId
+import androidx.test.espresso.assertion.ViewAssertions.matches
+import androidx.test.espresso.intent.Intents.intending
+import androidx.test.espresso.intent.matcher.IntentMatchers.hasAction
+import androidx.test.espresso.intent.matcher.IntentMatchers.hasType
+import androidx.test.espresso.matcher.ViewMatchers
+import androidx.test.espresso.matcher.ViewMatchers.isDisplayed
+import androidx.test.espresso.matcher.ViewMatchers.withText
+import org.hamcrest.Matchers.allOf
+
+class CaptureScreen {
+    fun assertCameraTitle(): CaptureScreen {
+        onView(withId(net.gini.android.capture.R.id.gc_camera_title)).check(matches(withText(net.gini.android.capture.R.string.gc_camera_info_label_only_invoice)))
+        return this
+    }
+
+    fun clickCameraButton(): CaptureScreen {
+        onView(withId(net.gini.android.capture.R.id.gc_button_camera_trigger)).perform(click())
+        return this
+    }
+
+    fun clickHelpButton(): CaptureScreen {
+        onView(withId(net.gini.android.capture.R.id.gc_action_show_onboarding)).perform(click())
+        return this
+    }
+
+    fun clickCancelButton(): CaptureScreen {
+        onView(withId(net.gini.android.capture.R.id.gc_navigation_bar)).perform(click())
+        return this
+    }
+
+    fun assertFlashIconIsDisplayed(): CaptureScreen {
+        onView(withId(net.gini.android.capture.R.id.gc_camera_flash_button_subtitle)).check(
+            matches(
+                isDisplayed()
+            )
+        )
+        return this
+    }
+
+    fun assertFlashIconIsOn(): CaptureScreen {
+        onView(withId(net.gini.android.capture.R.id.gc_camera_flash_button_subtitle)).check(
+            matches(
+                withText(net.gini.android.capture.R.string.gc_camera_flash_on_subtitle)
+            )
+        )
+        return this
+    }
+
+    fun assertFlashIconIsOff(): CaptureScreen {
+        onView(withId(net.gini.android.capture.R.id.gc_camera_flash_button_subtitle)).check(
+            matches(
+                withText(net.gini.android.capture.R.string.gc_camera_flash_off_subtitle)
+            )
+        )
+        return this
+    }
+
+    fun clickFilesButton(): CaptureScreen {
+        onView(withId(net.gini.android.capture.R.id.gc_button_import_document)).perform(click())
+        return this
+    }
+
+    fun clickPhotos(): CaptureScreen {
+        onView(
+            allOf(withId(net.gini.android.capture.R.id.gc_app_label), withText("Photos")))
+             .perform(click())
+        return this
+    }
+
+    fun clickFiles(): CaptureScreen {
+        onView(
+            allOf(withId(net.gini.android.capture.R.id.gc_app_label), withText("Files")))
+            .perform(click())
+        return this
+    }
+}

bank-sdk/example-app/src/androidTest/java/net/gini/android/bank/sdk/exampleapp/ui/screens/ConfigurationScreen.kt

@@ -0,0 +1,30 @@
+package net.gini.android.bank.sdk.exampleapp.ui.screens
+
+import androidx.test.espresso.Espresso.onView
+import androidx.test.espresso.action.ViewActions.click
+import androidx.test.espresso.action.ViewActions.closeSoftKeyboard
+import androidx.test.espresso.action.ViewActions.scrollTo
+import androidx.test.espresso.assertion.ViewAssertions.matches
+import androidx.test.espresso.matcher.ViewMatchers
+import androidx.test.espresso.matcher.ViewMatchers.isDisplayed
+import androidx.test.espresso.matcher.ViewMatchers.withText
+import net.gini.android.bank.sdk.exampleapp.R
+
+class ConfigurationScreen {
+
+    fun scrollToAnalysisText(): ConfigurationScreen {
+        onView(withText("Analysis"))
+            .perform(scrollTo())
+        return this
+    }
+
+    fun clickFlashToggleToEnable(): ConfigurationScreen {
+        onView(ViewMatchers.withId(R.id.switch_flashOnByDefault)).perform(closeSoftKeyboard(), click())
+        return this
+    }
+
+    fun assertFlashToggleIsDisable(): ConfigurationScreen {
+        onView(ViewMatchers.withId(R.id.switch_flashOnByDefault)).check(matches(isDisplayed()))
+        return this
+    }
+}