Fix #3607: ExplorationPlayer End to End tests

app/src/main/java/org/oppia/android/app/utility/ClickableAreasImage.kt

@@ -116,6 +116,7 @@ class ClickableAreasImage(
         newView.isFocusable = true
         newView.isFocusableInTouchMode = true
         newView.tag = clickableArea.label
+        newView.contentDescription = clickableArea.label
         newView.setOnTouchListener { _, event ->
           if (event.action == MotionEvent.ACTION_DOWN) {
             showOrHideRegion(newView, clickableArea)

app/src/sharedTest/java/org/oppia/android/app/testing/ImageRegionSelectionInteractionViewTest.kt

@@ -6,8 +6,10 @@ import androidx.appcompat.app.AppCompatActivity
 import androidx.test.core.app.ActivityScenario.launch
 import androidx.test.core.app.ApplicationProvider
 import androidx.test.espresso.Espresso.onView
+import androidx.test.espresso.action.ViewActions.click
 import androidx.test.espresso.assertion.ViewAssertions.matches
 import androidx.test.espresso.matcher.ViewMatchers.isDisplayed
+import androidx.test.espresso.matcher.ViewMatchers.withContentDescription
 import androidx.test.espresso.matcher.ViewMatchers.withId
 import androidx.test.espresso.matcher.ViewMatchers.withTagValue
 import androidx.test.ext.junit.runners.AndroidJUnit4
@@ -135,6 +137,26 @@ class ImageRegionSelectionInteractionViewTest {
     }
   }
 
+  @Test
+  // TODO(#1611): Fix ImageRegionSelectionInteractionViewTest
+  @Ignore
+  fun testImageRegionSelectionInteractionView_clickDescRegion3_region3Clicked() {
+    launch(ImageRegionSelectionTestActivity::class.java).use {
+      it.onActivity {
+        it.findViewById<ImageRegionSelectionInteractionView>(R.id.clickable_image_view)
+          .setListener(onClickableAreaClickedListener)
+      }
+      onView(withContentDescription("Region 3")).perform(click())
+
+      verify(onClickableAreaClickedListener)
+        .onClickableAreaTouched(
+          capture(regionClickedEvent)
+        )
+      assertThat(regionClickedEvent.value)
+        .isEqualTo(NamedRegionClickedEvent(regionLabel = "Region 3"))
+    }
+  }
+
   @Test
   // TODO(#1611): Fix ImageRegionSelectionInteractionViewTest
   @Ignore

instrumentation/src/java/org/oppia/android/instrumentation/testing/EndToEndTestHelper.kt

@@ -49,6 +49,11 @@ object EndToEndTestHelper {
     wait(Until.hasObject(By.text(text)), TRANSITION_TIMEOUT_SECONDS)
   }
 
+  /** Waits for the view with given content description to appear. */
+  fun UiDevice.waitForDesc(text: String) {
+    wait(Until.hasObject(By.desc(text)), TRANSITION_TIMEOUT_SECONDS)
+  }
+
   /** Return the UiObject with the given text. */
   fun UiDevice.findObjectByText(text: String): UiObject2? {
     waitForText(text)
@@ -61,6 +66,17 @@ object EndToEndTestHelper {
     return findObject(By.res("$OPPIA_PACKAGE:id/$resourceId"))
   }
 
+  /** Returns the UiObject for the given resourceId. */
+  fun UiObject2.findObjectByRes(resourceId: String): UiObject2? {
+    return findObject(By.res("$OPPIA_PACKAGE:id/$resourceId"))
+  }
+
+  /** Returns the UiObject for the given content description. */
+  fun UiDevice.findObjectByDesc(text: String): UiObject2? {
+    waitForDesc(text)
+    return findObject(By.desc(text))
+  }
+
   /** Performs a scroll until the view with the give text is visible. */
   fun scrollRecyclerViewTextIntoView(text: String, isVertical: Boolean = true) {
     val recyclerView = UiScrollable(UiSelector().scrollable(true))

instrumentation/src/javatests/org/oppia/android/instrumentation/player/ExplorationPlayerTest.kt

@@ -4,7 +4,9 @@ import androidx.test.platform.app.InstrumentationRegistry
 import androidx.test.uiautomator.UiDevice
 import com.google.common.truth.Truth.assertThat
 import org.junit.Before
+import org.junit.Ignore
 import org.junit.Test
+import org.oppia.android.instrumentation.testing.EndToEndTestHelper.findObjectByDesc
 import org.oppia.android.instrumentation.testing.EndToEndTestHelper.findObjectByRes
 import org.oppia.android.instrumentation.testing.EndToEndTestHelper.findObjectByText
 import org.oppia.android.instrumentation.testing.EndToEndTestHelper.scrollRecyclerViewTextIntoView
@@ -23,22 +25,161 @@ class ExplorationPlayerTest {
   }
 
   @Test
-  fun testExploration_prototypeExploration_toolbarTitle_isDisplayedSuccessfully() {
+  fun testPlayExploration_prototypeExploration_playedFullyThrough_finishesSuccessfully() {
     navigateToPrototypeExploration()
-    assertThat(device.findObjectByRes("exploration_toolbar_title")).isNotNull()
+
+    // Play through all interactions.
+    playContinueInteraction()
+    playFractionInputInteraction()
+    playMultipleChoiceIntearction1()
+    playMultipleChoiceIntearction2()
+    playItemSelectionInteraction()
+    playNumericInputInteraction()
+    playRatioInputInteraction()
+    playTextInputInteraction()
+    playDragAndDropInteraction()
+    playDragDropMergeInteraction()
+    playEndExplorationInteraction()
+
+    // Assert Topic Completed.
+    scrollRecyclerViewTextIntoView("Chapter 1: Prototype Exploration")
+    val chapterCompletedTick = device.findObjectByText(
+      "Chapter 1: Prototype Exploration"
+    )!!.parent.findObjectByRes("chapter_completed_tick")
+    assertThat(chapterCompletedTick).isNotNull()
+  }
+
+  // TODO(#3697): Update e2e tests when backend support is introduced.
+  @Test
+  @Ignore("Need backend connection support to test the ImageRegionSelectionInteraction")
+  fun testPlayExploration_imageRegionInteractionExp_playedFullyThrough_finishesSuccessfully() {
+    navigateToImageRegionSelectionInteraction()
+
+    // Image Region Selection Interaction.
+    val imageSelectionView = device.findObjectByRes("interaction_container_frame_layout")
+    device.waitForRes("image_click_interaction_image_view")
+    device.findObjectByDesc("Saturn")!!.click()
+    device.findObjectByText("SUBMIT")!!.click()
+    device.findObjectByText("CONTINUE")!!.click()
+
+    // End Exploration.
+    playEndExplorationInteraction()
+
+    // Assert Topic Completed.
+    scrollRecyclerViewTextIntoView("Chapter 2: Image Region Selection Exploration")
+    val chapterCompletedTick = device.findObjectByText(
+      "Chapter 2: Image Region Selection Exploration"
+    )!!.parent.findObjectByRes("chapter_completed_tick")
+    assertThat(chapterCompletedTick).isNotNull()
   }
 
   /** Navigates and opens the Prototype Exploration using the admin profile. */
   private fun navigateToPrototypeExploration() {
-    device.findObjectByRes("skip_text_view")?.click()
-    device.findObjectByRes("get_started_button")?.click()
+    device.findObjectByRes("skip_text_view")!!.click()
+    device.findObjectByRes("get_started_button")!!.click()
+    device.waitForRes("profile_select_text")
+    device.findObjectByText("Admin")!!.click()
+    scrollRecyclerViewTextIntoView("First Test Topic")
+    device.findObjectByText("First Test Topic")!!.click()
+    device.findObjectByText("LESSONS")!!.click()
+    device.findObjectByText("First Story")!!.click()
+    scrollRecyclerViewTextIntoView("Chapter 1: Prototype Exploration")
+    device.findObjectByText("Chapter 1: Prototype Exploration")!!.click()
+  }
+
+  private fun completePrototypeExploration() {
+    playContinueInteraction()
+    playFractionInputInteraction()
+    playMultipleChoiceIntearction1()
+    playMultipleChoiceIntearction2()
+    playItemSelectionInteraction()
+    playNumericInputInteraction()
+    playRatioInputInteraction()
+    playTextInputInteraction()
+    playDragAndDropInteraction()
+    playDragDropMergeInteraction()
+    playEndExplorationInteraction()
+  }
+
+  private fun playContinueInteraction() {
+    device.findObjectByText("CONTINUE")!!.click()
+  }
+
+  private fun playFractionInputInteraction() {
+    device.findObjectByRes("fraction_input_interaction_view")!!.text = "1/2"
+    device.findObjectByText("SUBMIT")!!.click()
+    playContinueInteraction()
+  }
+
+  private fun playMultipleChoiceIntearction1() {
+    device.findObjectByText("Eagle")!!.click()
+    playContinueInteraction()
+  }
+
+  private fun playMultipleChoiceIntearction2() {
+    device.findObjectByText("Green")!!.click()
+    playContinueInteraction()
+  }
+
+  private fun playItemSelectionInteraction() {
+    device.findObjectByText("Red")!!.click()
+    device.findObjectByText("Green")!!.click()
+    device.findObjectByText("Blue")!!.click()
+    device.findObjectByText("SUBMIT")!!.click()
+    playContinueInteraction()
+  }
+
+  private fun playNumericInputInteraction() {
+    device.findObjectByRes("numeric_input_interaction_view")!!.text = "121"
+    device.findObjectByText("SUBMIT")!!.click()
+    playContinueInteraction()
+  }
+
+  private fun playRatioInputInteraction() {
+    device.findObjectByRes("ratio_input_interaction_view")!!.text = "4:5"
+    device.findObjectByText("SUBMIT")!!.click()
+    playContinueInteraction()
+  }
+
+  private fun playTextInputInteraction() {
+    device.findObjectByRes("text_input_interaction_view")!!.text = "Finnish"
+    device.findObjectByText("SUBMIT")!!.click()
+    playContinueInteraction()
+  }
+
+  private fun playDragAndDropInteraction() {
+    device.findObjectByDesc("Move item down to 2")!!.click()
+    device.findObjectByDesc("Move item down to 3")!!.click()
+    device.findObjectByDesc("Move item down to 4")!!.click()
+    device.findObjectByText("SUBMIT")!!.click()
+    playContinueInteraction()
+  }
+
+  private fun playDragDropMergeInteraction() {
+    device.findObjectByDesc("Link to item 2")!!.click()
+    device.findObjectByDesc("Move item down to 3")!!.click()
+    device.findObjectByText("SUBMIT")!!.click()
+    playContinueInteraction()
+  }
+
+  private fun playEndExplorationInteraction() {
+    device.findObjectByText("RETURN TO TOPIC")!!.click()
+  }
+
+  /** Navigates and opens the Image Region Selection Exploration using the admin profile. */
+  private fun navigateToImageRegionSelectionInteraction() {
+    device.findObjectByRes("skip_text_view")!!.click()
+    device.findObjectByRes("get_started_button")!!.click()
     device.waitForRes("profile_select_text")
-    device.findObjectByText("Admin")?.click()
+    device.findObjectByText("Admin")!!.click()
     scrollRecyclerViewTextIntoView("First Test Topic")
-    device.findObjectByText("First Test Topic")?.click()
-    device.findObjectByText("LESSONS")?.click()
-    device.findObjectByText("First Story")?.click()
+    device.findObjectByText("First Test Topic")!!.click()
+    device.findObjectByText("LESSONS")!!.click()
+    device.findObjectByText("First Story")!!.click()
     scrollRecyclerViewTextIntoView("Chapter 1: Prototype Exploration")
-    device.findObjectByText("Chapter 1: Prototype Exploration")?.click()
+    device.findObjectByText("Chapter 1: Prototype Exploration")!!.click()
+    completePrototypeExploration()
+    scrollRecyclerViewTextIntoView("Chapter 2: Image Region Selection Exploration")
+    device.findObjectByText("Chapter 2: Image Region Selection Exploration")!!.click()
   }
 }