| /* |
| * 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.wm.shell.transition; |
| |
| import static android.app.WindowConfiguration.ACTIVITY_TYPE_HOME; |
| import static android.app.WindowConfiguration.ACTIVITY_TYPE_STANDARD; |
| import static android.app.WindowConfiguration.WINDOWING_MODE_FULLSCREEN; |
| import static android.app.WindowConfiguration.WINDOWING_MODE_MULTI_WINDOW; |
| import static android.view.WindowManager.TRANSIT_CHANGE; |
| import static android.view.WindowManager.TRANSIT_CLOSE; |
| import static android.view.WindowManager.TRANSIT_OPEN; |
| import static android.view.WindowManager.TRANSIT_TO_BACK; |
| import static android.view.WindowManager.TRANSIT_TO_FRONT; |
| |
| import static com.android.dx.mockito.inline.extended.ExtendedMockito.doReturn; |
| |
| import static org.junit.Assert.assertEquals; |
| import static org.junit.Assert.assertFalse; |
| import static org.junit.Assert.assertTrue; |
| import static org.mockito.ArgumentMatchers.any; |
| import static org.mockito.ArgumentMatchers.anyInt; |
| import static org.mockito.ArgumentMatchers.eq; |
| import static org.mockito.ArgumentMatchers.isNull; |
| import static org.mockito.Mockito.doAnswer; |
| import static org.mockito.Mockito.mock; |
| import static org.mockito.Mockito.times; |
| import static org.mockito.Mockito.verify; |
| |
| import android.app.ActivityManager.RunningTaskInfo; |
| import android.os.Binder; |
| import android.os.IBinder; |
| import android.os.RemoteException; |
| import android.view.SurfaceControl; |
| import android.view.WindowManager; |
| import android.window.IRemoteTransition; |
| import android.window.IRemoteTransitionFinishedCallback; |
| import android.window.TransitionFilter; |
| import android.window.TransitionInfo; |
| import android.window.TransitionRequestInfo; |
| import android.window.WindowContainerTransaction; |
| import android.window.WindowOrganizer; |
| |
| import androidx.annotation.NonNull; |
| import androidx.annotation.Nullable; |
| import androidx.test.ext.junit.runners.AndroidJUnit4; |
| import androidx.test.filters.SmallTest; |
| |
| import com.android.wm.shell.TestShellExecutor; |
| import com.android.wm.shell.common.ShellExecutor; |
| import com.android.wm.shell.common.TransactionPool; |
| |
| import org.junit.Before; |
| import org.junit.Test; |
| import org.junit.runner.RunWith; |
| |
| import java.util.ArrayList; |
| |
| /** |
| * Tests for the shell transitions. |
| */ |
| @SmallTest |
| @RunWith(AndroidJUnit4.class) |
| public class ShellTransitionTests { |
| |
| private final WindowOrganizer mOrganizer = mock(WindowOrganizer.class); |
| private final TransactionPool mTransactionPool = mock(TransactionPool.class); |
| private final TestShellExecutor mMainExecutor = new TestShellExecutor(); |
| private final ShellExecutor mAnimExecutor = new TestShellExecutor(); |
| private final TestTransitionHandler mDefaultHandler = new TestTransitionHandler(); |
| |
| @Before |
| public void setUp() { |
| doAnswer(invocation -> invocation.getArguments()[1]) |
| .when(mOrganizer).startTransition(anyInt(), any(), any()); |
| } |
| |
| @Test |
| public void testBasicTransitionFlow() { |
| Transitions transitions = new Transitions(mOrganizer, mTransactionPool, mMainExecutor, |
| mAnimExecutor); |
| transitions.replaceDefaultHandlerForTest(mDefaultHandler); |
| |
| IBinder transitToken = new Binder(); |
| transitions.requestStartTransition(transitToken, |
| new TransitionRequestInfo(TRANSIT_OPEN, null /* trigger */, null /* remote */)); |
| verify(mOrganizer, times(1)).startTransition(eq(TRANSIT_OPEN), eq(transitToken), any()); |
| TransitionInfo info = new TransitionInfoBuilder(TRANSIT_OPEN) |
| .addChange(TRANSIT_OPEN).addChange(TRANSIT_CLOSE).build(); |
| transitions.onTransitionReady(transitToken, info, mock(SurfaceControl.Transaction.class)); |
| assertEquals(1, mDefaultHandler.activeCount()); |
| mDefaultHandler.finishAll(); |
| mMainExecutor.flushAll(); |
| verify(mOrganizer, times(1)).finishTransition(eq(transitToken), any(), any()); |
| } |
| |
| @Test |
| public void testNonDefaultHandler() { |
| Transitions transitions = new Transitions(mOrganizer, mTransactionPool, mMainExecutor, |
| mAnimExecutor); |
| transitions.replaceDefaultHandlerForTest(mDefaultHandler); |
| |
| final WindowContainerTransaction handlerWCT = new WindowContainerTransaction(); |
| // Make a test handler that only responds to multi-window triggers AND only animates |
| // Change transitions. |
| TestTransitionHandler testHandler = new TestTransitionHandler() { |
| @Override |
| public boolean startAnimation(@NonNull IBinder transition, @NonNull TransitionInfo info, |
| @NonNull SurfaceControl.Transaction t, |
| @NonNull Transitions.TransitionFinishCallback finishCallback) { |
| for (TransitionInfo.Change chg : info.getChanges()) { |
| if (chg.getMode() == TRANSIT_CHANGE) { |
| return super.startAnimation(transition, info, t, finishCallback); |
| } |
| } |
| return false; |
| } |
| |
| @Nullable |
| @Override |
| public WindowContainerTransaction handleRequest(@NonNull IBinder transition, |
| @NonNull TransitionRequestInfo request) { |
| final RunningTaskInfo task = request.getTriggerTask(); |
| return (task != null && task.getWindowingMode() == WINDOWING_MODE_MULTI_WINDOW) |
| ? handlerWCT : null; |
| } |
| }; |
| transitions.addHandler(testHandler); |
| |
| IBinder transitToken = new Binder(); |
| TransitionInfo open = new TransitionInfoBuilder(TRANSIT_OPEN) |
| .addChange(TRANSIT_OPEN).addChange(TRANSIT_CLOSE).build(); |
| |
| // Make a request that will be rejected by the testhandler. |
| transitions.requestStartTransition(transitToken, |
| new TransitionRequestInfo(TRANSIT_OPEN, null /* trigger */, null /* remote */)); |
| verify(mOrganizer, times(1)).startTransition(eq(TRANSIT_OPEN), eq(transitToken), isNull()); |
| transitions.onTransitionReady(transitToken, open, mock(SurfaceControl.Transaction.class)); |
| assertEquals(1, mDefaultHandler.activeCount()); |
| assertEquals(0, testHandler.activeCount()); |
| mDefaultHandler.finishAll(); |
| mMainExecutor.flushAll(); |
| |
| // Make a request that will be handled by testhandler but not animated by it. |
| RunningTaskInfo mwTaskInfo = |
| createTaskInfo(1, WINDOWING_MODE_MULTI_WINDOW, ACTIVITY_TYPE_STANDARD); |
| transitions.requestStartTransition(transitToken, |
| new TransitionRequestInfo(TRANSIT_OPEN, mwTaskInfo, null /* remote */)); |
| verify(mOrganizer, times(1)).startTransition( |
| eq(TRANSIT_OPEN), eq(transitToken), eq(handlerWCT)); |
| transitions.onTransitionReady(transitToken, open, mock(SurfaceControl.Transaction.class)); |
| assertEquals(1, mDefaultHandler.activeCount()); |
| assertEquals(0, testHandler.activeCount()); |
| mDefaultHandler.finishAll(); |
| mMainExecutor.flushAll(); |
| |
| // Make a request that will be handled AND animated by testhandler. |
| // Add an aggressive handler (doesn't handle but always animates) on top to make sure that |
| // the test handler gets first shot at animating since it claimed to handle it. |
| TestTransitionHandler topHandler = new TestTransitionHandler(); |
| transitions.addHandler(topHandler); |
| transitions.requestStartTransition(transitToken, |
| new TransitionRequestInfo(TRANSIT_CHANGE, mwTaskInfo, null /* remote */)); |
| verify(mOrganizer, times(1)).startTransition( |
| eq(TRANSIT_CHANGE), eq(transitToken), eq(handlerWCT)); |
| TransitionInfo change = new TransitionInfoBuilder(TRANSIT_CHANGE) |
| .addChange(TRANSIT_CHANGE).build(); |
| transitions.onTransitionReady(transitToken, change, mock(SurfaceControl.Transaction.class)); |
| assertEquals(0, mDefaultHandler.activeCount()); |
| assertEquals(1, testHandler.activeCount()); |
| assertEquals(0, topHandler.activeCount()); |
| testHandler.finishAll(); |
| mMainExecutor.flushAll(); |
| } |
| |
| @Test |
| public void testRequestRemoteTransition() { |
| Transitions transitions = new Transitions(mOrganizer, mTransactionPool, mMainExecutor, |
| mAnimExecutor); |
| transitions.replaceDefaultHandlerForTest(mDefaultHandler); |
| |
| final boolean[] remoteCalled = new boolean[]{false}; |
| final WindowContainerTransaction remoteFinishWCT = new WindowContainerTransaction(); |
| IRemoteTransition testRemote = new IRemoteTransition.Stub() { |
| @Override |
| public void startAnimation(TransitionInfo info, SurfaceControl.Transaction t, |
| IRemoteTransitionFinishedCallback finishCallback) throws RemoteException { |
| remoteCalled[0] = true; |
| finishCallback.onTransitionFinished(remoteFinishWCT); |
| } |
| }; |
| IBinder transitToken = new Binder(); |
| transitions.requestStartTransition(transitToken, |
| new TransitionRequestInfo(TRANSIT_OPEN, null /* trigger */, testRemote)); |
| verify(mOrganizer, times(1)).startTransition(eq(TRANSIT_OPEN), eq(transitToken), any()); |
| TransitionInfo info = new TransitionInfoBuilder(TRANSIT_OPEN) |
| .addChange(TRANSIT_OPEN).addChange(TRANSIT_CLOSE).build(); |
| transitions.onTransitionReady(transitToken, info, mock(SurfaceControl.Transaction.class)); |
| assertEquals(0, mDefaultHandler.activeCount()); |
| assertTrue(remoteCalled[0]); |
| mDefaultHandler.finishAll(); |
| mMainExecutor.flushAll(); |
| verify(mOrganizer, times(1)).finishTransition(eq(transitToken), eq(remoteFinishWCT), any()); |
| } |
| |
| @Test |
| public void testTransitionFilterActivityType() { |
| TransitionFilter filter = new TransitionFilter(); |
| filter.mRequirements = |
| new TransitionFilter.Requirement[]{new TransitionFilter.Requirement()}; |
| filter.mRequirements[0].mActivityType = ACTIVITY_TYPE_HOME; |
| filter.mRequirements[0].mModes = new int[]{TRANSIT_OPEN, TRANSIT_TO_FRONT}; |
| |
| final TransitionInfo openHome = new TransitionInfoBuilder(TRANSIT_OPEN) |
| .addChange(TRANSIT_OPEN, |
| createTaskInfo(1, WINDOWING_MODE_FULLSCREEN, ACTIVITY_TYPE_HOME)).build(); |
| assertTrue(filter.matches(openHome)); |
| |
| final TransitionInfo openStd = new TransitionInfoBuilder(TRANSIT_OPEN) |
| .addChange(TRANSIT_OPEN, createTaskInfo( |
| 1, WINDOWING_MODE_FULLSCREEN, ACTIVITY_TYPE_STANDARD)).build(); |
| assertFalse(filter.matches(openStd)); |
| } |
| |
| @Test |
| public void testTransitionFilterMultiRequirement() { |
| // filter that requires at-least one opening and one closing app |
| TransitionFilter filter = new TransitionFilter(); |
| filter.mRequirements = new TransitionFilter.Requirement[]{ |
| new TransitionFilter.Requirement(), new TransitionFilter.Requirement()}; |
| filter.mRequirements[0].mModes = new int[]{TRANSIT_OPEN, TRANSIT_TO_FRONT}; |
| filter.mRequirements[1].mModes = new int[]{TRANSIT_CLOSE, TRANSIT_TO_BACK}; |
| |
| final TransitionInfo openOnly = new TransitionInfoBuilder(TRANSIT_OPEN) |
| .addChange(TRANSIT_OPEN).build(); |
| assertFalse(filter.matches(openOnly)); |
| |
| final TransitionInfo openClose = new TransitionInfoBuilder(TRANSIT_OPEN) |
| .addChange(TRANSIT_OPEN).addChange(TRANSIT_CLOSE).build(); |
| assertTrue(filter.matches(openClose)); |
| } |
| |
| @Test |
| public void testRegisteredRemoteTransition() { |
| Transitions transitions = new Transitions(mOrganizer, mTransactionPool, mMainExecutor, |
| mAnimExecutor); |
| transitions.replaceDefaultHandlerForTest(mDefaultHandler); |
| |
| final boolean[] remoteCalled = new boolean[]{false}; |
| IRemoteTransition testRemote = new IRemoteTransition.Stub() { |
| @Override |
| public void startAnimation(TransitionInfo info, SurfaceControl.Transaction t, |
| IRemoteTransitionFinishedCallback finishCallback) throws RemoteException { |
| remoteCalled[0] = true; |
| finishCallback.onTransitionFinished(null /* wct */); |
| } |
| }; |
| |
| TransitionFilter filter = new TransitionFilter(); |
| filter.mRequirements = |
| new TransitionFilter.Requirement[]{new TransitionFilter.Requirement()}; |
| filter.mRequirements[0].mModes = new int[]{TRANSIT_OPEN, TRANSIT_TO_FRONT}; |
| |
| transitions.registerRemote(filter, testRemote); |
| mMainExecutor.flushAll(); |
| |
| IBinder transitToken = new Binder(); |
| transitions.requestStartTransition(transitToken, |
| new TransitionRequestInfo(TRANSIT_OPEN, null /* trigger */, null /* remote */)); |
| verify(mOrganizer, times(1)).startTransition(eq(TRANSIT_OPEN), eq(transitToken), any()); |
| TransitionInfo info = new TransitionInfoBuilder(TRANSIT_OPEN) |
| .addChange(TRANSIT_OPEN).addChange(TRANSIT_CLOSE).build(); |
| transitions.onTransitionReady(transitToken, info, mock(SurfaceControl.Transaction.class)); |
| assertEquals(0, mDefaultHandler.activeCount()); |
| assertTrue(remoteCalled[0]); |
| mDefaultHandler.finishAll(); |
| mMainExecutor.flushAll(); |
| verify(mOrganizer, times(1)).finishTransition(eq(transitToken), any(), any()); |
| } |
| |
| class TransitionInfoBuilder { |
| final TransitionInfo mInfo; |
| |
| TransitionInfoBuilder(@WindowManager.TransitionType int type) { |
| mInfo = new TransitionInfo(type, 0 /* flags */); |
| mInfo.setRootLeash(createMockSurface(true /* valid */), 0, 0); |
| } |
| |
| TransitionInfoBuilder addChange(@WindowManager.TransitionType int mode, |
| RunningTaskInfo taskInfo) { |
| final TransitionInfo.Change change = |
| new TransitionInfo.Change(null /* token */, null /* leash */); |
| change.setMode(mode); |
| change.setTaskInfo(taskInfo); |
| mInfo.addChange(change); |
| return this; |
| } |
| |
| TransitionInfoBuilder addChange(@WindowManager.TransitionType int mode) { |
| return addChange(mode, null /* taskInfo */); |
| } |
| |
| TransitionInfo build() { |
| return mInfo; |
| } |
| } |
| |
| class TestTransitionHandler implements Transitions.TransitionHandler { |
| final ArrayList<Transitions.TransitionFinishCallback> mFinishes = new ArrayList<>(); |
| |
| @Override |
| public boolean startAnimation(@NonNull IBinder transition, @NonNull TransitionInfo info, |
| @NonNull SurfaceControl.Transaction t, |
| @NonNull Transitions.TransitionFinishCallback finishCallback) { |
| mFinishes.add(finishCallback); |
| return true; |
| } |
| |
| @Nullable |
| @Override |
| public WindowContainerTransaction handleRequest(@NonNull IBinder transition, |
| @NonNull TransitionRequestInfo request) { |
| return null; |
| } |
| |
| void finishAll() { |
| for (int i = mFinishes.size() - 1; i >= 0; --i) { |
| mFinishes.get(i).onTransitionFinished(null /* wct */, null /* wctCB */); |
| } |
| mFinishes.clear(); |
| } |
| |
| int activeCount() { |
| return mFinishes.size(); |
| } |
| } |
| |
| private static SurfaceControl createMockSurface(boolean valid) { |
| SurfaceControl sc = mock(SurfaceControl.class); |
| doReturn(valid).when(sc).isValid(); |
| return sc; |
| } |
| |
| private static RunningTaskInfo createTaskInfo(int taskId, int windowingMode, int activityType) { |
| RunningTaskInfo taskInfo = new RunningTaskInfo(); |
| taskInfo.taskId = taskId; |
| taskInfo.configuration.windowConfiguration.setWindowingMode(windowingMode); |
| taskInfo.configuration.windowConfiguration.setActivityType(activityType); |
| return taskInfo; |
| } |
| |
| private static RunningTaskInfo createTaskInfo(int taskId) { |
| RunningTaskInfo taskInfo = new RunningTaskInfo(); |
| taskInfo.taskId = taskId; |
| return taskInfo; |
| } |
| |
| } |