Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit c967194c authored by Treehugger Robot's avatar Treehugger Robot Committed by Android (Google) Code Review
Browse files

Merge "Add 4 CUJs using explicit trace assertions." into main

parents d5dafaf5 bb779fcd

libs/WindowManager/Shell/tests/e2e/desktopmode/flicker-service/src/com/android/wm/shell/flicker/OpenAppFromAllAppsLandscapeExplicitTest.kt

0 → 100644
+149 −0
Original line number Diff line number Diff line 
/*

 * Copyright (C) 2025 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.wm.shell.flicker



import android.app.Instrumentation

import android.tools.Rotation

import android.tools.device.apphelpers.ClockAppHelper

import android.tools.flicker.FlickerConfig

import android.tools.flicker.FlickerService

import android.tools.traces.monitors.withTracing

import android.tools.traces.parsers.WindowManagerStateHelper

import androidx.test.platform.app.InstrumentationRegistry

import androidx.test.uiautomator.UiDevice

import com.android.launcher3.tapl.LauncherInstrumentation

import com.android.server.wm.flicker.helpers.DesktopModeAppHelper

import com.android.server.wm.flicker.helpers.SimpleAppHelper

import com.android.window.flags.Flags

import org.junit.Assume

import org.junit.AfterClass

import org.junit.BeforeClass

import org.junit.Test

import android.tools.flicker.rules.ChangeDisplayOrientationRule

import android.tools.flicker.subject.layers.LayersTraceSubject

import com.google.common.truth.Truth.assertThat

import com.android.wm.shell.Utils

import org.junit.Rule

import android.tools.NavBar

import android.tools.flicker.subject.layers.LayerTraceEntrySubject

import android.tools.flicker.subject.wm.WindowManagerTraceSubject

import android.tools.helpers.WindowUtils

import android.tools.io.Reader



// TODO(b/408170368): Refactor explicit tests if they prove to be reliable

class OpenAppFromAllAppsLandscapeExplicitTest {

    @Rule

    @JvmField

    val testSetupRule = Utils.testSetupRule(NavBar.MODE_GESTURAL, rotation)



    companion object {

        val rotation = Rotation.ROTATION_90



        val instrumentation: Instrumentation = InstrumentationRegistry.getInstrumentation()

        val wmHelper: WindowManagerStateHelper =

            WindowManagerStateHelper(instrumentation, clearCacheAfterParsing = false)

        val tapl: LauncherInstrumentation = LauncherInstrumentation()

        val device = UiDevice.getInstance(instrumentation)



        val clockApp = ClockAppHelper()

        val testApp = DesktopModeAppHelper(SimpleAppHelper(instrumentation))

        val config = FlickerConfig()

        val flickerService = FlickerService(config)

        lateinit var traceReader: Reader

        lateinit var finalState: LayerTraceEntrySubject



        @JvmStatic

        @BeforeClass

        fun setUp() {

            // Prerequisites

            Assume.assumeTrue(Flags.enableDesktopWindowingMode() && tapl.isTablet)

            tapl.setEnableRotation(true)

            tapl.setExpectedRotation(rotation.value)

            tapl.enableTransientTaskbar(false)

            ChangeDisplayOrientationRule.setRotation(rotation)

            tapl.showTaskbarIfHidden()



            // Start CUJ

            testApp.enterDesktopMode(wmHelper, device)

            wmHelper.StateSyncBuilder().withFreeformApp(testApp).waitForAndVerify()



            // Collect the trace we want to run assertions on

            traceReader = withTracing {

                // Launch Clock app from all apps menu

                tapl.launchedAppState.taskbar

                    .openAllApps()

                    .getAppIcon(clockApp.appName)

                    .launch(clockApp.packageName)



                wmHelper

                    .StateSyncBuilder()

                    .withFreeformApp(clockApp)

                    .waitForAndVerify()

            }



            val trace = traceReader.readLayersTrace() ?: error("Failed to read layers trace")

            val animationStates = LayersTraceSubject(trace, traceReader)

            finalState = animationStates.last()

        }



        @AfterClass

        @JvmStatic

        fun cleanUp() {

            clockApp.exit(wmHelper)

            testApp.exit(wmHelper)

        }

    }



    @Test

    fun assertScenarios() {

        val scenarios = flickerService.detectScenarios(traceReader)

        val assertions = scenarios.flatMap { it.generateAssertions() }

        assertions.forEach { it.execute() }

    }



    @Test

    fun assertClockIsVisibleAtEnd() {

        finalState.isVisible(clockApp)

    }



    @Test

    fun assertClockIsInsideDisplayBoundsAtEnd() {

        finalState.visibleRegion(clockApp)

            .coversAtMost(wmHelper.currentState.wmState.getDefaultDisplay()!!.displayRect)

    }



    @Test

    fun assertClockIsLaunchedWithCascading() {

        val displayAppBounds = WindowUtils.getInsetDisplayBounds(rotation)

        val windowBounds = finalState.visibleRegion(clockApp).region.bounds

        val onRightSide = windowBounds.right == displayAppBounds.right

        val onLeftSide = windowBounds.left == displayAppBounds.left

        val onTopSide = windowBounds.top == displayAppBounds.top

        val onBottomSide = windowBounds.bottom == displayAppBounds.bottom

        val alignedOnCorners = onRightSide.xor(onLeftSide) and onTopSide.xor(onBottomSide)



        assertThat(alignedOnCorners).isTrue()

    }



    @Test

    fun assertClockIsOnTopAtEnd() {

        val wmTrace = traceReader.readWmTrace() ?: error("Failed to get wm trace")

        val subject = WindowManagerTraceSubject(wmTrace)



        subject.isAppWindowOnTop(clockApp)

    }

}
 
 No newline at end of file

libs/WindowManager/Shell/tests/e2e/desktopmode/flicker-service/src/com/android/wm/shell/flicker/OpenAppFromAllAppsPortraitExplicitTest.kt

0 → 100644
+149 −0
Original line number Diff line number Diff line 
/*

 * Copyright (C) 2025 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.wm.shell.flicker



import android.app.Instrumentation

import android.tools.Rotation

import android.tools.device.apphelpers.ClockAppHelper

import android.tools.flicker.FlickerConfig

import android.tools.flicker.FlickerService

import android.tools.traces.monitors.withTracing

import android.tools.traces.parsers.WindowManagerStateHelper

import androidx.test.platform.app.InstrumentationRegistry

import androidx.test.uiautomator.UiDevice

import com.android.launcher3.tapl.LauncherInstrumentation

import com.android.server.wm.flicker.helpers.DesktopModeAppHelper

import com.android.server.wm.flicker.helpers.SimpleAppHelper

import com.android.window.flags.Flags

import org.junit.Assume

import org.junit.AfterClass

import org.junit.BeforeClass

import org.junit.Test

import android.tools.flicker.rules.ChangeDisplayOrientationRule

import android.tools.flicker.subject.layers.LayersTraceSubject

import com.google.common.truth.Truth.assertThat

import com.android.wm.shell.Utils

import org.junit.Rule

import android.tools.NavBar

import android.tools.flicker.subject.layers.LayerTraceEntrySubject

import android.tools.flicker.subject.wm.WindowManagerTraceSubject

import android.tools.helpers.WindowUtils

import android.tools.io.Reader



// TODO(b/408170368): Refactor explicit tests if they prove to be reliable

class OpenAppFromAllAppsPortraitExplicitTest {

    @Rule

    @JvmField

    val testSetupRule = Utils.testSetupRule(NavBar.MODE_GESTURAL, rotation)



    companion object {

        val rotation = Rotation.ROTATION_0



        val instrumentation: Instrumentation = InstrumentationRegistry.getInstrumentation()

        val wmHelper: WindowManagerStateHelper =

            WindowManagerStateHelper(instrumentation, clearCacheAfterParsing = false)

        val tapl: LauncherInstrumentation = LauncherInstrumentation()

        val device = UiDevice.getInstance(instrumentation)



        val clockApp = ClockAppHelper()

        val testApp = DesktopModeAppHelper(SimpleAppHelper(instrumentation))

        val config = FlickerConfig()

        val flickerService = FlickerService(config)

        lateinit var traceReader: Reader

        lateinit var finalState: LayerTraceEntrySubject



        @JvmStatic

        @BeforeClass

        fun setUp() {

            // Prerequisites

            Assume.assumeTrue(Flags.enableDesktopWindowingMode() && tapl.isTablet)

            tapl.setEnableRotation(true)

            tapl.setExpectedRotation(rotation.value)

            tapl.enableTransientTaskbar(false)

            ChangeDisplayOrientationRule.setRotation(rotation)

            tapl.showTaskbarIfHidden()



            // Start CUJ

            testApp.enterDesktopMode(wmHelper, device)

            wmHelper.StateSyncBuilder().withFreeformApp(testApp).waitForAndVerify()



            // Collect the trace we want to run assertions on

            traceReader = withTracing {

                // Launch Clock app from all apps menu

                tapl.launchedAppState.taskbar

                    .openAllApps()

                    .getAppIcon(clockApp.appName)

                    .launch(clockApp.packageName)



                wmHelper

                    .StateSyncBuilder()

                    .withFreeformApp(clockApp)

                    .waitForAndVerify()

            }



            val trace = traceReader.readLayersTrace() ?: error("Failed to read layers trace")

            val animationStates = LayersTraceSubject(trace, traceReader)

            finalState = animationStates.last()

        }



        @AfterClass

        @JvmStatic

        fun cleanUp() {

            clockApp.exit(wmHelper)

            testApp.exit(wmHelper)

        }

    }



    @Test

    fun assertScenarios() {

        val scenarios = flickerService.detectScenarios(traceReader)

        val assertions = scenarios.flatMap { it.generateAssertions() }

        assertions.forEach { it.execute() }

    }



    @Test

    fun assertClockIsVisibleAtEnd() {

        finalState.isVisible(clockApp)

    }



    @Test

    fun assertClockIsInsideDisplayBoundsAtEnd() {

        finalState.visibleRegion(clockApp)

            .coversAtMost(wmHelper.currentState.wmState.getDefaultDisplay()!!.displayRect)

    }



    @Test

    fun assertClockIsLaunchedWithCascading() {

        val displayAppBounds = WindowUtils.getInsetDisplayBounds(rotation)

        val windowBounds = finalState.visibleRegion(clockApp).region.bounds

        val onRightSide = windowBounds.right == displayAppBounds.right

        val onLeftSide = windowBounds.left == displayAppBounds.left

        val onTopSide = windowBounds.top == displayAppBounds.top

        val onBottomSide = windowBounds.bottom == displayAppBounds.bottom

        val alignedOnCorners = onRightSide.xor(onLeftSide) and onTopSide.xor(onBottomSide)



        assertThat(alignedOnCorners).isTrue()

    }



    @Test

    fun assertClockIsOnTopAtEnd() {

        val wmTrace = traceReader.readWmTrace() ?: error("Failed to get wm trace")

        val subject = WindowManagerTraceSubject(wmTrace)



        subject.isAppWindowOnTop(clockApp)

    }

}
 
 No newline at end of file

libs/WindowManager/Shell/tests/e2e/desktopmode/flicker-service/src/com/android/wm/shell/flicker/OpenAppFromTaskbarLandscapeExplicitTest.kt

0 → 100644
+148 −0
Original line number Diff line number Diff line 
/*

 * Copyright (C) 2025 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.wm.shell.flicker



import android.app.Instrumentation

import android.tools.Rotation

import android.tools.flicker.FlickerConfig

import android.tools.flicker.FlickerService

import android.tools.traces.monitors.withTracing

import android.tools.traces.parsers.WindowManagerStateHelper

import androidx.test.platform.app.InstrumentationRegistry

import androidx.test.uiautomator.UiDevice

import com.android.launcher3.tapl.LauncherInstrumentation

import com.android.server.wm.flicker.helpers.DesktopModeAppHelper

import com.android.server.wm.flicker.helpers.SimpleAppHelper

import com.android.window.flags.Flags

import org.junit.Assume

import org.junit.AfterClass

import org.junit.BeforeClass

import org.junit.Test

import android.tools.flicker.rules.ChangeDisplayOrientationRule

import android.tools.flicker.subject.layers.LayersTraceSubject

import com.google.common.truth.Truth.assertThat

import com.android.wm.shell.Utils

import org.junit.Rule

import android.tools.NavBar

import android.tools.device.apphelpers.BrowserAppHelper

import android.tools.flicker.subject.layers.LayerTraceEntrySubject

import android.tools.flicker.subject.wm.WindowManagerTraceSubject

import android.tools.helpers.WindowUtils

import android.tools.io.Reader



// TODO(b/408170368): Refactor explicit tests if they prove to be reliable

class OpenAppFromTaskbarLandscapeExplicitTest {

    @Rule

    @JvmField

    val testSetupRule = Utils.testSetupRule(NavBar.MODE_GESTURAL, rotation)



    companion object {

        val rotation = Rotation.ROTATION_90



        val instrumentation: Instrumentation = InstrumentationRegistry.getInstrumentation()

        val wmHelper: WindowManagerStateHelper =

            WindowManagerStateHelper(instrumentation, clearCacheAfterParsing = false)

        val tapl: LauncherInstrumentation = LauncherInstrumentation()

        val device = UiDevice.getInstance(instrumentation)



        val browserApp = BrowserAppHelper(instrumentation)

        val testApp = DesktopModeAppHelper(SimpleAppHelper(instrumentation))

        val config = FlickerConfig()

        val flickerService = FlickerService(config)

        lateinit var traceReader: Reader

        lateinit var finalState: LayerTraceEntrySubject



        @JvmStatic

        @BeforeClass

        fun setUp() {

            // Prerequisites

            Assume.assumeTrue(Flags.enableDesktopWindowingMode() && tapl.isTablet)

            tapl.setEnableRotation(true)

            tapl.setExpectedRotation(rotation.value)

            tapl.enableTransientTaskbar(false)

            ChangeDisplayOrientationRule.setRotation(rotation)

            tapl.showTaskbarIfHidden()



            // Start CUJ

            testApp.enterDesktopMode(wmHelper, device)

            wmHelper.StateSyncBuilder().withFreeformApp(testApp).waitForAndVerify()



            // Collect the trace we want to run assertions on

            traceReader = withTracing {

                // Launch browser app from taskbar

                tapl.launchedAppState.taskbar

                    .getAppIcon(browserApp.appName)

                    .launch(browserApp.packageName)



                wmHelper

                    .StateSyncBuilder()

                    .withFreeformApp(browserApp)

                    .waitForAndVerify()

            }



            val trace = traceReader.readLayersTrace() ?: error("Failed to read layers trace")

            val animationStates = LayersTraceSubject(trace, traceReader)

            finalState = animationStates.last()

        }



        @AfterClass

        @JvmStatic

        fun cleanUp() {

            browserApp.exit(wmHelper)

            testApp.exit(wmHelper)

        }

    }



    @Test

    fun assertScenarios() {

        val scenarios = flickerService.detectScenarios(traceReader)

        val assertions = scenarios.flatMap { it.generateAssertions() }

        assertions.forEach { it.execute() }

    }



    @Test

    fun assertBrowserIsVisibleAtEnd() {

        finalState.isVisible(browserApp)

    }



    @Test

    fun assertBrowserIsInsideDisplayBoundsAtEnd() {

        finalState.visibleRegion(browserApp)

            .coversAtMost(wmHelper.currentState.wmState.getDefaultDisplay()!!.displayRect)

    }



    @Test

    fun assertBrowserIsLaunchedWithCascading() {

        val displayAppBounds = WindowUtils.getInsetDisplayBounds(rotation)

        val windowBounds = finalState.visibleRegion(browserApp).region.bounds

        val onRightSide = windowBounds.right == displayAppBounds.right

        val onLeftSide = windowBounds.left == displayAppBounds.left

        val onTopSide = windowBounds.top == displayAppBounds.top

        val onBottomSide = windowBounds.bottom == displayAppBounds.bottom

        val alignedOnCorners = onRightSide.xor(onLeftSide) and onTopSide.xor(onBottomSide)



        assertThat(alignedOnCorners).isTrue()

    }



    @Test

    fun assertBrowserIsOnTopAtEnd() {

        val wmTrace = traceReader.readWmTrace() ?: error("Failed to get wm trace")

        val subject = WindowManagerTraceSubject(wmTrace)



        subject.isAppWindowOnTop(browserApp)

    }

}
 
 No newline at end of file

libs/WindowManager/Shell/tests/e2e/desktopmode/flicker-service/src/com/android/wm/shell/flicker/OpenAppFromTaskbarPortraitExplicitTest.kt

0 → 100644
+148 −0
Original line number Diff line number Diff line 
/*

 * Copyright (C) 2025 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.wm.shell.flicker



import android.app.Instrumentation

import android.tools.Rotation

import android.tools.flicker.FlickerConfig

import android.tools.flicker.FlickerService

import android.tools.traces.monitors.withTracing

import android.tools.traces.parsers.WindowManagerStateHelper

import androidx.test.platform.app.InstrumentationRegistry

import androidx.test.uiautomator.UiDevice

import com.android.launcher3.tapl.LauncherInstrumentation

import com.android.server.wm.flicker.helpers.DesktopModeAppHelper

import com.android.server.wm.flicker.helpers.SimpleAppHelper

import com.android.window.flags.Flags

import org.junit.Assume

import org.junit.AfterClass

import org.junit.BeforeClass

import org.junit.Test

import android.tools.flicker.rules.ChangeDisplayOrientationRule

import android.tools.flicker.subject.layers.LayersTraceSubject

import com.google.common.truth.Truth.assertThat

import com.android.wm.shell.Utils

import org.junit.Rule

import android.tools.NavBar

import android.tools.device.apphelpers.BrowserAppHelper

import android.tools.flicker.subject.layers.LayerTraceEntrySubject

import android.tools.flicker.subject.wm.WindowManagerTraceSubject

import android.tools.helpers.WindowUtils

import android.tools.io.Reader



// TODO(b/408170368): Refactor explicit tests if they prove to be reliable

class OpenAppFromTaskbarPortraitExplicitTest {

    @Rule

    @JvmField

    val testSetupRule = Utils.testSetupRule(NavBar.MODE_GESTURAL, rotation)



    companion object {

        val rotation = Rotation.ROTATION_0



        val instrumentation: Instrumentation = InstrumentationRegistry.getInstrumentation()

        val wmHelper: WindowManagerStateHelper =

            WindowManagerStateHelper(instrumentation, clearCacheAfterParsing = false)

        val tapl: LauncherInstrumentation = LauncherInstrumentation()

        val device = UiDevice.getInstance(instrumentation)



        val browserApp = BrowserAppHelper(instrumentation)

        val testApp = DesktopModeAppHelper(SimpleAppHelper(instrumentation))

        val config = FlickerConfig()

        val flickerService = FlickerService(config)

        lateinit var traceReader: Reader

        lateinit var finalState: LayerTraceEntrySubject



        @JvmStatic

        @BeforeClass

        fun setUp() {

            // Prerequisites

            Assume.assumeTrue(Flags.enableDesktopWindowingMode() && tapl.isTablet)

            tapl.setEnableRotation(true)

            tapl.setExpectedRotation(rotation.value)

            tapl.enableTransientTaskbar(false)

            ChangeDisplayOrientationRule.setRotation(rotation)

            tapl.showTaskbarIfHidden()



            // Start CUJ

            testApp.enterDesktopMode(wmHelper, device)

            wmHelper.StateSyncBuilder().withFreeformApp(testApp).waitForAndVerify()



            // Collect the trace we want to run assertions on

            traceReader = withTracing {

                // Launch browser app from taskbar

                tapl.launchedAppState.taskbar

                    .getAppIcon(browserApp.appName)

                    .launch(browserApp.packageName)



                wmHelper

                    .StateSyncBuilder()

                    .withFreeformApp(browserApp)

                    .waitForAndVerify()

            }



            val trace = traceReader.readLayersTrace() ?: error("Failed to read layers trace")

            val animationStates = LayersTraceSubject(trace, traceReader)

            finalState = animationStates.last()

        }



        @AfterClass

        @JvmStatic

        fun cleanUp() {

            browserApp.exit(wmHelper)

            testApp.exit(wmHelper)

        }

    }



    @Test

    fun assertScenarios() {

        val scenarios = flickerService.detectScenarios(traceReader)

        val assertions = scenarios.flatMap { it.generateAssertions() }

        assertions.forEach { it.execute() }

    }



    @Test

    fun assertBrowserIsVisibleAtEnd() {

        finalState.isVisible(browserApp)

    }



    @Test

    fun assertBrowserIsInsideDisplayBoundsAtEnd() {

        finalState.visibleRegion(browserApp)

            .coversAtMost(wmHelper.currentState.wmState.getDefaultDisplay()!!.displayRect)

    }



    @Test

    fun assertBrowserIsLaunchedWithCascading() {

        val displayAppBounds = WindowUtils.getInsetDisplayBounds(rotation)

        val windowBounds = finalState.visibleRegion(browserApp).region.bounds

        val onRightSide = windowBounds.right == displayAppBounds.right

        val onLeftSide = windowBounds.left == displayAppBounds.left

        val onTopSide = windowBounds.top == displayAppBounds.top

        val onBottomSide = windowBounds.bottom == displayAppBounds.bottom

        val alignedOnCorners = onRightSide.xor(onLeftSide) and onTopSide.xor(onBottomSide)



        assertThat(alignedOnCorners).isTrue()

    }



    @Test

    fun assertBrowserIsOnTopAtEnd() {

        val wmTrace = traceReader.readWmTrace() ?: error("Failed to get wm trace")

        val subject = WindowManagerTraceSubject(wmTrace)



        subject.isAppWindowOnTop(browserApp)

    }

}
 
 No newline at end of file