| /* |
| * Copyright (C) 2021 The Android Open Source Project |
| * |
| * Licensed under the Apache License, Version 2.0 (the "License"); |
| * you may not use this file except in compliance with the License. |
| * You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| |
| package com.android.server.wm.flicker.launch |
| |
| import android.app.Instrumentation |
| import android.platform.test.annotations.Presubmit |
| import androidx.test.filters.RequiresDevice |
| import androidx.test.platform.app.InstrumentationRegistry |
| import com.android.server.wm.flicker.entireScreenCovered |
| import com.android.server.wm.flicker.FlickerBuilderProvider |
| import com.android.server.wm.flicker.FlickerParametersRunnerFactory |
| import com.android.server.wm.flicker.FlickerTestParameter |
| import com.android.server.wm.flicker.FlickerTestParameterFactory |
| import com.android.server.wm.flicker.LAUNCHER_COMPONENT |
| import com.android.server.wm.flicker.repetitions |
| import com.android.server.wm.flicker.annotation.Group4 |
| import com.android.server.wm.flicker.dsl.FlickerBuilder |
| import com.android.server.wm.flicker.helpers.TwoActivitiesAppHelper |
| import com.android.server.wm.flicker.testapp.ActivityOptions |
| import com.android.server.wm.traces.parser.toFlickerComponent |
| import org.junit.FixMethodOrder |
| import org.junit.Test |
| import org.junit.runner.RunWith |
| import org.junit.runners.MethodSorters |
| import org.junit.runners.Parameterized |
| |
| /** |
| * Test the back and forward transition between 2 activities. |
| * |
| * To run this test: `atest FlickerTests:ActivitiesTransitionTest` |
| * |
| * Actions: |
| * Launch an app |
| * Launch a secondary activity within the app |
| * Close the secondary activity back to the initial one |
| * |
| * Notes: |
| * 1. Part of the test setup occurs automatically via |
| * [com.android.server.wm.flicker.TransitionRunnerWithRules], |
| * including configuring navigation mode, initial orientation and ensuring no |
| * apps are running before setup |
| */ |
| @RequiresDevice |
| @RunWith(Parameterized::class) |
| @Parameterized.UseParametersRunnerFactory(FlickerParametersRunnerFactory::class) |
| @FixMethodOrder(MethodSorters.NAME_ASCENDING) |
| @Group4 |
| class ActivitiesTransitionTest(val testSpec: FlickerTestParameter) { |
| val instrumentation: Instrumentation = InstrumentationRegistry.getInstrumentation() |
| private val testApp: TwoActivitiesAppHelper = TwoActivitiesAppHelper(instrumentation) |
| |
| /** |
| * Entry point for the test runner. It will use this method to initialize and cache |
| * flicker executions |
| */ |
| @FlickerBuilderProvider |
| fun buildFlicker(): FlickerBuilder { |
| return FlickerBuilder(instrumentation).apply { |
| withTestName { testSpec.name } |
| repeat { testSpec.config.repetitions } |
| setup { |
| eachRun { |
| testApp.launchViaIntent(wmHelper) |
| wmHelper.waitForFullScreenApp(testApp.component) |
| } |
| } |
| teardown { |
| test { |
| testApp.exit() |
| } |
| } |
| transitions { |
| testApp.openSecondActivity(device, wmHelper) |
| device.pressBack() |
| wmHelper.waitForAppTransitionIdle() |
| wmHelper.waitForFullScreenApp(testApp.component) |
| } |
| } |
| } |
| |
| /** |
| * Checks that the [ActivityOptions.BUTTON_ACTIVITY_COMPONENT_NAME] activity is visible at |
| * the start of the transition, that |
| * [ActivityOptions.SIMPLE_ACTIVITY_AUTO_FOCUS_COMPONENT_NAME] becomes visible during the |
| * transition, and that [ActivityOptions.BUTTON_ACTIVITY_COMPONENT_NAME] is again visible |
| * at the end |
| */ |
| @Presubmit |
| @Test |
| fun finishSubActivity() { |
| val buttonActivityComponent = ActivityOptions |
| .BUTTON_ACTIVITY_COMPONENT_NAME.toFlickerComponent() |
| val imeAutoFocusActivityComponent = ActivityOptions |
| .SIMPLE_ACTIVITY_AUTO_FOCUS_COMPONENT_NAME.toFlickerComponent() |
| testSpec.assertWm { |
| this.isAppWindowOnTop(buttonActivityComponent) |
| .then() |
| .isAppWindowOnTop(imeAutoFocusActivityComponent) |
| .then() |
| .isAppWindowOnTop(buttonActivityComponent) |
| } |
| } |
| |
| /** |
| * Checks that all parts of the screen are covered during the transition |
| */ |
| @Presubmit |
| @Test |
| fun entireScreenCovered() = testSpec.entireScreenCovered() |
| |
| /** |
| * Checks that the [LAUNCHER_COMPONENT] window is not on top. The launcher cannot be |
| * asserted with `isAppWindowVisible` because it contains 2 windows with the exact same name, |
| * and both are never simultaneously visible |
| */ |
| @Presubmit |
| @Test |
| fun launcherWindowNotOnTop() { |
| testSpec.assertWm { |
| this.isAppWindowNotOnTop(LAUNCHER_COMPONENT) |
| } |
| } |
| |
| /** |
| * Checks that the [LAUNCHER_COMPONENT] layer is never visible during the transition |
| */ |
| @Presubmit |
| @Test |
| fun launcherLayerNotVisible() { |
| testSpec.assertLayers { this.isInvisible(LAUNCHER_COMPONENT) } |
| } |
| |
| companion object { |
| /** |
| * Creates the test configurations. |
| * |
| * See [FlickerTestParameterFactory.getConfigNonRotationTests] for configuring |
| * repetitions, screen orientation and navigation modes. |
| */ |
| @Parameterized.Parameters(name = "{0}") |
| @JvmStatic |
| fun getParams(): Collection<FlickerTestParameter> { |
| return FlickerTestParameterFactory.getInstance() |
| .getConfigNonRotationTests(repetitions = 5) |
| } |
| } |
| } |