/* * Copyright (C) 2017 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.launcher3; import static com.android.launcher3.model.WidgetsModel.GO_DISABLE_WIDGETS; import static com.android.launcher3.util.SystemUiController.UI_STATE_FULLSCREEN_TASK; import static java.lang.annotation.RetentionPolicy.SOURCE; import android.app.Activity; import android.content.Context; import android.content.ContextWrapper; import android.content.Intent; import android.content.pm.LauncherApps; import android.content.res.Configuration; import android.graphics.Rect; import android.os.Bundle; import android.os.UserHandle; import android.util.Log; import androidx.annotation.IntDef; import com.android.launcher3.DeviceProfile.OnDeviceProfileChangeListener; import com.android.launcher3.logging.StatsLogManager; import com.android.launcher3.util.SystemUiController; import com.android.launcher3.util.ViewCache; import com.android.launcher3.views.ActivityContext; import com.android.launcher3.views.ScrimView; import java.io.PrintWriter; import java.lang.annotation.Retention; import java.util.ArrayList; /** * Launcher BaseActivity */ public abstract class BaseActivity extends Activity implements ActivityContext { private static final String TAG = "BaseActivity"; public static final int INVISIBLE_BY_STATE_HANDLER = 1 << 0; public static final int INVISIBLE_BY_APP_TRANSITIONS = 1 << 1; public static final int INVISIBLE_BY_PENDING_FLAGS = 1 << 2; // This is not treated as invisibility flag, but adds as a hint for an incomplete transition. // When the wallpaper animation runs, it replaces this flag with a proper invisibility // flag, INVISIBLE_BY_PENDING_FLAGS only for the duration of that animation. public static final int PENDING_INVISIBLE_BY_WALLPAPER_ANIMATION = 1 << 3; private static final int INVISIBLE_FLAGS = INVISIBLE_BY_STATE_HANDLER | INVISIBLE_BY_APP_TRANSITIONS | INVISIBLE_BY_PENDING_FLAGS; public static final int STATE_HANDLER_INVISIBILITY_FLAGS = INVISIBLE_BY_STATE_HANDLER | PENDING_INVISIBLE_BY_WALLPAPER_ANIMATION; public static final int INVISIBLE_ALL = INVISIBLE_FLAGS | PENDING_INVISIBLE_BY_WALLPAPER_ANIMATION; @Retention(SOURCE) @IntDef( flag = true, value = {INVISIBLE_BY_STATE_HANDLER, INVISIBLE_BY_APP_TRANSITIONS, INVISIBLE_BY_PENDING_FLAGS, PENDING_INVISIBLE_BY_WALLPAPER_ANIMATION}) public @interface InvisibilityFlags{} private final ArrayList mDPChangeListeners = new ArrayList<>(); private final ArrayList mMultiWindowModeChangedListeners = new ArrayList<>(); protected DeviceProfile mDeviceProfile; protected StatsLogManager mStatsLogManager; protected SystemUiController mSystemUiController; public static final int ACTIVITY_STATE_STARTED = 1 << 0; public static final int ACTIVITY_STATE_RESUMED = 1 << 1; /** * State flags indicating that the activity has received one frame after resume, and was * not immediately paused. */ public static final int ACTIVITY_STATE_DEFERRED_RESUMED = 1 << 2; public static final int ACTIVITY_STATE_WINDOW_FOCUSED = 1 << 3; /** * State flag indicating if the user is active or the activity when to background as a result * of user action. * @see #isUserActive() */ public static final int ACTIVITY_STATE_USER_ACTIVE = 1 << 4; /** * State flag indicating if the user will be active shortly. */ public static final int ACTIVITY_STATE_USER_WILL_BE_ACTIVE = 1 << 5; /** * State flag indicating that a state transition is in progress */ public static final int ACTIVITY_STATE_TRANSITION_ACTIVE = 1 << 6; @Retention(SOURCE) @IntDef( flag = true, value = {ACTIVITY_STATE_STARTED, ACTIVITY_STATE_RESUMED, ACTIVITY_STATE_DEFERRED_RESUMED, ACTIVITY_STATE_WINDOW_FOCUSED, ACTIVITY_STATE_USER_ACTIVE, ACTIVITY_STATE_TRANSITION_ACTIVE}) public @interface ActivityFlags{} @ActivityFlags private int mActivityFlags; // When the recents animation is running, the visibility of the Launcher is managed by the // animation @InvisibilityFlags private int mForceInvisible; private final ViewCache mViewCache = new ViewCache(); @Override public ViewCache getViewCache() { return mViewCache; } @Override public DeviceProfile getDeviceProfile() { return mDeviceProfile; } /** * Returns {@link StatsLogManager} for user event logging. */ public StatsLogManager getStatsLogManager() { if (mStatsLogManager == null) { mStatsLogManager = StatsLogManager.newInstance(this); } return mStatsLogManager; } public SystemUiController getSystemUiController() { if (mSystemUiController == null) { mSystemUiController = new SystemUiController(getWindow()); } return mSystemUiController; } public ScrimView getScrimView() { return null; } @Override public void onActivityResult(int requestCode, int resultCode, Intent data) { super.onActivityResult(requestCode, resultCode, data); } @Override protected void onStart() { addActivityFlags(ACTIVITY_STATE_STARTED); super.onStart(); } @Override protected void onResume() { addActivityFlags(ACTIVITY_STATE_RESUMED | ACTIVITY_STATE_USER_ACTIVE); removeActivityFlags(ACTIVITY_STATE_USER_WILL_BE_ACTIVE); super.onResume(); } @Override protected void onUserLeaveHint() { removeActivityFlags(ACTIVITY_STATE_USER_ACTIVE); super.onUserLeaveHint(); } @Override public void onMultiWindowModeChanged(boolean isInMultiWindowMode, Configuration newConfig) { super.onMultiWindowModeChanged(isInMultiWindowMode, newConfig); for (int i = mMultiWindowModeChangedListeners.size() - 1; i >= 0; i--) { mMultiWindowModeChangedListeners.get(i).onMultiWindowModeChanged(isInMultiWindowMode); } } @Override protected void onStop() { removeActivityFlags(ACTIVITY_STATE_STARTED | ACTIVITY_STATE_USER_ACTIVE); mForceInvisible = 0; super.onStop(); // Reset the overridden sysui flags used for the task-swipe launch animation, this is a // catch all for if we do not get resumed (and therefore not paused below) getSystemUiController().updateUiState(UI_STATE_FULLSCREEN_TASK, 0); } @Override protected void onPause() { removeActivityFlags(ACTIVITY_STATE_RESUMED | ACTIVITY_STATE_DEFERRED_RESUMED); super.onPause(); // Reset the overridden sysui flags used for the task-swipe launch animation, we do this // here instead of at the end of the animation because the start of the new activity does // not happen immediately, which would cause us to reset to launcher's sysui flags and then // back to the new app (causing a flash) getSystemUiController().updateUiState(UI_STATE_FULLSCREEN_TASK, 0); } @Override public void onWindowFocusChanged(boolean hasFocus) { super.onWindowFocusChanged(hasFocus); if (hasFocus) { addActivityFlags(ACTIVITY_STATE_WINDOW_FOCUSED); } else { removeActivityFlags(ACTIVITY_STATE_WINDOW_FOCUSED); } } public boolean isStarted() { return (mActivityFlags & ACTIVITY_STATE_STARTED) != 0; } /** * isResumed in already defined as a hidden final method in Activity.java */ public boolean hasBeenResumed() { return (mActivityFlags & ACTIVITY_STATE_RESUMED) != 0; } public boolean isUserActive() { return (mActivityFlags & ACTIVITY_STATE_USER_ACTIVE) != 0; } public int getActivityFlags() { return mActivityFlags; } protected void addActivityFlags(int flags) { mActivityFlags |= flags; onActivityFlagsChanged(flags); } protected void removeActivityFlags(int flags) { mActivityFlags &= ~flags; onActivityFlagsChanged(flags); } protected void onActivityFlagsChanged(int changeBits) { } public void addOnDeviceProfileChangeListener(OnDeviceProfileChangeListener listener) { mDPChangeListeners.add(listener); } public void removeOnDeviceProfileChangeListener(OnDeviceProfileChangeListener listener) { mDPChangeListeners.remove(listener); } protected void dispatchDeviceProfileChanged() { for (int i = mDPChangeListeners.size() - 1; i >= 0; i--) { mDPChangeListeners.get(i).onDeviceProfileChanged(mDeviceProfile); } } public void addMultiWindowModeChangedListener(MultiWindowModeChangedListener listener) { mMultiWindowModeChangedListeners.add(listener); } public void removeMultiWindowModeChangedListener(MultiWindowModeChangedListener listener) { mMultiWindowModeChangedListeners.remove(listener); } /** * Used to set the override visibility state, used only to handle the transition home with the * recents animation. * @see QuickstepTransitionManager#createWallpaperOpenRunner */ public void addForceInvisibleFlag(@InvisibilityFlags int flag) { mForceInvisible |= flag; } public void clearForceInvisibleFlag(@InvisibilityFlags int flag) { mForceInvisible &= ~flag; } /** * @return Wether this activity should be considered invisible regardless of actual visibility. */ public boolean isForceInvisible() { return hasSomeInvisibleFlag(INVISIBLE_FLAGS); } public boolean hasSomeInvisibleFlag(int mask) { return (mForceInvisible & mask) != 0; } public interface MultiWindowModeChangedListener { void onMultiWindowModeChanged(boolean isInMultiWindowMode); } protected void dumpMisc(String prefix, PrintWriter writer) { writer.println(prefix + "deviceProfile isTransposed=" + getDeviceProfile().isVerticalBarLayout()); writer.println(prefix + "orientation=" + getResources().getConfiguration().orientation); writer.println(prefix + "mSystemUiController: " + mSystemUiController); writer.println(prefix + "mActivityFlags: " + mActivityFlags); writer.println(prefix + "mForceInvisible: " + mForceInvisible); } /** * A wrapper around the platform method with Launcher specific checks */ public void startShortcut(String packageName, String id, Rect sourceBounds, Bundle startActivityOptions, UserHandle user) { if (GO_DISABLE_WIDGETS) { return; } try { getSystemService(LauncherApps.class).startShortcut(packageName, id, sourceBounds, startActivityOptions, user); } catch (SecurityException | IllegalStateException e) { Log.e(TAG, "Failed to start shortcut", e); } } public static T fromContext(Context context) { if (context instanceof BaseActivity) { return (T) context; } else if (context instanceof ContextWrapper) { return fromContext(((ContextWrapper) context).getBaseContext()); } else { throw new IllegalArgumentException("Cannot find BaseActivity in parent tree"); } } }