blob: de5419eb7bb221a4a84b30779a984521ecb262a3 [file] [log] [blame]
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001/*
2 * Copyright (C) 2008 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 * http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
Daniel Sandler325dc232013-06-05 22:57:57 -040017package com.android.launcher3;
The Android Open Source Project31dd5032009-03-03 19:32:27 -080018
Sunny Goyalcd2ac0f2022-04-14 21:21:47 -070019import static android.app.PendingIntent.FLAG_IMMUTABLE;
20import static android.app.PendingIntent.FLAG_UPDATE_CURRENT;
Sunny Goyal6c0c61a2020-12-08 19:19:56 -080021import static android.content.pm.ActivityInfo.CONFIG_UI_MODE;
Schneider Victor-tulias25ecae12020-09-14 14:07:38 -070022import static android.view.View.IMPORTANT_FOR_ACCESSIBILITY_NO;
Sunny Goyal8f965462020-04-23 19:00:36 -070023import static android.view.accessibility.AccessibilityEvent.TYPE_WINDOW_STATE_CHANGED;
Vinit Nayak48b28022020-04-27 20:48:49 +000024
Pinyao Tinga74b63a2019-07-17 23:26:06 -070025import static com.android.launcher3.AbstractFloatingView.TYPE_ALL;
Brian Isganitisa85ae692021-09-23 19:56:24 -040026import static com.android.launcher3.AbstractFloatingView.TYPE_FOLDER;
Sunny Goyal30ac97d2020-06-24 23:47:46 -070027import static com.android.launcher3.AbstractFloatingView.TYPE_ICON_SURFACE;
Pinyao Tinga74b63a2019-07-17 23:26:06 -070028import static com.android.launcher3.AbstractFloatingView.TYPE_REBIND_SAFE;
Tony Wickham6a71a5b2018-08-21 11:40:23 -070029import static com.android.launcher3.AbstractFloatingView.TYPE_SNACKBAR;
Brian Isganitisa85ae692021-09-23 19:56:24 -040030import static com.android.launcher3.AbstractFloatingView.getTopOpenViewWithType;
Alex Chau0c4e11b2022-07-08 18:41:36 +010031import static com.android.launcher3.LauncherAnimUtils.HOTSEAT_SCALE_PROPERTY_FACTORY;
32import static com.android.launcher3.LauncherAnimUtils.SCALE_INDEX_WIDGET_TRANSITION;
Sunny Goyal4c7f2152017-10-17 17:17:16 -070033import static com.android.launcher3.LauncherAnimUtils.SPRING_LOADED_EXIT_DELAY;
Alex Chau0c4e11b2022-07-08 18:41:36 +010034import static com.android.launcher3.LauncherAnimUtils.WORKSPACE_SCALE_PROPERTY_FACTORY;
Jon Mirandac4a99bf2021-11-04 16:53:45 -070035import static com.android.launcher3.LauncherSettings.Favorites.ITEM_TYPE_APPLICATION;
Sunny Goyal3e3f44c2017-10-23 17:14:52 -070036import static com.android.launcher3.LauncherState.ALL_APPS;
Sunny Goyal8f965462020-04-23 19:00:36 -070037import static com.android.launcher3.LauncherState.FLAG_MULTI_PAGE;
38import static com.android.launcher3.LauncherState.FLAG_NON_INTERACTIVE;
Sunny Goyal3e3f44c2017-10-23 17:14:52 -070039import static com.android.launcher3.LauncherState.NORMAL;
Sunny Goyalf2393f12020-04-01 20:13:12 -070040import static com.android.launcher3.LauncherState.NO_OFFSET;
41import static com.android.launcher3.LauncherState.NO_SCALE;
Sunny Goyal8f965462020-04-23 19:00:36 -070042import static com.android.launcher3.LauncherState.SPRING_LOADED;
Sunny Goyalb1d7de22019-09-06 10:36:54 -070043import static com.android.launcher3.Utilities.postAsyncCallback;
Sunny Goyal384b5782021-02-09 22:50:02 -080044import static com.android.launcher3.accessibility.LauncherAccessibilityDelegate.getSupportedActions;
Alex Chau3d2c0622022-09-01 21:28:14 +010045import static com.android.launcher3.anim.Interpolators.EMPHASIZED;
Federico Barona1845112022-10-20 21:11:58 -070046import static com.android.launcher3.config.FeatureFlags.SHOW_DOT_PAGINATION;
Thiru Ramasamy5fbac632022-01-28 15:05:36 -080047import static com.android.launcher3.logging.StatsLogManager.EventEnum;
Hyunyoung Song801f81f2020-06-19 02:58:53 -070048import static com.android.launcher3.logging.StatsLogManager.LAUNCHER_STATE_BACKGROUND;
Hyunyoung Song95786e02020-09-15 00:34:10 -070049import static com.android.launcher3.logging.StatsLogManager.LAUNCHER_STATE_HOME;
thiruramc96873c2021-02-11 15:13:47 -080050import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_ALLAPPS_ENTRY;
thiruram9f53d612021-02-24 10:54:01 -080051import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_ALLAPPS_ENTRY_WITH_DEVICE_SEARCH;
thiruramc96873c2021-02-11 15:13:47 -080052import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_ALLAPPS_EXIT;
Hyunyoung Song801f81f2020-06-19 02:58:53 -070053import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_ONRESUME;
54import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_ONSTOP;
Sunny Goyal82379182022-11-02 18:58:49 -070055import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_SWIPELEFT;
56import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_SWIPERIGHT;
Yogisha Dixit4ff5ee32021-05-04 14:58:34 +010057import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_WIDGET_RECONFIGURED;
Sunny Goyal60e68c92020-08-12 13:59:27 -070058import static com.android.launcher3.model.ItemInstallQueue.FLAG_ACTIVITY_PAUSED;
59import static com.android.launcher3.model.ItemInstallQueue.FLAG_DRAG_AND_DROP;
Sunny Goyal3a1eadd2019-10-23 17:44:27 -070060import static com.android.launcher3.popup.SystemShortcut.APP_INFO;
Sunny Goyal3a1eadd2019-10-23 17:44:27 -070061import static com.android.launcher3.popup.SystemShortcut.INSTALL;
62import static com.android.launcher3.popup.SystemShortcut.WIDGETS;
Sunny Goyal8f965462020-04-23 19:00:36 -070063import static com.android.launcher3.states.RotationHelper.REQUEST_LOCK;
Sunny Goyalbe8c3402019-05-22 15:17:52 -070064import static com.android.launcher3.states.RotationHelper.REQUEST_NONE;
Jon Mirandac4a99bf2021-11-04 16:53:45 -070065import static com.android.launcher3.util.ItemInfoMatcher.forFolderMatch;
Sunny Goyal326403e2017-10-02 12:45:10 -070066
Gilles Debunnedd6c9922010-10-25 11:23:41 -070067import android.animation.Animator;
Sunny Goyal6001ea22018-05-10 16:31:00 -070068import android.animation.AnimatorListenerAdapter;
Gilles Debunnedd6c9922010-10-25 11:23:41 -070069import android.animation.AnimatorSet;
Gilles Debunnedd6c9922010-10-25 11:23:41 -070070import android.animation.ValueAnimator;
Adam Cohen0b395352014-06-09 22:54:36 +000071import android.annotation.TargetApi;
Tony Wickhame78a70b2021-03-29 16:45:59 -070072import android.app.Notification;
73import android.app.NotificationChannel;
74import android.app.NotificationManager;
75import android.app.PendingIntent;
Adam Cohen0cf2a7c2011-11-08 15:07:01 -080076import android.appwidget.AppWidgetHostView;
Michael Jurkaaf442092010-06-10 17:01:57 -070077import android.appwidget.AppWidgetManager;
The Android Open Source Project31dd5032009-03-03 19:32:27 -080078import android.content.ActivityNotFoundException;
Michael Jurkae326f182011-11-21 14:05:46 -080079import android.content.ComponentCallbacks2;
The Android Open Source Project31dd5032009-03-03 19:32:27 -080080import android.content.Context;
The Android Open Source Project31dd5032009-03-03 19:32:27 -080081import android.content.Intent;
Adam Cohen173f7112015-03-27 15:14:00 -070082import android.content.IntentSender;
Winson Chung82f55532011-08-09 14:14:23 -070083import android.content.SharedPreferences;
The Android Open Source Project31dd5032009-03-03 19:32:27 -080084import android.content.pm.PackageManager;
Sunny Goyalf8d56fc2018-01-31 15:18:11 -080085import android.content.res.Configuration;
Adam Cohen3f9c9712014-10-31 11:48:25 -070086import android.database.sqlite.SQLiteDatabase;
Schneider Victor-tulias25ecae12020-09-14 14:07:38 -070087import android.graphics.Bitmap;
Federico Baron3f255eb2022-12-22 14:40:58 -080088import android.graphics.Color;
Tony Wickham1906cc32021-02-11 11:55:24 -080089import android.graphics.Rect;
Sunny Goyal831212e2021-05-14 14:24:09 -070090import android.graphics.RectF;
Adam Cohen0f668f32014-09-08 19:54:17 +020091import android.os.Build;
The Android Open Source Project31dd5032009-03-03 19:32:27 -080092import android.os.Bundle;
Sunny Goyal210e1742019-10-17 12:05:38 -070093import android.os.CancellationSignal;
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -070094import android.os.Parcelable;
Sunny Goyal7c74e4a2016-12-15 15:53:17 -080095import android.os.Process;
Winson Chunga2413752012-04-03 14:22:34 -070096import android.os.StrictMode;
Riddle Hsu979da642020-09-22 21:52:40 +080097import android.os.SystemClock;
Schneider Victor-tulias927d6dc2021-08-26 11:56:47 -070098import android.os.Trace;
Jon Mirandac4a99bf2021-11-04 16:53:45 -070099import android.os.UserHandle;
Michael Jurkaa33411c2012-06-14 16:18:21 -0700100import android.text.TextUtils;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800101import android.text.method.TextKeyListener;
Federico Baron7539d762022-09-29 09:47:04 -0700102import android.util.AttributeSet;
Alex Chau0c4e11b2022-07-08 18:41:36 +0100103import android.util.FloatProperty;
Joe Onorato7c312c12009-08-13 21:36:53 -0700104import android.util.Log;
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -0700105import android.util.SparseArray;
Adam Cohen96d30a12013-07-16 18:13:21 -0700106import android.view.KeyEvent;
Sunny Goyal66b24572016-09-21 15:57:55 -0700107import android.view.KeyboardShortcutGroup;
108import android.view.KeyboardShortcutInfo;
Sunny Goyal9b29ca52017-02-17 10:39:44 -0800109import android.view.LayoutInflater;
Adam Cohen96d30a12013-07-16 18:13:21 -0700110import android.view.Menu;
vadimt9af34a72020-01-21 11:19:13 -0800111import android.view.MotionEvent;
Adam Cohen96d30a12013-07-16 18:13:21 -0700112import android.view.View;
Adam Cohen96d30a12013-07-16 18:13:21 -0700113import android.view.ViewGroup;
Sunny Goyal7b8d63f2022-04-14 16:37:32 -0700114import android.view.ViewTreeObserver.OnPreDrawListener;
Schneider Victor-tulias25ecae12020-09-14 14:07:38 -0700115import android.view.WindowManager.LayoutParams;
Svetoslav Ganov815ba2d2011-01-07 14:55:17 -0800116import android.view.accessibility.AccessibilityEvent;
Sunny Goyal5a1f53b2015-05-27 10:24:24 -0700117import android.view.animation.OvershootInterpolator;
Schneider Victor-tulias25ecae12020-09-14 14:07:38 -0700118import android.widget.ImageView;
Adam Cohen96d30a12013-07-16 18:13:21 -0700119import android.widget.Toast;
Sunny Goyala1d1bf32015-06-26 13:24:53 -0700120
Sunny Goyal35e7d382020-05-08 13:37:58 -0700121import androidx.annotation.CallSuper;
Fengjiang Lie884c2c2022-12-19 14:42:14 -0800122import androidx.annotation.FloatRange;
Andras Kloczl55edfe52021-05-14 12:21:30 +0200123import androidx.annotation.NonNull;
Sunny Goyal11a50742019-08-07 09:24:26 -0700124import androidx.annotation.Nullable;
Pinyao Tingc9074272019-11-11 11:51:44 -0800125import androidx.annotation.StringRes;
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700126import androidx.annotation.VisibleForTesting;
Sunny Goyal11a50742019-08-07 09:24:26 -0700127
Sunny Goyal651077b2014-06-30 14:15:31 -0700128import com.android.launcher3.DropTarget.DragObject;
Schneider Victor-tuliasbdb0dd82021-11-03 16:26:41 -0700129import com.android.launcher3.accessibility.BaseAccessibilityDelegate.LauncherAction;
Sunny Goyalae502842016-06-17 08:43:56 -0700130import com.android.launcher3.accessibility.LauncherAccessibilityDelegate;
Brian Isganitis1664c9f2022-01-14 23:15:47 -0500131import com.android.launcher3.allapps.ActivityAllAppsContainerView;
Jon Mirandaf58db152022-06-02 16:06:37 -0700132import com.android.launcher3.allapps.AllAppsRecyclerView;
vadimtd4c90e12019-06-04 13:59:43 -0700133import com.android.launcher3.allapps.AllAppsStore;
Hyunyoung Song645764e2016-06-06 14:19:02 -0700134import com.android.launcher3.allapps.AllAppsTransitionController;
kholoud mohamedceec31b2022-02-03 15:44:25 +0000135import com.android.launcher3.allapps.BaseAllAppsContainerView;
Becky Qiu4ed3dfc2022-10-19 16:58:22 -0700136import com.android.launcher3.allapps.BaseSearchConfig;
Sunny Goyal7ede6112017-12-05 15:11:21 -0800137import com.android.launcher3.allapps.DiscoveryBounce;
Sunny Goyalf0b6db72018-08-13 16:10:14 -0700138import com.android.launcher3.anim.PropertyListBuilder;
Sunny Goyal8f965462020-04-23 19:00:36 -0700139import com.android.launcher3.compat.AccessibilityManagerCompat;
Tony Wickhame0c33232016-02-08 11:37:04 -0800140import com.android.launcher3.config.FeatureFlags;
vadimt00d42552018-12-11 17:59:36 -0800141import com.android.launcher3.dot.DotInfo;
Vadim Tryshevfedca432015-08-19 17:55:02 -0700142import com.android.launcher3.dragndrop.DragController;
143import com.android.launcher3.dragndrop.DragLayer;
Tony Wickham39938cb2021-02-26 09:15:31 -0800144import com.android.launcher3.dragndrop.DragOptions;
Vadim Tryshevfedca432015-08-19 17:55:02 -0700145import com.android.launcher3.dragndrop.DragView;
Sunny Goyal59969372021-05-06 12:11:44 -0700146import com.android.launcher3.dragndrop.LauncherDragController;
Federico Baron8bf1bca2022-09-27 16:19:11 -0700147import com.android.launcher3.folder.Folder;
Sunny Goyal11a50742019-08-07 09:24:26 -0700148import com.android.launcher3.folder.FolderGridOrganizer;
Sunny Goyal26119432016-02-18 22:09:23 +0000149import com.android.launcher3.folder.FolderIcon;
Schneider Victor-tulias25ecae12020-09-14 14:07:38 -0700150import com.android.launcher3.icons.BitmapRenderer;
Sunny Goyalf840f102018-09-21 14:41:05 -0700151import com.android.launcher3.icons.IconCache;
Sunny Goyal3333b0c2016-05-09 20:43:21 -0700152import com.android.launcher3.keyboard.ViewGroupFocusHelper;
Hyunyoung Song801f81f2020-06-19 02:58:53 -0700153import com.android.launcher3.logger.LauncherAtom;
Thiru Ramasamy5fbac632022-01-28 15:05:36 -0800154import com.android.launcher3.logger.LauncherAtom.ContainerInfo;
155import com.android.launcher3.logger.LauncherAtom.WorkspaceContainer;
Sunny Goyala7ce1662016-05-31 15:01:35 -0700156import com.android.launcher3.logging.FileLog;
thiruramc96873c2021-02-11 15:13:47 -0800157import com.android.launcher3.logging.InstanceId;
158import com.android.launcher3.logging.InstanceIdSequence;
Hyunyoung Song801f81f2020-06-19 02:58:53 -0700159import com.android.launcher3.logging.StatsLogManager;
Sunny Goyal87dcde62019-07-17 20:35:56 -0700160import com.android.launcher3.model.BgDataModel.Callbacks;
Sunny Goyal60e68c92020-08-12 13:59:27 -0700161import com.android.launcher3.model.ItemInstallQueue;
Sunny Goyal53116c62020-08-07 16:32:18 -0700162import com.android.launcher3.model.ModelUtils;
Sunny Goyala535ae42017-02-27 10:07:13 -0800163import com.android.launcher3.model.ModelWriter;
kholoud mohamedc76b2032021-12-20 16:47:38 +0000164import com.android.launcher3.model.StringCache;
Pinyao Tingbbb9a9c2021-05-11 15:42:54 -0700165import com.android.launcher3.model.WidgetsModel;
Sunny Goyale396abf2020-04-06 15:11:17 -0700166import com.android.launcher3.model.data.AppInfo;
167import com.android.launcher3.model.data.FolderInfo;
168import com.android.launcher3.model.data.ItemInfo;
169import com.android.launcher3.model.data.LauncherAppWidgetInfo;
Sunny Goyale396abf2020-04-06 15:11:17 -0700170import com.android.launcher3.model.data.WorkspaceItemInfo;
Sunny Goyala535ae42017-02-27 10:07:13 -0800171import com.android.launcher3.notification.NotificationListener;
Federico Baron7539d762022-09-29 09:47:04 -0700172import com.android.launcher3.pageindicators.WorkspacePageIndicator;
Sunny Goyale7b00122019-10-02 16:13:34 -0700173import com.android.launcher3.pm.PinRequestHelper;
Samuel Fufa41d909f2020-03-20 16:27:09 -0700174import com.android.launcher3.pm.UserCache;
Brian Isganitis149dbcb2021-11-08 18:12:38 -0500175import com.android.launcher3.popup.ArrowPopup;
Tony Wickham540913e2017-01-23 11:47:51 -0800176import com.android.launcher3.popup.PopupContainerWithArrow;
Sunny Goyala535ae42017-02-27 10:07:13 -0800177import com.android.launcher3.popup.PopupDataProvider;
Sunny Goyal3a1eadd2019-10-23 17:44:27 -0700178import com.android.launcher3.popup.SystemShortcut;
Samuel Fufaca37b8a2019-08-19 17:04:36 -0700179import com.android.launcher3.qsb.QsbContainerView;
Sunny Goyal35e7d382020-05-08 13:37:58 -0700180import com.android.launcher3.statemanager.StateManager;
181import com.android.launcher3.statemanager.StateManager.StateHandler;
Sunny Goyal35e7d382020-05-08 13:37:58 -0700182import com.android.launcher3.statemanager.StatefulActivity;
Sunny Goyal623eddd2018-03-02 12:24:41 -0800183import com.android.launcher3.states.RotationHelper;
vadimt9af34a72020-01-21 11:19:13 -0800184import com.android.launcher3.testing.TestLogging;
vadimtf6ef8792022-07-26 13:54:31 -0700185import com.android.launcher3.testing.shared.TestProtocol;
Sunny Goyal210e1742019-10-17 12:05:38 -0700186import com.android.launcher3.touch.AllAppsSwipeController;
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700187import com.android.launcher3.uioverrides.plugins.PluginManagerWrapper;
Sunny Goyal2100c782016-08-22 16:00:03 -0700188import com.android.launcher3.util.ActivityResultInfo;
Sunny Goyale84c5b82019-09-26 17:05:31 -0700189import com.android.launcher3.util.ActivityTracker;
Winson Chung6b1c73f2015-06-18 11:38:42 -0700190import com.android.launcher3.util.ComponentKey;
Sunny Goyalefb7e842018-10-04 15:11:00 -0700191import com.android.launcher3.util.IntArray;
Andras Kloczl55edfe52021-05-14 12:21:30 +0200192import com.android.launcher3.util.IntSet;
Tony Wickham133cd542020-04-08 17:48:41 -0700193import com.android.launcher3.util.OnboardingPrefs;
Sunny Goyal04cc3a72016-05-17 10:32:43 -0700194import com.android.launcher3.util.PackageManagerHelper;
Tony Wickham010d2552017-01-20 08:15:28 -0800195import com.android.launcher3.util.PackageUserKey;
Sunny Goyal2100c782016-08-22 16:00:03 -0700196import com.android.launcher3.util.PendingRequestArgs;
Sunny Goyal4a48a982021-06-17 15:15:46 -0700197import com.android.launcher3.util.RunnableList;
Samuel Fufa41d909f2020-03-20 16:27:09 -0700198import com.android.launcher3.util.SafeCloseable;
Sunny Goyala992ac92023-01-10 17:50:32 -0800199import com.android.launcher3.util.ScreenOnTracker;
200import com.android.launcher3.util.ScreenOnTracker.ScreenOnListener;
Sunny Goyal8392c822017-06-20 10:03:56 -0700201import com.android.launcher3.util.SystemUiController;
Mario Bertschlera6936942017-05-31 14:48:19 -0700202import com.android.launcher3.util.Themes;
Adam Cohen091440a2015-03-18 14:16:05 -0700203import com.android.launcher3.util.Thunk;
Sunny Goyal210e1742019-10-17 12:05:38 -0700204import com.android.launcher3.util.TouchController;
Sunny Goyalfca6bc92017-09-28 16:28:34 -0700205import com.android.launcher3.util.TraceHelper;
Sunny Goyal527c7d32015-08-28 15:19:36 -0700206import com.android.launcher3.util.ViewOnDrawExecutor;
Sunny Goyalab770a12018-11-14 15:17:26 -0800207import com.android.launcher3.views.ActivityContext;
Jon Mirandaf58db152022-06-02 16:06:37 -0700208import com.android.launcher3.views.FloatingIconView;
Sunny Goyal30ac97d2020-06-24 23:47:46 -0700209import com.android.launcher3.views.FloatingSurfaceView;
Sunny Goyal7c7be8c2018-03-07 19:58:07 -0800210import com.android.launcher3.views.OptionsPopupView;
Govinda Wassermanc06e1512019-04-09 09:56:53 -0400211import com.android.launcher3.views.ScrimView;
Sunny Goyal29947f02017-12-18 13:49:44 -0800212import com.android.launcher3.widget.LauncherAppWidgetHostView;
Yogisha Dixit741fae92021-02-22 14:03:44 +0000213import com.android.launcher3.widget.LauncherAppWidgetProviderInfo;
Sihua Ma8bbfcb62022-11-08 16:46:07 -0800214import com.android.launcher3.widget.LauncherWidgetHolder;
Sunny Goyal782f0c92017-01-19 10:27:54 -0800215import com.android.launcher3.widget.PendingAddShortcutInfo;
Hyunyoung Song3f471442015-04-08 19:01:34 -0700216import com.android.launcher3.widget.PendingAddWidgetInfo;
Sunny Goyal29947f02017-12-18 13:49:44 -0800217import com.android.launcher3.widget.PendingAppWidgetHostView;
Sunny Goyal04a324a2017-01-20 21:08:59 -0800218import com.android.launcher3.widget.WidgetAddFlowHandler;
Sunny Goyal337c81f2019-12-10 12:19:13 -0800219import com.android.launcher3.widget.WidgetManagerHelper;
Pinyao Tingc7a6c292019-08-26 14:36:02 -0700220import com.android.launcher3.widget.custom.CustomWidgetManager;
Steven Ng2f5648a2021-02-08 17:18:25 +0000221import com.android.launcher3.widget.model.WidgetsListBaseEntry;
222import com.android.launcher3.widget.picker.WidgetsFullSheet;
Sunny Goyal80a071b2021-12-27 13:30:08 +0530223import com.android.systemui.plugins.LauncherOverlayPlugin;
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700224import com.android.systemui.plugins.PluginListener;
225import com.android.systemui.plugins.shared.LauncherExterns;
226import com.android.systemui.plugins.shared.LauncherOverlayManager;
227import com.android.systemui.plugins.shared.LauncherOverlayManager.LauncherOverlay;
Adam Cohen6c5891a2014-07-09 23:53:15 -0700228
Adam Cohen16d7ffc2011-10-05 17:49:14 -0700229import java.io.FileDescriptor;
Adam Cohen16d7ffc2011-10-05 17:49:14 -0700230import java.io.PrintWriter;
Adam Cohenc0dcf592011-06-01 15:30:43 -0700231import java.util.ArrayList;
Winson Chungf0c6ae02012-03-21 16:10:31 -0700232import java.util.Collection;
Jon Mirandac4a99bf2021-11-04 16:53:45 -0700233import java.util.Collections;
Zak Cohen658c67a2018-10-19 14:21:05 -0700234import java.util.HashMap;
Sunny Goyal4390ace2014-10-13 11:33:11 -0700235import java.util.HashSet;
Michael Jurkad7c28052012-04-27 15:43:36 -0700236import java.util.List;
Thiru Ramasamy694407c2022-03-08 12:11:24 -0800237import java.util.Optional;
Sunny Goyalaae6fbb2019-01-31 16:05:58 -0800238import java.util.function.Predicate;
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700239import java.util.function.Supplier;
Sunny Goyal3a1eadd2019-10-23 17:44:27 -0700240import java.util.stream.Stream;
Jon Mirandaf5197fc2019-09-04 16:55:41 -0700241
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800242/**
243 * Default launcher application.
244 */
Shikha Malhotra0f2e1b62022-03-27 21:02:21 +0000245public class Launcher extends StatefulActivity<LauncherState>
246 implements LauncherExterns, Callbacks, InvariantDeviceProfile.OnIDPChangeListener,
Sunny Goyal82379182022-11-02 18:58:49 -0700247 PluginListener<LauncherOverlayPlugin> {
Vadim Tryshevfedca432015-08-19 17:55:02 -0700248 public static final String TAG = "Launcher";
Sunny Goyale84c5b82019-09-26 17:05:31 -0700249
250 public static final ActivityTracker<Launcher> ACTIVITY_TRACKER = new ActivityTracker<>();
251
Sunny Goyal2bba4c32015-05-18 15:42:48 -0700252 static final boolean LOGD = false;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800253
Winson Chunga2413752012-04-03 14:22:34 -0700254 static final boolean DEBUG_STRICT_MODE = false;
Romain Guy6fefcf12009-06-11 13:07:43 -0700255
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800256 private static final int REQUEST_CREATE_SHORTCUT = 1;
The Android Open Source Project7376fae2009-03-11 12:11:58 -0700257 private static final int REQUEST_CREATE_APPWIDGET = 5;
Jon Mirandac476d6e2017-05-04 16:30:01 -0700258
The Android Open Source Project7376fae2009-03-11 12:11:58 -0700259 private static final int REQUEST_PICK_APPWIDGET = 9;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800260
Michael Jurka8b805b12012-04-18 14:23:14 -0700261 private static final int REQUEST_BIND_APPWIDGET = 11;
Sunny Goyal8a2a63b2018-03-06 22:15:18 -0800262 public static final int REQUEST_BIND_PENDING_APPWIDGET = 12;
263 public static final int REQUEST_RECONFIGURE_APPWIDGET = 13;
Michael Jurka8b805b12012-04-18 14:23:14 -0700264
Jon Mirandac476d6e2017-05-04 16:30:01 -0700265 private static final int REQUEST_PERMISSION_CALL_PHONE = 14;
Sunny Goyal28c6b962015-10-12 11:42:05 -0700266
Sunny Goyal5a1f53b2015-05-27 10:24:24 -0700267 private static final float BOUNCE_ANIMATION_TENSION = 1.3f;
268
Mathew Inwood876a8462013-06-14 14:12:41 +0100269 /**
270 * IntentStarter uses request codes starting with this. This must be greater than all activity
271 * request codes used internally.
272 */
273 protected static final int REQUEST_LAST = 100;
274
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800275 // Type: int
Jeremy Simc94f4b72022-06-10 11:43:37 -0700276 protected static final String RUNTIME_STATE = "launcher.state";
Sunny Goyal2100c782016-08-22 16:00:03 -0700277 // Type: PendingRequestArgs
278 private static final String RUNTIME_STATE_PENDING_REQUEST_ARGS = "launcher.request_args";
Sunny Goyaldedda052019-05-14 15:23:48 -0700279 // Type: int
280 private static final String RUNTIME_STATE_PENDING_REQUEST_CODE = "launcher.request_code";
Sunny Goyal2100c782016-08-22 16:00:03 -0700281 // Type: ActivityResultInfo
282 private static final String RUNTIME_STATE_PENDING_ACTIVITY_RESULT = "launcher.activity_result";
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -0700283 // Type: SparseArray<Parcelable>
284 private static final String RUNTIME_STATE_WIDGET_PANEL = "launcher.widget_panel";
Sunny Goyal12e3f1f2021-07-15 14:31:58 -0700285 // Type int[]
286 private static final String RUNTIME_STATE_CURRENT_SCREEN_IDS = "launcher.current_screen_ids";
Sunny Goyal17c72fb2019-10-14 14:06:38 -0700287
Jeremy Simc94f4b72022-06-10 11:43:37 -0700288 // Type PendingSplitSelectInfo<Parcelable>
289 protected static final String PENDING_SPLIT_SELECT_INFO = "launcher.pending_split_select_info";
290
vadimt00d42552018-12-11 17:59:36 -0800291 public static final String ON_CREATE_EVT = "Launcher.onCreate";
Sunny Goyal17c72fb2019-10-14 14:06:38 -0700292 public static final String ON_START_EVT = "Launcher.onStart";
293 public static final String ON_RESUME_EVT = "Launcher.onResume";
294 public static final String ON_NEW_INTENT_EVT = "Launcher.onNewIntent";
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800295
Sunny Goyal35e7d382020-05-08 13:37:58 -0700296 private StateManager<LauncherState> mStateManager;
Patrick Dubroy6b509c12010-08-23 15:08:16 -0700297
Adam Cohenad4e15c2013-10-17 16:21:35 -0700298 private static final int ON_ACTIVITY_RESULT_ANIMATION_DELAY = 500;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800299
Winson Chunga2413752012-04-03 14:22:34 -0700300 // How long to wait before the new-shortcut animation automatically pans the workspace
Jon Mirandaf5197fc2019-09-04 16:55:41 -0700301 @VisibleForTesting public static final int NEW_APPS_PAGE_MOVE_DELAY = 500;
Rajeev Kumar43c0f582017-06-23 15:34:55 -0700302 private static final int NEW_APPS_ANIMATION_INACTIVE_TIMEOUT_SECONDS = 5;
Jon Mirandaf5197fc2019-09-04 16:55:41 -0700303 @Thunk @VisibleForTesting public static final int NEW_APPS_ANIMATION_DELAY = 500;
Winson Chunga2413752012-04-03 14:22:34 -0700304
Schneider Victor-tulias25ecae12020-09-14 14:07:38 -0700305 private static final int THEME_CROSS_FADE_ANIMATION_DURATION = 375;
306
Schneider Victor-tulias927d6dc2021-08-26 11:56:47 -0700307 private static final String DISPLAY_WORKSPACE_TRACE_METHOD_NAME = "DisplayWorkspaceFirstFrame";
308 private static final String DISPLAY_ALL_APPS_TRACE_METHOD_NAME = "DisplayAllApps";
309 public static final int DISPLAY_WORKSPACE_TRACE_COOKIE = 0;
310 public static final int DISPLAY_ALL_APPS_TRACE_COOKIE = 1;
311
Alex Chau0c4e11b2022-07-08 18:41:36 +0100312 private static final FloatProperty<Workspace<?>> WORKSPACE_WIDGET_SCALE =
313 WORKSPACE_SCALE_PROPERTY_FACTORY.get(SCALE_INDEX_WIDGET_TRANSITION);
314 private static final FloatProperty<Hotseat> HOTSEAT_WIDGET_SCALE =
315 HOTSEAT_SCALE_PROPERTY_FACTORY.get(SCALE_INDEX_WIDGET_TRANSITION);
316
Ats Jenk8121e0d2022-12-01 11:34:43 -0800317 private static final boolean DESKTOP_MODE_1_SUPPORTED =
318 "1".equals(Utilities.getSystemProperty("persist.wm.debug.desktop_mode", "0"));
319
320 private static final boolean DESKTOP_MODE_2_SUPPORTED =
321 "1".equals(Utilities.getSystemProperty("persist.wm.debug.desktop_mode_2", "0"));
322
Samuel Fufaca37b8a2019-08-19 17:04:36 -0700323 @Thunk
Shikha Malhotra0f2e1b62022-03-27 21:02:21 +0000324 Workspace<?> mWorkspace;
Samuel Fufaca37b8a2019-08-19 17:04:36 -0700325 @Thunk
326 DragLayer mDragLayer;
Sunny Goyal322d5562015-06-25 19:35:49 -0700327
Sunny Goyal337c81f2019-12-10 12:19:13 -0800328 private WidgetManagerHelper mAppWidgetManager;
Sihua Ma0593a0d2022-10-03 16:01:48 -0700329 private LauncherWidgetHolder mAppWidgetHolder;
Romain Guycbb89e42009-06-08 15:52:54 -0700330
Rajeev Kumar43c0f582017-06-23 15:34:55 -0700331 private final int[] mTmpAddItemCellCoordinates = new int[2];
Michael Jurka0280c3b2010-09-17 15:00:07 -0700332
Samuel Fufaca37b8a2019-08-19 17:04:36 -0700333 @Thunk
334 Hotseat mHotseat;
Adam Cohenf358a4b2013-07-23 16:47:31 -0700335
Sunny Goyal47328fd2016-05-25 18:56:41 -0700336 private DropTargetBar mDropTargetBar;
Hyunyoung Song3f471442015-04-08 19:01:34 -0700337
338 // Main container view for the all apps screen.
Samuel Fufaca37b8a2019-08-19 17:04:36 -0700339 @Thunk
Brian Isganitis1664c9f2022-01-14 23:15:47 -0500340 ActivityAllAppsContainerView<Launcher> mAppsView;
Hyunyoung Song645764e2016-06-06 14:19:02 -0700341 AllAppsTransitionController mAllAppsController;
Hyunyoung Song3f471442015-04-08 19:01:34 -0700342
Govinda Wassermanc06e1512019-04-09 09:56:53 -0400343 // Scrim view for the all apps and overview state.
Samuel Fufaca37b8a2019-08-19 17:04:36 -0700344 @Thunk
345 ScrimView mScrimView;
Govinda Wassermanc06e1512019-04-09 09:56:53 -0400346
Winson Chung8ae41982017-11-10 11:42:13 -0800347 // UI and state for the overview panel
Sunny Goyal7c7be8c2018-03-07 19:58:07 -0800348 private View mOverviewPanel;
Winson Chung8ae41982017-11-10 11:42:13 -0800349
Samuel Fufaca37b8a2019-08-19 17:04:36 -0700350 @Thunk
351 boolean mWorkspaceLoading = true;
Joe Onorato9c1289c2009-08-17 11:03:03 -0400352
Winson Chungc9bf6d42019-10-04 15:33:18 -0700353 // Used to notify when an activity launch has been deferred because launcher is not yet resumed
354 // TODO: See if we can remove this later
355 private Runnable mOnDeferredActivityLaunchCallback;
356
Sunny Goyal527c7d32015-08-28 15:19:36 -0700357 private ViewOnDrawExecutor mPendingExecutor;
Sunny Goyal7b8d63f2022-04-14 16:37:32 -0700358 private OnPreDrawListener mOnInitialBindListener;
Michael Jurka7607c2f2013-04-03 14:33:19 -0700359
Joe Onorato9c1289c2009-08-17 11:03:03 -0400360 private LauncherModel mModel;
Sunny Goyal43bf11d2017-02-02 13:52:53 -0800361 private ModelWriter mModelWriter;
Joe Onorato0589f0f2010-02-08 13:44:00 -0800362 private IconCache mIconCache;
Sunny Goyalae502842016-06-17 08:43:56 -0700363 private LauncherAccessibilityDelegate mAccessibilityDelegate;
Joe Onorato9c1289c2009-08-17 11:03:03 -0400364
Tony Wickham010d2552017-01-20 08:15:28 -0800365 private PopupDataProvider mPopupDataProvider;
Tony Wickhambfbf7f92016-05-19 11:19:39 -0700366
Andras Kloczl55edfe52021-05-14 12:21:30 +0200367 private IntSet mSynchronouslyBoundPages = new IntSet();
Sunny Goyal12e3f1f2021-07-15 14:31:58 -0700368 @NonNull private IntSet mPagesToBindSynchronously = new IntSet();
Adam Cohen1462de32012-07-24 22:34:36 -0700369
Winson Chung46353de2012-02-16 14:05:10 -0800370 // We only want to get the SharedPreferences once since it does an FS stat each time we get
371 // it from the context.
372 private SharedPreferences mSharedPrefs;
Brian Isganitis099945b2022-01-31 18:15:00 -0500373 private OnboardingPrefs<? extends Launcher> mOnboardingPrefs;
Winson Chung46353de2012-02-16 14:05:10 -0800374
Sunny Goyal2100c782016-08-22 16:00:03 -0700375 // Activity result which needs to be processed after workspace has loaded.
376 private ActivityResultInfo mPendingActivityResult;
377 /**
378 * Holds extra information required to handle a result from an external call, like
379 * {@link #startActivityForResult(Intent, int)} or {@link #requestPermissions(String[], int)}
380 */
381 private PendingRequestArgs mPendingRequestArgs;
Sunny Goyaldedda052019-05-14 15:23:48 -0700382 // Request id for any pending activity result
Sunny Goyal210e1742019-10-17 12:05:38 -0700383 protected int mPendingActivityRequestCode = -1;
Patrick Dubroy002cbf42011-03-03 16:36:21 -0800384
Tracy Zhou4d7b2442019-12-09 13:42:57 -0800385 private ViewGroupFocusHelper mFocusHandler;
Hyunyoung Song7fb3ccc2017-10-17 15:39:46 -0700386
Sunny Goyal623eddd2018-03-02 12:24:41 -0800387 private RotationHelper mRotationHelper;
Sunny Goyal7779d622015-06-11 16:18:39 -0700388
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700389 protected LauncherOverlayManager mOverlayManager;
Abhilasha Chahalcb329352022-05-31 15:50:53 +0000390 protected DragController mDragController;
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700391 // If true, overlay callbacks are deferred
392 private boolean mDeferOverlayCallbacks;
393 private final Runnable mDeferredOverlayCallbacks = this::checkIfOverlayStillDeferred;
394
Riddle Hsu979da642020-09-22 21:52:40 +0800395 protected long mLastTouchUpTime = -1;
Sunny Goyala306e592020-03-24 01:51:41 -0700396 private boolean mTouchInProgress;
Sunny Goyal9b180102020-03-11 10:02:29 -0700397
Samuel Fufa41d909f2020-03-20 16:27:09 -0700398 private SafeCloseable mUserChangedCallbackCloseable;
399
thiruramc96873c2021-02-11 15:13:47 -0800400 // New InstanceId is assigned to mAllAppsSessionLogId for each AllApps sessions.
401 // When Launcher is not in AllApps state mAllAppsSessionLogId will be null.
402 // User actions within AllApps state are logged with this InstanceId, to recreate AllApps
403 // session on the server side.
404 protected InstanceId mAllAppsSessionLogId;
405 private LauncherState mPrevLauncherState;
406
kholoud mohamedc76b2032021-12-20 16:47:38 +0000407 private StringCache mStringCache;
Becky Qiu4ed3dfc2022-10-19 16:58:22 -0700408 private BaseSearchConfig mBaseSearchConfig;
kholoud mohamedc76b2032021-12-20 16:47:38 +0000409
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800410 @Override
Schneider Victor-tulias927d6dc2021-08-26 11:56:47 -0700411 @TargetApi(Build.VERSION_CODES.S)
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800412 protected void onCreate(Bundle savedInstanceState) {
Schneider Victor-tulias927d6dc2021-08-26 11:56:47 -0700413 // Only use a hard-coded cookie since we only want to trace this once.
414 if (Utilities.ATLEAST_S) {
415 Trace.beginAsyncSection(
416 DISPLAY_WORKSPACE_TRACE_METHOD_NAME, DISPLAY_WORKSPACE_TRACE_COOKIE);
417 Trace.beginAsyncSection(DISPLAY_ALL_APPS_TRACE_METHOD_NAME,
418 DISPLAY_ALL_APPS_TRACE_COOKIE);
419 }
Winson Chung5cc62c72019-10-16 11:32:41 -0700420 Object traceToken = TraceHelper.INSTANCE.beginSection(ON_CREATE_EVT,
421 TraceHelper.FLAG_UI_EVENT);
Winson Chunga2413752012-04-03 14:22:34 -0700422 if (DEBUG_STRICT_MODE) {
423 StrictMode.setThreadPolicy(new StrictMode.ThreadPolicy.Builder()
424 .detectDiskReads()
425 .detectDiskWrites()
426 .detectNetwork() // or .detectAll() for all detectable problems
427 .penaltyLog()
428 .build());
429 StrictMode.setVmPolicy(new StrictMode.VmPolicy.Builder()
430 .detectLeakedSqlLiteObjects()
431 .detectLeakedClosableObjects()
432 .penaltyLog()
433 .penaltyDeath()
434 .build());
435 }
436
Tony Wickhame78a70b2021-03-29 16:45:59 -0700437 if (Utilities.IS_DEBUG_DEVICE && FeatureFlags.NOTIFY_CRASHES.get()) {
438 final String notificationChannelId = "com.android.launcher3.Debug";
439 final String notificationChannelName = "Debug";
440 final String notificationTag = "Debug";
441 final int notificationId = 0;
442
443 NotificationManager notificationManager = getSystemService(NotificationManager.class);
444 notificationManager.createNotificationChannel(new NotificationChannel(
445 notificationChannelId, notificationChannelName,
446 NotificationManager.IMPORTANCE_HIGH));
447
448 Thread.currentThread().setUncaughtExceptionHandler((thread, throwable) -> {
449 String stackTrace = Log.getStackTraceString(throwable);
450
451 Intent shareIntent = new Intent(Intent.ACTION_SEND);
452 shareIntent.setType("text/plain");
453 shareIntent.putExtra(Intent.EXTRA_TEXT, stackTrace);
454 shareIntent = Intent.createChooser(shareIntent, null);
455 PendingIntent sharePendingIntent = PendingIntent.getActivity(
Sunny Goyalcd2ac0f2022-04-14 21:21:47 -0700456 this, 0, shareIntent, FLAG_UPDATE_CURRENT | FLAG_IMMUTABLE);
Tony Wickhame78a70b2021-03-29 16:45:59 -0700457
458 Notification notification = new Notification.Builder(this, notificationChannelId)
459 .setSmallIcon(android.R.drawable.ic_menu_close_clear_cancel)
460 .setContentTitle("Launcher crash detected!")
461 .setStyle(new Notification.BigTextStyle().bigText(stackTrace))
462 .addAction(android.R.drawable.ic_menu_share, "Share", sharePendingIntent)
463 .build();
464 notificationManager.notify(notificationTag, notificationId, notification);
465
466 Thread.UncaughtExceptionHandler defaultUncaughtExceptionHandler =
467 Thread.getDefaultUncaughtExceptionHandler();
468 if (defaultUncaughtExceptionHandler != null) {
469 defaultUncaughtExceptionHandler.uncaughtException(thread, throwable);
470 }
471 });
472 }
473
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800474 super.onCreate(savedInstanceState);
Daniel Sandlere060b0b2013-06-27 21:47:55 -0400475
Sunny Goyal87f784c2017-01-11 10:48:34 -0800476 LauncherAppState app = LauncherAppState.getInstance(this);
Sunny Goyala7a5bf32020-01-05 15:35:29 +0530477 mModel = app.getModel();
Sunny Goyal9d89f752020-06-19 11:09:24 -0700478
Sunny Goyal41d51a02019-05-14 09:44:34 -0700479 mRotationHelper = new RotationHelper(this);
Hyunyoung Song31971a32019-01-27 12:31:12 -0800480 InvariantDeviceProfile idp = app.getInvariantDeviceProfile();
481 initDeviceProfile(idp);
482 idp.addOnChangeListener(this);
Stefan Andonian146701c2022-11-10 23:07:40 +0000483 mSharedPrefs = LauncherPrefs.getPrefs(this);
Joe Onorato0589f0f2010-02-08 13:44:00 -0800484 mIconCache = app.getIconCache();
Sunny Goyal384b5782021-02-09 22:50:02 -0800485 mAccessibilityDelegate = createAccessibilityDelegate();
Adam Cohen2e6da152015-05-06 11:42:25 -0700486
Abhilasha Chahalcb329352022-05-31 15:50:53 +0000487 initDragController();
Hyunyoung Song645764e2016-06-06 14:19:02 -0700488 mAllAppsController = new AllAppsTransitionController(this);
Sunny Goyal35e7d382020-05-08 13:37:58 -0700489 mStateManager = new StateManager<>(this, NORMAL);
Romain Guycbb89e42009-06-08 15:52:54 -0700490
Sunny Goyal35e7d382020-05-08 13:37:58 -0700491 mOnboardingPrefs = createOnboardingPrefs(mSharedPrefs);
Tony Wickham133cd542020-04-08 17:48:41 -0700492
Luca Zuccarini81f5cee2022-10-11 13:02:09 +0000493 // TODO: move the SearchConfig to SearchState when new LauncherState is created.
494 mBaseSearchConfig = new BaseSearchConfig();
495
Sunny Goyal337c81f2019-12-10 12:19:13 -0800496 mAppWidgetManager = new WidgetManagerHelper(this);
Sihua Ma0593a0d2022-10-03 16:01:48 -0700497 mAppWidgetHolder = createAppWidgetHolder();
498 mAppWidgetHolder.startListening();
Romain Guycbb89e42009-06-08 15:52:54 -0700499
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800500 setupViews();
Schneider Victor-tulias25ecae12020-09-14 14:07:38 -0700501 crossFadeWithPreviousAppearance();
Sunny Goyal9c2b9602020-01-07 13:07:55 -0800502 mPopupDataProvider = new PopupDataProvider(this::updateNotificationDots);
Tony Wickham010d2552017-01-20 08:15:28 -0800503
Sunny Goyale84c5b82019-09-26 17:05:31 -0700504 boolean internalStateHandled = ACTIVITY_TRACKER.handleCreate(this);
Sunny Goyald3864fa2017-11-14 15:06:36 -0800505 if (internalStateHandled) {
Sunny Goyald3864fa2017-11-14 15:06:36 -0800506 if (savedInstanceState != null) {
507 // InternalStateHandler has already set the appropriate state.
508 // We dont need to do anything.
509 savedInstanceState.remove(RUNTIME_STATE);
510 }
511 }
512 restoreState(savedInstanceState);
Sunny Goyalbbece862019-03-01 13:13:52 -0800513 mStateManager.reapplyState();
Winson Chungb63b44c2017-11-10 17:54:44 -0800514
Sunny Goyalfe770c92016-09-27 14:38:58 -0700515 if (savedInstanceState != null) {
Sunny Goyal12e3f1f2021-07-15 14:31:58 -0700516 int[] pageIds = savedInstanceState.getIntArray(RUNTIME_STATE_CURRENT_SCREEN_IDS);
517 if (pageIds != null) {
518 mPagesToBindSynchronously = IntSet.wrap(pageIds);
519 }
Sunny Goyalfe770c92016-09-27 14:38:58 -0700520 }
Sunny Goyald3864fa2017-11-14 15:06:36 -0800521
Sunny Goyala7a5bf32020-01-05 15:35:29 +0530522 if (!mModel.addCallbacksAndLoad(this)) {
Sunny Goyald3864fa2017-11-14 15:06:36 -0800523 if (!internalStateHandled) {
Sunny Goyal7b8d63f2022-04-14 16:37:32 -0700524 // If we are not binding synchronously, pause drawing until initial bind complete,
525 // so that the system could continue to show the device loading prompt
526 mOnInitialBindListener = Boolean.FALSE::booleanValue;
Sunny Goyald3864fa2017-11-14 15:06:36 -0800527 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800528 }
529
530 // For handling default keys
Sunny Goyalf4aceab2017-12-06 16:16:31 -0800531 setDefaultKeyMode(DEFAULT_KEYS_SEARCH_LOCAL);
Joe Onorato34a0e1b2009-12-14 17:44:51 -0800532
Sunny Goyal9d89f752020-06-19 11:09:24 -0700533 setContentView(getRootView());
Sunny Goyal7b8d63f2022-04-14 16:37:32 -0700534 if (mOnInitialBindListener != null) {
535 getRootView().getViewTreeObserver().addOnPreDrawListener(mOnInitialBindListener);
536 }
Sunny Goyalf8d56fc2018-01-31 15:18:11 -0800537 getRootView().dispatchInsets();
Mario Bertschlera6936942017-05-31 14:48:19 -0700538
Sunny Goyala992ac92023-01-10 17:50:32 -0800539 // Listen for screen turning off
540 ScreenOnTracker.INSTANCE.get(this).addListener(mScreenOnListener);
Sunny Goyal8392c822017-06-20 10:03:56 -0700541 getSystemUiController().updateUiState(SystemUiController.UI_STATE_BASE_WINDOW,
542 Themes.getAttrBoolean(this, R.attr.isWorkspaceDarkText));
Sunny Goyal14b32402017-07-31 10:03:28 -0700543
544 if (mLauncherCallbacks != null) {
545 mLauncherCallbacks.onCreate(savedInstanceState);
546 }
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700547 mOverlayManager = getDefaultOverlay();
548 PluginManagerWrapper.INSTANCE.get(this).addPluginListener(this,
Sunny Goyal80a071b2021-12-27 13:30:08 +0530549 LauncherOverlayPlugin.class, false /* allowedMultiple */);
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700550
Sunny Goyal623eddd2018-03-02 12:24:41 -0800551 mRotationHelper.initialize();
Winson Chung5cc62c72019-10-16 11:32:41 -0700552 TraceHelper.INSTANCE.endSection(traceToken);
Samuel Fufa41d909f2020-03-20 16:27:09 -0700553
554 mUserChangedCallbackCloseable = UserCache.INSTANCE.get(this).addUserChangeListener(
555 () -> getStateManager().goToState(NORMAL));
Schneider Victor-tulias8a35c762020-09-03 14:30:10 -0700556
557 if (Utilities.ATLEAST_R) {
Schneider Victor-tulias25ecae12020-09-14 14:07:38 -0700558 getWindow().setSoftInputMode(LayoutParams.SOFT_INPUT_ADJUST_NOTHING);
Schneider Victor-tulias8a35c762020-09-03 14:30:10 -0700559 }
Stefan Andonian45fc3012022-05-05 22:48:09 +0000560 setTitle(R.string.home_screen);
Adam Cohen9211d422014-10-07 18:14:53 -0700561 }
562
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700563 protected LauncherOverlayManager getDefaultOverlay() {
564 return new LauncherOverlayManager() { };
565 }
566
Brian Isganitis099945b2022-01-31 18:15:00 -0500567 protected OnboardingPrefs<? extends Launcher> createOnboardingPrefs(
568 SharedPreferences sharedPrefs) {
Sunny Goyal35e7d382020-05-08 13:37:58 -0700569 return new OnboardingPrefs<>(this, sharedPrefs);
Tony Wickham133cd542020-04-08 17:48:41 -0700570 }
571
Brian Isganitis099945b2022-01-31 18:15:00 -0500572 public OnboardingPrefs<? extends Launcher> getOnboardingPrefs() {
Tony Wickham133cd542020-04-08 17:48:41 -0700573 return mOnboardingPrefs;
574 }
575
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700576 @Override
Sunny Goyal80a071b2021-12-27 13:30:08 +0530577 public void onPluginConnected(LauncherOverlayPlugin overlayManager, Context context) {
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700578 switchOverlay(() -> overlayManager.createOverlayManager(this, this));
579 }
580
581 @Override
Sunny Goyal80a071b2021-12-27 13:30:08 +0530582 public void onPluginDisconnected(LauncherOverlayPlugin plugin) {
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700583 switchOverlay(this::getDefaultOverlay);
584 }
585
586 private void switchOverlay(Supplier<LauncherOverlayManager> overlaySupplier) {
587 if (mOverlayManager != null) {
588 mOverlayManager.onActivityDestroyed(this);
589 }
590 mOverlayManager = overlaySupplier.get();
591 if (getRootView().isAttachedToWindow()) {
592 mOverlayManager.onAttachedToWindow();
593 }
594 mDeferOverlayCallbacks = true;
595 checkIfOverlayStillDeferred();
596 }
597
598 @Override
Brian Isganitis099945b2022-01-31 18:15:00 -0500599 public void dispatchDeviceProfileChanged() {
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700600 super.dispatchDeviceProfileChanged();
601 mOverlayManager.onDeviceProvideChanged();
602 }
603
Sunny Goyal7779d622015-06-11 16:18:39 -0700604 @Override
Winson Chung8eb49e02018-07-16 13:33:31 -0700605 public void onEnterAnimationComplete() {
606 super.onEnterAnimationComplete();
Sunny Goyalbe8c3402019-05-22 15:17:52 -0700607 mRotationHelper.setCurrentTransitionRequest(REQUEST_NONE);
Sunny Goyal5c20fdd2022-04-05 20:58:03 -0700608 // Starting with Android S, onEnterAnimationComplete is sent immediately
609 // causing the surface to get removed before the animation completed (b/175345344).
610 // Instead we rely on next user touch event to remove the view and optionally a callback
611 // from system from Android T onwards.
612 if (!Utilities.ATLEAST_S) {
613 AbstractFloatingView.closeOpenViews(this, false, TYPE_ICON_SURFACE);
614 }
Winson Chung8eb49e02018-07-16 13:33:31 -0700615 }
616
617 @Override
Jerry Chang09b40242021-08-27 13:29:01 +0800618 public void onMultiWindowModeChanged(boolean isInMultiWindowMode, Configuration newConfig) {
619 super.onMultiWindowModeChanged(isInMultiWindowMode, newConfig);
620 // Always update device profile when multi window mode changed.
621 initDeviceProfile(mDeviceProfile.inv);
622 dispatchDeviceProfileChanged();
623 }
624
Abhilasha Chahalcb329352022-05-31 15:50:53 +0000625 /**
626 * Initializes the drag controller.
627 */
628 protected void initDragController() {
629 mDragController = new LauncherDragController(this);
630 }
631
Sunny Goyal605bcf32018-03-02 15:16:12 -0800632 @Override
Sunny Goyal6e6f7992021-08-24 16:23:29 -0700633 public void onIdpChanged(boolean modelPropertiesChanged) {
Alex Chau360ec032022-08-10 16:11:42 +0100634 onHandleConfigurationChanged();
635 }
636
637 @Override
638 protected void onHandleConfigurationChanged() {
Alex Chau6209af62022-07-27 14:08:23 +0100639 if (!initDeviceProfile(mDeviceProfile.inv)) {
640 return;
641 }
642
Sunny Goyal371ea052019-03-06 15:38:32 -0800643 dispatchDeviceProfileChanged();
644 reapplyUi();
645 mDragLayer.recreateControllers();
646
Sunny Goyal76ba0a32019-06-10 11:56:11 -0700647 // Calling onSaveInstanceState ensures that static cache used by listWidgets is
648 // initialized properly.
649 onSaveInstanceState(new Bundle());
Sunny Goyalc4d32012020-04-03 17:10:11 -0700650 mModel.rebindCallbacks();
Hyunyoung Song31971a32019-01-27 12:31:12 -0800651 }
652
Govinda Wassermanc06e1512019-04-09 09:56:53 -0400653 public void onAssistantVisibilityChanged(float visibility) {
Sunny Goyal0b5b8d42021-03-31 14:56:47 -0700654 mHotseat.getQsb().setAlpha(1f - visibility);
Govinda Wassermanc06e1512019-04-09 09:56:53 -0400655 }
656
Bill Lina1221bc2021-06-03 01:49:27 +0800657 /**
Alex Chau6209af62022-07-27 14:08:23 +0100658 * Returns {@code true} if a new DeviceProfile is initialized, and {@code false} otherwise.
659 */
660 protected boolean initDeviceProfile(InvariantDeviceProfile idp) {
Sunny Goyalf8d56fc2018-01-31 15:18:11 -0800661 // Load configuration-specific DeviceProfile
Alex Chau6209af62022-07-27 14:08:23 +0100662 DeviceProfile deviceProfile = idp.getDeviceProfile(this);
663 if (mDeviceProfile == deviceProfile) {
664 return false;
665 }
666
667 mDeviceProfile = deviceProfile;
Jerry Changbfac46a2021-09-08 08:20:58 +0800668 if (isInMultiWindowMode()) {
669 mDeviceProfile = mDeviceProfile.getMultiWindowProfile(
670 this, getMultiWindowDisplaySize());
671 }
Sunny Goyalae6e3182019-04-30 12:04:37 -0700672
Sunny Goyal59d086c2018-05-07 17:31:40 -0700673 onDeviceProfileInitiated();
Sunny Goyal711c5962021-06-23 12:36:18 -0700674 mModelWriter = mModel.getWriter(getDeviceProfile().isVerticalBarLayout(), true, this);
Alex Chau6209af62022-07-27 14:08:23 +0100675 return true;
Sunny Goyalf8d56fc2018-01-31 15:18:11 -0800676 }
677
Sunny Goyal623eddd2018-03-02 12:24:41 -0800678 public RotationHelper getRotationHelper() {
679 return mRotationHelper;
680 }
681
Tracy Zhou4d7b2442019-12-09 13:42:57 -0800682 public ViewGroupFocusHelper getFocusHandler() {
683 return mFocusHandler;
684 }
685
Sunny Goyal35e7d382020-05-08 13:37:58 -0700686 @Override
687 public StateManager<LauncherState> getStateManager() {
Sunny Goyal3e3f44c2017-10-23 17:14:52 -0700688 return mStateManager;
Sunny Goyalbe93f262017-10-20 17:05:27 -0700689 }
690
Adam Cohen9211d422014-10-07 18:14:53 -0700691 private LauncherCallbacks mLauncherCallbacks;
692
Sunny Goyal32554d12015-12-03 15:31:25 -0800693 /**
694 * Call this after onCreate to set or clear overlay.
695 */
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700696 @Override
Sunny Goyal32554d12015-12-03 15:31:25 -0800697 public void setLauncherOverlay(LauncherOverlay overlay) {
Sunny Goyal32554d12015-12-03 15:31:25 -0800698 mWorkspace.setLauncherOverlay(overlay);
699 }
700
Adam Cohen9211d422014-10-07 18:14:53 -0700701 public boolean setLauncherCallbacks(LauncherCallbacks callbacks) {
702 mLauncherCallbacks = callbacks;
703 return true;
Adam Cohenf9426d52012-06-04 17:26:21 -0700704 }
705
Hyunyoung Song3f471442015-04-08 19:01:34 -0700706 public boolean isDraggingEnabled() {
Winson Chung36a62fe2012-05-06 18:04:42 -0700707 // We prevent dragging when we are loading the workspace as it is possible to pick up a view
708 // that is subsequently removed from the workspace in startBinding().
Sunny Goyal639e9062015-08-19 19:17:06 -0700709 return !isWorkspaceLoading();
Winson Chung36a62fe2012-05-06 18:04:42 -0700710 }
711
Schneider Victor-tulias5173fd82021-10-19 14:47:23 -0700712 @NonNull
713 @Override
Tony Wickham010d2552017-01-20 08:15:28 -0800714 public PopupDataProvider getPopupDataProvider() {
715 return mPopupDataProvider;
716 }
717
Sunny Goyal0b0847b2018-03-14 12:30:11 -0700718 @Override
Tony Wickhamf34bee82018-12-03 18:11:39 -0800719 public DotInfo getDotInfoForItem(ItemInfo info) {
720 return mPopupDataProvider.getDotInfoForItem(info);
Sunny Goyal0b0847b2018-03-14 12:30:11 -0700721 }
722
723 @Override
724 public void invalidateParent(ItemInfo info) {
Jon Mirandae6f3fa42019-03-04 09:14:40 -0800725 if (info.container >= 0) {
Sunny Goyal0b0847b2018-03-14 12:30:11 -0700726 View folderIcon = getWorkspace().getHomescreenIconByItemId(info.container);
Jon Mirandae6f3fa42019-03-04 09:14:40 -0800727 if (folderIcon instanceof FolderIcon && folderIcon.getTag() instanceof FolderInfo) {
Sunny Goyal11a50742019-08-07 09:24:26 -0700728 if (new FolderGridOrganizer(getDeviceProfile().inv)
729 .setFolderInfo((FolderInfo) folderIcon.getTag())
730 .isItemInPreview(info.rank)) {
Jon Mirandae6f3fa42019-03-04 09:14:40 -0800731 folderIcon.invalidate();
732 }
Sunny Goyal0b0847b2018-03-14 12:30:11 -0700733 }
734 }
735 }
736
Adam Cohenc76e1dd2013-11-14 11:09:14 +0000737 /**
Winson Chung557d6ed2011-07-08 15:34:52 -0700738 * Returns whether we should delay spring loaded mode -- for shortcuts and widgets that have
739 * a configuration step, this allows the proper animations to run after other transitions.
740 */
Sunny Goyalefb7e842018-10-04 15:11:00 -0700741 private int completeAdd(
Sunny Goyal2100c782016-08-22 16:00:03 -0700742 int requestCode, Intent intent, int appWidgetId, PendingRequestArgs info) {
Sunny Goyalefb7e842018-10-04 15:11:00 -0700743 int screenId = info.screenId;
Sunny Goyal2100c782016-08-22 16:00:03 -0700744 if (info.container == LauncherSettings.Favorites.CONTAINER_DESKTOP) {
Adam Cohen83079e42014-09-19 17:43:08 -0700745 // When the screen id represents an actual screen (as opposed to a rank) we make sure
746 // that the drop page actually exists.
Sunny Goyal2100c782016-08-22 16:00:03 -0700747 screenId = ensurePendingDropLayoutExists(info.screenId);
Adam Cohen83079e42014-09-19 17:43:08 -0700748 }
Adam Cohendb364c32014-05-20 14:23:40 -0700749
Sunny Goyal2100c782016-08-22 16:00:03 -0700750 switch (requestCode) {
Patrick Dubroy002cbf42011-03-03 16:36:21 -0800751 case REQUEST_CREATE_SHORTCUT:
Sunny Goyalfb5096d2016-09-08 14:32:06 -0700752 completeAddShortcut(intent, info.container, screenId, info.cellX, info.cellY, info);
Pinyao Tingc9074272019-11-11 11:51:44 -0800753 announceForAccessibility(R.string.item_added_to_workspace);
Winson Chungb8472bb2011-08-05 13:49:21 -0700754 break;
Patrick Dubroy002cbf42011-03-03 16:36:21 -0800755 case REQUEST_CREATE_APPWIDGET:
Sunny Goyal2100c782016-08-22 16:00:03 -0700756 completeAddAppWidget(appWidgetId, info, null, null);
Winson Chungb8472bb2011-08-05 13:49:21 -0700757 break;
Sunny Goyalff572272014-07-23 13:58:07 -0700758 case REQUEST_RECONFIGURE_APPWIDGET:
Sunny Goyal977838b2022-06-27 13:15:41 -0700759 getStatsLogManager().logger().withItemInfo(info).log(LAUNCHER_WIDGET_RECONFIGURED);
Sunny Goyal2100c782016-08-22 16:00:03 -0700760 completeRestoreAppWidget(appWidgetId, LauncherAppWidgetInfo.RESTORE_COMPLETED);
Sunny Goyalff572272014-07-23 13:58:07 -0700761 break;
Sunny Goyald478c832016-04-01 12:04:16 -0700762 case REQUEST_BIND_PENDING_APPWIDGET: {
Sunny Goyal2100c782016-08-22 16:00:03 -0700763 int widgetId = appWidgetId;
764 LauncherAppWidgetInfo widgetInfo =
Sunny Goyald478c832016-04-01 12:04:16 -0700765 completeRestoreAppWidget(widgetId, LauncherAppWidgetInfo.FLAG_UI_NOT_READY);
Sunny Goyal2100c782016-08-22 16:00:03 -0700766 if (widgetInfo != null) {
Sunny Goyald478c832016-04-01 12:04:16 -0700767 // Since the view was just bound, also launch the configure activity if needed
768 LauncherAppWidgetProviderInfo provider = mAppWidgetManager
769 .getLauncherAppWidgetInfo(widgetId);
Sunny Goyal04a324a2017-01-20 21:08:59 -0800770 if (provider != null) {
771 new WidgetAddFlowHandler(provider)
Samuel Fufaca37b8a2019-08-19 17:04:36 -0700772 .startConfigActivity(this, widgetInfo,
773 REQUEST_RECONFIGURE_APPWIDGET);
Sunny Goyald478c832016-04-01 12:04:16 -0700774 }
775 }
776 break;
777 }
Patrick Dubroy002cbf42011-03-03 16:36:21 -0800778 }
Adam Cohendb364c32014-05-20 14:23:40 -0700779 return screenId;
Patrick Dubroy002cbf42011-03-03 16:36:21 -0800780 }
781
Adam Cohenc7cd2cb2014-11-17 17:45:34 -0800782 private void handleActivityResult(
Michael Jurka8b805b12012-04-18 14:23:14 -0700783 final int requestCode, final int resultCode, final Intent data) {
Sunny Goyal2100c782016-08-22 16:00:03 -0700784 if (isWorkspaceLoading()) {
785 // process the result once the workspace has loaded.
786 mPendingActivityResult = new ActivityResultInfo(requestCode, resultCode, data);
787 return;
788 }
789 mPendingActivityResult = null;
790
Winson Chunge341d302013-08-16 14:31:00 -0700791 // Reset the startActivity waiting flag
Sunny Goyal2100c782016-08-22 16:00:03 -0700792 final PendingRequestArgs requestArgs = mPendingRequestArgs;
793 setWaitingForResult(null);
794 if (requestArgs == null) {
795 return;
796 }
797
798 final int pendingAddWidgetId = requestArgs.getWidgetId();
Winson Chunge341d302013-08-16 14:31:00 -0700799
Adam Cohenad4e15c2013-10-17 16:21:35 -0700800 Runnable exitSpringLoaded = new Runnable() {
801 @Override
802 public void run() {
Sunny Goyal3e3f44c2017-10-23 17:14:52 -0700803 mStateManager.goToState(NORMAL, SPRING_LOADED_EXIT_DELAY);
Adam Cohenad4e15c2013-10-17 16:21:35 -0700804 }
805 };
806
Michael Jurka8b805b12012-04-18 14:23:14 -0700807 if (requestCode == REQUEST_BIND_APPWIDGET) {
Winsona1f79d32015-08-05 14:00:45 -0700808 // This is called only if the user did not previously have permissions to bind widgets
Adam Cohenad4e15c2013-10-17 16:21:35 -0700809 final int appWidgetId = data != null ?
Michael Jurka8b805b12012-04-18 14:23:14 -0700810 data.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, -1) : -1;
811 if (resultCode == RESULT_CANCELED) {
Sunny Goyal2100c782016-08-22 16:00:03 -0700812 completeTwoStageWidgetDrop(RESULT_CANCELED, appWidgetId, requestArgs);
Sunny Goyal6e379fc2020-03-19 16:08:14 -0700813 mWorkspace.removeExtraEmptyScreenDelayed(
814 ON_ACTIVITY_RESULT_ANIMATION_DELAY, false, exitSpringLoaded);
Michael Jurka8b805b12012-04-18 14:23:14 -0700815 } else if (resultCode == RESULT_OK) {
Sunny Goyal2100c782016-08-22 16:00:03 -0700816 addAppWidgetImpl(
817 appWidgetId, requestArgs, null,
Sunny Goyal04a324a2017-01-20 21:08:59 -0800818 requestArgs.getWidgetHandler(),
Sunny Goyal2100c782016-08-22 16:00:03 -0700819 ON_ACTIVITY_RESULT_ANIMATION_DELAY);
Michael Jurka8b805b12012-04-18 14:23:14 -0700820 }
821 return;
822 }
Michael Jurka336fd4f2013-09-12 00:05:02 +0200823
Adam Cohened66b2b2012-01-23 17:28:51 -0800824 boolean isWidgetDrop = (requestCode == REQUEST_PICK_APPWIDGET ||
Sunny Goyal5c97f512015-05-19 16:03:28 -0700825 requestCode == REQUEST_CREATE_APPWIDGET);
Romain Guyaad5ef42009-06-10 02:48:37 -0700826
Adam Cohened66b2b2012-01-23 17:28:51 -0800827 // We have special handling for widgets
828 if (isWidgetDrop) {
Adam Cohen4637b5a2013-11-04 18:21:24 -0800829 final int appWidgetId;
830 int widgetId = data != null ? data.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, -1)
831 : -1;
832 if (widgetId < 0) {
833 appWidgetId = pendingAddWidgetId;
834 } else {
835 appWidgetId = widgetId;
836 }
837
Adam Cohenad4e15c2013-10-17 16:21:35 -0700838 final int result;
Adam Cohenf0129b12013-11-04 17:57:36 -0800839 if (appWidgetId < 0 || resultCode == RESULT_CANCELED) {
Adam Cohendb364c32014-05-20 14:23:40 -0700840 Log.e(TAG, "Error: appWidgetId (EXTRA_APPWIDGET_ID) was not " +
841 "returned from the widget configuration activity.");
Adam Cohenad4e15c2013-10-17 16:21:35 -0700842 result = RESULT_CANCELED;
Sunny Goyal2100c782016-08-22 16:00:03 -0700843 completeTwoStageWidgetDrop(result, appWidgetId, requestArgs);
Sunny Goyal6e379fc2020-03-19 16:08:14 -0700844 mWorkspace.removeExtraEmptyScreenDelayed(
845 ON_ACTIVITY_RESULT_ANIMATION_DELAY, false,
846 () -> getStateManager().goToState(NORMAL));
Sunny Goyal2100c782016-08-22 16:00:03 -0700847 } else {
848 if (requestArgs.container == LauncherSettings.Favorites.CONTAINER_DESKTOP) {
849 // When the screen id represents an actual screen (as opposed to a rank)
850 // we make sure that the drop page actually exists.
851 requestArgs.screenId =
852 ensurePendingDropLayoutExists(requestArgs.screenId);
Adam Cohendb364c32014-05-20 14:23:40 -0700853 }
Sunny Goyal2100c782016-08-22 16:00:03 -0700854 final CellLayout dropLayout =
855 mWorkspace.getScreenWithId(requestArgs.screenId);
856
857 dropLayout.setDropPending(true);
858 final Runnable onComplete = new Runnable() {
859 @Override
860 public void run() {
861 completeTwoStageWidgetDrop(resultCode, appWidgetId, requestArgs);
862 dropLayout.setDropPending(false);
863 }
864 };
Sunny Goyal6e379fc2020-03-19 16:08:14 -0700865 mWorkspace.removeExtraEmptyScreenDelayed(
866 ON_ACTIVITY_RESULT_ANIMATION_DELAY, false, onComplete);
Winson Chung5aaab772012-04-27 15:24:02 -0700867 }
Adam Cohened66b2b2012-01-23 17:28:51 -0800868 return;
869 }
870
Sunny Goyald478c832016-04-01 12:04:16 -0700871 if (requestCode == REQUEST_RECONFIGURE_APPWIDGET
872 || requestCode == REQUEST_BIND_PENDING_APPWIDGET) {
Sunny Goyalff572272014-07-23 13:58:07 -0700873 if (resultCode == RESULT_OK) {
874 // Update the widget view.
Sunny Goyal2100c782016-08-22 16:00:03 -0700875 completeAdd(requestCode, data, pendingAddWidgetId, requestArgs);
Sunny Goyalff572272014-07-23 13:58:07 -0700876 }
877 // Leave the widget in the pending state if the user canceled the configure.
878 return;
879 }
880
Sunny Goyalaad90582015-07-09 14:22:50 -0700881 if (requestCode == REQUEST_CREATE_SHORTCUT) {
882 // Handle custom shortcuts created using ACTION_CREATE_SHORTCUT.
Sunny Goyal2100c782016-08-22 16:00:03 -0700883 if (resultCode == RESULT_OK && requestArgs.container != ItemInfo.NO_ID) {
884 completeAdd(requestCode, data, -1, requestArgs);
Sunny Goyal6e379fc2020-03-19 16:08:14 -0700885 mWorkspace.removeExtraEmptyScreenDelayed(
886 ON_ACTIVITY_RESULT_ANIMATION_DELAY, false, exitSpringLoaded);
Sunny Goyal2100c782016-08-22 16:00:03 -0700887
Sunny Goyalaad90582015-07-09 14:22:50 -0700888 } else if (resultCode == RESULT_CANCELED) {
Sunny Goyal6e379fc2020-03-19 16:08:14 -0700889 mWorkspace.removeExtraEmptyScreenDelayed(
890 ON_ACTIVITY_RESULT_ANIMATION_DELAY, false, exitSpringLoaded);
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800891 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800892 }
Hongming Jind91cb6e2020-01-27 16:23:03 -0800893
Adam Cohened66b2b2012-01-23 17:28:51 -0800894 mDragLayer.clearAnimatedView();
Adam Cohenc7cd2cb2014-11-17 17:45:34 -0800895 }
896
897 @Override
Sunny Goyal64a75aa2017-07-03 13:50:52 -0700898 public void onActivityResult(
Adam Cohenc7cd2cb2014-11-17 17:45:34 -0800899 final int requestCode, final int resultCode, final Intent data) {
Sunny Goyaldedda052019-05-14 15:23:48 -0700900 mPendingActivityRequestCode = -1;
Adam Cohenc7cd2cb2014-11-17 17:45:34 -0800901 handleActivityResult(requestCode, resultCode, data);
Adam Cohened66b2b2012-01-23 17:28:51 -0800902 }
903
Sunny Goyal7ce471b2017-08-02 03:37:39 -0700904 @Override
Sunny Goyaldd2e6df2015-07-07 10:57:57 -0700905 public void onRequestPermissionsResult(int requestCode, String[] permissions,
Dave Hawkey3a43ed62015-06-26 10:27:47 -0600906 int[] grantResults) {
Sunny Goyal2100c782016-08-22 16:00:03 -0700907 PendingRequestArgs pendingArgs = mPendingRequestArgs;
908 if (requestCode == REQUEST_PERMISSION_CALL_PHONE && pendingArgs != null
909 && pendingArgs.getRequestCode() == REQUEST_PERMISSION_CALL_PHONE) {
910 setWaitingForResult(null);
911
Sunny Goyal28c6b962015-10-12 11:42:05 -0700912 View v = null;
Sunny Goyal2100c782016-08-22 16:00:03 -0700913 CellLayout layout = getCellLayout(pendingArgs.container, pendingArgs.screenId);
Sunny Goyal28c6b962015-10-12 11:42:05 -0700914 if (layout != null) {
Sunny Goyal2100c782016-08-22 16:00:03 -0700915 v = layout.getChildAt(pendingArgs.cellX, pendingArgs.cellY);
Sunny Goyal28c6b962015-10-12 11:42:05 -0700916 }
Sunny Goyal2100c782016-08-22 16:00:03 -0700917 Intent intent = pendingArgs.getPendingIntent();
918
Sunny Goyal28c6b962015-10-12 11:42:05 -0700919 if (grantResults.length > 0
920 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
Sunny Goyal852537f2020-07-15 17:02:16 -0700921 startActivitySafely(v, intent, null);
Sunny Goyal28c6b962015-10-12 11:42:05 -0700922 } else {
923 // TODO: Show a snack bar with link to settings
924 Toast.makeText(this, getString(R.string.msg_no_phone_permission,
Sunny Goyal112ce422016-08-22 16:45:29 -0700925 getString(R.string.derived_app_name)), Toast.LENGTH_SHORT).show();
Sunny Goyal28c6b962015-10-12 11:42:05 -0700926 }
927 }
Dave Hawkey3a43ed62015-06-26 10:27:47 -0600928 }
929
Adam Cohendb364c32014-05-20 14:23:40 -0700930 /**
931 * Check to see if a given screen id exists. If not, create it at the end, return the new id.
932 *
933 * @param screenId the screen id to check
934 * @return the new screen, or screenId if it exists
935 */
Sunny Goyalefb7e842018-10-04 15:11:00 -0700936 private int ensurePendingDropLayoutExists(int screenId) {
Sunny Goyal32554d12015-12-03 15:31:25 -0800937 CellLayout dropLayout = mWorkspace.getScreenWithId(screenId);
Adam Cohendb364c32014-05-20 14:23:40 -0700938 if (dropLayout == null) {
939 // it's possible that the add screen was removed because it was
940 // empty and a re-bind occurred
Andras Kloczl408a54f2021-08-28 00:59:08 +0100941 mWorkspace.addExtraEmptyScreens();
942 IntSet emptyPagesAdded = mWorkspace.commitExtraEmptyScreens();
943 return emptyPagesAdded.isEmpty() ? -1 : emptyPagesAdded.getArray().get(0);
Adam Cohendb364c32014-05-20 14:23:40 -0700944 }
Andras Kloczl408a54f2021-08-28 00:59:08 +0100945 return screenId;
Adam Cohendb364c32014-05-20 14:23:40 -0700946 }
947
Samuel Fufaca37b8a2019-08-19 17:04:36 -0700948 @Thunk
949 void completeTwoStageWidgetDrop(
Sunny Goyal2100c782016-08-22 16:00:03 -0700950 final int resultCode, final int appWidgetId, final PendingRequestArgs requestArgs) {
951 CellLayout cellLayout = mWorkspace.getScreenWithId(requestArgs.screenId);
Adam Cohened66b2b2012-01-23 17:28:51 -0800952 Runnable onCompleteRunnable = null;
953 int animationType = 0;
954
Adam Cohen9d5b7d82012-05-09 18:00:44 -0700955 AppWidgetHostView boundWidget = null;
Adam Cohened66b2b2012-01-23 17:28:51 -0800956 if (resultCode == RESULT_OK) {
957 animationType = Workspace.COMPLETE_TWO_STAGE_WIDGET_DROP_ANIMATION;
Sihua Ma0593a0d2022-10-03 16:01:48 -0700958 final AppWidgetHostView layout = mAppWidgetHolder.createView(this, appWidgetId,
Sunny Goyal04a324a2017-01-20 21:08:59 -0800959 requestArgs.getWidgetHandler().getProviderInfo(this));
Adam Cohen9d5b7d82012-05-09 18:00:44 -0700960 boundWidget = layout;
Adam Cohened66b2b2012-01-23 17:28:51 -0800961 onCompleteRunnable = new Runnable() {
962 @Override
963 public void run() {
Sunny Goyal2100c782016-08-22 16:00:03 -0700964 completeAddAppWidget(appWidgetId, requestArgs, layout, null);
Sunny Goyal3e3f44c2017-10-23 17:14:52 -0700965 mStateManager.goToState(NORMAL, SPRING_LOADED_EXIT_DELAY);
Adam Cohened66b2b2012-01-23 17:28:51 -0800966 }
967 };
968 } else if (resultCode == RESULT_CANCELED) {
Sihua Ma0593a0d2022-10-03 16:01:48 -0700969 mAppWidgetHolder.deleteAppWidgetId(appWidgetId);
Adam Cohened66b2b2012-01-23 17:28:51 -0800970 animationType = Workspace.CANCEL_TWO_STAGE_WIDGET_DROP_ANIMATION;
Adam Cohened66b2b2012-01-23 17:28:51 -0800971 }
Adam Cohen9d5b7d82012-05-09 18:00:44 -0700972 if (mDragLayer.getAnimatedView() != null) {
Sunny Goyal2100c782016-08-22 16:00:03 -0700973 mWorkspace.animateWidgetDrop(requestArgs, cellLayout,
Adam Cohen9d5b7d82012-05-09 18:00:44 -0700974 (DragView) mDragLayer.getAnimatedView(), onCompleteRunnable,
975 animationType, boundWidget, true);
Adam Cohenad4e15c2013-10-17 16:21:35 -0700976 } else if (onCompleteRunnable != null) {
Adam Cohen9d5b7d82012-05-09 18:00:44 -0700977 // The animated view may be null in the case of a rotation during widget configuration
978 onCompleteRunnable.run();
979 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800980 }
981
982 @Override
Michael Jurkacd496d72013-04-11 11:32:45 -0700983 protected void onStop() {
984 super.onStop();
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700985 if (mDeferOverlayCallbacks) {
986 checkIfOverlayStillDeferred();
987 } else {
988 mOverlayManager.onActivityStopped(this);
Adam Cohen9211d422014-10-07 18:14:53 -0700989 }
Hyunyoung Song5ee7c132021-05-11 13:52:36 -0700990 hideKeyboard();
Hyunyoung Song95786e02020-09-15 00:34:10 -0700991 logStopAndResume(false /* isResume */);
Sihua Ma0593a0d2022-10-03 16:01:48 -0700992 mAppWidgetHolder.setActivityStarted(false);
Schneider Victor-tulias5173fd82021-10-19 14:47:23 -0700993 NotificationListener.removeNotificationsChangedListener(getPopupDataProvider());
Michael Jurkacd496d72013-04-11 11:32:45 -0700994 }
995
996 @Override
997 protected void onStart() {
Winson Chung5cc62c72019-10-16 11:32:41 -0700998 Object traceToken = TraceHelper.INSTANCE.beginSection(ON_START_EVT,
999 TraceHelper.FLAG_UI_EVENT);
Michael Jurkacd496d72013-04-11 11:32:45 -07001000 super.onStart();
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001001 if (!mDeferOverlayCallbacks) {
1002 mOverlayManager.onActivityStarted(this);
Adam Cohen9211d422014-10-07 18:14:53 -07001003 }
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001004
Sihua Ma0593a0d2022-10-03 16:01:48 -07001005 mAppWidgetHolder.setActivityStarted(true);
Winson Chung5cc62c72019-10-16 11:32:41 -07001006 TraceHelper.INSTANCE.endSection(traceToken);
Michael Jurkacd496d72013-04-11 11:32:45 -07001007 }
1008
Sunny Goyal35e7d382020-05-08 13:37:58 -07001009 @Override
1010 @CallSuper
1011 protected void onDeferredResumed() {
Hyunyoung Song95786e02020-09-15 00:34:10 -07001012 logStopAndResume(true /* isResume */);
Sunny Goyala002c6c2019-02-12 16:20:10 -08001013
Sunny Goyal35e7d382020-05-08 13:37:58 -07001014 // Process any items that were added while Launcher was away.
Sunny Goyal60e68c92020-08-12 13:59:27 -07001015 ItemInstallQueue.INSTANCE.get(this)
1016 .resumeModelPush(FLAG_ACTIVITY_PAUSED);
Sunny Goyale9c6f4c2019-05-30 11:35:25 -07001017
Sunny Goyal35e7d382020-05-08 13:37:58 -07001018 // Refresh shortcuts if the permission changed.
Sunny Goyal8b74cc72020-07-27 17:50:33 -07001019 mModel.validateModelDataOnResume();
Sunny Goyale9c6f4c2019-05-30 11:35:25 -07001020
Sunny Goyal35e7d382020-05-08 13:37:58 -07001021 // Set the notification listener and fetch updated notifications when we resume
Schneider Victor-tulias5173fd82021-10-19 14:47:23 -07001022 NotificationListener.addNotificationsChangedListener(mPopupDataProvider);
Winson Chung87583112019-06-10 14:20:58 -07001023
Sunny Goyal35e7d382020-05-08 13:37:58 -07001024 DiscoveryBounce.showForHomeIfNeeded(this);
Sihua Ma0593a0d2022-10-03 16:01:48 -07001025 mAppWidgetHolder.setActivityResumed(true);
Sunny Goyaldedda052019-05-14 15:23:48 -07001026 }
1027
Hyunyoung Song95786e02020-09-15 00:34:10 -07001028 private void logStopAndResume(boolean isResume) {
Hyunyoung Song77e29772020-08-25 00:53:48 -07001029 if (mPendingExecutor != null) return;
Hyunyoung Song801f81f2020-06-19 02:58:53 -07001030 int pageIndex = mWorkspace.isOverlayShown() ? -1 : mWorkspace.getCurrentPage();
Hyunyoung Song95786e02020-09-15 00:34:10 -07001031 int statsLogOrdinal = mStateManager.getState().statsLogOrdinal;
Hyunyoung Song801f81f2020-06-19 02:58:53 -07001032
1033 StatsLogManager.EventEnum event;
1034 StatsLogManager.StatsLogger logger = getStatsLogManager().logger();
Hyunyoung Song95786e02020-09-15 00:34:10 -07001035 if (isResume) {
Hyunyoung Song801f81f2020-06-19 02:58:53 -07001036 logger.withSrcState(LAUNCHER_STATE_BACKGROUND)
Hyunyoung Song95786e02020-09-15 00:34:10 -07001037 .withDstState(mStateManager.getState().statsLogOrdinal);
Hyunyoung Song801f81f2020-06-19 02:58:53 -07001038 event = LAUNCHER_ONRESUME;
1039 } else { /* command == Action.Command.STOP */
Hyunyoung Song95786e02020-09-15 00:34:10 -07001040 logger.withSrcState(mStateManager.getState().statsLogOrdinal)
Hyunyoung Song801f81f2020-06-19 02:58:53 -07001041 .withDstState(LAUNCHER_STATE_BACKGROUND);
1042 event = LAUNCHER_ONSTOP;
1043 }
1044
Hyunyoung Song95786e02020-09-15 00:34:10 -07001045 if (statsLogOrdinal == LAUNCHER_STATE_HOME && mWorkspace != null) {
Hyunyoung Song801f81f2020-06-19 02:58:53 -07001046 logger.withContainerInfo(LauncherAtom.ContainerInfo.newBuilder()
1047 .setWorkspace(
1048 LauncherAtom.WorkspaceContainer.newBuilder()
1049 .setPageIndex(pageIndex)).build());
Becky Qiubfc2da12019-08-01 11:09:38 -07001050 }
Hyunyoung Song801f81f2020-06-19 02:58:53 -07001051 logger.log(event);
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001052 }
Becky Qiubfc2da12019-08-01 11:09:38 -07001053
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001054 private void scheduleDeferredCheck() {
1055 mHandler.removeCallbacks(mDeferredOverlayCallbacks);
1056 postAsyncCallback(mHandler, mDeferredOverlayCallbacks);
1057 }
1058
1059 private void checkIfOverlayStillDeferred() {
1060 if (!mDeferOverlayCallbacks) {
1061 return;
1062 }
Sunny Goyal8f965462020-04-23 19:00:36 -07001063 if (isStarted() && (!hasBeenResumed()
1064 || mStateManager.getState().hasFlag(FLAG_NON_INTERACTIVE))) {
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001065 return;
1066 }
1067 mDeferOverlayCallbacks = false;
1068
1069 // Move the client to the correct state. Calling the same method twice is no-op.
1070 if (isStarted()) {
1071 mOverlayManager.onActivityStarted(this);
1072 }
1073 if (hasBeenResumed()) {
1074 mOverlayManager.onActivityResumed(this);
1075 } else {
1076 mOverlayManager.onActivityPaused(this);
1077 }
1078 if (!isStarted()) {
1079 mOverlayManager.onActivityStopped(this);
1080 }
1081 }
1082
1083 public void deferOverlayCallbacksUntilNextResumeOrStop() {
1084 mDeferOverlayCallbacks = true;
1085 }
1086
1087 public LauncherOverlayManager getOverlayManager() {
1088 return mOverlayManager;
Becky Qiubfc2da12019-08-01 11:09:38 -07001089 }
1090
Sunny Goyal35e7d382020-05-08 13:37:58 -07001091 @Override
Winson Chungef528762019-09-06 12:05:52 -07001092 public void onStateSetStart(LauncherState state) {
Sunny Goyal35e7d382020-05-08 13:37:58 -07001093 super.onStateSetStart(state);
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001094 if (mDeferOverlayCallbacks) {
1095 scheduleDeferredCheck();
Sunny Goyale9c6f4c2019-05-30 11:35:25 -07001096 }
Sunny Goyal210e1742019-10-17 12:05:38 -07001097 addActivityFlags(ACTIVITY_STATE_TRANSITION_ACTIVE);
Sunny Goyal8f965462020-04-23 19:00:36 -07001098
Sunny Goyal8f965462020-04-23 19:00:36 -07001099 if (state == SPRING_LOADED) {
1100 // Prevent any Un/InstallShortcutReceivers from updating the db while we are
1101 // not on homescreen
Sunny Goyal60e68c92020-08-12 13:59:27 -07001102 ItemInstallQueue.INSTANCE.get(this).pauseModelPush(FLAG_DRAG_AND_DROP);
Sunny Goyal8f965462020-04-23 19:00:36 -07001103 getRotationHelper().setCurrentStateRequest(REQUEST_LOCK);
1104
1105 mWorkspace.showPageIndicatorAtCurrentScroll();
1106 mWorkspace.setClipChildren(false);
1107 }
1108 // When multiple pages are visible, show persistent page indicator
1109 mWorkspace.getPageIndicator().setShouldAutoHide(!state.hasFlag(FLAG_MULTI_PAGE));
thiruram0eabc782021-04-02 14:30:10 -07001110
thiruramc96873c2021-02-11 15:13:47 -08001111 mPrevLauncherState = mStateManager.getCurrentStableState();
thiruram0eabc782021-04-02 14:30:10 -07001112 if (mPrevLauncherState != state && ALL_APPS.equals(state)
1113 // Making sure mAllAppsSessionLogId is null to avoid double logging.
1114 && mAllAppsSessionLogId == null) {
1115 // creates new instance ID since new all apps session is started.
1116 mAllAppsSessionLogId = new InstanceIdSequence().newInstanceId();
Thiru Ramasamy694407c2022-03-08 12:11:24 -08001117 if (getAllAppsEntryEvent().isPresent()) {
1118 getStatsLogManager().logger()
1119 .withContainerInfo(ContainerInfo.newBuilder()
1120 .setWorkspace(WorkspaceContainer.newBuilder()
1121 .setPageIndex(getWorkspace().getCurrentPage())).build())
1122 .log(getAllAppsEntryEvent().get());
1123 }
thiruram0eabc782021-04-02 14:30:10 -07001124 }
Sunny Goyal1eb11242022-09-09 17:14:45 -07001125 updateDisallowBack();
Sunny Goyaldedda052019-05-14 15:23:48 -07001126 }
1127
Thiru Ramasamy5fbac632022-01-28 15:05:36 -08001128 /**
1129 * Returns {@link EventEnum} that should be logged when Launcher enters into AllApps state.
1130 */
Thiru Ramasamy694407c2022-03-08 12:11:24 -08001131 protected Optional<EventEnum> getAllAppsEntryEvent() {
1132 return Optional.of(FeatureFlags.ENABLE_DEVICE_SEARCH.get()
Thiru Ramasamy5fbac632022-01-28 15:05:36 -08001133 ? LAUNCHER_ALLAPPS_ENTRY_WITH_DEVICE_SEARCH
Thiru Ramasamy694407c2022-03-08 12:11:24 -08001134 : LAUNCHER_ALLAPPS_ENTRY);
Thiru Ramasamy5fbac632022-01-28 15:05:36 -08001135 }
1136
Sunny Goyal35e7d382020-05-08 13:37:58 -07001137 @Override
Winson Chungef528762019-09-06 12:05:52 -07001138 public void onStateSetEnd(LauncherState state) {
Sunny Goyalfee1b252020-12-14 12:30:38 -08001139 super.onStateSetEnd(state);
Sihua Ma0593a0d2022-10-03 16:01:48 -07001140 getAppWidgetHolder().setStateIsNormal(state == LauncherState.NORMAL);
Sunny Goyal8f965462020-04-23 19:00:36 -07001141 getWorkspace().setClipChildren(!state.hasFlag(FLAG_MULTI_PAGE));
1142
Winson Chungef528762019-09-06 12:05:52 -07001143 finishAutoCancelActionMode();
Sunny Goyal210e1742019-10-17 12:05:38 -07001144 removeActivityFlags(ACTIVITY_STATE_TRANSITION_ACTIVE);
Sunny Goyal8f965462020-04-23 19:00:36 -07001145
1146 // dispatch window state changed
1147 getWindow().getDecorView().sendAccessibilityEvent(TYPE_WINDOW_STATE_CHANGED);
1148 AccessibilityManagerCompat.sendStateEventToTest(this, state.ordinal);
1149
1150 if (state == NORMAL) {
1151 // Re-enable any Un/InstallShortcutReceiver and now process any queued items
Sunny Goyal60e68c92020-08-12 13:59:27 -07001152 ItemInstallQueue.INSTANCE.get(this)
1153 .resumeModelPush(FLAG_DRAG_AND_DROP);
Sunny Goyal8f965462020-04-23 19:00:36 -07001154
1155 // Clear any rotation locks when going to normal state
1156 getRotationHelper().setCurrentStateRequest(REQUEST_NONE);
1157 }
thiruramc96873c2021-02-11 15:13:47 -08001158
thiruramea56f842021-06-02 16:02:37 -07001159 if (ALL_APPS.equals(mPrevLauncherState) && !ALL_APPS.equals(state)
thiruram0eabc782021-04-02 14:30:10 -07001160 // Making sure mAllAppsSessionLogId is not null to avoid double logging.
thiruramc96873c2021-02-11 15:13:47 -08001161 && mAllAppsSessionLogId != null) {
Samuel Fuface820f52021-06-18 17:23:48 -05001162 getAppsView().reset(false);
Thiru Ramasamy694407c2022-03-08 12:11:24 -08001163 getAllAppsExitEvent().ifPresent(getStatsLogManager().logger()::log);
thiruramc96873c2021-02-11 15:13:47 -08001164 mAllAppsSessionLogId = null;
1165 }
Winson Chungef528762019-09-06 12:05:52 -07001166 }
1167
Thiru Ramasamy694407c2022-03-08 12:11:24 -08001168 /**
1169 * Returns {@link EventEnum} that should be logged when Launcher exists from AllApps state.
1170 */
1171 protected Optional<EventEnum> getAllAppsExitEvent() {
1172 return Optional.of(LAUNCHER_ALLAPPS_EXIT);
1173 }
1174
Michael Jurkacd496d72013-04-11 11:32:45 -07001175 @Override
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001176 protected void onResume() {
Winson Chung5cc62c72019-10-16 11:32:41 -07001177 Object traceToken = TraceHelper.INSTANCE.beginSection(ON_RESUME_EVT,
1178 TraceHelper.FLAG_UI_EVENT);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001179 super.onResume();
Sunny Goyalfca6bc92017-09-28 16:28:34 -07001180
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001181 if (mDeferOverlayCallbacks) {
1182 scheduleDeferredCheck();
1183 } else {
1184 mOverlayManager.onActivityResumed(this);
Adam Cohen9211d422014-10-07 18:14:53 -07001185 }
Mario Bertschler0fc6f682017-02-17 12:16:13 -08001186
Jon Mirandaa82a7dc2022-05-10 11:48:32 -07001187 DragView.removeAllViews(this);
Winson Chung5cc62c72019-10-16 11:32:41 -07001188 TraceHelper.INSTANCE.endSection(traceToken);
Adam Cohen06dff352012-06-01 17:17:08 -07001189 }
1190
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001191 @Override
The Android Open Source Project7376fae2009-03-11 12:11:58 -07001192 protected void onPause() {
Winson Chung997a9232013-07-24 15:33:46 -07001193 // Ensure that items added to Launcher are queued until Launcher returns
Sunny Goyal60e68c92020-08-12 13:59:27 -07001194 ItemInstallQueue.INSTANCE.get(this).pauseModelPush(FLAG_ACTIVITY_PAUSED);
Winson Chung997a9232013-07-24 15:33:46 -07001195
The Android Open Source Project7376fae2009-03-11 12:11:58 -07001196 super.onPause();
Joe Onorato24b6fd82009-11-12 13:47:09 -08001197 mDragController.cancelDrag();
Sunny Goyal9b180102020-03-11 10:02:29 -07001198 mLastTouchUpTime = -1;
Hyunyoung Song497708c2019-05-01 16:16:53 -07001199 mDropTargetBar.animateToVisibility(false);
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001200
1201 if (!mDeferOverlayCallbacks) {
1202 mOverlayManager.onActivityPaused(this);
Adam Cohenbffe7452013-07-22 18:21:45 -07001203 }
Sihua Ma0593a0d2022-10-03 16:01:48 -07001204 mAppWidgetHolder.setActivityResumed(false);
Adam Cohenbffe7452013-07-22 18:21:45 -07001205 }
1206
Lucas Dupin87d75202021-07-28 10:24:54 -07001207 /**
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001208 * Restores the previous state, if it exists.
1209 *
1210 * @param savedState The previous state.
1211 */
1212 private void restoreState(Bundle savedState) {
1213 if (savedState == null) {
1214 return;
1215 }
1216
Sunny Goyal3e3f44c2017-10-23 17:14:52 -07001217 int stateOrdinal = savedState.getInt(RUNTIME_STATE, NORMAL.ordinal);
Sunny Goyalf9403d92017-10-18 10:55:56 -07001218 LauncherState[] stateValues = LauncherState.values();
1219 LauncherState state = stateValues[stateOrdinal];
Sunny Goyal6c0c61a2020-12-08 19:19:56 -08001220
1221 NonConfigInstance lastInstance = (NonConfigInstance) getLastNonConfigurationInstance();
1222 boolean forceRestore = lastInstance != null
1223 && (lastInstance.config.diff(mOldConfig) & CONFIG_UI_MODE) != 0;
1224 if (forceRestore || !state.shouldDisableRestore()) {
Sunny Goyal3e3f44c2017-10-23 17:14:52 -07001225 mStateManager.goToState(state, false /* animated */);
Joe Onorato3a8820b2009-11-10 15:06:42 -08001226 }
1227
Samuel Fufaca37b8a2019-08-19 17:04:36 -07001228 PendingRequestArgs requestArgs = savedState.getParcelable(
1229 RUNTIME_STATE_PENDING_REQUEST_ARGS);
Sunny Goyal2100c782016-08-22 16:00:03 -07001230 if (requestArgs != null) {
1231 setWaitingForResult(requestArgs);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001232 }
Sunny Goyaldedda052019-05-14 15:23:48 -07001233 mPendingActivityRequestCode = savedState.getInt(RUNTIME_STATE_PENDING_REQUEST_CODE);
Sunny Goyal2100c782016-08-22 16:00:03 -07001234
1235 mPendingActivityResult = savedState.getParcelable(RUNTIME_STATE_PENDING_ACTIVITY_RESULT);
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -07001236
1237 SparseArray<Parcelable> widgetsState =
1238 savedState.getSparseParcelableArray(RUNTIME_STATE_WIDGET_PANEL);
1239 if (widgetsState != null) {
1240 WidgetsFullSheet.show(this, false).restoreHierarchyState(widgetsState);
1241 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001242 }
1243
1244 /**
1245 * Finds all the views we need and configure them properly.
1246 */
Tony Wickham04fca162020-02-05 15:06:52 -08001247 protected void setupViews() {
Becky Qiu3aec5d52022-09-16 11:17:50 -07001248 inflateRootView(R.layout.launcher);
Sunny Goyalcc96aa12018-01-11 09:56:07 -08001249 mDragLayer = findViewById(R.id.drag_layer);
Sunny Goyal3333b0c2016-05-09 20:43:21 -07001250 mFocusHandler = mDragLayer.getFocusIndicatorHelper();
Sunny Goyal966d9012017-06-06 16:43:59 -07001251 mWorkspace = mDragLayer.findViewById(R.id.workspace);
Sunny Goyald0a6ae72016-06-16 12:29:03 -07001252 mWorkspace.initParentViews(mDragLayer);
Sreyas321bfae2020-02-21 17:53:02 -08001253 mOverviewPanel = findViewById(R.id.overview_panel);
Sunny Goyal7c7be8c2018-03-07 19:58:07 -08001254 mHotseat = findViewById(R.id.hotseat);
Adam Cohenb66675a2020-05-15 16:16:17 -07001255 mHotseat.setWorkspace(mWorkspace);
Craig Mautner360310b2012-10-26 15:13:08 -07001256
Winson Chung4c98d922011-05-31 16:50:48 -07001257 // Setup the drag layer
Sunny Goyal5d1873a2018-05-08 11:10:44 -07001258 mDragLayer.setup(mDragController, mWorkspace);
Winson Chung4c98d922011-05-31 16:50:48 -07001259
Hyunyoung Song645764e2016-06-06 14:19:02 -07001260 mWorkspace.setup(mDragController);
Winsonc7d2e832016-07-28 12:24:55 -07001261 // Until the workspace is bound, ensure that we keep the wallpaper offset locked to the
1262 // default state, otherwise we will update to the wrong offsets in RTL
1263 mWorkspace.lockWallpaperToDefaultPage();
Sunny Goyalbb030562021-07-19 16:28:39 -07001264 mWorkspace.bindAndInitFirstWorkspaceScreen();
Hyunyoung Song645764e2016-06-06 14:19:02 -07001265 mDragController.addDragListener(mWorkspace);
Winson Chung4c98d922011-05-31 16:50:48 -07001266
Tony Wickham34d2c912015-09-11 09:27:58 -07001267 // Get the search/delete/uninstall bar
Rajeev Kumar43c0f582017-06-23 15:34:55 -07001268 mDropTargetBar = mDragLayer.findViewById(R.id.drop_target_bar);
Patrick Dubroy3ec8bdd2010-08-06 16:01:33 -07001269
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -07001270 // Setup Apps
1271 mAppsView = findViewById(R.id.apps_view);
Craig Mautner360310b2012-10-26 15:13:08 -07001272
Govinda Wassermanc06e1512019-04-09 09:56:53 -04001273 // Setup Scrim
1274 mScrimView = findViewById(R.id.scrim_view);
1275
Winson Chung3d503fb2011-07-13 17:25:49 -07001276 // Setup the drag controller (drop targets have to be added in reverse order in priority)
Sunny Goyal47328fd2016-05-25 18:56:41 -07001277 mDropTargetBar.setup(mDragController);
Samuel Fufaacebd1f2021-05-06 10:02:03 -05001278 mAllAppsController.setupViews(mScrimView, mAppsView);
Federico Baron3f255eb2022-12-22 14:40:58 -08001279
1280 if (SHOW_DOT_PAGINATION.get()) {
1281 mWorkspace.getPageIndicator().setShouldAutoHide(true);
1282 mWorkspace.getPageIndicator().setPaintColor(
1283 Themes.getAttrBoolean(this, R.attr.isWorkspaceDarkText)
1284 ? Color.BLACK
1285 : Color.WHITE);
1286 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001287 }
1288
Federico Baron7539d762022-09-29 09:47:04 -07001289 @Override
1290 public View onCreateView(View parent, String name, Context context, AttributeSet attrs) {
Federico Baron3f255eb2022-12-22 14:40:58 -08001291 if (SHOW_DOT_PAGINATION.get() && WorkspacePageIndicator.class.getName().equals(name)) {
Federico Baron7539d762022-09-29 09:47:04 -07001292 return LayoutInflater.from(context).inflate(R.layout.page_indicator_dots,
1293 (ViewGroup) parent, false);
1294 }
1295 return super.onCreateView(parent, name, context, attrs);
1296 }
1297
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001298 /**
1299 * Creates a view representing a shortcut.
1300 *
1301 * @param info The data structure describing the shortcut.
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001302 */
Sunny Goyal95899162019-03-27 16:03:06 -07001303 View createShortcut(WorkspaceItemInfo info) {
Schneider Victor-tulias9f922d32022-04-27 16:39:29 -07001304 // This can be called before PagedView#pageScrollsInitialized returns true, so use the
1305 // first page, which we always assume to be present.
1306 return createShortcut((ViewGroup) mWorkspace.getChildAt(0), info);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001307 }
1308
1309 /**
1310 * Creates a view representing a shortcut inflated from the specified resource.
1311 *
Schneider Victor-tulias9f922d32022-04-27 16:39:29 -07001312 * @param parent The group the shortcut belongs to. This is not necessarily the group where
1313 * the shortcut should be added.
Samuel Fufaca37b8a2019-08-19 17:04:36 -07001314 * @param info The data structure describing the shortcut.
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001315 * @return A View inflated from layoutResId.
1316 */
Sunny Goyal95899162019-03-27 16:03:06 -07001317 public View createShortcut(ViewGroup parent, WorkspaceItemInfo info) {
Sunny Goyal9b29ca52017-02-17 10:39:44 -08001318 BubbleTextView favorite = (BubbleTextView) LayoutInflater.from(parent.getContext())
1319 .inflate(R.layout.app_icon, parent, false);
Sunny Goyal95899162019-03-27 16:03:06 -07001320 favorite.applyFromWorkspaceItem(info);
Tracy Zhouba0b5952022-10-14 01:28:07 -07001321 favorite.setOnClickListener(getItemOnClickListener());
Sunny Goyaldcbcc862014-08-12 15:58:36 -07001322 favorite.setOnFocusChangeListener(mFocusHandler);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001323 return favorite;
1324 }
1325
1326 /**
Jon Mirandac476d6e2017-05-04 16:30:01 -07001327 * Add a shortcut to the workspace or to a Folder.
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001328 *
1329 * @param data The intent describing the shortcut.
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001330 */
sfufa@google.comd0a33232021-09-19 15:59:36 -07001331 protected void completeAddShortcut(Intent data, int container, int screenId, int cellX,
Sunny Goyalfb5096d2016-09-08 14:32:06 -07001332 int cellY, PendingRequestArgs args) {
Pinyao Ting5eee5f42019-10-31 16:47:35 -07001333 if (args.getRequestCode() != REQUEST_CREATE_SHORTCUT
Jon Mirandac476d6e2017-05-04 16:30:01 -07001334 || args.getPendingIntent().getComponent() == null) {
Sunny Goyalfb5096d2016-09-08 14:32:06 -07001335 return;
1336 }
Adam Cohen558baaf2011-08-15 15:22:57 -07001337
Jon Mirandac476d6e2017-05-04 16:30:01 -07001338 int[] cellXY = mTmpAddItemCellCoordinates;
1339 CellLayout layout = getCellLayout(container, screenId);
1340
Sunny Goyaleaf7a952020-07-29 16:54:20 -07001341 WorkspaceItemInfo info = PinRequestHelper.createWorkspaceItemFromPinItemRequest(
Sunny Goyale7b00122019-10-02 16:13:34 -07001342 this, PinRequestHelper.getPinItemRequest(data), 0);
Sunny Goyal782f0c92017-01-19 10:27:54 -08001343
1344 if (info == null) {
Sunny Goyalb57645f2017-03-20 13:57:28 -07001345 // Legacy shortcuts are only supported for primary profile.
1346 info = Process.myUserHandle().equals(args.user)
Sunny Goyal53116c62020-08-07 16:32:18 -07001347 ? ModelUtils.fromLegacyShortcutIntent(this, data) : null;
Sunny Goyal782f0c92017-01-19 10:27:54 -08001348
Sunny Goyalb57645f2017-03-20 13:57:28 -07001349 if (info == null) {
1350 Log.e(TAG, "Unable to parse a valid custom shortcut result");
1351 return;
1352 } else if (!new PackageManagerHelper(this).hasPermissionForActivity(
Sunny Goyal342e4662017-02-02 15:21:08 -08001353 info.intent, args.getPendingIntent().getComponent().getPackageName())) {
Sunny Goyal782f0c92017-01-19 10:27:54 -08001354 // The app is trying to add a shortcut without sufficient permissions
1355 Log.e(TAG, "Ignoring malicious intent " + info.intent.toUri(0));
1356 return;
1357 }
1358 }
1359
Jon Mirandac476d6e2017-05-04 16:30:01 -07001360 if (container < 0) {
1361 // Adding a shortcut to the Workspace.
1362 final View view = createShortcut(info);
1363 boolean foundCellSpan = false;
1364 // First we check if we already know the exact location where we want to add this item.
1365 if (cellX >= 0 && cellY >= 0) {
1366 cellXY[0] = cellX;
1367 cellXY[1] = cellY;
1368 foundCellSpan = true;
Adam Cohen558baaf2011-08-15 15:22:57 -07001369
Hyunyoung Song1ae42422020-01-26 23:25:14 -08001370 DragObject dragObject = new DragObject(getApplicationContext());
1371 dragObject.dragInfo = info;
Jon Mirandac476d6e2017-05-04 16:30:01 -07001372 // If appropriate, either create a folder or add to an existing folder
1373 if (mWorkspace.createUserFolderIfNecessary(view, container, layout, cellXY, 0,
Hyunyoung Song1ae42422020-01-26 23:25:14 -08001374 true, dragObject)) {
Jon Mirandac476d6e2017-05-04 16:30:01 -07001375 return;
1376 }
Jon Mirandac476d6e2017-05-04 16:30:01 -07001377 if (mWorkspace.addToExistingFolderIfNecessary(view, layout, cellXY, 0, dragObject,
1378 true)) {
1379 return;
1380 }
1381 } else {
1382 foundCellSpan = layout.findCellForSpan(cellXY, 1, 1);
1383 }
1384
1385 if (!foundCellSpan) {
Yogisha Dixit104d09f2021-07-19 14:05:17 +01001386 mWorkspace.onNoCellFound(layout, info, /* logInstanceId= */ null);
Adam Cohen558baaf2011-08-15 15:22:57 -07001387 return;
1388 }
Jon Mirandac476d6e2017-05-04 16:30:01 -07001389
1390 getModelWriter().addItemToDatabase(info, container, screenId, cellXY[0], cellXY[1]);
1391 mWorkspace.addInScreen(view, info);
Michael Jurkad3ef3062010-11-23 16:23:58 -08001392 } else {
Jon Mirandac476d6e2017-05-04 16:30:01 -07001393 // Adding a shortcut to a Folder.
Sunny Goyale29897f52017-07-20 10:09:42 -07001394 FolderIcon folderIcon = findFolderIcon(container);
Jon Mirandac476d6e2017-05-04 16:30:01 -07001395 if (folderIcon != null) {
1396 FolderInfo folderInfo = (FolderInfo) folderIcon.getTag();
1397 folderInfo.add(info, args.rank, false);
1398 } else {
Sunny Goyale29897f52017-07-20 10:09:42 -07001399 Log.e(TAG, "Could not find folder with id " + container + " to add shortcut.");
Jon Mirandac476d6e2017-05-04 16:30:01 -07001400 }
Michael Jurka0280c3b2010-09-17 15:00:07 -07001401 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001402 }
1403
Tony Wickhamc7cbf252021-05-24 15:46:48 -07001404 @Override
1405 public @Nullable FolderIcon findFolderIcon(final int folderIconId) {
Sunny Goyal83fd25e2018-07-09 16:47:01 -07001406 return (FolderIcon) mWorkspace.getHomescreenIconByItemId(folderIconId);
Sunny Goyale29897f52017-07-20 10:09:42 -07001407 }
1408
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001409 /**
The Android Open Source Project7376fae2009-03-11 12:11:58 -07001410 * Add a widget to the workspace.
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001411 *
Romain Guy5bbc91b2010-08-18 11:38:46 -07001412 * @param appWidgetId The app widget id
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001413 */
Samuel Fufaca37b8a2019-08-19 17:04:36 -07001414 @Thunk
1415 void completeAddAppWidget(int appWidgetId, ItemInfo itemInfo,
Adam Cohen59400422014-03-05 18:07:04 -08001416 AppWidgetHostView hostView, LauncherAppWidgetProviderInfo appWidgetInfo) {
1417
Adam Cohened66b2b2012-01-23 17:28:51 -08001418 if (appWidgetInfo == null) {
Sunny Goyal2e1efb42016-03-03 16:58:55 -08001419 appWidgetInfo = mAppWidgetManager.getLauncherAppWidgetInfo(appWidgetId);
Adam Cohened66b2b2012-01-23 17:28:51 -08001420 }
Romain Guycbb89e42009-06-08 15:52:54 -07001421
Yogisha Dixit0b15c7e2021-05-10 12:01:58 +01001422 if (hostView == null) {
1423 // Perform actual inflation because we're live
Sihua Ma0593a0d2022-10-03 16:01:48 -07001424 hostView = mAppWidgetHolder.createView(this, appWidgetId, appWidgetInfo);
Yogisha Dixit0b15c7e2021-05-10 12:01:58 +01001425 }
1426
Adam Cohen59400422014-03-05 18:07:04 -08001427 LauncherAppWidgetInfo launcherInfo;
Yogisha Dixit0b15c7e2021-05-10 12:01:58 +01001428 launcherInfo =
1429 new LauncherAppWidgetInfo(
1430 appWidgetId, appWidgetInfo.provider, appWidgetInfo, hostView);
Sunny Goyal2100c782016-08-22 16:00:03 -07001431 launcherInfo.spanX = itemInfo.spanX;
1432 launcherInfo.spanY = itemInfo.spanY;
1433 launcherInfo.minSpanX = itemInfo.minSpanX;
1434 launcherInfo.minSpanY = itemInfo.minSpanY;
Sunny Goyal952e63d2017-08-16 04:59:08 -07001435 launcherInfo.user = appWidgetInfo.getProfile();
Yogisha Dixit658c5da2021-05-24 23:23:15 +01001436 if (itemInfo instanceof PendingAddWidgetInfo) {
1437 launcherInfo.sourceContainer = ((PendingAddWidgetInfo) itemInfo).sourceContainer;
1438 } else if (itemInfo instanceof PendingRequestArgs) {
1439 launcherInfo.sourceContainer =
1440 ((PendingRequestArgs) itemInfo).getWidgetSourceContainer();
1441 }
Romain Guycbb89e42009-06-08 15:52:54 -07001442
Sunny Goyal43bf11d2017-02-02 13:52:53 -08001443 getModelWriter().addItemToDatabase(launcherInfo,
Sunny Goyal2100c782016-08-22 16:00:03 -07001444 itemInfo.container, itemInfo.screenId, itemInfo.cellX, itemInfo.cellY);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001445
Sunny Goyal2100c782016-08-22 16:00:03 -07001446 hostView.setVisibility(View.VISIBLE);
Sunny Goyald5462aa2016-11-22 16:52:39 +05301447 prepareAppWidget(hostView, launcherInfo);
1448 mWorkspace.addInScreen(hostView, launcherInfo);
Pinyao Tingc9074272019-11-11 11:51:44 -08001449 announceForAccessibility(R.string.item_added_to_workspace);
Yogisha Dixit037a5362021-03-22 14:13:03 +00001450
1451 // Show the widget resize frame.
1452 if (hostView instanceof LauncherAppWidgetHostView) {
1453 final LauncherAppWidgetHostView launcherHostView = (LauncherAppWidgetHostView) hostView;
1454 CellLayout cellLayout = getCellLayout(launcherInfo.container, launcherInfo.screenId);
1455 if (mStateManager.getState() == NORMAL) {
Yogisha Dixit7b1d25b2021-10-14 13:06:40 +01001456 AppWidgetResizeFrame.showForWidget(launcherHostView, cellLayout);
Yogisha Dixit037a5362021-03-22 14:13:03 +00001457 } else {
1458 mStateManager.addStateListener(new StateManager.StateListener<LauncherState>() {
1459 @Override
1460 public void onStateTransitionComplete(LauncherState finalState) {
1461 if (mPrevLauncherState == SPRING_LOADED && finalState == NORMAL) {
1462 AppWidgetResizeFrame.showForWidget(launcherHostView, cellLayout);
1463 mStateManager.removeStateListener(this);
1464 }
1465 }
1466 });
1467 }
1468 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001469 }
Romain Guycbb89e42009-06-08 15:52:54 -07001470
Sunny Goyald5462aa2016-11-22 16:52:39 +05301471 private void prepareAppWidget(AppWidgetHostView hostView, LauncherAppWidgetInfo item) {
Sunny Goyal87af0fd2016-05-16 14:56:02 -07001472 hostView.setTag(item);
1473 item.onBindAppWidget(this, hostView);
Sunny Goyal87af0fd2016-05-16 14:56:02 -07001474 hostView.setFocusable(true);
1475 hostView.setOnFocusChangeListener(mFocusHandler);
Sunny Goyal25c2e3e2015-10-28 23:28:21 -07001476 }
1477
Sunny Goyala992ac92023-01-10 17:50:32 -08001478 private final ScreenOnListener mScreenOnListener = this::onScreenOnChanged;
Adam Cohended9f8d2010-11-03 13:25:16 -07001479
Sunny Goyal9c2b9602020-01-07 13:07:55 -08001480 private void updateNotificationDots(Predicate<PackageUserKey> updatedDots) {
Tony Wickhamf34bee82018-12-03 18:11:39 -08001481 mWorkspace.updateNotificationDots(updatedDots);
1482 mAppsView.getAppsStore().updateNotificationDots(updatedDots);
Tony Wickham010d2552017-01-20 08:15:28 -08001483 }
1484
Adam Cohended9f8d2010-11-03 13:25:16 -07001485 @Override
1486 public void onAttachedToWindow() {
1487 super.onAttachedToWindow();
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001488 mOverlayManager.onAttachedToWindow();
Adam Cohended9f8d2010-11-03 13:25:16 -07001489 }
1490
1491 @Override
1492 public void onDetachedFromWindow() {
1493 super.onDetachedFromWindow();
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001494 mOverlayManager.onDetachedFromWindow();
1495 closeContextMenu();
Adam Cohended9f8d2010-11-03 13:25:16 -07001496 }
1497
Schneider Victor-tulias25ecae12020-09-14 14:07:38 -07001498 @Override
1499 public Object onRetainNonConfigurationInstance() {
Sunny Goyal6c0c61a2020-12-08 19:19:56 -08001500 NonConfigInstance instance = new NonConfigInstance();
1501 instance.config = new Configuration(mOldConfig);
1502
Schneider Victor-tulias25ecae12020-09-14 14:07:38 -07001503 int width = mDragLayer.getWidth();
1504 int height = mDragLayer.getHeight();
1505
Schneider Victor-tulias5aad9d82020-12-15 10:47:44 -05001506 if (FeatureFlags.ENABLE_LAUNCHER_ACTIVITY_THEME_CROSSFADE.get()
1507 && width > 0
1508 && height > 0) {
Sunny Goyal6c0c61a2020-12-08 19:19:56 -08001509 instance.snapshot =
1510 BitmapRenderer.createHardwareBitmap(width, height, mDragLayer::draw);
Schneider Victor-tulias25ecae12020-09-14 14:07:38 -07001511 }
Sunny Goyal6c0c61a2020-12-08 19:19:56 -08001512 return instance;
Schneider Victor-tulias25ecae12020-09-14 14:07:38 -07001513 }
1514
Sunny Goyalc4fa8c32017-11-07 12:23:58 -08001515 public AllAppsTransitionController getAllAppsController() {
1516 return mAllAppsController;
1517 }
1518
Sunny Goyal9d69c8d2018-03-19 13:41:31 -07001519 @Override
Winson Chunga6945242014-01-08 14:04:34 -08001520 public DragLayer getDragLayer() {
1521 return mDragLayer;
1522 }
1523
Brian Isganitis1664c9f2022-01-14 23:15:47 -05001524 @Override
1525 public ActivityAllAppsContainerView<Launcher> getAppsView() {
Winson Chungb745afb2015-03-02 11:51:23 -08001526 return mAppsView;
1527 }
1528
Shikha Malhotra0f2e1b62022-03-27 21:02:21 +00001529 public Workspace<?> getWorkspace() {
Winson Chunga6945242014-01-08 14:04:34 -08001530 return mWorkspace;
1531 }
1532
1533 public Hotseat getHotseat() {
1534 return mHotseat;
1535 }
1536
Sunny Goyal7c7be8c2018-03-07 19:58:07 -08001537 public <T extends View> T getOverviewPanel() {
Winson Chung8ae41982017-11-10 11:42:13 -08001538 return (T) mOverviewPanel;
Winson Chunga6945242014-01-08 14:04:34 -08001539 }
1540
Sunny Goyal47328fd2016-05-25 18:56:41 -07001541 public DropTargetBar getDropTargetBar() {
1542 return mDropTargetBar;
Tony Wickham34d2c912015-09-11 09:27:58 -07001543 }
1544
Tony Wickhamb4821882021-04-23 14:26:45 -07001545 @Override
Tony Wickham490a8ab2020-04-01 17:03:58 -07001546 public ScrimView getScrimView() {
1547 return mScrimView;
1548 }
1549
Sihua Ma0593a0d2022-10-03 16:01:48 -07001550 public LauncherWidgetHolder getAppWidgetHolder() {
1551 return mAppWidgetHolder;
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001552 }
Romain Guycbb89e42009-06-08 15:52:54 -07001553
Sihua Ma0593a0d2022-10-03 16:01:48 -07001554 protected LauncherWidgetHolder createAppWidgetHolder() {
Sihua Ma1db8bc22022-11-08 17:13:13 -08001555 return LauncherWidgetHolder.HolderFactory.newFactory(this).newInstance(
1556 this, appWidgetId -> getWorkspace().removeWidget(appWidgetId));
Cyrus Boadway0d309db2021-04-14 12:29:14 +00001557 }
1558
Winson Chunga9abd0e2010-10-27 17:18:37 -07001559 public LauncherModel getModel() {
1560 return mModel;
1561 }
1562
Sunny Goyal43bf11d2017-02-02 13:52:53 -08001563 public ModelWriter getModelWriter() {
1564 return mModelWriter;
1565 }
1566
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001567 @Override
Adam Cohen79d90c52016-04-22 13:29:20 -07001568 public SharedPreferences getSharedPrefs() {
Winson Chunga6945242014-01-08 14:04:34 -08001569 return mSharedPrefs;
1570 }
1571
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001572 @Override
1573 public SharedPreferences getDevicePrefs() {
Stefan Andonian146701c2022-11-10 23:07:40 +00001574 return LauncherPrefs.getDevicePrefs(this);
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001575 }
1576
Samuel Fufaca37b8a2019-08-19 17:04:36 -07001577 public int getOrientation() {
1578 return mOldConfig.orientation;
1579 }
Jon Miranda6bed3502017-09-19 14:43:17 -07001580
Becky Qiu4ed3dfc2022-10-19 16:58:22 -07001581 public BaseSearchConfig getSearchConfig() {
1582 return mBaseSearchConfig;
Luca Zuccarinibda972b2022-10-03 11:48:27 +00001583 }
1584
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001585 @Override
1586 protected void onNewIntent(Intent intent) {
vadimtbaf5fbb2019-12-16 18:56:09 -08001587 if (Utilities.IS_RUNNING_IN_TEST_HARNESS) {
1588 Log.d(TestProtocol.PERMANENT_DIAG_TAG, "Launcher.onNewIntent: " + intent);
1589 }
Winson Chung5cc62c72019-10-16 11:32:41 -07001590 Object traceToken = TraceHelper.INSTANCE.beginSection(ON_NEW_INTENT_EVT);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001591 super.onNewIntent(intent);
1592
Sunny Goyalf4aceab2017-12-06 16:16:31 -08001593 boolean alreadyOnHome = hasWindowFocus() && ((intent.getFlags() &
Winson15f8b172015-08-19 11:02:39 -07001594 Intent.FLAG_ACTIVITY_BROUGHT_TO_FRONT)
1595 != Intent.FLAG_ACTIVITY_BROUGHT_TO_FRONT);
Sunny Goyal85313732016-09-28 12:00:07 -07001596
1597 // Check this condition before handling isActionMain, as this will get reset.
Sunny Goyal3e3f44c2017-10-23 17:14:52 -07001598 boolean shouldMoveToDefaultScreen = alreadyOnHome && isInState(NORMAL)
Sunny Goyalf9403d92017-10-18 10:55:56 -07001599 && AbstractFloatingView.getTopOpenView(this) == null;
Winson15f8b172015-08-19 11:02:39 -07001600 boolean isActionMain = Intent.ACTION_MAIN.equals(intent.getAction());
Winson Chung1c2d5222021-06-08 11:50:13 -07001601 boolean internalStateHandled = ACTIVITY_TRACKER.handleNewIntent(this);
kholoud mohamedceec31b2022-02-03 15:44:25 +00001602
Winson15f8b172015-08-19 11:02:39 -07001603 if (isActionMain) {
Sunny Goyald3864fa2017-11-14 15:06:36 -08001604 if (!internalStateHandled) {
Sunny Goyald3864fa2017-11-14 15:06:36 -08001605 // In all these cases, only animate if we're already on home
Andy Wickham65ced1b2020-03-07 02:14:19 +00001606 closeOpenViews(isStarted());
Jon Mirandafeba90f2016-10-06 10:53:29 -07001607
Sunny Goyala2467272018-03-16 14:53:05 -07001608 if (!isInState(NORMAL)) {
1609 // Only change state, if not already the same. This prevents cancelling any
1610 // animations running as part of resume
Sunny Goyalfee1b252020-12-14 12:30:38 -08001611 mStateManager.goToState(NORMAL, mStateManager.shouldAnimateStateChange());
Sunny Goyala2467272018-03-16 14:53:05 -07001612 }
Sunny Goyald3864fa2017-11-14 15:06:36 -08001613
1614 // Reset the apps view
Sunny Goyal5d1873a2018-05-08 11:10:44 -07001615 if (!alreadyOnHome) {
Sunny Goyal7185dd62018-03-14 17:51:49 -07001616 mAppsView.reset(isStarted() /* animate */);
Sunny Goyald3864fa2017-11-14 15:06:36 -08001617 }
1618
Sunny Goyalaad33592018-08-07 17:20:35 -07001619 if (shouldMoveToDefaultScreen && !mWorkspace.isHandlingTouch()) {
Sunny Goyald3864fa2017-11-14 15:06:36 -08001620 mWorkspace.post(mWorkspace::moveToDefaultScreen);
1621 }
1622 }
Adam Cohen6fecd412013-10-02 17:41:50 -07001623
Adam Cohen9211d422014-10-07 18:14:53 -07001624 if (mLauncherCallbacks != null) {
Sunny Goyal85462132018-04-24 11:39:37 -07001625 mLauncherCallbacks.onHomeIntent(internalStateHandled);
Adam Cohen9211d422014-10-07 18:14:53 -07001626 }
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001627 mOverlayManager.hideOverlay(isStarted() && !isForceInvisible());
Sunny Goyal30ac97d2020-06-24 23:47:46 -07001628 handleGestureContract(intent);
Sunny Goyal512a2c12020-04-08 12:52:45 -07001629 } else if (Intent.ACTION_ALL_APPS.equals(intent.getAction())) {
Winson Chungdd15ace2020-08-04 15:52:01 -07001630 showAllAppsFromIntent(alreadyOnHome);
kholoud mohamedceec31b2022-02-03 15:44:25 +00001631 } else if (Intent.ACTION_SHOW_WORK_APPS.equals(intent.getAction())) {
1632 showAllAppsWorkTabFromIntent(alreadyOnHome);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001633 }
Winson15f8b172015-08-19 11:02:39 -07001634
Winson Chung5cc62c72019-10-16 11:32:41 -07001635 TraceHelper.INSTANCE.endSection(traceToken);
Adam Coppa120b8e2013-11-12 16:26:04 +00001636 }
1637
Winson Chungdd15ace2020-08-04 15:52:01 -07001638 protected void showAllAppsFromIntent(boolean alreadyOnHome) {
1639 AbstractFloatingView.closeAllOpenViews(this);
1640 getStateManager().goToState(ALL_APPS, alreadyOnHome);
1641 }
1642
kholoud mohamedceec31b2022-02-03 15:44:25 +00001643 private void showAllAppsWorkTabFromIntent(boolean alreadyOnHome) {
1644 showAllAppsFromIntent(alreadyOnHome);
1645 mAppsView.switchToTab(BaseAllAppsContainerView.AdapterHolder.WORK);
1646 }
1647
Sunny Goyaldeb91c42020-03-24 02:17:59 -07001648 /**
Sunny Goyal30ac97d2020-06-24 23:47:46 -07001649 * Handles gesture nav contract
1650 */
1651 protected void handleGestureContract(Intent intent) {
1652 GestureNavContract gnc = GestureNavContract.fromIntent(intent);
1653 if (gnc != null) {
1654 AbstractFloatingView.closeOpenViews(this, false, TYPE_ICON_SURFACE);
1655 FloatingSurfaceView.show(this, gnc);
1656 }
1657 }
1658
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001659 @Override
Adam Cohen1462de32012-07-24 22:34:36 -07001660 public void onRestoreInstanceState(Bundle state) {
1661 super.onRestoreInstanceState(state);
Andras Kloczl55edfe52021-05-14 12:21:30 +02001662 if (mSynchronouslyBoundPages != null) {
Sunny Goyal12e3f1f2021-07-15 14:31:58 -07001663 mSynchronouslyBoundPages.forEach(screenId -> {
1664 int pageIndex = mWorkspace.getPageIndexForScreenId(screenId);
1665 if (pageIndex != PagedView.INVALID_PAGE) {
1666 mWorkspace.restoreInstanceStateForChild(pageIndex);
1667 }
1668 });
Andras Kloczl55edfe52021-05-14 12:21:30 +02001669 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001670 }
1671
1672 @Override
1673 protected void onSaveInstanceState(Bundle outState) {
Sunny Goyal12e3f1f2021-07-15 14:31:58 -07001674 outState.putIntArray(RUNTIME_STATE_CURRENT_SCREEN_IDS,
1675 mWorkspace.getCurrentPageScreenIds().getArray().toArray());
Sunny Goyalea609262017-10-25 15:47:38 -07001676 outState.putInt(RUNTIME_STATE, mStateManager.getState().ordinal);
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -07001677
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -07001678 AbstractFloatingView widgets = AbstractFloatingView
1679 .getOpenView(this, AbstractFloatingView.TYPE_WIDGETS_FULL_SHEET);
1680 if (widgets != null) {
1681 SparseArray<Parcelable> widgetsState = new SparseArray<>();
1682 widgets.saveHierarchyState(widgetsState);
1683 outState.putSparseParcelableArray(RUNTIME_STATE_WIDGET_PANEL, widgetsState);
1684 } else {
1685 outState.remove(RUNTIME_STATE_WIDGET_PANEL);
1686 }
1687
Federico Baron8bf1bca2022-09-27 16:19:11 -07001688 // We close any open folders and shortcut containers that are not safe for rebind,
1689 // and we need to make sure this state is reflected.
1690 AbstractFloatingView.closeAllOpenViewsExcept(
1691 this, isStarted() && !isForceInvisible(), TYPE_REBIND_SAFE);
Pinyao Tinga74b63a2019-07-17 23:26:06 -07001692 finishAutoCancelActionMode();
Tony Wickham49c8d292016-07-01 11:44:34 -07001693
Sunny Goyal2100c782016-08-22 16:00:03 -07001694 if (mPendingRequestArgs != null) {
1695 outState.putParcelable(RUNTIME_STATE_PENDING_REQUEST_ARGS, mPendingRequestArgs);
1696 }
Sunny Goyaldedda052019-05-14 15:23:48 -07001697 outState.putInt(RUNTIME_STATE_PENDING_REQUEST_CODE, mPendingActivityRequestCode);
1698
Sunny Goyal2100c782016-08-22 16:00:03 -07001699 if (mPendingActivityResult != null) {
1700 outState.putParcelable(RUNTIME_STATE_PENDING_ACTIVITY_RESULT, mPendingActivityResult);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001701 }
1702
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -07001703 super.onSaveInstanceState(outState);
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001704 mOverlayManager.onActivitySaveInstanceState(this, outState);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001705 }
1706
1707 @Override
1708 public void onDestroy() {
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001709 super.onDestroy();
Sunny Goyale84c5b82019-09-26 17:05:31 -07001710 ACTIVITY_TRACKER.onActivityDestroyed(this);
Romain Guycbb89e42009-06-08 15:52:54 -07001711
Sunny Goyala992ac92023-01-10 17:50:32 -08001712 ScreenOnTracker.INSTANCE.get(this).removeListener(mScreenOnListener);
Sunny Goyalaaf7d1d2016-05-17 13:38:54 -07001713 mWorkspace.removeFolderListeners();
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001714 PluginManagerWrapper.INSTANCE.get(this).removePluginListener(this);
Winson Chunge7a03942011-08-05 15:05:12 -07001715
Sunny Goyala7a5bf32020-01-05 15:35:29 +05301716 mModel.removeCallbacks(this);
Sunny Goyal623eddd2018-03-02 12:24:41 -08001717 mRotationHelper.destroy();
Sunny Goyal745bad92016-05-02 10:54:12 -07001718
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001719 try {
Sihua Ma0593a0d2022-10-03 16:01:48 -07001720 mAppWidgetHolder.stopListening();
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001721 } catch (NullPointerException ex) {
Joe Onoratoa30ce8e2009-11-11 08:16:49 -08001722 Log.w(TAG, "problem while stopping AppWidgetHost during Launcher destruction", ex);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001723 }
Sihua Maaa2b8722022-10-25 15:17:58 -07001724 mAppWidgetHolder.destroy();
Patrick Dubroy2313eff2011-01-11 20:01:31 -08001725
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001726 TextKeyListener.getInstance().release();
Tony2917a8b2017-07-31 23:29:42 -07001727 clearPendingBinds();
Hyunyoung Song31971a32019-01-27 12:31:12 -08001728 LauncherAppState.getIDP(this).removeOnChangeListener(this);
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001729
1730 mOverlayManager.onActivityDestroyed(this);
Samuel Fufa41d909f2020-03-20 16:27:09 -07001731 mUserChangedCallbackCloseable.close();
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001732 }
1733
Sunny Goyalae502842016-06-17 08:43:56 -07001734 public LauncherAccessibilityDelegate getAccessibilityDelegate() {
1735 return mAccessibilityDelegate;
1736 }
1737
Adam Cohena9cf38f2011-05-02 15:36:58 -07001738 public DragController getDragController() {
1739 return mDragController;
1740 }
1741
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001742 @Override
Sunny Goyal0eca4e22016-07-20 11:43:06 -07001743 public void startActivityForResult(Intent intent, int requestCode, Bundle options) {
Sunny Goyaldedda052019-05-14 15:23:48 -07001744 if (requestCode != -1) {
1745 mPendingActivityRequestCode = requestCode;
1746 }
Sunny Goyal210e1742019-10-17 12:05:38 -07001747 super.startActivityForResult(intent, requestCode, options);
Adam Cohen173f7112015-03-27 15:14:00 -07001748 }
1749
1750 @Override
Sunny Goyaldedda052019-05-14 15:23:48 -07001751 public void startIntentSenderForResult(IntentSender intent, int requestCode,
Adam Cohen173f7112015-03-27 15:14:00 -07001752 Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags, Bundle options) {
Sunny Goyaldedda052019-05-14 15:23:48 -07001753 if (requestCode != -1) {
1754 mPendingActivityRequestCode = requestCode;
1755 }
Sunny Goyal210e1742019-10-17 12:05:38 -07001756 try {
1757 super.startIntentSenderForResult(intent, requestCode,
1758 fillInIntent, flagsMask, flagsValues, extraFlags, options);
1759 } catch (IntentSender.SendIntentException e) {
1760 throw new ActivityNotFoundException();
Adam Cohen173f7112015-03-27 15:14:00 -07001761 }
1762 }
1763
Winson Chung70d72102011-08-12 11:24:35 -07001764 /**
1765 * Indicates that we want global search for this activity by setting the globalSearch
1766 * argument for {@link #startSearch} to true.
1767 */
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001768 @Override
Romain Guycbb89e42009-06-08 15:52:54 -07001769 public void startSearch(String initialQuery, boolean selectInitialQuery,
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001770 Bundle appSearchData, boolean globalSearch) {
1771 if (appSearchData == null) {
1772 appSearchData = new Bundle();
Bjorn Bringert32b12d22013-06-06 13:00:41 +01001773 appSearchData.putString("source", "launcher-search");
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001774 }
Sunny Goyalda4fe1a2016-05-26 16:05:17 -07001775
Sunny Goyal6f28e712016-09-13 14:19:29 -07001776 if (mLauncherCallbacks == null ||
1777 !mLauncherCallbacks.startSearch(initialQuery, selectInitialQuery, appSearchData)) {
1778 // Starting search from the callbacks failed. Start the default global search.
Sunny Goyalf4aceab2017-12-06 16:16:31 -08001779 super.startSearch(initialQuery, selectInitialQuery, appSearchData, true);
Ian Parkinson047036e2014-09-01 15:40:53 +01001780 }
Winson Chungcd99cd32015-04-29 11:03:24 -07001781
1782 // We need to show the workspace after starting the search
Sunny Goyal3e3f44c2017-10-23 17:14:52 -07001783 mStateManager.goToState(NORMAL);
Bjorn Bringertc459e522013-06-07 19:36:01 +01001784 }
1785
Joe Onorato9c1289c2009-08-17 11:03:03 -04001786 public boolean isWorkspaceLocked() {
Sunny Goyal2100c782016-08-22 16:00:03 -07001787 return mWorkspaceLoading || mPendingRequestArgs != null;
Joe Onorato9c1289c2009-08-17 11:03:03 -04001788 }
1789
Adam Cohen517a7f52014-03-01 12:12:59 -08001790 public boolean isWorkspaceLoading() {
1791 return mWorkspaceLoading;
1792 }
1793
Brian Isganitis099945b2022-01-31 18:15:00 -05001794 @Override
1795 public boolean isBindingItems() {
1796 return mWorkspaceLoading;
1797 }
1798
Anjali Koppalff7ceff2014-05-01 18:26:37 -07001799 private void setWorkspaceLoading(boolean value) {
Anjali Koppalff7ceff2014-05-01 18:26:37 -07001800 mWorkspaceLoading = value;
Anjali Koppalff7ceff2014-05-01 18:26:37 -07001801 }
1802
Sunny Goyal04a324a2017-01-20 21:08:59 -08001803 public void setWaitingForResult(PendingRequestArgs args) {
Sunny Goyal2100c782016-08-22 16:00:03 -07001804 mPendingRequestArgs = args;
Adam Cohen9211d422014-10-07 18:14:53 -07001805 }
Anjali Koppalff7ceff2014-05-01 18:26:37 -07001806
Sunny Goyal2100c782016-08-22 16:00:03 -07001807 void addAppWidgetFromDropImpl(int appWidgetId, ItemInfo info, AppWidgetHostView boundWidget,
Sunny Goyal04a324a2017-01-20 21:08:59 -08001808 WidgetAddFlowHandler addFlowHandler) {
Tony Wickhama0628cc2015-10-14 15:23:04 -07001809 if (LOGD) {
1810 Log.d(TAG, "Adding widget from drop");
1811 }
Sunny Goyal04a324a2017-01-20 21:08:59 -08001812 addAppWidgetImpl(appWidgetId, info, boundWidget, addFlowHandler, 0);
Adam Cohenad4e15c2013-10-17 16:21:35 -07001813 }
1814
Sunny Goyal2100c782016-08-22 16:00:03 -07001815 void addAppWidgetImpl(int appWidgetId, ItemInfo info,
Sunny Goyal04a324a2017-01-20 21:08:59 -08001816 AppWidgetHostView boundWidget, WidgetAddFlowHandler addFlowHandler, int delay) {
Samuel Fufaca37b8a2019-08-19 17:04:36 -07001817 if (!addFlowHandler.startConfigActivity(this, appWidgetId, info,
1818 REQUEST_CREATE_APPWIDGET)) {
Sunny Goyal04a324a2017-01-20 21:08:59 -08001819 // If the configuration flow was not started, add the widget
Michael Jurkaaf442092010-06-10 17:01:57 -07001820
Adam Cohenad4e15c2013-10-17 16:21:35 -07001821 Runnable onComplete = new Runnable() {
1822 @Override
1823 public void run() {
1824 // Exit spring loaded mode if necessary after adding the widget
Sunny Goyal3e3f44c2017-10-23 17:14:52 -07001825 mStateManager.goToState(NORMAL, SPRING_LOADED_EXIT_DELAY);
Adam Cohenad4e15c2013-10-17 16:21:35 -07001826 }
1827 };
Samuel Fufaca37b8a2019-08-19 17:04:36 -07001828 completeAddAppWidget(appWidgetId, info, boundWidget,
1829 addFlowHandler.getProviderInfo(this));
Sunny Goyal6e379fc2020-03-19 16:08:14 -07001830 mWorkspace.removeExtraEmptyScreenDelayed(delay, false, onComplete);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001831 }
1832 }
Romain Guycbb89e42009-06-08 15:52:54 -07001833
Sunny Goyalefb7e842018-10-04 15:11:00 -07001834 public void addPendingItem(PendingAddItemInfo info, int container, int screenId,
Sunny Goyal71b5c0b2015-01-08 16:59:04 -08001835 int[] cell, int spanX, int spanY) {
Sunny Goyal2100c782016-08-22 16:00:03 -07001836 info.container = container;
1837 info.screenId = screenId;
1838 if (cell != null) {
1839 info.cellX = cell[0];
1840 info.cellY = cell[1];
1841 }
1842 info.spanX = spanX;
1843 info.spanY = spanY;
1844
Sunny Goyal71b5c0b2015-01-08 16:59:04 -08001845 switch (info.itemType) {
1846 case LauncherSettings.Favorites.ITEM_TYPE_CUSTOM_APPWIDGET:
1847 case LauncherSettings.Favorites.ITEM_TYPE_APPWIDGET:
Sunny Goyal2100c782016-08-22 16:00:03 -07001848 addAppWidgetFromDrop((PendingAddWidgetInfo) info);
Sunny Goyal71b5c0b2015-01-08 16:59:04 -08001849 break;
1850 case LauncherSettings.Favorites.ITEM_TYPE_SHORTCUT:
Sunny Goyal782f0c92017-01-19 10:27:54 -08001851 processShortcutFromDrop((PendingAddShortcutInfo) info);
Sunny Goyal71b5c0b2015-01-08 16:59:04 -08001852 break;
1853 default:
1854 throw new IllegalStateException("Unknown item type: " + info.itemType);
Samuel Fufaca37b8a2019-08-19 17:04:36 -07001855 }
Sunny Goyal71b5c0b2015-01-08 16:59:04 -08001856 }
1857
Adam Cohenfbba09b2011-07-18 21:43:05 -07001858 /**
1859 * Process a shortcut drop.
Adam Cohenfbba09b2011-07-18 21:43:05 -07001860 */
Sunny Goyal782f0c92017-01-19 10:27:54 -08001861 private void processShortcutFromDrop(PendingAddShortcutInfo info) {
Sunny Goyalfb5096d2016-09-08 14:32:06 -07001862 Intent intent = new Intent(Intent.ACTION_CREATE_SHORTCUT).setComponent(info.componentName);
1863 setWaitingForResult(PendingRequestArgs.forIntent(REQUEST_CREATE_SHORTCUT, intent, info));
vadimtcf275c12020-04-15 12:43:01 -07001864 TestLogging.recordEvent(TestProtocol.SEQUENCE_MAIN, "start: processShortcutFromDrop");
Sunny Goyal782f0c92017-01-19 10:27:54 -08001865 if (!info.activityInfo.startConfigActivity(this, REQUEST_CREATE_SHORTCUT)) {
1866 handleActivityResult(REQUEST_CREATE_SHORTCUT, RESULT_CANCELED, null);
1867 }
Michael Jurka0280c3b2010-09-17 15:00:07 -07001868 }
1869
Adam Cohenfbba09b2011-07-18 21:43:05 -07001870 /**
1871 * Process a widget drop.
Adam Cohenfbba09b2011-07-18 21:43:05 -07001872 */
Sunny Goyal2100c782016-08-22 16:00:03 -07001873 private void addAppWidgetFromDrop(PendingAddWidgetInfo info) {
Adam Cohened66b2b2012-01-23 17:28:51 -08001874 AppWidgetHostView hostView = info.boundWidget;
Sunny Goyal952e63d2017-08-16 04:59:08 -07001875 final int appWidgetId;
Sunny Goyal8a0dc382017-01-25 11:30:06 -08001876 WidgetAddFlowHandler addFlowHandler = info.getHandler();
Adam Cohened66b2b2012-01-23 17:28:51 -08001877 if (hostView != null) {
Tony Wickhama0628cc2015-10-14 15:23:04 -07001878 // In the case where we've prebound the widget, we remove it from the DragLayer
1879 if (LOGD) {
1880 Log.d(TAG, "Removing widget view from drag layer and setting boundWidget to null");
1881 }
1882 getDragLayer().removeView(hostView);
1883
Adam Cohened66b2b2012-01-23 17:28:51 -08001884 appWidgetId = hostView.getAppWidgetId();
Sunny Goyal04a324a2017-01-20 21:08:59 -08001885 addAppWidgetFromDropImpl(appWidgetId, info, hostView, addFlowHandler);
Sunny Goyal5b9ebca2015-06-01 18:37:32 -07001886
1887 // Clear the boundWidget so that it doesn't get destroyed.
1888 info.boundWidget = null;
Adam Cohened66b2b2012-01-23 17:28:51 -08001889 } else {
Adam Cohen9d5b7d82012-05-09 18:00:44 -07001890 // In this case, we either need to start an activity to get permission to bind
1891 // the widget, or we need to start an activity to configure the widget, or both.
Pinyao Tingc7a6c292019-08-26 14:36:02 -07001892 if (info.itemType == LauncherSettings.Favorites.ITEM_TYPE_CUSTOM_APPWIDGET) {
1893 appWidgetId = CustomWidgetManager.INSTANCE.get(this).getWidgetIdForCustomProvider(
1894 info.componentName);
Sunny Goyal952e63d2017-08-16 04:59:08 -07001895 } else {
Sihua Ma0593a0d2022-10-03 16:01:48 -07001896 appWidgetId = getAppWidgetHolder().allocateAppWidgetId();
Sunny Goyal952e63d2017-08-16 04:59:08 -07001897 }
Adam Cohendd70d662012-10-04 16:53:44 -07001898 Bundle options = info.bindOptions;
1899
Sunny Goyalffe83f12014-08-14 17:39:34 -07001900 boolean success = mAppWidgetManager.bindAppWidgetIdIfAllowed(
1901 appWidgetId, info.info, options);
Adam Cohendd70d662012-10-04 16:53:44 -07001902 if (success) {
Sunny Goyal04a324a2017-01-20 21:08:59 -08001903 addAppWidgetFromDropImpl(appWidgetId, info, null, addFlowHandler);
Michael Jurka8b805b12012-04-18 14:23:14 -07001904 } else {
Sunny Goyal04a324a2017-01-20 21:08:59 -08001905 addFlowHandler.startBindFlow(this, appWidgetId, info, REQUEST_BIND_APPWIDGET);
Michael Jurka8b805b12012-04-18 14:23:14 -07001906 }
Adam Cohened66b2b2012-01-23 17:28:51 -08001907 }
Adam Cohenfbba09b2011-07-18 21:43:05 -07001908 }
1909
Samuel Fufa746d4202020-02-02 18:55:44 -08001910 /**
1911 * Creates and adds new folder to CellLayout
1912 */
Samuel Fufa28c3e452020-02-08 16:07:16 -08001913 public FolderIcon addFolder(CellLayout layout, int container, final int screenId, int cellX,
1914 int cellY) {
Michael Jurkac9d95c52011-08-29 14:03:34 -07001915 final FolderInfo folderInfo = new FolderInfo();
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001916
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001917 // Update the model
Sunny Goyal43bf11d2017-02-02 13:52:53 -08001918 getModelWriter().addItemToDatabase(folderInfo, container, screenId, cellX, cellY);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001919
1920 // Create the view
Samuel Fufa746d4202020-02-02 18:55:44 -08001921 FolderIcon newFolder = FolderIcon.inflateFolderAndIcon(R.layout.folder_icon, this, layout,
1922 folderInfo);
Sunny Goyald5462aa2016-11-22 16:52:39 +05301923 mWorkspace.addInScreen(newFolder, folderInfo);
Winson Chung5f8afe62013-08-12 16:19:28 -07001924 // Force measure the new folder icon
1925 CellLayout parent = mWorkspace.getParentCellLayoutForView(newFolder);
1926 parent.getShortcutsAndWidgets().measureChild(newFolder);
Adam Cohendf035382011-04-11 17:22:04 -07001927 return newFolder;
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001928 }
Romain Guycbb89e42009-06-08 15:52:54 -07001929
Tony Wickham1906cc32021-02-11 11:55:24 -08001930 @Override
1931 public Rect getFolderBoundingBox() {
1932 // We need to bound the folder to the currently visible workspace area
Andras Kloczl3a4ba0b2021-03-29 18:47:14 +02001933 return getWorkspace().getPageAreaRelativeToDragLayer();
Tony Wickham1906cc32021-02-11 11:55:24 -08001934 }
1935
1936 @Override
1937 public void updateOpenFolderPosition(int[] inOutPosition, Rect bounds, int width, int height) {
1938 int left = inOutPosition[0];
1939 int top = inOutPosition[1];
1940 DeviceProfile grid = getDeviceProfile();
1941 int distFromEdgeOfScreen = getWorkspace().getPaddingLeft();
1942 if (grid.isPhone && (grid.availableWidthPx - width) < 4 * distFromEdgeOfScreen) {
1943 // Center the folder if it is very close to being centered anyway, by virtue of
1944 // filling the majority of the viewport. ie. remove it from the uncanny valley
1945 // of centeredness.
1946 left = (grid.availableWidthPx - width) / 2;
1947 } else if (width >= bounds.width()) {
1948 // If the folder doesn't fit within the bounds, center it about the desired bounds
1949 left = bounds.left + (bounds.width() - width) / 2;
1950 }
1951 if (height >= bounds.height()) {
1952 // Folder height is greater than page height, center on page
1953 top = bounds.top + (bounds.height() - height) / 2;
1954 } else {
1955 // Folder height is less than page height, so bound it to the absolute open folder
1956 // bounds if necessary
1957 Rect folderBounds = grid.getAbsoluteOpenFolderBounds();
1958 left = Math.max(folderBounds.left, Math.min(left, folderBounds.right - width));
1959 top = Math.max(folderBounds.top, Math.min(top, folderBounds.bottom - height));
1960 }
1961 inOutPosition[0] = left;
1962 inOutPosition[1] = top;
1963 }
1964
Winsonc0b52fe2015-09-09 16:38:15 -07001965 /**
Winsonfa56b3f2015-09-14 12:01:13 -07001966 * Unbinds the view for the specified item, and removes the item and all its children.
1967 *
1968 * @param v the view being removed.
Winsonfa56b3f2015-09-14 12:01:13 -07001969 * @param itemInfo the {@link ItemInfo} for this view.
1970 * @param deleteFromDb whether or not to delete this item from the db.
Winsonc0b52fe2015-09-09 16:38:15 -07001971 */
Tony Wickhambfbf7f92016-05-19 11:19:39 -07001972 public boolean removeItem(View v, final ItemInfo itemInfo, boolean deleteFromDb) {
Pinyao Ting6a41d562022-05-10 23:47:36 +00001973 return removeItem(v, itemInfo, deleteFromDb, null);
1974 }
1975
1976 /**
1977 * Unbinds the view for the specified item, and removes the item and all its children.
1978 *
1979 * @param v the view being removed.
1980 * @param itemInfo the {@link ItemInfo} for this view.
1981 * @param deleteFromDb whether or not to delete this item from the db.
1982 * @param reason the resaon for removal.
1983 */
1984 public boolean removeItem(View v, final ItemInfo itemInfo, boolean deleteFromDb,
1985 @Nullable final String reason) {
Sunny Goyal95899162019-03-27 16:03:06 -07001986 if (itemInfo instanceof WorkspaceItemInfo) {
Winsonfa56b3f2015-09-14 12:01:13 -07001987 // Remove the shortcut from the folder before removing it from launcher
Sunny Goyal44c06432016-04-02 10:56:02 -07001988 View folderIcon = mWorkspace.getHomescreenIconByItemId(itemInfo.container);
1989 if (folderIcon instanceof FolderIcon) {
Sunny Goyal95899162019-03-27 16:03:06 -07001990 ((FolderInfo) folderIcon.getTag()).remove((WorkspaceItemInfo) itemInfo, true);
Winsonfa56b3f2015-09-14 12:01:13 -07001991 } else {
1992 mWorkspace.removeWorkspaceItem(v);
1993 }
Winsonc0b52fe2015-09-09 16:38:15 -07001994 if (deleteFromDb) {
Pinyao Ting6a41d562022-05-10 23:47:36 +00001995 getModelWriter().deleteItemFromDatabase(itemInfo, reason);
Winsonc0b52fe2015-09-09 16:38:15 -07001996 }
1997 } else if (itemInfo instanceof FolderInfo) {
1998 final FolderInfo folderInfo = (FolderInfo) itemInfo;
Sunny Goyalaaf7d1d2016-05-17 13:38:54 -07001999 if (v instanceof FolderIcon) {
2000 ((FolderIcon) v).removeListeners();
2001 }
Winsonc0b52fe2015-09-09 16:38:15 -07002002 mWorkspace.removeWorkspaceItem(v);
2003 if (deleteFromDb) {
Sunny Goyal43bf11d2017-02-02 13:52:53 -08002004 getModelWriter().deleteFolderAndContentsFromDatabase(folderInfo);
Winsonc0b52fe2015-09-09 16:38:15 -07002005 }
2006 } else if (itemInfo instanceof LauncherAppWidgetInfo) {
2007 final LauncherAppWidgetInfo widgetInfo = (LauncherAppWidgetInfo) itemInfo;
Winson44818e02015-10-02 11:25:46 -07002008 mWorkspace.removeWorkspaceItem(v);
Winsonc0b52fe2015-09-09 16:38:15 -07002009 if (deleteFromDb) {
Sihua Ma0593a0d2022-10-03 16:01:48 -07002010 getModelWriter().deleteWidgetInfo(widgetInfo, getAppWidgetHolder(), reason);
Winsonc0b52fe2015-09-09 16:38:15 -07002011 }
2012 } else {
2013 return false;
2014 }
2015 return true;
2016 }
2017
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002018 @Override
2019 public boolean dispatchKeyEvent(KeyEvent event) {
vadimt6b534ee2021-08-06 15:49:02 -07002020 TestLogging.recordKeyEvent(TestProtocol.SEQUENCE_MAIN, "Key event", event);
Hyunyoung Song3c7d9cb2017-01-30 15:11:27 -08002021 return (event.getKeyCode() == KeyEvent.KEYCODE_HOME) || super.dispatchKeyEvent(event);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002022 }
2023
Joe Onorato88ec0992009-11-19 13:16:06 -08002024 @Override
vadimt9af34a72020-01-21 11:19:13 -08002025 public boolean dispatchTouchEvent(MotionEvent ev) {
Sunny Goyala306e592020-03-24 01:51:41 -07002026 switch (ev.getAction()) {
2027 case MotionEvent.ACTION_DOWN:
2028 mTouchInProgress = true;
2029 break;
2030 case MotionEvent.ACTION_UP:
Riddle Hsub30adcb2020-10-07 15:57:44 +08002031 mLastTouchUpTime = SystemClock.uptimeMillis();
Sunny Goyala306e592020-03-24 01:51:41 -07002032 // Follow through
2033 case MotionEvent.ACTION_CANCEL:
2034 mTouchInProgress = false;
2035 break;
Sunny Goyal9b180102020-03-11 10:02:29 -07002036 }
vadimtd633c9c2020-01-22 18:00:37 -08002037 TestLogging.recordMotionEvent(TestProtocol.SEQUENCE_MAIN, "Touch event", ev);
vadimt9af34a72020-01-21 11:19:13 -08002038 return super.dispatchTouchEvent(ev);
2039 }
2040
Sunny Goyala306e592020-03-24 01:51:41 -07002041 /**
2042 * Returns true if a touch interaction is in progress
2043 */
2044 public boolean isTouchInProgress() {
2045 return mTouchInProgress;
2046 }
2047
vadimt9af34a72020-01-21 11:19:13 -08002048 @Override
Joe Onorato88ec0992009-11-19 13:16:06 -08002049 public void onBackPressed() {
Sunny Goyal7c8a65e2017-12-22 11:11:33 -08002050 if (finishAutoCancelActionMode()) {
2051 return;
2052 }
Adam Cohen9211d422014-10-07 18:14:53 -07002053
Sunny Goyal45478022015-06-08 16:52:41 -07002054 if (mDragController.isDragging()) {
2055 mDragController.cancelDrag();
Adam Cohenc9735cf2015-01-23 16:11:55 -08002056 return;
2057 }
2058
Jon Mirandafeba90f2016-10-06 10:53:29 -07002059 // Note: There should be at most one log per method call. This is enforced implicitly
2060 // by using if-else statements.
Sunny Goyal740ac7f2016-09-28 16:47:32 -07002061 AbstractFloatingView topView = AbstractFloatingView.getTopOpenView(this);
Sunny Goyal3f2637f2022-05-05 12:24:08 -07002062 if (topView == null || !topView.onBackPressed()) {
2063 // Not handled by the floating view.
2064 onStateBack();
Michael Jurkaaf442092010-06-10 17:01:57 -07002065 }
Joe Onorato88ec0992009-11-19 13:16:06 -08002066 }
2067
Sunny Goyal3f2637f2022-05-05 12:24:08 -07002068 protected void onStateBack() {
2069 mStateManager.getState().onBackPressed(this);
2070 }
2071
Fengjiang Lie884c2c2022-12-19 14:42:14 -08002072 protected void onBackProgressed(@FloatRange(from = 0.0, to = 1.0) float backProgress) {
2073 mStateManager.getState().onBackProgressed(this, backProgress);
2074 }
2075
2076 protected void onBackCancelled() {
2077 mStateManager.getState().onBackCancelled(this);
2078 }
2079
Sunny Goyala992ac92023-01-10 17:50:32 -08002080 protected void onScreenOnChanged(boolean isOn) {
Tracy Zhouf20a4bd2021-04-19 21:37:08 -07002081 // Reset AllApps to its initial state only if we are not in the middle of
2082 // processing a multi-step drop
Sunny Goyala992ac92023-01-10 17:50:32 -08002083 if (!isOn && mPendingRequestArgs == null) {
Tracy Zhouf20a4bd2021-04-19 21:37:08 -07002084 if (!isInState(NORMAL)) {
2085 onUiChangedWhileSleeping();
2086 }
2087 mStateManager.goToState(NORMAL);
2088 }
2089 }
2090
Sunny Goyalfe770c92016-09-27 14:38:58 -07002091 @TargetApi(Build.VERSION_CODES.M)
Sunny Goyal0b0847b2018-03-14 12:30:11 -07002092 @Override
Brian Isganitisbde3c8b2022-03-15 13:35:06 -07002093 public boolean onErrorStartingShortcut(Intent intent, ItemInfo info) {
Sunny Goyal0b0847b2018-03-14 12:30:11 -07002094 // Due to legacy reasons, direct call shortcuts require Launchers to have the
2095 // corresponding permission. Show the appropriate permission prompt if that
2096 // is the case.
2097 if (intent.getComponent() == null
2098 && Intent.ACTION_CALL.equals(intent.getAction())
2099 && checkSelfPermission(android.Manifest.permission.CALL_PHONE) !=
2100 PackageManager.PERMISSION_GRANTED) {
2101
2102 setWaitingForResult(PendingRequestArgs
2103 .forIntent(REQUEST_PERMISSION_CALL_PHONE, intent, info));
2104 requestPermissions(new String[]{android.Manifest.permission.CALL_PHONE},
2105 REQUEST_PERMISSION_CALL_PHONE);
2106 return true;
2107 } else {
2108 return false;
2109 }
Sunny Goyal0eca4e22016-07-20 11:43:06 -07002110 }
2111
Hyunyoung Song46d07f72018-05-22 15:41:25 -07002112 @Override
Sunny Goyal852537f2020-07-15 17:02:16 -07002113 public boolean startActivitySafely(View v, Intent intent, ItemInfo item) {
Winson Chung0b70cd42019-06-17 22:34:33 -07002114 if (!hasBeenResumed()) {
2115 // Workaround an issue where the WM launch animation is clobbered when finishing the
2116 // recents animation into launcher. Defer launching the activity until Launcher is
2117 // next resumed.
Sunny Goyal852537f2020-07-15 17:02:16 -07002118 addOnResumeCallback(() -> startActivitySafely(v, intent, item));
Winson Chungc9bf6d42019-10-04 15:33:18 -07002119 if (mOnDeferredActivityLaunchCallback != null) {
2120 mOnDeferredActivityLaunchCallback.run();
2121 mOnDeferredActivityLaunchCallback = null;
2122 }
Winson Chung0b70cd42019-06-17 22:34:33 -07002123 return true;
2124 }
2125
Sunny Goyal852537f2020-07-15 17:02:16 -07002126 boolean success = super.startActivitySafely(v, intent, item);
Hyunyoung Song1241e612018-05-15 21:46:51 -07002127 if (success && v instanceof BubbleTextView) {
Sunny Goyal0b0847b2018-03-14 12:30:11 -07002128 // This is set to the view that launched the activity that navigated the user away
2129 // from launcher. Since there is no callback for when the activity has finished
2130 // launching, enable the press state and keep this reference to reset the press
2131 // state when we return to launcher.
2132 BubbleTextView btv = (BubbleTextView) v;
2133 btv.setStayPressed(true);
Sunny Goyalb65d7662021-03-07 15:09:11 -08002134 addOnResumeCallback(() -> btv.setStayPressed(false));
Sunny Goyala7ce1662016-05-31 15:01:35 -07002135 }
Hyunyoung Song1241e612018-05-15 21:46:51 -07002136 return success;
Michael Jurka86a720e2012-05-09 11:23:23 -07002137 }
2138
Winson Chung3d503fb2011-07-13 17:25:49 -07002139 boolean isHotseatLayout(View layout) {
Sunny Goyalc13403c2016-11-18 23:44:48 -08002140 // TODO: Remove this method
Sunny Goyal876e4622018-11-02 13:50:40 -07002141 return mHotseat != null && (layout == mHotseat);
Winson Chung3d503fb2011-07-13 17:25:49 -07002142 }
Romain Guy1fbc1c82009-11-09 20:43:08 -08002143
Winson Chung3d503fb2011-07-13 17:25:49 -07002144 /**
2145 * Returns the CellLayout of the specified container at the specified screen.
2146 */
Sunny Goyalefb7e842018-10-04 15:11:00 -07002147 public CellLayout getCellLayout(int container, int screenId) {
Sunny Goyal876e4622018-11-02 13:50:40 -07002148 return (container == LauncherSettings.Favorites.CONTAINER_HOTSEAT)
2149 ? mHotseat : mWorkspace.getScreenWithId(screenId);
Romain Guya6abce82009-11-10 02:54:41 -08002150 }
2151
Michael Jurkae326f182011-11-21 14:05:46 -08002152 @Override
2153 public void onTrimMemory(int level) {
2154 super.onTrimMemory(level);
Adam Cohen3f9c9712014-10-31 11:48:25 -07002155 if (level >= ComponentCallbacks2.TRIM_MEMORY_UI_HIDDEN) {
2156 // The widget preview db can result in holding onto over
2157 // 3MB of memory for caching which isn't necessary.
2158 SQLiteDatabase.releaseMemory();
2159
Adam Cohenc8f4e1b2014-11-19 16:03:20 -08002160 // This clears all widget bitmaps from the widget tray
Hyunyoung Song3f471442015-04-08 19:01:34 -07002161 // TODO(hyunyoungs)
Michael Jurkae326f182011-11-21 14:05:46 -08002162 }
2163 }
2164
Michael Jurkad7c28052012-04-27 15:43:36 -07002165 @Override
2166 public boolean dispatchPopulateAccessibilityEvent(AccessibilityEvent event) {
alanv1d4fde62012-10-17 13:15:47 -07002167 final boolean result = super.dispatchPopulateAccessibilityEvent(event);
Michael Jurkad7c28052012-04-27 15:43:36 -07002168 final List<CharSequence> text = event.getText();
2169 text.clear();
alanv1d4fde62012-10-17 13:15:47 -07002170 // Populate event with a fake title based on the current state.
Sunny Goyal3e3f44c2017-10-23 17:14:52 -07002171 // TODO: When can workspace be null?
2172 text.add(mWorkspace == null
Sunny Goyal52e25452020-07-20 12:38:01 -07002173 ? getString(R.string.home_screen)
Sunny Goyalea609262017-10-25 15:47:38 -07002174 : mStateManager.getState().getDescription(this));
Michael Jurkad7c28052012-04-27 15:43:36 -07002175 return result;
2176 }
2177
Michael Jurka7607c2f2013-04-03 14:33:19 -07002178 /**
Winson Chungc9bf6d42019-10-04 15:33:18 -07002179 * Persistant callback which notifies when an activity launch is deferred because the activity
2180 * was not yet resumed.
2181 */
2182 public void setOnDeferredActivityLaunchCallback(Runnable callback) {
2183 mOnDeferredActivityLaunchCallback = callback;
2184 }
2185
2186 /**
Andras Kloczl55edfe52021-05-14 12:21:30 +02002187 * Sets the next pages to bind synchronously on next bind.
2188 * @param pages should not be null.
Sunny Goyala7a5bf32020-01-05 15:35:29 +05302189 */
Andras Kloczl55edfe52021-05-14 12:21:30 +02002190 public void setPagesToBindSynchronously(@NonNull IntSet pages) {
2191 mPagesToBindSynchronously = pages;
Sunny Goyala7a5bf32020-01-05 15:35:29 +05302192 }
2193
Sunny Goyal93f878c2016-03-30 17:31:24 -07002194 @Override
Sunny Goyal12e3f1f2021-07-15 14:31:58 -07002195 public IntSet getPagesToBindSynchronously(IntArray orderedScreenIds) {
Alex Chau49354042021-08-25 13:21:58 +01002196 IntSet visibleIds;
2197 if (!mPagesToBindSynchronously.isEmpty()) {
2198 visibleIds = mPagesToBindSynchronously;
2199 } else if (!mWorkspaceLoading) {
2200 visibleIds = mWorkspace.getCurrentPageScreenIds();
2201 } else {
2202 // If workspace binding is still in progress, getCurrentPageScreenIds won't be accurate,
2203 // and we should use mSynchronouslyBoundPages that's set during initial binding.
2204 visibleIds = mSynchronouslyBoundPages;
2205 }
Sunny Goyal12e3f1f2021-07-15 14:31:58 -07002206 IntArray actualIds = new IntArray();
2207
Sunny Goyal12e3f1f2021-07-15 14:31:58 -07002208 IntSet result = new IntSet();
2209 if (visibleIds.isEmpty()) {
Schneider Victor-tulias00213382021-09-27 13:41:10 -07002210 if (TestProtocol.sDebugTracing) {
2211 Log.d(TestProtocol.NULL_INT_SET, "getPagesToBindSynchronously (1): "
2212 + result);
2213 }
Sunny Goyal12e3f1f2021-07-15 14:31:58 -07002214 return result;
2215 }
2216 for (int id : orderedScreenIds.toArray()) {
Alex Chau1e448462021-08-13 21:48:35 +01002217 actualIds.add(id);
Sunny Goyal12e3f1f2021-07-15 14:31:58 -07002218 }
2219 int firstId = visibleIds.getArray().get(0);
Steven Ng4b346102021-09-14 19:17:09 +01002220 int pairId = mWorkspace.getScreenPair(firstId);
Alex Chau62f129b2021-09-03 16:54:27 +01002221 // Double check that actual screenIds contains the visibleId, as empty screens are hidden
2222 // in single panel.
Sunny Goyal12e3f1f2021-07-15 14:31:58 -07002223 if (actualIds.contains(firstId)) {
2224 result.add(firstId);
Alex Chau62f129b2021-09-03 16:54:27 +01002225 if (mDeviceProfile.isTwoPanels && actualIds.contains(pairId)) {
2226 result.add(pairId);
Sunny Goyal12e3f1f2021-07-15 14:31:58 -07002227 }
Alex Chau62f129b2021-09-03 16:54:27 +01002228 } else if (LauncherAppState.getIDP(this).supportedProfiles.stream().anyMatch(
2229 deviceProfile -> deviceProfile.isTwoPanels) && actualIds.contains(pairId)) {
2230 // Add the right panel if left panel is hidden when switching display, due to empty
2231 // pages being hidden in single panel.
2232 result.add(pairId);
Sunny Goyal12e3f1f2021-07-15 14:31:58 -07002233 }
Schneider Victor-tulias00213382021-09-27 13:41:10 -07002234 if (TestProtocol.sDebugTracing) {
2235 Log.d(TestProtocol.NULL_INT_SET, "getPagesToBindSynchronously (2): "
2236 + result);
2237 }
Sunny Goyal12e3f1f2021-07-15 14:31:58 -07002238 return result;
Joe Onorato9c1289c2009-08-17 11:03:03 -04002239 }
The Android Open Source Projectf96811c2009-03-18 17:39:48 -07002240
Joe Onorato9c1289c2009-08-17 11:03:03 -04002241 /**
Sunny Goyal527c7d32015-08-28 15:19:36 -07002242 * Clear any pending bind callbacks. This is called when is loader is planning to
2243 * perform a full rebind from scratch.
2244 */
2245 @Override
2246 public void clearPendingBinds() {
Sunny Goyal527c7d32015-08-28 15:19:36 -07002247 if (mPendingExecutor != null) {
Sunny Goyal4a48a982021-06-17 15:15:46 -07002248 mPendingExecutor.cancel();
Sunny Goyal527c7d32015-08-28 15:19:36 -07002249 mPendingExecutor = null;
Sunny Goyal6b6d0a32019-08-05 17:19:32 -07002250
2251 // We might have set this flag previously and forgot to clear it.
2252 mAppsView.getAppsStore()
2253 .disableDeferUpdatesSilently(AllAppsStore.DEFER_UPDATES_NEXT_DRAW);
Sunny Goyal527c7d32015-08-28 15:19:36 -07002254 }
2255 }
2256
2257 /**
Joe Onorato9c1289c2009-08-17 11:03:03 -04002258 * Refreshes the shortcuts shown on the workspace.
2259 *
2260 * Implementation of the method from LauncherModel.Callbacks.
2261 */
2262 public void startBinding() {
Winson Chung5cc62c72019-10-16 11:32:41 -07002263 Object traceToken = TraceHelper.INSTANCE.beginSection("startBinding");
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -07002264 // Floating panels (except the full widget sheet) are associated with individual icons. If
2265 // we are starting a fresh bind, close all such panels as all the icons are about
2266 // to go away.
Pinyao Tinga74b63a2019-07-17 23:26:06 -07002267 AbstractFloatingView.closeOpenViews(this, true, TYPE_ALL & ~TYPE_REBIND_SAFE);
Jon Miranda6dc7f1e2017-02-21 12:37:51 -08002268
Anjali Koppalff7ceff2014-05-01 18:26:37 -07002269 setWorkspaceLoading(true);
Adam Cohen517a7f52014-03-01 12:12:59 -08002270
Winson Chungd64d1762013-08-20 14:37:16 -07002271 // Clear the workspace because it's going to be rebound
Sunny Goyal2db53422019-03-01 16:06:12 -08002272 mDragController.cancelDrag();
2273
Adam Cohendf035382011-04-11 17:22:04 -07002274 mWorkspace.clearDropTargets();
Winson Chung9e6a0a22013-08-27 11:58:12 -07002275 mWorkspace.removeAllWorkspaceScreens();
Sihua Ma0593a0d2022-10-03 16:01:48 -07002276 mAppWidgetHolder.clearViews();
Winson Chungd64d1762013-08-20 14:37:16 -07002277
Winson Chung3d503fb2011-07-13 17:25:49 -07002278 if (mHotseat != null) {
Sunny Goyalc4d32012020-04-03 17:10:11 -07002279 mHotseat.resetLayout(getDeviceProfile().isVerticalBarLayout());
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002280 }
Winson Chung5cc62c72019-10-16 11:32:41 -07002281 TraceHelper.INSTANCE.endSection(traceToken);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002282 }
2283
Adam Cohendcd297f2013-06-18 13:13:40 -07002284 @Override
Sunny Goyalefb7e842018-10-04 15:11:00 -07002285 public void bindScreens(IntArray orderedScreenIds) {
Alex Chau1e448462021-08-13 21:48:35 +01002286 int firstScreenPosition = 0;
Jon Miranda7143ba62019-03-15 09:00:05 -07002287 if (FeatureFlags.QSB_ON_FIRST_SCREEN &&
Andras Kloczldbf577a2021-05-26 15:02:52 +02002288 orderedScreenIds.indexOf(Workspace.FIRST_SCREEN_ID) != firstScreenPosition) {
Sunny Goyalefb7e842018-10-04 15:11:00 -07002289 orderedScreenIds.removeValue(Workspace.FIRST_SCREEN_ID);
Andras Kloczldbf577a2021-05-26 15:02:52 +02002290 orderedScreenIds.add(firstScreenPosition, Workspace.FIRST_SCREEN_ID);
Jon Miranda7143ba62019-03-15 09:00:05 -07002291 } else if (!FeatureFlags.QSB_ON_FIRST_SCREEN && orderedScreenIds.isEmpty()) {
Sunny Goyala9e2f5a2016-06-10 12:22:04 -07002292 // If there are no screens, we need to have an empty screen
Andras Kloczl408a54f2021-08-28 00:59:08 +01002293 mWorkspace.addExtraEmptyScreens();
Adam Cohen5084cba2013-09-03 12:01:16 -07002294 }
Sunny Goyalda4fe1a2016-05-26 16:05:17 -07002295 bindAddScreens(orderedScreenIds);
Winson Chung0e6a7132013-08-23 12:55:10 -07002296
Winsonc7d2e832016-07-28 12:24:55 -07002297 // After we have added all the screens, if the wallpaper was locked to the default state,
2298 // then notify to indicate that it can be released and a proper wallpaper offset can be
2299 // computed before the next layout
2300 mWorkspace.unlockWallpaperFromDefaultPageOnNextLayout();
Winson Chung64359a52013-07-08 17:17:08 -07002301 }
2302
Sunny Goyalefb7e842018-10-04 15:11:00 -07002303 private void bindAddScreens(IntArray orderedScreenIds) {
Andras Kloczl8c574de2021-08-17 23:12:17 +02002304 if (mDeviceProfile.isTwoPanels) {
2305 // Some empty pages might have been removed while the phone was in a single panel
2306 // mode, so we want to add those empty pages back.
2307 IntSet screenIds = IntSet.wrap(orderedScreenIds);
Steven Ng4b346102021-09-14 19:17:09 +01002308 orderedScreenIds.forEach(screenId -> screenIds.add(mWorkspace.getScreenPair(screenId)));
Andras Kloczl8c574de2021-08-17 23:12:17 +02002309 orderedScreenIds = screenIds.getArray();
2310 }
2311
Adam Cohendcd297f2013-06-18 13:13:40 -07002312 int count = orderedScreenIds.size();
2313 for (int i = 0; i < count; i++) {
Sunny Goyalefb7e842018-10-04 15:11:00 -07002314 int screenId = orderedScreenIds.get(i);
Andras Kloczldbf577a2021-05-26 15:02:52 +02002315 if (FeatureFlags.QSB_ON_FIRST_SCREEN && screenId == Workspace.FIRST_SCREEN_ID) {
Sunny Goyalda4fe1a2016-05-26 16:05:17 -07002316 // No need to bind the first screen, as its always bound.
Andras Kloczldbf577a2021-05-26 15:02:52 +02002317 continue;
Sunny Goyalda4fe1a2016-05-26 16:05:17 -07002318 }
Andras Kloczldbf577a2021-05-26 15:02:52 +02002319 mWorkspace.insertNewWorkspaceScreenBeforeEmptyScreen(screenId);
Adam Cohendcd297f2013-06-18 13:13:40 -07002320 }
Adam Cohendcd297f2013-06-18 13:13:40 -07002321 }
2322
Sunny Goyalb23980c2017-08-17 07:45:25 -07002323 @Override
Tony Wickham6a71a5b2018-08-21 11:40:23 -07002324 public void preAddApps() {
2325 // If there's an undo snackbar, force it to complete to ensure empty screens are removed
2326 // before trying to add new items.
2327 mModelWriter.commitDelete();
2328 AbstractFloatingView snackbar = AbstractFloatingView.getOpenView(this, TYPE_SNACKBAR);
2329 if (snackbar != null) {
2330 snackbar.post(() -> snackbar.close(true));
2331 }
2332 }
2333
2334 @Override
Sunny Goyalefb7e842018-10-04 15:11:00 -07002335 public void bindAppsAdded(IntArray newScreens, ArrayList<ItemInfo> addNotAnimated,
Sunny Goyal29947f02017-12-18 13:49:44 -08002336 ArrayList<ItemInfo> addAnimated) {
Winson Chungd64d1762013-08-20 14:37:16 -07002337 // Add the new screens
Adam Cohen76a47a12014-02-05 11:47:43 -08002338 if (newScreens != null) {
Alex Chau817e0fa2021-09-08 20:46:32 +01002339 // newScreens can contain an empty right panel that is already bound, but not known
2340 // by BgDataModel.
2341 newScreens.removeAllValues(mWorkspace.mScreenOrder);
Adam Cohen76a47a12014-02-05 11:47:43 -08002342 bindAddScreens(newScreens);
2343 }
Winson Chungd64d1762013-08-20 14:37:16 -07002344
2345 // We add the items without animation on non-visible pages, and with
2346 // animations on the new page (which we will try and snap to).
Adam Cohen76a47a12014-02-05 11:47:43 -08002347 if (addNotAnimated != null && !addNotAnimated.isEmpty()) {
Sunny Goyalb23980c2017-08-17 07:45:25 -07002348 bindItems(addNotAnimated, false);
Winson Chungd64d1762013-08-20 14:37:16 -07002349 }
Adam Cohen76a47a12014-02-05 11:47:43 -08002350 if (addAnimated != null && !addAnimated.isEmpty()) {
Sunny Goyalb23980c2017-08-17 07:45:25 -07002351 bindItems(addAnimated, true);
Winson Chungd64d1762013-08-20 14:37:16 -07002352 }
Winson Chungc58497e2013-09-03 17:48:37 -07002353
Winson Chung87412982013-10-03 18:34:14 -07002354 // Remove the extra empty screen
Sunny Goyal6e379fc2020-03-19 16:08:14 -07002355 mWorkspace.removeExtraEmptyScreen(false);
Winson Chungd64d1762013-08-20 14:37:16 -07002356 }
2357
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002358 /**
Joe Onorato9c1289c2009-08-17 11:03:03 -04002359 * Bind the items start-end from the list.
2360 *
2361 * Implementation of the method from LauncherModel.Callbacks.
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002362 */
Tony Wickham0bb211a2015-10-02 16:22:08 -07002363 @Override
Sunny Goyalb23980c2017-08-17 07:45:25 -07002364 public void bindItems(final List<ItemInfo> items, final boolean forceAnimateIcons) {
Schneider Victor-tulias68706eb2021-04-29 15:24:54 -07002365 bindItems(items, forceAnimateIcons, /* focusFirstItemForAccessibility= */ false);
2366 }
2367
2368
2369 /**
2370 * Bind the items start-end from the list.
2371 *
2372 * Implementation of the method from LauncherModel.Callbacks.
2373 *
2374 * @param focusFirstItemForAccessibility true iff the first item to be added to the workspace
2375 * should be focused for accessibility.
2376 */
2377 public void bindItems(
2378 final List<ItemInfo> items,
2379 final boolean forceAnimateIcons,
2380 final boolean focusFirstItemForAccessibility) {
Sunny Goyal3be633b2016-12-08 09:59:25 -08002381 // Get the list of added items and intersect them with the set of items here
Rajeev Kumar43c0f582017-06-23 15:34:55 -07002382 final Collection<Animator> bounceAnims = new ArrayList<>();
Schneider Victor-tulias68fb4162021-09-16 13:24:01 -07002383 boolean canAnimatePageChange = canAnimatePageChange();
Shikha Malhotraf78da1b2022-04-11 10:23:18 +00002384 Workspace<?> workspace = mWorkspace;
Sunny Goyalefb7e842018-10-04 15:11:00 -07002385 int newItemsScreenId = -1;
Sunny Goyalb23980c2017-08-17 07:45:25 -07002386 int end = items.size();
Schneider Victor-tulias68706eb2021-04-29 15:24:54 -07002387 View newView = null;
Sunny Goyalb23980c2017-08-17 07:45:25 -07002388 for (int i = 0; i < end; i++) {
Sunny Goyal3be633b2016-12-08 09:59:25 -08002389 final ItemInfo item = items.get(i);
Winson Chung4d279d92011-07-21 11:46:32 -07002390
2391 // Short circuit if we are loading dock items for a configuration which has no dock
2392 if (item.container == LauncherSettings.Favorites.CONTAINER_HOTSEAT &&
2393 mHotseat == null) {
2394 continue;
2395 }
2396
Sunny Goyal639e9062015-08-19 19:17:06 -07002397 final View view;
Joe Onorato9c1289c2009-08-17 11:03:03 -04002398 switch (item.itemType) {
2399 case LauncherSettings.Favorites.ITEM_TYPE_APPLICATION:
2400 case LauncherSettings.Favorites.ITEM_TYPE_SHORTCUT:
Sunny Goyal3be633b2016-12-08 09:59:25 -08002401 case LauncherSettings.Favorites.ITEM_TYPE_DEEP_SHORTCUT: {
Sunny Goyal95899162019-03-27 16:03:06 -07002402 WorkspaceItemInfo info = (WorkspaceItemInfo) item;
Sunny Goyal639e9062015-08-19 19:17:06 -07002403 view = createShortcut(info);
Joe Onorato9c1289c2009-08-17 11:03:03 -04002404 break;
Sunny Goyal3be633b2016-12-08 09:59:25 -08002405 }
2406 case LauncherSettings.Favorites.ITEM_TYPE_FOLDER: {
Tracy Zhou4d7b2442019-12-09 13:42:57 -08002407 view = FolderIcon.inflateFolderAndIcon(R.layout.folder_icon, this,
Michael Jurka0142d492010-08-25 17:46:15 -07002408 (ViewGroup) workspace.getChildAt(workspace.getCurrentPage()),
Sunny Goyal1cd01b02016-11-09 10:43:58 -08002409 (FolderInfo) item);
Joe Onorato9c1289c2009-08-17 11:03:03 -04002410 break;
Sunny Goyal3be633b2016-12-08 09:59:25 -08002411 }
Sunny Goyal952e63d2017-08-16 04:59:08 -07002412 case LauncherSettings.Favorites.ITEM_TYPE_APPWIDGET:
2413 case LauncherSettings.Favorites.ITEM_TYPE_CUSTOM_APPWIDGET: {
Sunny Goyala9a1a212017-08-18 01:03:21 -07002414 view = inflateAppWidget((LauncherAppWidgetInfo) item);
Sunny Goyalb23980c2017-08-17 07:45:25 -07002415 if (view == null) {
2416 continue;
Sunny Goyal3be633b2016-12-08 09:59:25 -08002417 }
Sunny Goyal3be633b2016-12-08 09:59:25 -08002418 break;
2419 }
Winson Chungc763c4e2013-07-19 13:49:06 -07002420 default:
2421 throw new RuntimeException("Invalid Item Type");
Joe Onorato9c1289c2009-08-17 11:03:03 -04002422 }
Sunny Goyal639e9062015-08-19 19:17:06 -07002423
Samuel Fufaca37b8a2019-08-19 17:04:36 -07002424 /*
Sunny Goyalda4fe1a2016-05-26 16:05:17 -07002425 * Remove colliding items.
2426 */
2427 if (item.container == LauncherSettings.Favorites.CONTAINER_DESKTOP) {
2428 CellLayout cl = mWorkspace.getScreenWithId(item.screenId);
2429 if (cl != null && cl.isOccupied(item.cellX, item.cellY)) {
2430 View v = cl.getChildAt(item.cellX, item.cellY);
Jon Miranda0aff1152021-11-05 16:36:07 -07002431 if (v == null) {
2432 Log.e(TAG, "bindItems failed when removing colliding item=" + item);
2433 }
Sunny Goyalda4fe1a2016-05-26 16:05:17 -07002434 Object tag = v.getTag();
2435 String desc = "Collision while binding workspace item: " + item
2436 + ". Collides with " + tag;
Zak Cohen3eeb41d2020-02-14 14:15:13 -08002437 if (FeatureFlags.IS_STUDIO_BUILD) {
Sunny Goyalda4fe1a2016-05-26 16:05:17 -07002438 throw (new RuntimeException(desc));
2439 } else {
Pinyao Ting6a41d562022-05-10 23:47:36 +00002440 getModelWriter().deleteItemFromDatabase(item, desc);
Jon Miranda701774d2022-02-10 11:09:04 -08002441 if (TestProtocol.sDebugTracing) {
2442 Log.d(TestProtocol.MISSING_PROMISE_ICON,
2443 TAG + "bindItems failed for item=" + item);
2444 }
Sunny Goyalda4fe1a2016-05-26 16:05:17 -07002445 continue;
2446 }
2447 }
2448 }
Sunny Goyald5462aa2016-11-22 16:52:39 +05302449 workspace.addInScreenFromBind(view, item);
Schneider Victor-tulias68fb4162021-09-16 13:24:01 -07002450 if (forceAnimateIcons) {
Sunny Goyal639e9062015-08-19 19:17:06 -07002451 // Animate all the applications up now
2452 view.setAlpha(0f);
2453 view.setScaleX(0f);
2454 view.setScaleY(0f);
2455 bounceAnims.add(createNewAppBounceAnimation(view, i));
Sunny Goyal3be633b2016-12-08 09:59:25 -08002456 newItemsScreenId = item.screenId;
Sunny Goyal639e9062015-08-19 19:17:06 -07002457 }
Schneider Victor-tulias68706eb2021-04-29 15:24:54 -07002458
2459 if (newView == null) {
2460 newView = view;
2461 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002462 }
Winson Chungf0c6ae02012-03-21 16:10:31 -07002463
Schneider Victor-tulias68706eb2021-04-29 15:24:54 -07002464 View viewToFocus = newView;
2465 // Animate to the correct pager
Schneider Victor-tulias68fb4162021-09-16 13:24:01 -07002466 if (forceAnimateIcons && newItemsScreenId > -1) {
Sunny Goyalf0b6db72018-08-13 16:10:14 -07002467 AnimatorSet anim = new AnimatorSet();
2468 anim.playTogether(bounceAnims);
Schneider Victor-tulias68706eb2021-04-29 15:24:54 -07002469 if (focusFirstItemForAccessibility && viewToFocus != null) {
2470 anim.addListener(new AnimatorListenerAdapter() {
2471 @Override
2472 public void onAnimationEnd(Animator animation) {
2473 viewToFocus.sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_FOCUSED);
2474 }
2475 });
2476 }
Jon Miranda64eb8ea2018-03-29 11:43:58 -07002477
Sunny Goyalefb7e842018-10-04 15:11:00 -07002478 int currentScreenId = mWorkspace.getScreenIdForPageIndex(mWorkspace.getNextPage());
Sunny Goyalf0b6db72018-08-13 16:10:14 -07002479 final int newScreenIndex = mWorkspace.getPageIndexForScreenId(newItemsScreenId);
2480 final Runnable startBounceAnimRunnable = anim::start;
2481
Schneider Victor-tulias68fb4162021-09-16 13:24:01 -07002482 if (canAnimatePageChange && newItemsScreenId != currentScreenId) {
Sunny Goyalf0b6db72018-08-13 16:10:14 -07002483 // We post the animation slightly delayed to prevent slowdowns
2484 // when we are loading right after we return to launcher.
2485 mWorkspace.postDelayed(new Runnable() {
2486 public void run() {
2487 if (mWorkspace != null) {
Andy Wickham65ced1b2020-03-07 02:14:19 +00002488 closeOpenViews(false);
Sunny Goyalf0b6db72018-08-13 16:10:14 -07002489
2490 mWorkspace.snapToPage(newScreenIndex);
2491 mWorkspace.postDelayed(startBounceAnimRunnable,
2492 NEW_APPS_ANIMATION_DELAY);
Winson Chung94d67682013-09-25 16:29:40 -07002493 }
Sunny Goyalf0b6db72018-08-13 16:10:14 -07002494 }
2495 }, NEW_APPS_PAGE_MOVE_DELAY);
2496 } else {
2497 mWorkspace.postDelayed(startBounceAnimRunnable, NEW_APPS_ANIMATION_DELAY);
Winson Chung997a9232013-07-24 15:33:46 -07002498 }
Schneider Victor-tulias68706eb2021-04-29 15:24:54 -07002499 } else if (focusFirstItemForAccessibility && viewToFocus != null) {
2500 viewToFocus.sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_FOCUSED);
Winson Chung64359a52013-07-08 17:17:08 -07002501 }
Joe Onorato9c1289c2009-08-17 11:03:03 -04002502 workspace.requestLayout();
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002503 }
2504
Joe Onorato9c1289c2009-08-17 11:03:03 -04002505 /**
2506 * Add the views for a widget to the workspace.
Joe Onorato9c1289c2009-08-17 11:03:03 -04002507 */
Sunny Goyala9a1a212017-08-18 01:03:21 -07002508 public void bindAppWidget(LauncherAppWidgetInfo item) {
2509 View view = inflateAppWidget(item);
2510 if (view != null) {
2511 mWorkspace.addInScreen(view, item);
2512 mWorkspace.requestLayout();
2513 }
2514 }
2515
2516 private View inflateAppWidget(LauncherAppWidgetInfo item) {
Samuel Fufaca37b8a2019-08-19 17:04:36 -07002517 if (item.hasOptionFlag(LauncherAppWidgetInfo.OPTION_SEARCH_WIDGET)) {
2518 item.providerName = QsbContainerView.getSearchComponentName(this);
2519 if (item.providerName == null) {
Pinyao Ting6a41d562022-05-10 23:47:36 +00002520 getModelWriter().deleteItemFromDatabase(item,
2521 "search widget removed because search component cannot be found");
Samuel Fufaca37b8a2019-08-19 17:04:36 -07002522 return null;
2523 }
2524 }
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002525 final AppWidgetHostView view;
Sunny Goyal2e1efb42016-03-03 16:58:55 -08002526 if (mIsSafeModeEnabled) {
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002527 view = new PendingAppWidgetHostView(this, item, mIconCache, true);
Sunny Goyald5462aa2016-11-22 16:52:39 +05302528 prepareAppWidget(view, item);
Sunny Goyalb23980c2017-08-17 07:45:25 -07002529 return view;
Sunny Goyal2e1efb42016-03-03 16:58:55 -08002530 }
2531
Winson Chung5cc62c72019-10-16 11:32:41 -07002532 Object traceToken = TraceHelper.INSTANCE.beginSection("BIND_WIDGET_id=" + item.appWidgetId);
Joe Onorato9c1289c2009-08-17 11:03:03 -04002533
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002534 try {
2535 final LauncherAppWidgetProviderInfo appWidgetInfo;
Steven Ngacd9d792021-06-25 11:51:44 +01002536 String removalReason = "";
Adam Cohen59400422014-03-05 18:07:04 -08002537
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002538 if (item.hasRestoreFlag(LauncherAppWidgetInfo.FLAG_PROVIDER_NOT_READY)) {
2539 // If the provider is not ready, bind as a pending widget.
2540 appWidgetInfo = null;
Steven Ngacd9d792021-06-25 11:51:44 +01002541 removalReason = "the provider isn't ready.";
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002542 } else if (item.hasRestoreFlag(LauncherAppWidgetInfo.FLAG_ID_NOT_VALID)) {
2543 // The widget id is not valid. Try to find the widget based on the provider info.
2544 appWidgetInfo = mAppWidgetManager.findProvider(item.providerName, item.user);
Pinyao Tingbbb9a9c2021-05-11 15:42:54 -07002545 if (appWidgetInfo == null) {
2546 if (WidgetsModel.GO_DISABLE_WIDGETS) {
Steven Ngacd9d792021-06-25 11:51:44 +01002547 removalReason = "widgets are disabled on go device.";
Pinyao Tingbbb9a9c2021-05-11 15:42:54 -07002548 } else {
Steven Ngacd9d792021-06-25 11:51:44 +01002549 removalReason =
2550 "WidgetManagerHelper cannot find a provider from provider info.";
Pinyao Tingbbb9a9c2021-05-11 15:42:54 -07002551 }
2552 }
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002553 } else {
2554 appWidgetInfo = mAppWidgetManager.getLauncherAppWidgetInfo(item.appWidgetId);
Pinyao Tingbbb9a9c2021-05-11 15:42:54 -07002555 if (appWidgetInfo == null) {
2556 if (item.appWidgetId <= LauncherAppWidgetInfo.CUSTOM_WIDGET_ID) {
Steven Ngacd9d792021-06-25 11:51:44 +01002557 removalReason =
2558 "CustomWidgetManager cannot find provider from that widget id.";
Pinyao Tingbbb9a9c2021-05-11 15:42:54 -07002559 } else {
Steven Ngacd9d792021-06-25 11:51:44 +01002560 removalReason = "AppWidgetManager cannot find provider for that widget id."
2561 + " It could be because AppWidgetService is not available, or the"
Pinyao Tingbbb9a9c2021-05-11 15:42:54 -07002562 + " appWidgetId has not been bound to a the provider yet, or you"
2563 + " don't have access to that appWidgetId.";
2564 }
2565 }
Sunny Goyalff572272014-07-23 13:58:07 -07002566 }
Sunny Goyalff572272014-07-23 13:58:07 -07002567
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002568 // If the provider is ready, but the width is not yet restored, try to restore it.
2569 if (!item.hasRestoreFlag(LauncherAppWidgetInfo.FLAG_PROVIDER_NOT_READY)
2570 && (item.restoreStatus != LauncherAppWidgetInfo.RESTORE_COMPLETED)) {
2571 if (appWidgetInfo == null) {
Pinyao Ting6a41d562022-05-10 23:47:36 +00002572 getModelWriter().deleteItemFromDatabase(item,
2573 "Removing restored widget: id=" + item.appWidgetId
Pinyao Tingbbb9a9c2021-05-11 15:42:54 -07002574 + " belongs to component " + item.providerName + " user " + item.user
Steven Ngacd9d792021-06-25 11:51:44 +01002575 + ", as the provider is null and " + removalReason);
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002576 return null;
2577 }
Sunny Goyalff572272014-07-23 13:58:07 -07002578
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002579 // If we do not have a valid id, try to bind an id.
2580 if (item.hasRestoreFlag(LauncherAppWidgetInfo.FLAG_ID_NOT_VALID)) {
2581 if (!item.hasRestoreFlag(LauncherAppWidgetInfo.FLAG_ID_ALLOCATED)) {
2582 // Id has not been allocated yet. Allocate a new id.
Sihua Ma0593a0d2022-10-03 16:01:48 -07002583 item.appWidgetId = mAppWidgetHolder.allocateAppWidgetId();
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002584 item.restoreStatus |= LauncherAppWidgetInfo.FLAG_ID_ALLOCATED;
Sunny Goyal86df1382016-08-10 15:03:22 -07002585
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002586 // Also try to bind the widget. If the bind fails, the user will be shown
2587 // a click to setup UI, which will ask for the bind permission.
Yogisha Dixit658c5da2021-05-24 23:23:15 +01002588 PendingAddWidgetInfo pendingInfo =
2589 new PendingAddWidgetInfo(appWidgetInfo, item.sourceContainer);
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002590 pendingInfo.spanX = item.spanX;
2591 pendingInfo.spanY = item.spanY;
2592 pendingInfo.minSpanX = item.minSpanX;
2593 pendingInfo.minSpanY = item.minSpanY;
Sunny Goyal19ff7282021-04-22 10:12:54 -07002594 Bundle options = pendingInfo.getDefaultSizeOptions(this);
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002595
2596 boolean isDirectConfig =
2597 item.hasRestoreFlag(LauncherAppWidgetInfo.FLAG_DIRECT_CONFIG);
2598 if (isDirectConfig && item.bindOptions != null) {
2599 Bundle newOptions = item.bindOptions.getExtras();
2600 if (options != null) {
2601 newOptions.putAll(options);
2602 }
2603 options = newOptions;
Sunny Goyal86df1382016-08-10 15:03:22 -07002604 }
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002605 boolean success = mAppWidgetManager.bindAppWidgetIdIfAllowed(
2606 item.appWidgetId, appWidgetInfo, options);
2607
2608 // We tried to bind once. If we were not able to bind, we would need to
2609 // go through the permission dialog, which means we cannot skip the config
2610 // activity.
2611 item.bindOptions = null;
2612 item.restoreStatus &= ~LauncherAppWidgetInfo.FLAG_DIRECT_CONFIG;
2613
2614 // Bind succeeded
2615 if (success) {
2616 // If the widget has a configure activity, it is still needs to set it
2617 // up, otherwise the widget is ready to go.
2618 item.restoreStatus = (appWidgetInfo.configure == null) || isDirectConfig
2619 ? LauncherAppWidgetInfo.RESTORE_COMPLETED
2620 : LauncherAppWidgetInfo.FLAG_UI_NOT_READY;
2621 }
2622
2623 getModelWriter().updateItemInDatabase(item);
Sunny Goyal86df1382016-08-10 15:03:22 -07002624 }
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002625 } else if (item.hasRestoreFlag(LauncherAppWidgetInfo.FLAG_UI_NOT_READY)
2626 && (appWidgetInfo.configure == null)) {
2627 // The widget was marked as UI not ready, but there is no configure activity to
2628 // update the UI.
2629 item.restoreStatus = LauncherAppWidgetInfo.RESTORE_COMPLETED;
Sunny Goyal43bf11d2017-02-02 13:52:53 -08002630 getModelWriter().updateItemInDatabase(item);
Sunny Goyalff572272014-07-23 13:58:07 -07002631 }
Samuel Fufa9151c012020-02-24 17:06:28 -08002632 else if (item.hasRestoreFlag(LauncherAppWidgetInfo.FLAG_UI_NOT_READY)
2633 && appWidgetInfo.configure != null) {
2634 if (mAppWidgetManager.isAppWidgetRestored(item.appWidgetId)) {
2635 item.restoreStatus = LauncherAppWidgetInfo.RESTORE_COMPLETED;
2636 getModelWriter().updateItemInDatabase(item);
2637 }
2638 }
Sunny Goyal56c73602015-09-25 12:55:01 -07002639 }
2640
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002641 if (item.restoreStatus == LauncherAppWidgetInfo.RESTORE_COMPLETED) {
2642 // Verify that we own the widget
2643 if (appWidgetInfo == null) {
Pinyao Ting0d97f8d2020-12-04 15:12:26 -08002644 FileLog.e(TAG, "Removing invalid widget: id=" + item.appWidgetId);
Sihua Ma0593a0d2022-10-03 16:01:48 -07002645 getModelWriter().deleteWidgetInfo(item, getAppWidgetHolder(), removalReason);
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002646 return null;
2647 }
Joe Onorato9c1289c2009-08-17 11:03:03 -04002648
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002649 item.minSpanX = appWidgetInfo.minSpanX;
2650 item.minSpanY = appWidgetInfo.minSpanY;
Sihua Ma0593a0d2022-10-03 16:01:48 -07002651 view = mAppWidgetHolder.createView(this, item.appWidgetId, appWidgetInfo);
Samuel Fufa9151c012020-02-24 17:06:28 -08002652 } else if (!item.hasRestoreFlag(LauncherAppWidgetInfo.FLAG_ID_NOT_VALID)
2653 && appWidgetInfo != null) {
Sihua Ma0593a0d2022-10-03 16:01:48 -07002654 mAppWidgetHolder.addPendingView(item.appWidgetId,
Samuel Fufa9151c012020-02-24 17:06:28 -08002655 new PendingAppWidgetHostView(this, item, mIconCache, false));
Sihua Ma0593a0d2022-10-03 16:01:48 -07002656 view = mAppWidgetHolder.createView(this, item.appWidgetId, appWidgetInfo);
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002657 } else {
2658 view = new PendingAppWidgetHostView(this, item, mIconCache, false);
2659 }
2660 prepareAppWidget(view, item);
2661 } finally {
Winson Chung5cc62c72019-10-16 11:32:41 -07002662 TraceHelper.INSTANCE.endSection(traceToken);
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002663 }
2664
Sunny Goyalb23980c2017-08-17 07:45:25 -07002665 return view;
Joe Onorato9c1289c2009-08-17 11:03:03 -04002666 }
2667
Sunny Goyalff572272014-07-23 13:58:07 -07002668 /**
2669 * Restores a pending widget.
2670 *
2671 * @param appWidgetId The app widget id
Sunny Goyalff572272014-07-23 13:58:07 -07002672 */
Sunny Goyald478c832016-04-01 12:04:16 -07002673 private LauncherAppWidgetInfo completeRestoreAppWidget(int appWidgetId, int finalRestoreFlag) {
Sunny Goyalff572272014-07-23 13:58:07 -07002674 LauncherAppWidgetHostView view = mWorkspace.getWidgetForAppWidgetId(appWidgetId);
2675 if ((view == null) || !(view instanceof PendingAppWidgetHostView)) {
2676 Log.e(TAG, "Widget update called, when the widget no longer exists.");
Sunny Goyald478c832016-04-01 12:04:16 -07002677 return null;
Sunny Goyalff572272014-07-23 13:58:07 -07002678 }
2679
Sunny Goyal0fc1be12014-08-11 17:05:23 -07002680 LauncherAppWidgetInfo info = (LauncherAppWidgetInfo) view.getTag();
Sunny Goyald478c832016-04-01 12:04:16 -07002681 info.restoreStatus = finalRestoreFlag;
Jon Miranda2b823f42017-05-02 18:36:18 -07002682 if (info.restoreStatus == LauncherAppWidgetInfo.RESTORE_COMPLETED) {
2683 info.pendingItemInfo = null;
2684 }
Sunny Goyalff572272014-07-23 13:58:07 -07002685
Sunny Goyalba47faa2017-10-04 16:50:57 -07002686 if (((PendingAppWidgetHostView) view).isReinflateIfNeeded()) {
Sunny Goyal29947f02017-12-18 13:49:44 -08002687 view.reInflate();
Sunny Goyalba47faa2017-10-04 16:50:57 -07002688 }
2689
Sunny Goyal43bf11d2017-02-02 13:52:53 -08002690 getModelWriter().updateItemInDatabase(info);
Sunny Goyald478c832016-04-01 12:04:16 -07002691 return info;
Sunny Goyalff572272014-07-23 13:58:07 -07002692 }
2693
Sunny Goyal527c7d32015-08-28 15:19:36 -07002694 public void clearPendingExecutor(ViewOnDrawExecutor executor) {
2695 if (mPendingExecutor == executor) {
2696 mPendingExecutor = null;
2697 }
2698 }
2699
Sunny Goyalb5b9ad62016-04-02 11:23:39 -07002700 @Override
Schneider Victor-tulias927d6dc2021-08-26 11:56:47 -07002701 @TargetApi(Build.VERSION_CODES.S)
Sunny Goyal4a48a982021-06-17 15:15:46 -07002702 public void onInitialBindComplete(IntSet boundPages, RunnableList pendingTasks) {
2703 mSynchronouslyBoundPages = boundPages;
Sunny Goyal4a48a982021-06-17 15:15:46 -07002704 mPagesToBindSynchronously = new IntSet();
2705
2706 clearPendingBinds();
2707 ViewOnDrawExecutor executor = new ViewOnDrawExecutor(pendingTasks);
2708 mPendingExecutor = executor;
2709 if (!isInState(ALL_APPS)) {
2710 mAppsView.getAppsStore().enableDeferUpdates(AllAppsStore.DEFER_UPDATES_NEXT_DRAW);
2711 pendingTasks.add(() -> mAppsView.getAppsStore().disableDeferUpdates(
2712 AllAppsStore.DEFER_UPDATES_NEXT_DRAW));
2713 }
2714
Sunny Goyal7b8d63f2022-04-14 16:37:32 -07002715 if (mOnInitialBindListener != null) {
2716 getRootView().getViewTreeObserver().removeOnPreDrawListener(mOnInitialBindListener);
2717 mOnInitialBindListener = null;
Sunny Goyalb5b9ad62016-04-02 11:23:39 -07002718 }
Sunny Goyal7b8d63f2022-04-14 16:37:32 -07002719
2720 executor.onLoadAnimationCompleted();
Sunny Goyal4a48a982021-06-17 15:15:46 -07002721 executor.attachTo(this);
Schneider Victor-tulias927d6dc2021-08-26 11:56:47 -07002722 if (Utilities.ATLEAST_S) {
2723 Trace.endAsyncSection(DISPLAY_WORKSPACE_TRACE_METHOD_NAME,
2724 DISPLAY_WORKSPACE_TRACE_COOKIE);
2725 }
Sunny Goyalb5b9ad62016-04-02 11:23:39 -07002726 }
2727
Joe Onorato9c1289c2009-08-17 11:03:03 -04002728 /**
2729 * Callback saying that there aren't any more items to bind.
2730 *
2731 * Implementation of the method from LauncherModel.Callbacks.
2732 */
Andras Kloczl55edfe52021-05-14 12:21:30 +02002733 public void finishBindingItems(IntSet pagesBoundFirst) {
Winson Chung5cc62c72019-10-16 11:32:41 -07002734 Object traceToken = TraceHelper.INSTANCE.beginSection("finishBindingItems");
Adam Cohen1462de32012-07-24 22:34:36 -07002735 mWorkspace.restoreInstanceStateForRemainingPages();
Joe Onorato9c1289c2009-08-17 11:03:03 -04002736
Anjali Koppalff7ceff2014-05-01 18:26:37 -07002737 setWorkspaceLoading(false);
Adam Cohendb364c32014-05-20 14:23:40 -07002738
Sunny Goyal2100c782016-08-22 16:00:03 -07002739 if (mPendingActivityResult != null) {
2740 handleActivityResult(mPendingActivityResult.requestCode,
2741 mPendingActivityResult.resultCode, mPendingActivityResult.data);
2742 mPendingActivityResult = null;
Adam Cohendb364c32014-05-20 14:23:40 -07002743 }
2744
Andras Kloczl55edfe52021-05-14 12:21:30 +02002745 int currentPage = pagesBoundFirst != null && !pagesBoundFirst.isEmpty()
Sunny Goyal12e3f1f2021-07-15 14:31:58 -07002746 ? mWorkspace.getPageIndexForScreenId(pagesBoundFirst.getArray().get(0))
2747 : PagedView.INVALID_PAGE;
Tonyf80e8932018-12-21 11:58:04 -08002748 // When undoing the removal of the last item on a page, return to that page.
Tony Wickham03f27012019-04-25 14:22:54 -07002749 // Since we are just resetting the current page without user interaction,
2750 // override the previous page so we don't log the page switch.
Andras Kloczl55edfe52021-05-14 12:21:30 +02002751 mWorkspace.setCurrentPage(currentPage, currentPage /* overridePrevPage */);
2752 mPagesToBindSynchronously = new IntSet();
Tony Wickham6a71a5b2018-08-21 11:40:23 -07002753
Sunny Goyalac6f69f2019-08-16 11:59:55 -07002754 // Cache one page worth of icons
2755 getViewCache().setCacheSize(R.layout.folder_application,
2756 mDeviceProfile.inv.numFolderColumns * mDeviceProfile.inv.numFolderRows);
2757 getViewCache().setCacheSize(R.layout.folder_page, 2);
2758
Winson Chung5cc62c72019-10-16 11:32:41 -07002759 TraceHelper.INSTANCE.endSection(traceToken);
Sebastian Francofa37a0a2022-05-18 10:14:01 -07002760
2761 mWorkspace.removeExtraEmptyScreen(true);
Winson Chungf0c6ae02012-03-21 16:10:31 -07002762 }
2763
Schneider Victor-tulias68fb4162021-09-16 13:24:01 -07002764 private boolean canAnimatePageChange() {
Sunny Goyal9b180102020-03-11 10:02:29 -07002765 if (mDragController.isDragging()) {
2766 return false;
2767 } else {
Riddle Hsu979da642020-09-22 21:52:40 +08002768 return (SystemClock.uptimeMillis() - mLastTouchUpTime)
Sunny Goyal9b180102020-03-11 10:02:29 -07002769 > (NEW_APPS_ANIMATION_INACTIVE_TIMEOUT_SECONDS * 1000);
2770 }
Winson Chunga2413752012-04-03 14:22:34 -07002771 }
2772
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002773 /**
2774 * Similar to {@link #getFirstMatch} but optimized to finding a suitable view for the app close
2775 * animation.
2776 *
2777 * @param preferredItemId The id of the preferred item to match to if it exists.
2778 * @param packageName The package name of the app to match.
2779 * @param user The user of the app to match.
Jon Mirandab42e1242022-03-08 16:37:35 -08002780 * @param supportsAllAppsState If true and we are in All Apps state, looks for view in All Apps.
2781 * Else we only looks on the workspace.
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002782 */
Jon Mirandaf58db152022-06-02 16:06:37 -07002783 public @Nullable View getFirstMatchForAppClose(int preferredItemId, String packageName,
2784 UserHandle user, boolean supportsAllAppsState) {
Sunny Goyal32084d42022-05-02 10:00:07 -07002785 final Predicate<ItemInfo> preferredItem = info ->
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002786 info != null && info.id == preferredItemId;
Sunny Goyal32084d42022-05-02 10:00:07 -07002787 final Predicate<ItemInfo> packageAndUserAndApp = info ->
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002788 info != null
2789 && info.itemType == ITEM_TYPE_APPLICATION
2790 && info.user.equals(user)
2791 && info.getTargetComponent() != null
2792 && TextUtils.equals(info.getTargetComponent().getPackageName(),
2793 packageName);
2794
Jon Mirandab42e1242022-03-08 16:37:35 -08002795 if (supportsAllAppsState && isInState(LauncherState.ALL_APPS)) {
Jon Mirandaf58db152022-06-02 16:06:37 -07002796 AllAppsRecyclerView activeRecyclerView = mAppsView.getActiveRecyclerView();
2797 View v = getFirstMatch(Collections.singletonList(activeRecyclerView),
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002798 preferredItem, packageAndUserAndApp);
Jon Mirandaf58db152022-06-02 16:06:37 -07002799
Sunny Goyalf34811d2022-10-21 20:42:34 +00002800 if (v != null && activeRecyclerView.computeVerticalScrollOffset() > 0) {
Jon Mirandaf58db152022-06-02 16:06:37 -07002801 RectF locationBounds = new RectF();
2802 FloatingIconView.getLocationBoundsForView(this, v, false, locationBounds,
2803 new Rect());
2804 if (locationBounds.top < mAppsView.getHeaderBottom()) {
2805 // Icon is covered by scrim, return null to play fallback animation.
2806 return null;
2807 }
2808 }
2809
2810 return v;
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002811 }
Federico Baron8bf1bca2022-09-27 16:19:11 -07002812
2813 // Look for the item inside the folder at the current page
2814 Folder folder = Folder.getOpen(this);
2815 if (folder != null) {
2816 View v = getFirstMatch(Collections.singletonList(
2817 folder.getContent().getCurrentCellLayout().getShortcutsAndWidgets()),
2818 preferredItem,
2819 packageAndUserAndApp);
2820 if (v == null) {
2821 folder.close(isStarted() && !isForceInvisible());
2822 } else {
2823 return v;
2824 }
2825 }
2826
2827 List<ViewGroup> containers = new ArrayList<>(mWorkspace.getPanelCount() + 1);
2828 containers.add(mWorkspace.getHotseat().getShortcutsAndWidgets());
2829 mWorkspace.forEachVisiblePage(page
2830 -> containers.add(((CellLayout) page).getShortcutsAndWidgets()));
2831
2832 // Order: Preferred item by itself or in folder, then by matching package/user
2833 return getFirstMatch(containers, preferredItem, forFolderMatch(preferredItem),
2834 packageAndUserAndApp, forFolderMatch(packageAndUserAndApp));
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002835 }
2836
2837 /**
2838 * Finds the first view matching the ordered operators across the given viewgroups in order.
2839 * @param containers List of ViewGroups to scan, in order of preference.
2840 * @param operators List of operators, in order starting from best matching operator.
2841 */
Jon Mirandaf26bdcb2022-06-09 16:09:30 -07002842 @Nullable
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002843 private static View getFirstMatch(Iterable<ViewGroup> containers,
Sunny Goyal32084d42022-05-02 10:00:07 -07002844 final Predicate<ItemInfo>... operators) {
2845 for (Predicate<ItemInfo> operator : operators) {
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002846 for (ViewGroup container : containers) {
2847 View match = mapOverViewGroup(container, operator);
2848 if (match != null) {
2849 return match;
2850 }
2851 }
2852 }
2853 return null;
2854 }
2855
2856 /**
2857 * Returns the first view matching the operator in the given ViewGroups, or null if none.
2858 * Forward iteration matters.
2859 */
Jon Mirandaf26bdcb2022-06-09 16:09:30 -07002860 @Nullable
Sunny Goyal32084d42022-05-02 10:00:07 -07002861 private static View mapOverViewGroup(ViewGroup container, Predicate<ItemInfo> op) {
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002862 final int itemCount = container.getChildCount();
2863 for (int itemIdx = 0; itemIdx < itemCount; itemIdx++) {
2864 View item = container.getChildAt(itemIdx);
Sunny Goyal32084d42022-05-02 10:00:07 -07002865 if (op.test((ItemInfo) item.getTag())) {
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002866 return item;
2867 }
2868 }
2869 return null;
2870 }
2871
Winson Chungc9168342013-06-26 14:54:55 -07002872 private ValueAnimator createNewAppBounceAnimation(View v, int i) {
Sunny Goyalf0b6db72018-08-13 16:10:14 -07002873 ValueAnimator bounceAnim = new PropertyListBuilder().alpha(1).scale(1).build(v)
Sunny Goyal60e68c92020-08-12 13:59:27 -07002874 .setDuration(ItemInstallQueue.NEW_SHORTCUT_BOUNCE_DURATION);
2875 bounceAnim.setStartDelay(i * ItemInstallQueue.NEW_SHORTCUT_STAGGER_DELAY);
Sunny Goyal5a1f53b2015-05-27 10:24:24 -07002876 bounceAnim.setInterpolator(new OvershootInterpolator(BOUNCE_ANIMATION_TENSION));
Winson Chungc9168342013-06-26 14:54:55 -07002877 return bounceAnim;
2878 }
2879
Pinyao Tingc9074272019-11-11 11:51:44 -08002880 private void announceForAccessibility(@StringRes int stringResId) {
2881 getDragLayer().announceForAccessibility(getString(stringResId));
2882 }
2883
Amith Yamasani6d7fe502010-11-16 09:05:07 -08002884 /**
Josh Tsuji231c9222022-01-11 20:43:59 -05002885 * Informs us that the overlay (-1 screen, typically), has either become visible or invisible.
2886 */
Sunny Goyal82379182022-11-02 18:58:49 -07002887 public void onOverlayVisibilityChanged(boolean visible) {
2888 getStatsLogManager().logger()
2889 .withSrcState(LAUNCHER_STATE_HOME)
2890 .withDstState(LAUNCHER_STATE_HOME)
2891 .withContainerInfo(LauncherAtom.ContainerInfo.newBuilder()
2892 .setWorkspace(WorkspaceContainer.newBuilder()
2893 .setPageIndex(visible ? 0 : -1))
2894 .build())
2895 .log(visible ? LAUNCHER_SWIPELEFT : LAUNCHER_SWIPERIGHT);
2896 }
Josh Tsuji231c9222022-01-11 20:43:59 -05002897
2898 /**
2899 * Informs us that the page transition has ended, so that we can react to the newly selected
2900 * page if we want to.
2901 */
2902 public void onPageEndTransition() {}
2903
2904 /**
Joe Onorato9c1289c2009-08-17 11:03:03 -04002905 * Add the icons for all apps.
2906 *
2907 * Implementation of the method from LauncherModel.Callbacks.
2908 */
Sunny Goyal28daf4a2020-06-08 17:06:09 -07002909 @Override
Schneider Victor-tulias927d6dc2021-08-26 11:56:47 -07002910 @TargetApi(Build.VERSION_CODES.S)
Sunny Goyal28daf4a2020-06-08 17:06:09 -07002911 public void bindAllApplications(AppInfo[] apps, int flags) {
2912 mAppsView.getAppsStore().setApps(apps, flags);
Sunny Goyal1818fb72020-11-09 14:32:48 -08002913 PopupContainerWithArrow.dismissInvalidPopup(this);
Schneider Victor-tulias927d6dc2021-08-26 11:56:47 -07002914 if (Utilities.ATLEAST_S) {
2915 Trace.endAsyncSection(DISPLAY_ALL_APPS_TRACE_METHOD_NAME,
2916 DISPLAY_ALL_APPS_TRACE_COOKIE);
2917 }
Joe Onorato9c1289c2009-08-17 11:03:03 -04002918 }
2919
2920 /**
Zak Cohen658c67a2018-10-19 14:21:05 -07002921 * Copies LauncherModel's map of activities to shortcut counts to Launcher's. This is necessary
Tony Wickhambfbf7f92016-05-19 11:19:39 -07002922 * because LauncherModel's map is updated in the background, while Launcher runs on the UI.
2923 */
2924 @Override
Zak Cohen658c67a2018-10-19 14:21:05 -07002925 public void bindDeepShortcutMap(HashMap<ComponentKey, Integer> deepShortcutMapCopy) {
Tony Wickham010d2552017-01-20 08:15:28 -08002926 mPopupDataProvider.setDeepShortcutMap(deepShortcutMapCopy);
Tony Wickham1bce7fd2016-04-28 17:39:03 -07002927 }
2928
Sunny Goyal4390ace2014-10-13 11:33:11 -07002929 @Override
Schneider Victor-tulias6a5f4312021-01-12 19:30:02 +00002930 public void bindIncrementalDownloadProgressUpdated(AppInfo app) {
2931 mAppsView.getAppsStore().updateProgressBar(app);
Mario Bertschler08ffaae2017-03-20 11:30:27 -07002932 }
2933
2934 @Override
Sunny Goyal29947f02017-12-18 13:49:44 -08002935 public void bindWidgetsRestored(ArrayList<LauncherAppWidgetInfo> widgets) {
Sunny Goyal4390ace2014-10-13 11:33:11 -07002936 mWorkspace.widgetsRestored(widgets);
2937 }
2938
Joe Onorato9c1289c2009-08-17 11:03:03 -04002939 /**
Sunny Goyalb50cc8c2014-10-06 16:23:56 -07002940 * Some shortcuts were updated in the background.
Sunny Goyalb50cc8c2014-10-06 16:23:56 -07002941 * Implementation of the method from LauncherModel.Callbacks.
Sunny Goyald3b87ef2016-07-28 12:11:54 -07002942 *
2943 * @param updated list of shortcuts which have changed.
Sunny Goyalb50cc8c2014-10-06 16:23:56 -07002944 */
Sunny Goyal4390ace2014-10-13 11:33:11 -07002945 @Override
Sunny Goyal28f50752020-07-21 14:15:13 -07002946 public void bindWorkspaceItemsChanged(List<WorkspaceItemInfo> updated) {
Sunny Goyal4390ace2014-10-13 11:33:11 -07002947 if (!updated.isEmpty()) {
Sunny Goyal711c5962021-06-23 12:36:18 -07002948 mWorkspace.updateWorkspaceItems(updated, this);
Sunny Goyal1818fb72020-11-09 14:32:48 -08002949 PopupContainerWithArrow.dismissInvalidPopup(this);
Sunny Goyal4390ace2014-10-13 11:33:11 -07002950 }
Sunny Goyalb50cc8c2014-10-06 16:23:56 -07002951 }
2952
2953 /**
Chris Wrenaeff7ea2014-02-14 16:59:24 -05002954 * Update the state of a package, typically related to install state.
2955 *
2956 * Implementation of the method from LauncherModel.Callbacks.
2957 */
Sunny Goyale755d462014-07-22 13:48:29 -07002958 @Override
Sunny Goyal29947f02017-12-18 13:49:44 -08002959 public void bindRestoreItemsChange(HashSet<ItemInfo> updates) {
Sunny Goyal711c5962021-06-23 12:36:18 -07002960 mWorkspace.updateRestoreItems(updates, this);
Sunny Goyala22666f2014-09-18 13:25:15 -07002961 }
2962
2963 /**
Sunny Goyal3bbbabc2016-03-15 09:16:30 -07002964 * A package was uninstalled/updated. We take both the super set of packageNames
Winson Chung83892cc2013-05-01 16:53:33 -07002965 * in addition to specific applications to remove, the reason being that
2966 * this can be called when a package is updated as well. In that scenario,
Sunny Goyal3bbbabc2016-03-15 09:16:30 -07002967 * we only remove specific components from the workspace and hotseat, where as
Winson Chung83892cc2013-05-01 16:53:33 -07002968 * package-removal should clear all items by package name.
Joe Onorato9c1289c2009-08-17 11:03:03 -04002969 */
Sunny Goyal1a745e82014-10-02 15:58:31 -07002970 @Override
Sunny Goyal32084d42022-05-02 10:00:07 -07002971 public void bindWorkspaceComponentsRemoved(Predicate<ItemInfo> matcher) {
Sunny Goyal6e13dd32017-08-17 03:01:19 -07002972 mWorkspace.removeItemsByMatcher(matcher);
2973 mDragController.onAppsRemoved(matcher);
Sunny Goyal1818fb72020-11-09 14:32:48 -08002974 PopupContainerWithArrow.dismissInvalidPopup(this);
Sunny Goyal3bbbabc2016-03-15 09:16:30 -07002975 }
Sunny Goyal4390ace2014-10-13 11:33:11 -07002976
Sunny Goyal3bbbabc2016-03-15 09:16:30 -07002977 @Override
Steven Ng2f5648a2021-02-08 17:18:25 +00002978 public void bindAllWidgets(final List<WidgetsListBaseEntry> allWidgets) {
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -07002979 mPopupDataProvider.setAllWidgets(allWidgets);
Tony Wickham26b17462017-03-20 17:12:24 -07002980 }
2981
kholoud mohamedc76b2032021-12-20 16:47:38 +00002982 @Override
2983 public void bindStringCache(StringCache cache) {
2984 mStringCache = cache;
2985 }
2986
2987 @Override
2988 public StringCache getStringCache() {
2989 return mStringCache;
2990 }
2991
Tony Wickham86222d22017-03-29 15:30:43 -07002992 /**
2993 * @param packageUser if null, refreshes all widgets and shortcuts, otherwise only
2994 * refreshes the widgets and shortcuts associated with the given package/user
2995 */
2996 public void refreshAndBindWidgetsForPackageUser(@Nullable PackageUserKey packageUser) {
Sunny Goyalc6e97692017-06-02 13:46:55 -07002997 mModel.refreshAndBindWidgetsAndShortcuts(packageUser);
Sunny Goyal2e1efb42016-03-03 16:58:55 -08002998 }
2999
Winson Chung80baf5a2010-08-09 16:03:15 -07003000 /**
Hyunyoung Song3c7d9cb2017-01-30 15:11:27 -08003001 * $ adb shell dumpsys activity com.android.launcher3.Launcher [--all]
Joe Onoratobe386092009-11-17 17:32:16 -08003002 */
Adam Cohen16d7ffc2011-10-05 17:49:14 -07003003 @Override
3004 public void dump(String prefix, FileDescriptor fd, PrintWriter writer, String[] args) {
3005 super.dump(prefix, fd, writer, args);
Sunny Goyala1365452015-10-01 15:46:24 -07003006
Hyunyoung Song3c7d9cb2017-01-30 15:11:27 -08003007 if (args.length > 0 && TextUtils.equals(args[0], "--all")) {
3008 writer.println(prefix + "Workspace Items");
Sunny Goyal7ce471b2017-08-02 03:37:39 -07003009 for (int i = 0; i < mWorkspace.getPageCount(); i++) {
Hyunyoung Song3c7d9cb2017-01-30 15:11:27 -08003010 writer.println(prefix + " Homescreen " + i);
3011
3012 ViewGroup layout = ((CellLayout) mWorkspace.getPageAt(i)).getShortcutsAndWidgets();
3013 for (int j = 0; j < layout.getChildCount(); j++) {
3014 Object tag = layout.getChildAt(j).getTag();
3015 if (tag != null) {
3016 writer.println(prefix + " " + tag.toString());
3017 }
3018 }
3019 }
3020
3021 writer.println(prefix + " Hotseat");
Sunny Goyal876e4622018-11-02 13:50:40 -07003022 ViewGroup layout = mHotseat.getShortcutsAndWidgets();
Sunny Goyala1365452015-10-01 15:46:24 -07003023 for (int j = 0; j < layout.getChildCount(); j++) {
3024 Object tag = layout.getChildAt(j).getTag();
3025 if (tag != null) {
3026 writer.println(prefix + " " + tag.toString());
3027 }
Adam Cohen4caf2982013-08-20 18:54:31 -07003028 }
Sunny Goyala1365452015-10-01 15:46:24 -07003029 }
3030
Hyunyoung Song3c7d9cb2017-01-30 15:11:27 -08003031 writer.println(prefix + "Misc:");
Winson Chungef528762019-09-06 12:05:52 -07003032 dumpMisc(prefix + "\t", writer);
3033 writer.println(prefix + "\tmWorkspaceLoading=" + mWorkspaceLoading);
3034 writer.println(prefix + "\tmPendingRequestArgs=" + mPendingRequestArgs
3035 + " mPendingActivityResult=" + mPendingActivityResult);
3036 writer.println(prefix + "\tmRotationHelper: " + mRotationHelper);
Sihua Ma0593a0d2022-10-03 16:01:48 -07003037 writer.println(prefix + "\tmAppWidgetHolder.isListening: "
3038 + mAppWidgetHolder.isListening());
Winson Chungef528762019-09-06 12:05:52 -07003039
Tony Wickham646e4482020-04-06 17:25:53 -07003040 // Extra logging for general debugging
Hyunyoung Songa310a802019-04-25 13:57:16 -07003041 mDragLayer.dump(prefix, writer);
3042 mStateManager.dump(prefix, writer);
Tony Wickham646e4482020-04-06 17:25:53 -07003043 mPopupDataProvider.dump(prefix, writer);
Pat Manning5f74bfd2022-07-20 12:08:54 +01003044 mDeviceProfile.dump(this, prefix, writer);
Sunny Goyal2bba1902018-02-27 12:20:50 -08003045
3046 try {
3047 FileLog.flushAll(writer);
3048 } catch (Exception e) {
3049 // Ignore
3050 }
Hyunyoung Song3c7d9cb2017-01-30 15:11:27 -08003051
3052 mModel.dumpState(prefix, fd, writer, args);
Sunny Goyala1365452015-10-01 15:46:24 -07003053
Adam Cohen9211d422014-10-07 18:14:53 -07003054 if (mLauncherCallbacks != null) {
3055 mLauncherCallbacks.dump(prefix, fd, writer, args);
3056 }
Sunny Goyalb1d7de22019-09-06 10:36:54 -07003057 mOverlayManager.dump(prefix, writer);
Adam Cohen16d7ffc2011-10-05 17:49:14 -07003058 }
Adam Cohen487f7dd2012-06-28 18:12:10 -07003059
Sunny Goyal66b24572016-09-21 15:57:55 -07003060 @Override
Sunny Goyal66b24572016-09-21 15:57:55 -07003061 public void onProvideKeyboardShortcuts(
3062 List<KeyboardShortcutGroup> data, Menu menu, int deviceId) {
3063
3064 ArrayList<KeyboardShortcutInfo> shortcutInfos = new ArrayList<>();
Sunny Goyal3e3f44c2017-10-23 17:14:52 -07003065 if (isInState(NORMAL)) {
Sunny Goyal66b24572016-09-21 15:57:55 -07003066 shortcutInfos.add(new KeyboardShortcutInfo(getString(R.string.all_apps_button_label),
3067 KeyEvent.KEYCODE_A, KeyEvent.META_CTRL_ON));
Vadim Tryshev74c261c2018-06-12 13:44:43 -07003068 shortcutInfos.add(new KeyboardShortcutInfo(getString(R.string.widget_button_text),
3069 KeyEvent.KEYCODE_W, KeyEvent.META_CTRL_ON));
Sunny Goyal66b24572016-09-21 15:57:55 -07003070 }
Sunny Goyal384b5782021-02-09 22:50:02 -08003071 getSupportedActions(this, getCurrentFocus()).forEach(la ->
Vadim Tryshev3455f8d2018-05-11 20:02:20 -07003072 shortcutInfos.add(new KeyboardShortcutInfo(
Sunny Goyal384b5782021-02-09 22:50:02 -08003073 la.accessibilityAction.getLabel(), la.keyCode, KeyEvent.META_CTRL_ON)));
Sunny Goyal66b24572016-09-21 15:57:55 -07003074 if (!shortcutInfos.isEmpty()) {
3075 data.add(new KeyboardShortcutGroup(getString(R.string.home_screen), shortcutInfos));
3076 }
3077
3078 super.onProvideKeyboardShortcuts(data, menu, deviceId);
3079 }
3080
3081 @Override
3082 public boolean onKeyShortcut(int keyCode, KeyEvent event) {
3083 if (event.hasModifiers(KeyEvent.META_CTRL_ON)) {
3084 switch (keyCode) {
3085 case KeyEvent.KEYCODE_A:
Sunny Goyal3e3f44c2017-10-23 17:14:52 -07003086 if (isInState(NORMAL)) {
3087 getStateManager().goToState(ALL_APPS);
Sunny Goyal66b24572016-09-21 15:57:55 -07003088 return true;
3089 }
3090 break;
Vadim Tryshev74c261c2018-06-12 13:44:43 -07003091 case KeyEvent.KEYCODE_W:
3092 if (isInState(NORMAL)) {
3093 OptionsPopupView.openWidgets(this);
3094 return true;
3095 }
3096 break;
Sunny Goyal384b5782021-02-09 22:50:02 -08003097 default:
3098 for (LauncherAction la : getSupportedActions(this, getCurrentFocus())) {
3099 if (la.keyCode == keyCode) {
3100 return la.invokeFromKeyboard(getCurrentFocus());
3101 }
3102 }
Sunny Goyal66b24572016-09-21 15:57:55 -07003103 }
3104 }
3105 return super.onKeyShortcut(keyCode, event);
3106 }
3107
Vadim Tryshev646a0dd2018-02-05 16:27:50 -08003108 @Override
3109 public boolean onKeyUp(int keyCode, KeyEvent event) {
3110 if (keyCode == KeyEvent.KEYCODE_MENU) {
3111 // KEYCODE_MENU is sent by some tests, for example
3112 // LauncherJankTests#testWidgetsContainerFling. Don't just remove its handling.
3113 if (!mDragController.isDragging() && !mWorkspace.isSwitchingState() &&
3114 isInState(NORMAL)) {
3115 // Close any open floating views.
Andy Wickham65ced1b2020-03-07 02:14:19 +00003116 closeOpenViews();
Vadim Tryshev646a0dd2018-02-05 16:27:50 -08003117
3118 // Setting the touch point to (-1, -1) will show the options popup in the center of
3119 // the screen.
vadimtbc5d7e62019-12-09 13:53:05 -08003120 if (Utilities.IS_RUNNING_IN_TEST_HARNESS) {
3121 Log.d(TestProtocol.PERMANENT_DIAG_TAG, "Opening options popup on key up");
3122 }
Sunny Goyal831212e2021-05-14 14:24:09 -07003123 showDefaultOptions(-1, -1);
Vadim Tryshev646a0dd2018-02-05 16:27:50 -08003124 }
3125 return true;
3126 }
3127 return super.onKeyUp(keyCode, event);
3128 }
3129
Sunny Goyal831212e2021-05-14 14:24:09 -07003130 /**
3131 * Shows the default options popup
3132 */
3133 public void showDefaultOptions(float x, float y) {
Brian Isganitisa85ae692021-09-23 19:56:24 -04003134 OptionsPopupView.show(this, getPopupTarget(x, y), OptionsPopupView.getOptions(this),
3135 false);
3136 }
3137
3138 /**
3139 * Returns target rectangle for anchoring a popup menu.
3140 */
3141 protected RectF getPopupTarget(float x, float y) {
Sunny Goyal831212e2021-05-14 14:24:09 -07003142 float halfSize = getResources().getDimension(R.dimen.options_menu_thumb_size) / 2;
3143 if (x < 0 || y < 0) {
3144 x = mDragLayer.getWidth() / 2;
3145 y = mDragLayer.getHeight() / 2;
3146 }
Brian Isganitisa85ae692021-09-23 19:56:24 -04003147 return new RectF(x - halfSize, y - halfSize, x + halfSize, y + halfSize);
3148 }
3149
3150 @Override
3151 public boolean shouldUseColorExtractionForPopup() {
3152 return getTopOpenViewWithType(this, TYPE_FOLDER) == null
3153 && getStateManager().getState() != LauncherState.ALL_APPS;
Sunny Goyal831212e2021-05-14 14:24:09 -07003154 }
3155
Sunny Goyalb5181c82021-03-10 07:39:12 +00003156 @Override
3157 protected void collectStateHandlers(List<StateHandler> out) {
3158 out.add(getAllAppsController());
3159 out.add(getWorkspace());
Andrew Sappersteinabef55a2016-06-19 12:49:00 -07003160 }
3161
Sunny Goyal210e1742019-10-17 12:05:38 -07003162 public TouchController[] createTouchControllers() {
3163 return new TouchController[] {getDragController(), new AllAppsSwipeController(this)};
3164 }
3165
Sunny Goyal210e1742019-10-17 12:05:38 -07003166 public void useFadeOutAnimationForLauncherStart(CancellationSignal signal) { }
3167
Sunny Goyal1eb11242022-09-09 17:14:45 -07003168 public void onDragLayerHierarchyChanged() {
3169 updateDisallowBack();
3170 }
3171
3172 private void updateDisallowBack() {
Ats Jenk8121e0d2022-12-01 11:34:43 -08003173 if (DESKTOP_MODE_1_SUPPORTED || DESKTOP_MODE_2_SUPPORTED) {
3174 // Do not disable back in launcher when prototype behavior is enabled
3175 return;
3176 }
Sunny Goyal1eb11242022-09-09 17:14:45 -07003177 LauncherRootView rv = getRootView();
3178 if (rv != null) {
3179 boolean disableBack = getStateManager().getState() == NORMAL
3180 && AbstractFloatingView.getTopOpenView(this) == null;
3181 rv.setDisallowBackGesture(disableBack);
3182 }
3183 }
Sunny Goyal210e1742019-10-17 12:05:38 -07003184
Vinit Nayakf9b585b2019-07-10 14:25:32 -07003185 @Override
3186 public void returnToHomescreen() {
3187 super.returnToHomescreen();
3188 getStateManager().goToState(LauncherState.NORMAL);
3189 }
3190
Andy Wickham65ced1b2020-03-07 02:14:19 +00003191 private void closeOpenViews() {
3192 closeOpenViews(true);
3193 }
3194
3195 protected void closeOpenViews(boolean animate) {
3196 AbstractFloatingView.closeAllOpenViews(this, animate);
3197 }
3198
Sunny Goyal3a1eadd2019-10-23 17:44:27 -07003199 public Stream<SystemShortcut.Factory> getSupportedShortcuts() {
Samuel Fufa5cf3e862020-02-03 20:22:54 -08003200 return Stream.of(APP_INFO, WIDGETS, INSTALL);
Sunny Goyal3a1eadd2019-10-23 17:44:27 -07003201 }
3202
Sunny Goyal384b5782021-02-09 22:50:02 -08003203 protected LauncherAccessibilityDelegate createAccessibilityDelegate() {
3204 return new LauncherAccessibilityDelegate(this);
3205 }
Sunny Goyalf2393f12020-04-01 20:13:12 -07003206
3207 /**
3208 * @see LauncherState#getOverviewScaleAndOffset(Launcher)
3209 */
3210 public float[] getNormalOverviewScaleAndOffset() {
Tony Wickham82d5a062021-05-14 14:37:12 -07003211 return new float[] {NO_SCALE, NO_OFFSET};
Sunny Goyalf2393f12020-04-01 20:13:12 -07003212 }
3213
Sunny Goyal210e1742019-10-17 12:05:38 -07003214 public static Launcher getLauncher(Context context) {
Winson Chung8687bc22020-02-27 23:34:24 -08003215 return fromContext(context);
Sunny Goyal210e1742019-10-17 12:05:38 -07003216 }
3217
Sunny Goyal3dce5f32017-10-05 11:40:05 -07003218 /**
Sunny Goyalab770a12018-11-14 15:17:26 -08003219 * Just a wrapper around the type cast to allow easier tracking of calls.
3220 */
3221 public static <T extends Launcher> T cast(ActivityContext activityContext) {
3222 return (T) activityContext;
3223 }
3224
Schneider Victor-tulias25ecae12020-09-14 14:07:38 -07003225 /**
3226 * Cross-fades the launcher's updated appearance with its previous appearance.
3227 *
3228 * This method is used to cross-fade UI updates on activity creation, specifically dark mode
3229 * updates.
3230 */
3231 private void crossFadeWithPreviousAppearance() {
Sunny Goyal6c0c61a2020-12-08 19:19:56 -08003232 NonConfigInstance lastInstance = (NonConfigInstance) getLastNonConfigurationInstance();
Schneider Victor-tulias25ecae12020-09-14 14:07:38 -07003233
Sunny Goyal6c0c61a2020-12-08 19:19:56 -08003234 if (lastInstance == null || lastInstance.snapshot == null) {
Schneider Victor-tulias25ecae12020-09-14 14:07:38 -07003235 return;
3236 }
3237
3238 ImageView crossFadeHelper = new ImageView(this);
Sunny Goyal6c0c61a2020-12-08 19:19:56 -08003239 crossFadeHelper.setImageBitmap(lastInstance.snapshot);
Schneider Victor-tulias25ecae12020-09-14 14:07:38 -07003240 crossFadeHelper.setImportantForAccessibility(IMPORTANT_FOR_ACCESSIBILITY_NO);
3241
3242 InsettableFrameLayout.LayoutParams layoutParams = new InsettableFrameLayout.LayoutParams(
3243 InsettableFrameLayout.LayoutParams.MATCH_PARENT,
3244 InsettableFrameLayout.LayoutParams.MATCH_PARENT);
3245
3246 layoutParams.ignoreInsets = true;
3247
3248 crossFadeHelper.setLayoutParams(layoutParams);
3249
3250 getRootView().addView(crossFadeHelper);
3251
3252 crossFadeHelper
3253 .animate()
3254 .setDuration(THEME_CROSS_FADE_ANIMATION_DURATION)
3255 .alpha(0f)
3256 .withEndAction(() -> getRootView().removeView(crossFadeHelper))
3257 .start();
3258 }
Sunny Goyal6c0c61a2020-12-08 19:19:56 -08003259
Sunny Goyalb65d7662021-03-07 15:09:11 -08003260 public boolean supportsAdaptiveIconAnimation(View clickedView) {
3261 return false;
3262 }
3263
Tony Wickham39938cb2021-02-26 09:15:31 -08003264 public DragOptions getDefaultWorkspaceDragOptions() {
3265 return new DragOptions();
3266 }
3267
Schneider Victor-tulias9b6babf2022-03-24 14:47:32 -07003268 /**
3269 * Animates Launcher elements during a transition to the All Apps page.
3270 *
3271 * @param progress Transition progress from 0 to 1; where 0 => home and 1 => all apps.
3272 */
3273 public void onAllAppsTransition(float progress) {
3274 // No-Op
3275 }
3276
3277 /**
3278 * Animates Launcher elements during a transition to the Widgets pages.
3279 *
3280 * @param progress Transition progress from 0 to 1; where 0 => home and 1 => widgets.
3281 */
3282 public void onWidgetsTransition(float progress) {
Alex Chau3d2c0622022-09-01 21:28:14 +01003283 float scale = Utilities.mapToRange(progress, 0f, 1f, 1f,
3284 mDeviceProfile.bottomSheetWorkspaceScale, EMPHASIZED);
3285 WORKSPACE_WIDGET_SCALE.set(getWorkspace(), scale);
3286 HOTSEAT_WIDGET_SCALE.set(getHotseat(), scale);
Schneider Victor-tulias9b6babf2022-03-24 14:47:32 -07003287 }
3288
Sunny Goyal6c0c61a2020-12-08 19:19:56 -08003289 private static class NonConfigInstance {
3290 public Configuration config;
3291 public Bitmap snapshot;
3292 }
thiruramc96873c2021-02-11 15:13:47 -08003293
3294 @Override
3295 public StatsLogManager getStatsLogManager() {
3296 return super.getStatsLogManager().withDefaultInstanceId(mAllAppsSessionLogId);
3297 }
Brian Isganitis149dbcb2021-11-08 18:12:38 -05003298
3299 /**
3300 * Returns the current popup for testing, if any.
3301 */
3302 @VisibleForTesting
3303 @Nullable
3304 public ArrowPopup<?> getOptionsPopup() {
3305 return findViewById(R.id.popup_container);
3306 }
Schneider Victor-tulias789a6a92022-03-04 12:06:09 -08003307
3308 /** Pauses view updates that should not be run during the app launch animation. */
3309 public void pauseExpensiveViewUpdates() {
3310 // Pause page indicator animations as they lead to layer trashing.
Shikha Malhotrae957b602022-04-11 07:57:18 +00003311 getWorkspace().getPageIndicator().pauseAnimations();
Jon Miranda46ecc0c2022-06-02 11:34:15 -07003312
3313 getWorkspace().mapOverItems((info, view) -> {
3314 if (view instanceof LauncherAppWidgetHostView) {
3315 ((LauncherAppWidgetHostView) view).beginDeferringUpdates();
3316 }
3317 return false; // Return false to continue iterating through all the items.
3318 });
Schneider Victor-tulias789a6a92022-03-04 12:06:09 -08003319 }
3320
3321 /** Resumes view updates at the end of the app launch animation. */
3322 public void resumeExpensiveViewUpdates() {
Shikha Malhotrae957b602022-04-11 07:57:18 +00003323 getWorkspace().getPageIndicator().skipAnimationsToEnd();
Shikha Malhotra0f2e1b62022-03-27 21:02:21 +00003324
Jon Miranda46ecc0c2022-06-02 11:34:15 -07003325 getWorkspace().mapOverItems((info, view) -> {
3326 if (view instanceof LauncherAppWidgetHostView) {
3327 ((LauncherAppWidgetHostView) view).endDeferringUpdates();
3328 }
3329 return false; // Return false to continue iterating through all the items.
3330 });
3331 }
Ats Jenkca009e42023-01-06 09:52:40 -08003332
3333 /**
3334 * Returns {@code true} if there are visible tasks with windowing mode set to
3335 * {@link android.app.WindowConfiguration#WINDOWING_MODE_FREEFORM}
3336 */
3337 public boolean areFreeformTasksVisible() {
3338 return false; // Base launcher does not track freeform tasks
3339 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08003340}