blob: c454a910b2ed742149f670b7905dcb720582abed [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;
Sunny Goyal8f965462020-04-23 19:00:36 -070022import static android.view.accessibility.AccessibilityEvent.TYPE_WINDOW_STATE_CHANGED;
Vinit Nayak48b28022020-04-27 20:48:49 +000023
Kateryna Ivanova71203732023-05-24 15:09:00 +000024import static com.android.app.animation.Interpolators.EMPHASIZED;
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;
Sunny Goyal669b71f2023-01-27 14:37:07 -080035import static com.android.launcher3.LauncherSettings.Favorites.CONTAINER_DESKTOP;
Jon Mirandac4a99bf2021-11-04 16:53:45 -070036import static com.android.launcher3.LauncherSettings.Favorites.ITEM_TYPE_APPLICATION;
Sunny Goyal3e3f44c2017-10-23 17:14:52 -070037import static com.android.launcher3.LauncherState.ALL_APPS;
Charlie Anderson438d4052023-04-25 14:38:57 -040038import static com.android.launcher3.LauncherState.EDIT_MODE;
Sunny Goyal8f965462020-04-23 19:00:36 -070039import static com.android.launcher3.LauncherState.FLAG_MULTI_PAGE;
40import static com.android.launcher3.LauncherState.FLAG_NON_INTERACTIVE;
Sunny Goyal3e3f44c2017-10-23 17:14:52 -070041import static com.android.launcher3.LauncherState.NORMAL;
Sunny Goyalf2393f12020-04-01 20:13:12 -070042import static com.android.launcher3.LauncherState.NO_OFFSET;
43import static com.android.launcher3.LauncherState.NO_SCALE;
Sunny Goyal8f965462020-04-23 19:00:36 -070044import static com.android.launcher3.LauncherState.SPRING_LOADED;
Sunny Goyalb1d7de22019-09-06 10:36:54 -070045import static com.android.launcher3.Utilities.postAsyncCallback;
Sebastián Franco1f4d56c2023-08-08 03:29:10 +000046import static com.android.launcher3.config.FeatureFlags.FOLDABLE_SINGLE_PAGE;
Charlie Anderson438d4052023-04-25 14:38:57 -040047import static com.android.launcher3.config.FeatureFlags.MULTI_SELECT_EDIT_MODE;
Federico Barona1845112022-10-20 21:11:58 -070048import static com.android.launcher3.config.FeatureFlags.SHOW_DOT_PAGINATION;
Thiru Ramasamy5fbac632022-01-28 15:05:36 -080049import static com.android.launcher3.logging.StatsLogManager.EventEnum;
Hyunyoung Song801f81f2020-06-19 02:58:53 -070050import static com.android.launcher3.logging.StatsLogManager.LAUNCHER_STATE_BACKGROUND;
Hyunyoung Song95786e02020-09-15 00:34:10 -070051import static com.android.launcher3.logging.StatsLogManager.LAUNCHER_STATE_HOME;
thiruramc96873c2021-02-11 15:13:47 -080052import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_ALLAPPS_ENTRY;
thiruram9f53d612021-02-24 10:54:01 -080053import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_ALLAPPS_ENTRY_WITH_DEVICE_SEARCH;
thiruramc96873c2021-02-11 15:13:47 -080054import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_ALLAPPS_EXIT;
Hyunyoung Song801f81f2020-06-19 02:58:53 -070055import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_ONRESUME;
56import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_ONSTOP;
Sunny Goyal82379182022-11-02 18:58:49 -070057import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_SWIPELEFT;
58import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_SWIPERIGHT;
Yogisha Dixit4ff5ee32021-05-04 14:58:34 +010059import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_WIDGET_RECONFIGURED;
Fengjiang Li5a36c172023-04-13 18:18:27 +000060import static com.android.launcher3.logging.StatsLogManager.LauncherLatencyEvent.LAUNCHER_LATENCY_STARTUP_ACTIVITY_ON_CREATE;
61import static com.android.launcher3.logging.StatsLogManager.LauncherLatencyEvent.LAUNCHER_LATENCY_STARTUP_TOTAL_DURATION;
62import static com.android.launcher3.logging.StatsLogManager.LauncherLatencyEvent.LAUNCHER_LATENCY_STARTUP_VIEW_INFLATION;
63import static com.android.launcher3.logging.StatsLogManager.LauncherLatencyEvent.LAUNCHER_LATENCY_STARTUP_WORKSPACE_LOADER_ASYNC;
64import static com.android.launcher3.logging.StatsLogManager.LauncherLatencyEvent.LAUNCHER_LATENCY_STARTUP_WORKSPACE_LOADER_SYNC;
65import static com.android.launcher3.logging.StatsLogManager.StatsLatencyLogger.LatencyType.COLD;
66import static com.android.launcher3.logging.StatsLogManager.StatsLatencyLogger.LatencyType.COLD_DEVICE_REBOOTING;
67import static com.android.launcher3.logging.StatsLogManager.StatsLatencyLogger.LatencyType.WARM;
Sunny Goyal60e68c92020-08-12 13:59:27 -070068import static com.android.launcher3.model.ItemInstallQueue.FLAG_ACTIVITY_PAUSED;
69import static com.android.launcher3.model.ItemInstallQueue.FLAG_DRAG_AND_DROP;
fbaron30d9e3f2023-08-03 17:03:59 -070070import static com.android.launcher3.model.data.LauncherAppWidgetInfo.CUSTOM_WIDGET_ID;
Sunny Goyal3a1eadd2019-10-23 17:44:27 -070071import static com.android.launcher3.popup.SystemShortcut.APP_INFO;
Sunny Goyal3a1eadd2019-10-23 17:44:27 -070072import static com.android.launcher3.popup.SystemShortcut.INSTALL;
73import static com.android.launcher3.popup.SystemShortcut.WIDGETS;
Sunny Goyal8f965462020-04-23 19:00:36 -070074import static com.android.launcher3.states.RotationHelper.REQUEST_LOCK;
Sunny Goyalbe8c3402019-05-22 15:17:52 -070075import static com.android.launcher3.states.RotationHelper.REQUEST_NONE;
Jeremy Sim7cf0dd92023-03-24 22:39:45 -070076import static com.android.launcher3.util.Executors.MAIN_EXECUTOR;
Jon Mirandac4a99bf2021-11-04 16:53:45 -070077import static com.android.launcher3.util.ItemInfoMatcher.forFolderMatch;
Sunny Goyal326403e2017-10-02 12:45:10 -070078
Gilles Debunnedd6c9922010-10-25 11:23:41 -070079import android.animation.Animator;
Sunny Goyal6001ea22018-05-10 16:31:00 -070080import android.animation.AnimatorListenerAdapter;
Gilles Debunnedd6c9922010-10-25 11:23:41 -070081import android.animation.AnimatorSet;
Gilles Debunnedd6c9922010-10-25 11:23:41 -070082import android.animation.ValueAnimator;
Adam Cohen0b395352014-06-09 22:54:36 +000083import android.annotation.TargetApi;
Tony Wickhame78a70b2021-03-29 16:45:59 -070084import android.app.Notification;
85import android.app.NotificationChannel;
86import android.app.NotificationManager;
87import android.app.PendingIntent;
Adam Cohen0cf2a7c2011-11-08 15:07:01 -080088import android.appwidget.AppWidgetHostView;
Michael Jurkaaf442092010-06-10 17:01:57 -070089import android.appwidget.AppWidgetManager;
The Android Open Source Project31dd5032009-03-03 19:32:27 -080090import android.content.ActivityNotFoundException;
Michael Jurkae326f182011-11-21 14:05:46 -080091import android.content.ComponentCallbacks2;
The Android Open Source Project31dd5032009-03-03 19:32:27 -080092import android.content.Context;
The Android Open Source Project31dd5032009-03-03 19:32:27 -080093import android.content.Intent;
Adam Cohen173f7112015-03-27 15:14:00 -070094import android.content.IntentSender;
Winson Chung82f55532011-08-09 14:14:23 -070095import android.content.SharedPreferences;
Sunny Goyalf8d56fc2018-01-31 15:18:11 -080096import android.content.res.Configuration;
Adam Cohen3f9c9712014-10-31 11:48:25 -070097import android.database.sqlite.SQLiteDatabase;
Sunny Goyal5cd1b192023-04-06 22:33:11 +000098import android.graphics.Color;
Tony Wickham1906cc32021-02-11 11:55:24 -080099import android.graphics.Rect;
Sunny Goyal831212e2021-05-14 14:24:09 -0700100import android.graphics.RectF;
Adam Cohen0f668f32014-09-08 19:54:17 +0200101import android.os.Build;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800102import android.os.Bundle;
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -0700103import android.os.Parcelable;
Winson Chunga2413752012-04-03 14:22:34 -0700104import android.os.StrictMode;
Riddle Hsu979da642020-09-22 21:52:40 +0800105import android.os.SystemClock;
Schneider Victor-tulias927d6dc2021-08-26 11:56:47 -0700106import android.os.Trace;
Jon Mirandac4a99bf2021-11-04 16:53:45 -0700107import android.os.UserHandle;
Michael Jurkaa33411c2012-06-14 16:18:21 -0700108import android.text.TextUtils;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800109import android.text.method.TextKeyListener;
Federico Baron7539d762022-09-29 09:47:04 -0700110import android.util.AttributeSet;
Alex Chau0c4e11b2022-07-08 18:41:36 +0100111import android.util.FloatProperty;
Joe Onorato7c312c12009-08-13 21:36:53 -0700112import android.util.Log;
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -0700113import android.util.SparseArray;
Adam Cohen96d30a12013-07-16 18:13:21 -0700114import android.view.KeyEvent;
Sunny Goyal66b24572016-09-21 15:57:55 -0700115import android.view.KeyboardShortcutGroup;
Sunny Goyal9b29ca52017-02-17 10:39:44 -0800116import android.view.LayoutInflater;
Adam Cohen96d30a12013-07-16 18:13:21 -0700117import android.view.Menu;
vadimt9af34a72020-01-21 11:19:13 -0800118import android.view.MotionEvent;
Adam Cohen96d30a12013-07-16 18:13:21 -0700119import android.view.View;
Adam Cohen96d30a12013-07-16 18:13:21 -0700120import android.view.ViewGroup;
Fengjiang Li5a36c172023-04-13 18:18:27 +0000121import android.view.ViewTreeObserver;
Sunny Goyal7b8d63f2022-04-14 16:37:32 -0700122import android.view.ViewTreeObserver.OnPreDrawListener;
Schneider Victor-tulias25ecae12020-09-14 14:07:38 -0700123import android.view.WindowManager.LayoutParams;
Svetoslav Ganov815ba2d2011-01-07 14:55:17 -0800124import android.view.accessibility.AccessibilityEvent;
Sunny Goyal5a1f53b2015-05-27 10:24:24 -0700125import android.view.animation.OvershootInterpolator;
Fengjiang Lib7860bd2023-03-15 10:50:50 -0700126import android.window.BackEvent;
127import android.window.OnBackAnimationCallback;
Sunny Goyala1d1bf32015-06-26 13:24:53 -0700128
Sunny Goyal35e7d382020-05-08 13:37:58 -0700129import androidx.annotation.CallSuper;
Andras Kloczl55edfe52021-05-14 12:21:30 +0200130import androidx.annotation.NonNull;
Sunny Goyal11a50742019-08-07 09:24:26 -0700131import androidx.annotation.Nullable;
Fengjiang Lid0c23592023-04-20 16:42:25 -0700132import androidx.annotation.RequiresApi;
Pinyao Tingc9074272019-11-11 11:51:44 -0800133import androidx.annotation.StringRes;
Anushree Ganjam97434ee2023-05-18 22:03:16 +0000134import androidx.annotation.UiThread;
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700135import androidx.annotation.VisibleForTesting;
Sunny Goyal11a50742019-08-07 09:24:26 -0700136
Sunny Goyal651077b2014-06-30 14:15:31 -0700137import com.android.launcher3.DropTarget.DragObject;
Sunny Goyalae502842016-06-17 08:43:56 -0700138import com.android.launcher3.accessibility.LauncherAccessibilityDelegate;
Brian Isganitis1664c9f2022-01-14 23:15:47 -0500139import com.android.launcher3.allapps.ActivityAllAppsContainerView;
Jon Mirandaf58db152022-06-02 16:06:37 -0700140import com.android.launcher3.allapps.AllAppsRecyclerView;
vadimtd4c90e12019-06-04 13:59:43 -0700141import com.android.launcher3.allapps.AllAppsStore;
Hyunyoung Song645764e2016-06-06 14:19:02 -0700142import com.android.launcher3.allapps.AllAppsTransitionController;
Becky Qiu4ed3dfc2022-10-19 16:58:22 -0700143import com.android.launcher3.allapps.BaseSearchConfig;
Sunny Goyal7ede6112017-12-05 15:11:21 -0800144import com.android.launcher3.allapps.DiscoveryBounce;
Holly Sund9d70ea2023-09-05 13:14:22 -0700145import com.android.launcher3.anim.AnimationSuccessListener;
Sunny Goyalf0b6db72018-08-13 16:10:14 -0700146import com.android.launcher3.anim.PropertyListBuilder;
Jeremy Sim94fd07e2023-04-19 20:56:49 -0700147import com.android.launcher3.apppairs.AppPairIcon;
Sunny Goyal669b71f2023-01-27 14:37:07 -0800148import com.android.launcher3.celllayout.CellPosMapper;
149import com.android.launcher3.celllayout.CellPosMapper.CellPos;
Sebastian Franco09589322022-11-02 15:25:58 -0700150import com.android.launcher3.celllayout.CellPosMapper.TwoPanelCellPosMapper;
Sunny Goyal8f965462020-04-23 19:00:36 -0700151import com.android.launcher3.compat.AccessibilityManagerCompat;
Tony Wickhame0c33232016-02-08 11:37:04 -0800152import com.android.launcher3.config.FeatureFlags;
vadimt00d42552018-12-11 17:59:36 -0800153import com.android.launcher3.dot.DotInfo;
Vadim Tryshevfedca432015-08-19 17:55:02 -0700154import com.android.launcher3.dragndrop.DragController;
155import com.android.launcher3.dragndrop.DragLayer;
156import com.android.launcher3.dragndrop.DragView;
Sunny Goyal59969372021-05-06 12:11:44 -0700157import com.android.launcher3.dragndrop.LauncherDragController;
Federico Baron8bf1bca2022-09-27 16:19:11 -0700158import com.android.launcher3.folder.Folder;
Sunny Goyal11a50742019-08-07 09:24:26 -0700159import com.android.launcher3.folder.FolderGridOrganizer;
Sunny Goyal26119432016-02-18 22:09:23 +0000160import com.android.launcher3.folder.FolderIcon;
Sunny Goyalf840f102018-09-21 14:41:05 -0700161import com.android.launcher3.icons.IconCache;
Sunny Goyal3333b0c2016-05-09 20:43:21 -0700162import com.android.launcher3.keyboard.ViewGroupFocusHelper;
Hyunyoung Song801f81f2020-06-19 02:58:53 -0700163import com.android.launcher3.logger.LauncherAtom;
Thiru Ramasamy5fbac632022-01-28 15:05:36 -0800164import com.android.launcher3.logger.LauncherAtom.ContainerInfo;
165import com.android.launcher3.logger.LauncherAtom.WorkspaceContainer;
Sunny Goyala7ce1662016-05-31 15:01:35 -0700166import com.android.launcher3.logging.FileLog;
thiruramc96873c2021-02-11 15:13:47 -0800167import com.android.launcher3.logging.InstanceId;
168import com.android.launcher3.logging.InstanceIdSequence;
Fengjiang Li5a36c172023-04-13 18:18:27 +0000169import com.android.launcher3.logging.StartupLatencyLogger;
Hyunyoung Song801f81f2020-06-19 02:58:53 -0700170import com.android.launcher3.logging.StatsLogManager;
Sunny Goyal87dcde62019-07-17 20:35:56 -0700171import com.android.launcher3.model.BgDataModel.Callbacks;
Sunny Goyal60e68c92020-08-12 13:59:27 -0700172import com.android.launcher3.model.ItemInstallQueue;
Sunny Goyala535ae42017-02-27 10:07:13 -0800173import com.android.launcher3.model.ModelWriter;
kholoud mohamedc76b2032021-12-20 16:47:38 +0000174import com.android.launcher3.model.StringCache;
Pinyao Tingbbb9a9c2021-05-11 15:42:54 -0700175import com.android.launcher3.model.WidgetsModel;
Sunny Goyale396abf2020-04-06 15:11:17 -0700176import com.android.launcher3.model.data.AppInfo;
177import com.android.launcher3.model.data.FolderInfo;
178import com.android.launcher3.model.data.ItemInfo;
179import com.android.launcher3.model.data.LauncherAppWidgetInfo;
Sunny Goyale396abf2020-04-06 15:11:17 -0700180import com.android.launcher3.model.data.WorkspaceItemInfo;
Sunny Goyala535ae42017-02-27 10:07:13 -0800181import com.android.launcher3.notification.NotificationListener;
Federico Baron7539d762022-09-29 09:47:04 -0700182import com.android.launcher3.pageindicators.WorkspacePageIndicator;
Sunny Goyale7b00122019-10-02 16:13:34 -0700183import com.android.launcher3.pm.PinRequestHelper;
Brian Isganitis149dbcb2021-11-08 18:12:38 -0500184import com.android.launcher3.popup.ArrowPopup;
Tony Wickham540913e2017-01-23 11:47:51 -0800185import com.android.launcher3.popup.PopupContainerWithArrow;
Sunny Goyala535ae42017-02-27 10:07:13 -0800186import com.android.launcher3.popup.PopupDataProvider;
Sunny Goyal3a1eadd2019-10-23 17:44:27 -0700187import com.android.launcher3.popup.SystemShortcut;
Samuel Fufaca37b8a2019-08-19 17:04:36 -0700188import com.android.launcher3.qsb.QsbContainerView;
Sunny Goyal35e7d382020-05-08 13:37:58 -0700189import com.android.launcher3.statemanager.StateManager;
190import com.android.launcher3.statemanager.StateManager.StateHandler;
Sunny Goyal35e7d382020-05-08 13:37:58 -0700191import com.android.launcher3.statemanager.StatefulActivity;
Sunny Goyal623eddd2018-03-02 12:24:41 -0800192import com.android.launcher3.states.RotationHelper;
vadimt9af34a72020-01-21 11:19:13 -0800193import com.android.launcher3.testing.TestLogging;
vadimtf6ef8792022-07-26 13:54:31 -0700194import com.android.launcher3.testing.shared.TestProtocol;
Sunny Goyal210e1742019-10-17 12:05:38 -0700195import com.android.launcher3.touch.AllAppsSwipeController;
Brian Isganitisf54c6fa2023-07-11 12:47:08 -0400196import com.android.launcher3.touch.ItemLongClickListener;
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700197import com.android.launcher3.uioverrides.plugins.PluginManagerWrapper;
Sunny Goyal2100c782016-08-22 16:00:03 -0700198import com.android.launcher3.util.ActivityResultInfo;
Sunny Goyale84c5b82019-09-26 17:05:31 -0700199import com.android.launcher3.util.ActivityTracker;
Vinit Nayak65460402023-08-11 15:40:07 -0700200import com.android.launcher3.util.BackPressHandler;
Sukesh Ram3f2338a2023-08-28 18:31:54 +0000201import com.android.launcher3.util.CannedAnimationCoordinator;
Winson Chung6b1c73f2015-06-18 11:38:42 -0700202import com.android.launcher3.util.ComponentKey;
Sunny Goyalefb7e842018-10-04 15:11:00 -0700203import com.android.launcher3.util.IntArray;
Andras Kloczl55edfe52021-05-14 12:21:30 +0200204import com.android.launcher3.util.IntSet;
Sebastian Franco4080fdd2023-09-19 14:17:23 -0700205import com.android.launcher3.util.KeyboardShortcutsDelegate;
Fengjiang Li5a36c172023-04-13 18:18:27 +0000206import com.android.launcher3.util.LockedUserState;
Tony Wickham133cd542020-04-08 17:48:41 -0700207import com.android.launcher3.util.OnboardingPrefs;
Tony Wickham010d2552017-01-20 08:15:28 -0800208import com.android.launcher3.util.PackageUserKey;
Sunny Goyal2100c782016-08-22 16:00:03 -0700209import com.android.launcher3.util.PendingRequestArgs;
Anushree Ganjam97434ee2023-05-18 22:03:16 +0000210import com.android.launcher3.util.Preconditions;
Sunny Goyal4a48a982021-06-17 15:15:46 -0700211import com.android.launcher3.util.RunnableList;
Sunny Goyala992ac92023-01-10 17:50:32 -0800212import com.android.launcher3.util.ScreenOnTracker;
213import com.android.launcher3.util.ScreenOnTracker.ScreenOnListener;
Sunny Goyal8392c822017-06-20 10:03:56 -0700214import com.android.launcher3.util.SystemUiController;
Mario Bertschlera6936942017-05-31 14:48:19 -0700215import com.android.launcher3.util.Themes;
Adam Cohen091440a2015-03-18 14:16:05 -0700216import com.android.launcher3.util.Thunk;
Sunny Goyal210e1742019-10-17 12:05:38 -0700217import com.android.launcher3.util.TouchController;
Sunny Goyalfca6bc92017-09-28 16:28:34 -0700218import com.android.launcher3.util.TraceHelper;
Sunny Goyal527c7d32015-08-28 15:19:36 -0700219import com.android.launcher3.util.ViewOnDrawExecutor;
Sunny Goyalab770a12018-11-14 15:17:26 -0800220import com.android.launcher3.views.ActivityContext;
Xiaowen Lei3c0f30a2023-04-12 16:59:45 -0700221import com.android.launcher3.views.ComposeInitializer;
Jon Mirandaf58db152022-06-02 16:06:37 -0700222import com.android.launcher3.views.FloatingIconView;
Sunny Goyal30ac97d2020-06-24 23:47:46 -0700223import com.android.launcher3.views.FloatingSurfaceView;
Sunny Goyal7c7be8c2018-03-07 19:58:07 -0800224import com.android.launcher3.views.OptionsPopupView;
Govinda Wassermanc06e1512019-04-09 09:56:53 -0400225import com.android.launcher3.views.ScrimView;
Sunny Goyal29947f02017-12-18 13:49:44 -0800226import com.android.launcher3.widget.LauncherAppWidgetHostView;
Yogisha Dixit741fae92021-02-22 14:03:44 +0000227import com.android.launcher3.widget.LauncherAppWidgetProviderInfo;
Sihua Ma8bbfcb62022-11-08 16:46:07 -0800228import com.android.launcher3.widget.LauncherWidgetHolder;
Sunny Goyal782f0c92017-01-19 10:27:54 -0800229import com.android.launcher3.widget.PendingAddShortcutInfo;
Hyunyoung Song3f471442015-04-08 19:01:34 -0700230import com.android.launcher3.widget.PendingAddWidgetInfo;
Sunny Goyal29947f02017-12-18 13:49:44 -0800231import com.android.launcher3.widget.PendingAppWidgetHostView;
Sunny Goyal04a324a2017-01-20 21:08:59 -0800232import com.android.launcher3.widget.WidgetAddFlowHandler;
Sunny Goyal337c81f2019-12-10 12:19:13 -0800233import com.android.launcher3.widget.WidgetManagerHelper;
Pinyao Tingc7a6c292019-08-26 14:36:02 -0700234import com.android.launcher3.widget.custom.CustomWidgetManager;
Steven Ng2f5648a2021-02-08 17:18:25 +0000235import com.android.launcher3.widget.model.WidgetsListBaseEntry;
236import com.android.launcher3.widget.picker.WidgetsFullSheet;
Sunny Goyal80a071b2021-12-27 13:30:08 +0530237import com.android.systemui.plugins.LauncherOverlayPlugin;
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700238import com.android.systemui.plugins.PluginListener;
239import com.android.systemui.plugins.shared.LauncherExterns;
240import com.android.systemui.plugins.shared.LauncherOverlayManager;
241import com.android.systemui.plugins.shared.LauncherOverlayManager.LauncherOverlay;
Adam Cohen6c5891a2014-07-09 23:53:15 -0700242
Adam Cohen16d7ffc2011-10-05 17:49:14 -0700243import java.io.FileDescriptor;
Adam Cohen16d7ffc2011-10-05 17:49:14 -0700244import java.io.PrintWriter;
Adam Cohenc0dcf592011-06-01 15:30:43 -0700245import java.util.ArrayList;
Winson Chungf0c6ae02012-03-21 16:10:31 -0700246import java.util.Collection;
Jon Mirandac4a99bf2021-11-04 16:53:45 -0700247import java.util.Collections;
Zak Cohen658c67a2018-10-19 14:21:05 -0700248import java.util.HashMap;
Sunny Goyal4390ace2014-10-13 11:33:11 -0700249import java.util.HashSet;
Michael Jurkad7c28052012-04-27 15:43:36 -0700250import java.util.List;
Anushree Ganjam97434ee2023-05-18 22:03:16 +0000251import java.util.Map;
Thiru Ramasamy694407c2022-03-08 12:11:24 -0800252import java.util.Optional;
Sunny Goyalaae6fbb2019-01-31 16:05:58 -0800253import java.util.function.Predicate;
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700254import java.util.function.Supplier;
Sunny Goyal3a1eadd2019-10-23 17:44:27 -0700255import java.util.stream.Stream;
Jon Mirandaf5197fc2019-09-04 16:55:41 -0700256
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800257/**
258 * Default launcher application.
259 */
Shikha Malhotra0f2e1b62022-03-27 21:02:21 +0000260public class Launcher extends StatefulActivity<LauncherState>
261 implements LauncherExterns, Callbacks, InvariantDeviceProfile.OnIDPChangeListener,
Sunny Goyal82379182022-11-02 18:58:49 -0700262 PluginListener<LauncherOverlayPlugin> {
Vadim Tryshevfedca432015-08-19 17:55:02 -0700263 public static final String TAG = "Launcher";
Sunny Goyale84c5b82019-09-26 17:05:31 -0700264
265 public static final ActivityTracker<Launcher> ACTIVITY_TRACKER = new ActivityTracker<>();
266
Sunny Goyal2bba4c32015-05-18 15:42:48 -0700267 static final boolean LOGD = false;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800268
Winson Chunga2413752012-04-03 14:22:34 -0700269 static final boolean DEBUG_STRICT_MODE = false;
Romain Guy6fefcf12009-06-11 13:07:43 -0700270
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800271 private static final int REQUEST_CREATE_SHORTCUT = 1;
The Android Open Source Project7376fae2009-03-11 12:11:58 -0700272 private static final int REQUEST_CREATE_APPWIDGET = 5;
Jon Mirandac476d6e2017-05-04 16:30:01 -0700273
The Android Open Source Project7376fae2009-03-11 12:11:58 -0700274 private static final int REQUEST_PICK_APPWIDGET = 9;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800275
Michael Jurka8b805b12012-04-18 14:23:14 -0700276 private static final int REQUEST_BIND_APPWIDGET = 11;
Sunny Goyal8a2a63b2018-03-06 22:15:18 -0800277 public static final int REQUEST_BIND_PENDING_APPWIDGET = 12;
278 public static final int REQUEST_RECONFIGURE_APPWIDGET = 13;
Michael Jurka8b805b12012-04-18 14:23:14 -0700279
Sunny Goyal5a1f53b2015-05-27 10:24:24 -0700280 private static final float BOUNCE_ANIMATION_TENSION = 1.3f;
281
Mathew Inwood876a8462013-06-14 14:12:41 +0100282 /**
283 * IntentStarter uses request codes starting with this. This must be greater than all activity
284 * request codes used internally.
285 */
286 protected static final int REQUEST_LAST = 100;
287
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800288 // Type: int
Jeremy Simc94f4b72022-06-10 11:43:37 -0700289 protected static final String RUNTIME_STATE = "launcher.state";
Sunny Goyal2100c782016-08-22 16:00:03 -0700290 // Type: PendingRequestArgs
291 private static final String RUNTIME_STATE_PENDING_REQUEST_ARGS = "launcher.request_args";
Sunny Goyaldedda052019-05-14 15:23:48 -0700292 // Type: int
293 private static final String RUNTIME_STATE_PENDING_REQUEST_CODE = "launcher.request_code";
Sunny Goyal2100c782016-08-22 16:00:03 -0700294 // Type: ActivityResultInfo
295 private static final String RUNTIME_STATE_PENDING_ACTIVITY_RESULT = "launcher.activity_result";
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -0700296 // Type: SparseArray<Parcelable>
297 private static final String RUNTIME_STATE_WIDGET_PANEL = "launcher.widget_panel";
Sunny Goyal12e3f1f2021-07-15 14:31:58 -0700298 // Type int[]
299 private static final String RUNTIME_STATE_CURRENT_SCREEN_IDS = "launcher.current_screen_ids";
Sunny Goyal17c72fb2019-10-14 14:06:38 -0700300
Jeremy Simc94f4b72022-06-10 11:43:37 -0700301 // Type PendingSplitSelectInfo<Parcelable>
302 protected static final String PENDING_SPLIT_SELECT_INFO = "launcher.pending_split_select_info";
303
Tracy Zhoucb93ec52023-03-31 22:51:17 -0700304 public static final String INTENT_ACTION_ALL_APPS_TOGGLE =
305 "launcher.intent_action_all_apps_toggle";
306
vadimt00d42552018-12-11 17:59:36 -0800307 public static final String ON_CREATE_EVT = "Launcher.onCreate";
Sunny Goyal17c72fb2019-10-14 14:06:38 -0700308 public static final String ON_START_EVT = "Launcher.onStart";
309 public static final String ON_RESUME_EVT = "Launcher.onResume";
310 public static final String ON_NEW_INTENT_EVT = "Launcher.onNewIntent";
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800311
Fengjiang Li5a36c172023-04-13 18:18:27 +0000312 private static boolean sIsNewProcess = true;
313
Sunny Goyal35e7d382020-05-08 13:37:58 -0700314 private StateManager<LauncherState> mStateManager;
Patrick Dubroy6b509c12010-08-23 15:08:16 -0700315
Adam Cohenad4e15c2013-10-17 16:21:35 -0700316 private static final int ON_ACTIVITY_RESULT_ANIMATION_DELAY = 500;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800317
Winson Chunga2413752012-04-03 14:22:34 -0700318 // How long to wait before the new-shortcut animation automatically pans the workspace
Jon Mirandaf5197fc2019-09-04 16:55:41 -0700319 @VisibleForTesting public static final int NEW_APPS_PAGE_MOVE_DELAY = 500;
Rajeev Kumar43c0f582017-06-23 15:34:55 -0700320 private static final int NEW_APPS_ANIMATION_INACTIVE_TIMEOUT_SECONDS = 5;
Jon Mirandaf5197fc2019-09-04 16:55:41 -0700321 @Thunk @VisibleForTesting public static final int NEW_APPS_ANIMATION_DELAY = 500;
Winson Chunga2413752012-04-03 14:22:34 -0700322
Schneider Victor-tulias927d6dc2021-08-26 11:56:47 -0700323 private static final String DISPLAY_WORKSPACE_TRACE_METHOD_NAME = "DisplayWorkspaceFirstFrame";
324 private static final String DISPLAY_ALL_APPS_TRACE_METHOD_NAME = "DisplayAllApps";
325 public static final int DISPLAY_WORKSPACE_TRACE_COOKIE = 0;
326 public static final int DISPLAY_ALL_APPS_TRACE_COOKIE = 1;
327
Alex Chau0c4e11b2022-07-08 18:41:36 +0100328 private static final FloatProperty<Workspace<?>> WORKSPACE_WIDGET_SCALE =
329 WORKSPACE_SCALE_PROPERTY_FACTORY.get(SCALE_INDEX_WIDGET_TRANSITION);
330 private static final FloatProperty<Hotseat> HOTSEAT_WIDGET_SCALE =
331 HOTSEAT_SCALE_PROPERTY_FACTORY.get(SCALE_INDEX_WIDGET_TRANSITION);
332
Sukesh Ram3f2338a2023-08-28 18:31:54 +0000333 private static final boolean DESKTOP_MODE_SUPPORTED =
Ats Jenk8121e0d2022-12-01 11:34:43 -0800334 "1".equals(Utilities.getSystemProperty("persist.wm.debug.desktop_mode_2", "0"));
335
Sebastian Franco4080fdd2023-09-19 14:17:23 -0700336 KeyboardShortcutsDelegate mKeyboardShortcutsDelegate = new KeyboardShortcutsDelegate(this);
Samuel Fufaca37b8a2019-08-19 17:04:36 -0700337 @Thunk
Shikha Malhotra0f2e1b62022-03-27 21:02:21 +0000338 Workspace<?> mWorkspace;
Samuel Fufaca37b8a2019-08-19 17:04:36 -0700339 @Thunk
340 DragLayer mDragLayer;
Sunny Goyal322d5562015-06-25 19:35:49 -0700341
Sunny Goyal337c81f2019-12-10 12:19:13 -0800342 private WidgetManagerHelper mAppWidgetManager;
Sihua Ma0593a0d2022-10-03 16:01:48 -0700343 private LauncherWidgetHolder mAppWidgetHolder;
Romain Guycbb89e42009-06-08 15:52:54 -0700344
Rajeev Kumar43c0f582017-06-23 15:34:55 -0700345 private final int[] mTmpAddItemCellCoordinates = new int[2];
Michael Jurka0280c3b2010-09-17 15:00:07 -0700346
Samuel Fufaca37b8a2019-08-19 17:04:36 -0700347 @Thunk
348 Hotseat mHotseat;
Adam Cohenf358a4b2013-07-23 16:47:31 -0700349
Sunny Goyal47328fd2016-05-25 18:56:41 -0700350 private DropTargetBar mDropTargetBar;
Hyunyoung Song3f471442015-04-08 19:01:34 -0700351
352 // Main container view for the all apps screen.
Samuel Fufaca37b8a2019-08-19 17:04:36 -0700353 @Thunk
Brian Isganitis1664c9f2022-01-14 23:15:47 -0500354 ActivityAllAppsContainerView<Launcher> mAppsView;
Hyunyoung Song645764e2016-06-06 14:19:02 -0700355 AllAppsTransitionController mAllAppsController;
Hyunyoung Song3f471442015-04-08 19:01:34 -0700356
Govinda Wassermanc06e1512019-04-09 09:56:53 -0400357 // Scrim view for the all apps and overview state.
Samuel Fufaca37b8a2019-08-19 17:04:36 -0700358 @Thunk
359 ScrimView mScrimView;
Govinda Wassermanc06e1512019-04-09 09:56:53 -0400360
Winson Chung8ae41982017-11-10 11:42:13 -0800361 // UI and state for the overview panel
Sunny Goyal7c7be8c2018-03-07 19:58:07 -0800362 private View mOverviewPanel;
Winson Chung8ae41982017-11-10 11:42:13 -0800363
Samuel Fufaca37b8a2019-08-19 17:04:36 -0700364 @Thunk
365 boolean mWorkspaceLoading = true;
Joe Onorato9c1289c2009-08-17 11:03:03 -0400366
Winson Chungc9bf6d42019-10-04 15:33:18 -0700367 // Used to notify when an activity launch has been deferred because launcher is not yet resumed
368 // TODO: See if we can remove this later
369 private Runnable mOnDeferredActivityLaunchCallback;
370
Sunny Goyal527c7d32015-08-28 15:19:36 -0700371 private ViewOnDrawExecutor mPendingExecutor;
Sunny Goyal7b8d63f2022-04-14 16:37:32 -0700372 private OnPreDrawListener mOnInitialBindListener;
Michael Jurka7607c2f2013-04-03 14:33:19 -0700373
Joe Onorato9c1289c2009-08-17 11:03:03 -0400374 private LauncherModel mModel;
Sunny Goyal43bf11d2017-02-02 13:52:53 -0800375 private ModelWriter mModelWriter;
Joe Onorato0589f0f2010-02-08 13:44:00 -0800376 private IconCache mIconCache;
Sunny Goyalae502842016-06-17 08:43:56 -0700377 private LauncherAccessibilityDelegate mAccessibilityDelegate;
Joe Onorato9c1289c2009-08-17 11:03:03 -0400378
Tony Wickham010d2552017-01-20 08:15:28 -0800379 private PopupDataProvider mPopupDataProvider;
Tony Wickhambfbf7f92016-05-19 11:19:39 -0700380
Andras Kloczl55edfe52021-05-14 12:21:30 +0200381 private IntSet mSynchronouslyBoundPages = new IntSet();
Sunny Goyal12e3f1f2021-07-15 14:31:58 -0700382 @NonNull private IntSet mPagesToBindSynchronously = new IntSet();
Adam Cohen1462de32012-07-24 22:34:36 -0700383
Winson Chung46353de2012-02-16 14:05:10 -0800384 // We only want to get the SharedPreferences once since it does an FS stat each time we get
385 // it from the context.
386 private SharedPreferences mSharedPrefs;
Brian Isganitis099945b2022-01-31 18:15:00 -0500387 private OnboardingPrefs<? extends Launcher> mOnboardingPrefs;
Winson Chung46353de2012-02-16 14:05:10 -0800388
Sunny Goyal2100c782016-08-22 16:00:03 -0700389 // Activity result which needs to be processed after workspace has loaded.
390 private ActivityResultInfo mPendingActivityResult;
391 /**
392 * Holds extra information required to handle a result from an external call, like
393 * {@link #startActivityForResult(Intent, int)} or {@link #requestPermissions(String[], int)}
394 */
395 private PendingRequestArgs mPendingRequestArgs;
Sunny Goyaldedda052019-05-14 15:23:48 -0700396 // Request id for any pending activity result
Sunny Goyal210e1742019-10-17 12:05:38 -0700397 protected int mPendingActivityRequestCode = -1;
Patrick Dubroy002cbf42011-03-03 16:36:21 -0800398
Tracy Zhou4d7b2442019-12-09 13:42:57 -0800399 private ViewGroupFocusHelper mFocusHandler;
Hyunyoung Song7fb3ccc2017-10-17 15:39:46 -0700400
Sunny Goyal623eddd2018-03-02 12:24:41 -0800401 private RotationHelper mRotationHelper;
Sunny Goyal7779d622015-06-11 16:18:39 -0700402
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700403 protected LauncherOverlayManager mOverlayManager;
Abhilasha Chahalcb329352022-05-31 15:50:53 +0000404 protected DragController mDragController;
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700405 // If true, overlay callbacks are deferred
406 private boolean mDeferOverlayCallbacks;
407 private final Runnable mDeferredOverlayCallbacks = this::checkIfOverlayStillDeferred;
408
Riddle Hsu979da642020-09-22 21:52:40 +0800409 protected long mLastTouchUpTime = -1;
Sunny Goyala306e592020-03-24 01:51:41 -0700410 private boolean mTouchInProgress;
Sunny Goyal9b180102020-03-11 10:02:29 -0700411
thiruramc96873c2021-02-11 15:13:47 -0800412 // New InstanceId is assigned to mAllAppsSessionLogId for each AllApps sessions.
413 // When Launcher is not in AllApps state mAllAppsSessionLogId will be null.
414 // User actions within AllApps state are logged with this InstanceId, to recreate AllApps
415 // session on the server side.
416 protected InstanceId mAllAppsSessionLogId;
417 private LauncherState mPrevLauncherState;
418
kholoud mohamedc76b2032021-12-20 16:47:38 +0000419 private StringCache mStringCache;
Becky Qiu4ed3dfc2022-10-19 16:58:22 -0700420 private BaseSearchConfig mBaseSearchConfig;
Fengjiang Li5a36c172023-04-13 18:18:27 +0000421 private StartupLatencyLogger mStartupLatencyLogger;
Sunny Goyal669b71f2023-01-27 14:37:07 -0800422 private CellPosMapper mCellPosMapper = CellPosMapper.DEFAULT;
423
Sunny Goyal0ee66472023-08-17 16:19:22 -0700424 private final CannedAnimationCoordinator mAnimationCoordinator =
425 new CannedAnimationCoordinator(this);
426
Vinit Nayak65460402023-08-11 15:40:07 -0700427 private final List<BackPressHandler> mBackPressedHandlers = new ArrayList<>();
428
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800429 @Override
Schneider Victor-tulias927d6dc2021-08-26 11:56:47 -0700430 @TargetApi(Build.VERSION_CODES.S)
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800431 protected void onCreate(Bundle savedInstanceState) {
Fengjiang Li5a36c172023-04-13 18:18:27 +0000432 mStartupLatencyLogger = createStartupLatencyLogger(
433 sIsNewProcess
434 ? LockedUserState.get(this).isUserUnlockedAtLauncherStartup()
435 ? COLD
436 : COLD_DEVICE_REBOOTING
437 : WARM);
438 sIsNewProcess = false;
439 mStartupLatencyLogger
440 .logStart(LAUNCHER_LATENCY_STARTUP_TOTAL_DURATION)
441 .logStart(LAUNCHER_LATENCY_STARTUP_ACTIVITY_ON_CREATE);
Schneider Victor-tulias927d6dc2021-08-26 11:56:47 -0700442 // Only use a hard-coded cookie since we only want to trace this once.
443 if (Utilities.ATLEAST_S) {
444 Trace.beginAsyncSection(
445 DISPLAY_WORKSPACE_TRACE_METHOD_NAME, DISPLAY_WORKSPACE_TRACE_COOKIE);
446 Trace.beginAsyncSection(DISPLAY_ALL_APPS_TRACE_METHOD_NAME,
447 DISPLAY_ALL_APPS_TRACE_COOKIE);
448 }
Sunny Goyal67736672023-06-02 13:35:19 +0000449 TraceHelper.INSTANCE.beginSection(ON_CREATE_EVT);
Winson Chunga2413752012-04-03 14:22:34 -0700450 if (DEBUG_STRICT_MODE) {
451 StrictMode.setThreadPolicy(new StrictMode.ThreadPolicy.Builder()
452 .detectDiskReads()
453 .detectDiskWrites()
454 .detectNetwork() // or .detectAll() for all detectable problems
455 .penaltyLog()
456 .build());
457 StrictMode.setVmPolicy(new StrictMode.VmPolicy.Builder()
458 .detectLeakedSqlLiteObjects()
459 .detectLeakedClosableObjects()
460 .penaltyLog()
461 .penaltyDeath()
462 .build());
463 }
464
Tony Wickhame78a70b2021-03-29 16:45:59 -0700465 if (Utilities.IS_DEBUG_DEVICE && FeatureFlags.NOTIFY_CRASHES.get()) {
466 final String notificationChannelId = "com.android.launcher3.Debug";
467 final String notificationChannelName = "Debug";
468 final String notificationTag = "Debug";
469 final int notificationId = 0;
470
471 NotificationManager notificationManager = getSystemService(NotificationManager.class);
472 notificationManager.createNotificationChannel(new NotificationChannel(
473 notificationChannelId, notificationChannelName,
474 NotificationManager.IMPORTANCE_HIGH));
475
476 Thread.currentThread().setUncaughtExceptionHandler((thread, throwable) -> {
477 String stackTrace = Log.getStackTraceString(throwable);
478
479 Intent shareIntent = new Intent(Intent.ACTION_SEND);
480 shareIntent.setType("text/plain");
481 shareIntent.putExtra(Intent.EXTRA_TEXT, stackTrace);
482 shareIntent = Intent.createChooser(shareIntent, null);
483 PendingIntent sharePendingIntent = PendingIntent.getActivity(
Sunny Goyalcd2ac0f2022-04-14 21:21:47 -0700484 this, 0, shareIntent, FLAG_UPDATE_CURRENT | FLAG_IMMUTABLE);
Tony Wickhame78a70b2021-03-29 16:45:59 -0700485
486 Notification notification = new Notification.Builder(this, notificationChannelId)
487 .setSmallIcon(android.R.drawable.ic_menu_close_clear_cancel)
488 .setContentTitle("Launcher crash detected!")
489 .setStyle(new Notification.BigTextStyle().bigText(stackTrace))
490 .addAction(android.R.drawable.ic_menu_share, "Share", sharePendingIntent)
491 .build();
492 notificationManager.notify(notificationTag, notificationId, notification);
493
494 Thread.UncaughtExceptionHandler defaultUncaughtExceptionHandler =
495 Thread.getDefaultUncaughtExceptionHandler();
496 if (defaultUncaughtExceptionHandler != null) {
497 defaultUncaughtExceptionHandler.uncaughtException(thread, throwable);
498 }
499 });
500 }
501
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800502 super.onCreate(savedInstanceState);
Daniel Sandlere060b0b2013-06-27 21:47:55 -0400503
Sunny Goyal87f784c2017-01-11 10:48:34 -0800504 LauncherAppState app = LauncherAppState.getInstance(this);
Sunny Goyala7a5bf32020-01-05 15:35:29 +0530505 mModel = app.getModel();
Sunny Goyal9d89f752020-06-19 11:09:24 -0700506
Sunny Goyal41d51a02019-05-14 09:44:34 -0700507 mRotationHelper = new RotationHelper(this);
Hyunyoung Song31971a32019-01-27 12:31:12 -0800508 InvariantDeviceProfile idp = app.getInvariantDeviceProfile();
509 initDeviceProfile(idp);
510 idp.addOnChangeListener(this);
Stefan Andonian146701c2022-11-10 23:07:40 +0000511 mSharedPrefs = LauncherPrefs.getPrefs(this);
Joe Onorato0589f0f2010-02-08 13:44:00 -0800512 mIconCache = app.getIconCache();
Sunny Goyal384b5782021-02-09 22:50:02 -0800513 mAccessibilityDelegate = createAccessibilityDelegate();
Adam Cohen2e6da152015-05-06 11:42:25 -0700514
Abhilasha Chahalcb329352022-05-31 15:50:53 +0000515 initDragController();
Hyunyoung Song645764e2016-06-06 14:19:02 -0700516 mAllAppsController = new AllAppsTransitionController(this);
Sunny Goyal35e7d382020-05-08 13:37:58 -0700517 mStateManager = new StateManager<>(this, NORMAL);
Romain Guycbb89e42009-06-08 15:52:54 -0700518
Sunny Goyal35e7d382020-05-08 13:37:58 -0700519 mOnboardingPrefs = createOnboardingPrefs(mSharedPrefs);
Tony Wickham133cd542020-04-08 17:48:41 -0700520
Luca Zuccarini81f5cee2022-10-11 13:02:09 +0000521 // TODO: move the SearchConfig to SearchState when new LauncherState is created.
522 mBaseSearchConfig = new BaseSearchConfig();
523
Schneider Victor-tuliasfb2affa2023-05-26 15:09:41 -0700524 setupViews();
525
Sunny Goyal337c81f2019-12-10 12:19:13 -0800526 mAppWidgetManager = new WidgetManagerHelper(this);
Sihua Ma0593a0d2022-10-03 16:01:48 -0700527 mAppWidgetHolder = createAppWidgetHolder();
528 mAppWidgetHolder.startListening();
Romain Guycbb89e42009-06-08 15:52:54 -0700529
Sunny Goyal9c2b9602020-01-07 13:07:55 -0800530 mPopupDataProvider = new PopupDataProvider(this::updateNotificationDots);
Tony Wickham010d2552017-01-20 08:15:28 -0800531
Sunny Goyale84c5b82019-09-26 17:05:31 -0700532 boolean internalStateHandled = ACTIVITY_TRACKER.handleCreate(this);
Sunny Goyald3864fa2017-11-14 15:06:36 -0800533 if (internalStateHandled) {
Sunny Goyald3864fa2017-11-14 15:06:36 -0800534 if (savedInstanceState != null) {
535 // InternalStateHandler has already set the appropriate state.
536 // We dont need to do anything.
537 savedInstanceState.remove(RUNTIME_STATE);
538 }
539 }
540 restoreState(savedInstanceState);
Sunny Goyalbbece862019-03-01 13:13:52 -0800541 mStateManager.reapplyState();
Winson Chungb63b44c2017-11-10 17:54:44 -0800542
Sunny Goyalfe770c92016-09-27 14:38:58 -0700543 if (savedInstanceState != null) {
Sunny Goyal12e3f1f2021-07-15 14:31:58 -0700544 int[] pageIds = savedInstanceState.getIntArray(RUNTIME_STATE_CURRENT_SCREEN_IDS);
545 if (pageIds != null) {
546 mPagesToBindSynchronously = IntSet.wrap(pageIds);
547 }
Sunny Goyalfe770c92016-09-27 14:38:58 -0700548 }
Sunny Goyald3864fa2017-11-14 15:06:36 -0800549
Fengjiang Li5a36c172023-04-13 18:18:27 +0000550 mStartupLatencyLogger.logWorkspaceLoadStartTime();
Sunny Goyala7a5bf32020-01-05 15:35:29 +0530551 if (!mModel.addCallbacksAndLoad(this)) {
Sunny Goyald3864fa2017-11-14 15:06:36 -0800552 if (!internalStateHandled) {
Sunny Goyal7b8d63f2022-04-14 16:37:32 -0700553 // If we are not binding synchronously, pause drawing until initial bind complete,
554 // so that the system could continue to show the device loading prompt
555 mOnInitialBindListener = Boolean.FALSE::booleanValue;
Sunny Goyald3864fa2017-11-14 15:06:36 -0800556 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800557 }
558
559 // For handling default keys
Sunny Goyalf4aceab2017-12-06 16:16:31 -0800560 setDefaultKeyMode(DEFAULT_KEYS_SEARCH_LOCAL);
Joe Onorato34a0e1b2009-12-14 17:44:51 -0800561
Sunny Goyal9d89f752020-06-19 11:09:24 -0700562 setContentView(getRootView());
Xiaowen Lei3c0f30a2023-04-12 16:59:45 -0700563 ComposeInitializer.initCompose(this);
564
Sunny Goyal7b8d63f2022-04-14 16:37:32 -0700565 if (mOnInitialBindListener != null) {
566 getRootView().getViewTreeObserver().addOnPreDrawListener(mOnInitialBindListener);
567 }
Sunny Goyalf8d56fc2018-01-31 15:18:11 -0800568 getRootView().dispatchInsets();
Mario Bertschlera6936942017-05-31 14:48:19 -0700569
Sunny Goyala992ac92023-01-10 17:50:32 -0800570 // Listen for screen turning off
571 ScreenOnTracker.INSTANCE.get(this).addListener(mScreenOnListener);
Sunny Goyal8392c822017-06-20 10:03:56 -0700572 getSystemUiController().updateUiState(SystemUiController.UI_STATE_BASE_WINDOW,
573 Themes.getAttrBoolean(this, R.attr.isWorkspaceDarkText));
Sunny Goyal14b32402017-07-31 10:03:28 -0700574
575 if (mLauncherCallbacks != null) {
576 mLauncherCallbacks.onCreate(savedInstanceState);
577 }
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700578 mOverlayManager = getDefaultOverlay();
579 PluginManagerWrapper.INSTANCE.get(this).addPluginListener(this,
Sunny Goyal80a071b2021-12-27 13:30:08 +0530580 LauncherOverlayPlugin.class, false /* allowedMultiple */);
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700581
Sunny Goyal623eddd2018-03-02 12:24:41 -0800582 mRotationHelper.initialize();
Sunny Goyal67736672023-06-02 13:35:19 +0000583 TraceHelper.INSTANCE.endSection();
Samuel Fufa41d909f2020-03-20 16:27:09 -0700584
Schneider Victor-tulias8a35c762020-09-03 14:30:10 -0700585 if (Utilities.ATLEAST_R) {
Schneider Victor-tulias25ecae12020-09-14 14:07:38 -0700586 getWindow().setSoftInputMode(LayoutParams.SOFT_INPUT_ADJUST_NOTHING);
Schneider Victor-tulias8a35c762020-09-03 14:30:10 -0700587 }
Stefan Andonian45fc3012022-05-05 22:48:09 +0000588 setTitle(R.string.home_screen);
Fengjiang Li5a36c172023-04-13 18:18:27 +0000589 mStartupLatencyLogger.logEnd(LAUNCHER_LATENCY_STARTUP_ACTIVITY_ON_CREATE);
590 }
591
592 /**
593 * Create {@link StartupLatencyLogger} that only collects launcher startup latency metrics
594 * without sending them anywhere. Child class can override this method to create logger
595 * that overrides {@link StartupLatencyLogger#log()} to report those metrics.
596 */
597 protected StartupLatencyLogger createStartupLatencyLogger(
598 StatsLogManager.StatsLatencyLogger.LatencyType latencyType) {
599 return new StartupLatencyLogger(latencyType);
Adam Cohen9211d422014-10-07 18:14:53 -0700600 }
601
Fengjiang Li6bb8d792023-01-12 16:20:58 -0800602 /**
Fengjiang Lib7860bd2023-03-15 10:50:50 -0700603 * Provide {@link OnBackAnimationCallback} in below order:
Fengjiang Li6bb8d792023-01-12 16:20:58 -0800604 * <ol>
605 * <li> auto cancel action mode handler
606 * <li> drag handler
607 * <li> view handler
Vinit Nayak65460402023-08-11 15:40:07 -0700608 * <li> registered {@link BackPressHandler}
Fengjiang Li6bb8d792023-01-12 16:20:58 -0800609 * <li> state handler
610 * </ol>
611 *
612 * A back gesture (a single click on back button, or a swipe back gesture that contains a series
613 * of swipe events) should be handled by the same handler from above list. For a new back
614 * gesture, a new handler should be regenerated.
615 *
616 * Note that state handler will always be handling the back press event if the previous 3 don't.
617 */
618 @NonNull
Fengjiang Lid0c23592023-04-20 16:42:25 -0700619 @RequiresApi(Build.VERSION_CODES.UPSIDE_DOWN_CAKE)
Fengjiang Lib7860bd2023-03-15 10:50:50 -0700620 protected OnBackAnimationCallback getOnBackAnimationCallback() {
Fengjiang Li6bb8d792023-01-12 16:20:58 -0800621 // #1 auto cancel action mode handler
622 if (isInAutoCancelActionMode()) {
623 return this::finishAutoCancelActionMode;
624 }
625
626 // #2 drag handler
627 if (mDragController.isDragging()) {
628 return mDragController::cancelDrag;
629 }
630
631 // #3 view handler
632 AbstractFloatingView topView =
633 AbstractFloatingView.getTopOpenView(Launcher.this);
634 if (topView != null && topView.canHandleBack()) {
635 return topView;
636 }
637
Vinit Nayak65460402023-08-11 15:40:07 -0700638 // #4 Custom back handlers
639 for (BackPressHandler handler : mBackPressedHandlers) {
640 if (handler.canHandleBack()) {
641 return handler;
642 }
643 }
644
645 // #5 state handler
Fengjiang Lib7860bd2023-03-15 10:50:50 -0700646 return new OnBackAnimationCallback() {
Fengjiang Li6bb8d792023-01-12 16:20:58 -0800647 @Override
648 public void onBackInvoked() {
649 onStateBack();
650 }
651
652 @Override
Fengjiang Lib7860bd2023-03-15 10:50:50 -0700653 public void onBackProgressed(@NonNull BackEvent backEvent) {
Fengjiang Li6bb8d792023-01-12 16:20:58 -0800654 mStateManager.getState().onBackProgressed(
Fengjiang Lib7860bd2023-03-15 10:50:50 -0700655 Launcher.this, backEvent.getProgress());
Fengjiang Li6bb8d792023-01-12 16:20:58 -0800656 }
657
658 @Override
659 public void onBackCancelled() {
660 mStateManager.getState().onBackCancelled(Launcher.this);
661 }
662 };
663 }
664
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700665 protected LauncherOverlayManager getDefaultOverlay() {
666 return new LauncherOverlayManager() { };
667 }
668
Brian Isganitis099945b2022-01-31 18:15:00 -0500669 protected OnboardingPrefs<? extends Launcher> createOnboardingPrefs(
670 SharedPreferences sharedPrefs) {
Sunny Goyal35e7d382020-05-08 13:37:58 -0700671 return new OnboardingPrefs<>(this, sharedPrefs);
Tony Wickham133cd542020-04-08 17:48:41 -0700672 }
673
Brian Isganitis099945b2022-01-31 18:15:00 -0500674 public OnboardingPrefs<? extends Launcher> getOnboardingPrefs() {
Tony Wickham133cd542020-04-08 17:48:41 -0700675 return mOnboardingPrefs;
676 }
677
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700678 @Override
Sunny Goyal80a071b2021-12-27 13:30:08 +0530679 public void onPluginConnected(LauncherOverlayPlugin overlayManager, Context context) {
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700680 switchOverlay(() -> overlayManager.createOverlayManager(this, this));
681 }
682
683 @Override
Sunny Goyal80a071b2021-12-27 13:30:08 +0530684 public void onPluginDisconnected(LauncherOverlayPlugin plugin) {
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700685 switchOverlay(this::getDefaultOverlay);
686 }
687
688 private void switchOverlay(Supplier<LauncherOverlayManager> overlaySupplier) {
689 if (mOverlayManager != null) {
690 mOverlayManager.onActivityDestroyed(this);
691 }
692 mOverlayManager = overlaySupplier.get();
693 if (getRootView().isAttachedToWindow()) {
694 mOverlayManager.onAttachedToWindow();
695 }
696 mDeferOverlayCallbacks = true;
697 checkIfOverlayStillDeferred();
698 }
699
700 @Override
Brian Isganitis099945b2022-01-31 18:15:00 -0500701 public void dispatchDeviceProfileChanged() {
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700702 super.dispatchDeviceProfileChanged();
703 mOverlayManager.onDeviceProvideChanged();
704 }
705
Sunny Goyal7779d622015-06-11 16:18:39 -0700706 @Override
Winson Chung8eb49e02018-07-16 13:33:31 -0700707 public void onEnterAnimationComplete() {
708 super.onEnterAnimationComplete();
Sunny Goyalbe8c3402019-05-22 15:17:52 -0700709 mRotationHelper.setCurrentTransitionRequest(REQUEST_NONE);
Sunny Goyal5c20fdd2022-04-05 20:58:03 -0700710 // Starting with Android S, onEnterAnimationComplete is sent immediately
711 // causing the surface to get removed before the animation completed (b/175345344).
712 // Instead we rely on next user touch event to remove the view and optionally a callback
713 // from system from Android T onwards.
714 if (!Utilities.ATLEAST_S) {
715 AbstractFloatingView.closeOpenViews(this, false, TYPE_ICON_SURFACE);
716 }
Winson Chung8eb49e02018-07-16 13:33:31 -0700717 }
718
719 @Override
Jerry Chang09b40242021-08-27 13:29:01 +0800720 public void onMultiWindowModeChanged(boolean isInMultiWindowMode, Configuration newConfig) {
721 super.onMultiWindowModeChanged(isInMultiWindowMode, newConfig);
722 // Always update device profile when multi window mode changed.
723 initDeviceProfile(mDeviceProfile.inv);
724 dispatchDeviceProfileChanged();
725 }
726
Abhilasha Chahalcb329352022-05-31 15:50:53 +0000727 /**
728 * Initializes the drag controller.
729 */
730 protected void initDragController() {
731 mDragController = new LauncherDragController(this);
732 }
733
Sunny Goyal605bcf32018-03-02 15:16:12 -0800734 @Override
Sunny Goyal6e6f7992021-08-24 16:23:29 -0700735 public void onIdpChanged(boolean modelPropertiesChanged) {
Alex Chau360ec032022-08-10 16:11:42 +0100736 onHandleConfigurationChanged();
737 }
738
739 @Override
740 protected void onHandleConfigurationChanged() {
Nicolo' Mazzucatoe120fcf2023-08-04 15:33:15 +0000741 Trace.beginSection("Launcher#onHandleconfigurationChanged");
742 try {
743 if (!initDeviceProfile(mDeviceProfile.inv)) {
744 return;
745 }
746
747 dispatchDeviceProfileChanged();
748 reapplyUi();
749 mDragLayer.recreateControllers();
750
751 // Calling onSaveInstanceState ensures that static cache used by listWidgets is
752 // initialized properly.
753 onSaveInstanceState(new Bundle());
754 mModel.rebindCallbacks();
755 } finally {
756 Trace.endSection();
Alex Chau6209af62022-07-27 14:08:23 +0100757 }
Hyunyoung Song31971a32019-01-27 12:31:12 -0800758 }
759
Govinda Wassermanc06e1512019-04-09 09:56:53 -0400760 public void onAssistantVisibilityChanged(float visibility) {
Sunny Goyal0b5b8d42021-03-31 14:56:47 -0700761 mHotseat.getQsb().setAlpha(1f - visibility);
Govinda Wassermanc06e1512019-04-09 09:56:53 -0400762 }
763
Bill Lina1221bc2021-06-03 01:49:27 +0800764 /**
Alex Chau6209af62022-07-27 14:08:23 +0100765 * Returns {@code true} if a new DeviceProfile is initialized, and {@code false} otherwise.
766 */
767 protected boolean initDeviceProfile(InvariantDeviceProfile idp) {
Sunny Goyalf8d56fc2018-01-31 15:18:11 -0800768 // Load configuration-specific DeviceProfile
Alex Chau6209af62022-07-27 14:08:23 +0100769 DeviceProfile deviceProfile = idp.getDeviceProfile(this);
770 if (mDeviceProfile == deviceProfile) {
771 return false;
772 }
773
774 mDeviceProfile = deviceProfile;
Jerry Changbfac46a2021-09-08 08:20:58 +0800775 if (isInMultiWindowMode()) {
776 mDeviceProfile = mDeviceProfile.getMultiWindowProfile(
777 this, getMultiWindowDisplaySize());
778 }
Sunny Goyalae6e3182019-04-30 12:04:37 -0700779
Sunny Goyal59d086c2018-05-07 17:31:40 -0700780 onDeviceProfileInitiated();
Sebastián Franco1f4d56c2023-08-08 03:29:10 +0000781 if (FOLDABLE_SINGLE_PAGE.get() && mDeviceProfile.isTwoPanels) {
Sebastian Franco09589322022-11-02 15:25:58 -0700782 mCellPosMapper = new TwoPanelCellPosMapper(mDeviceProfile.inv.numColumns);
783 } else {
784 mCellPosMapper = CellPosMapper.DEFAULT;
785 }
Sunny Goyal669b71f2023-01-27 14:37:07 -0800786 mModelWriter = mModel.getWriter(getDeviceProfile().isVerticalBarLayout(), true,
787 mCellPosMapper, this);
Alex Chau6209af62022-07-27 14:08:23 +0100788 return true;
Sunny Goyalf8d56fc2018-01-31 15:18:11 -0800789 }
790
Sunny Goyal669b71f2023-01-27 14:37:07 -0800791 @Override
792 public CellPosMapper getCellPosMapper() {
793 return mCellPosMapper;
794 }
795
Sunny Goyal623eddd2018-03-02 12:24:41 -0800796 public RotationHelper getRotationHelper() {
797 return mRotationHelper;
798 }
799
Tracy Zhou4d7b2442019-12-09 13:42:57 -0800800 public ViewGroupFocusHelper getFocusHandler() {
801 return mFocusHandler;
802 }
803
Sunny Goyal35e7d382020-05-08 13:37:58 -0700804 @Override
805 public StateManager<LauncherState> getStateManager() {
Sunny Goyal3e3f44c2017-10-23 17:14:52 -0700806 return mStateManager;
Sunny Goyalbe93f262017-10-20 17:05:27 -0700807 }
808
Adam Cohen9211d422014-10-07 18:14:53 -0700809 private LauncherCallbacks mLauncherCallbacks;
810
Sunny Goyal32554d12015-12-03 15:31:25 -0800811 /**
812 * Call this after onCreate to set or clear overlay.
813 */
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700814 @Override
Sunny Goyal32554d12015-12-03 15:31:25 -0800815 public void setLauncherOverlay(LauncherOverlay overlay) {
Sunny Goyal32554d12015-12-03 15:31:25 -0800816 mWorkspace.setLauncherOverlay(overlay);
817 }
818
Adam Cohen9211d422014-10-07 18:14:53 -0700819 public boolean setLauncherCallbacks(LauncherCallbacks callbacks) {
820 mLauncherCallbacks = callbacks;
821 return true;
Adam Cohenf9426d52012-06-04 17:26:21 -0700822 }
823
Hyunyoung Song3f471442015-04-08 19:01:34 -0700824 public boolean isDraggingEnabled() {
Winson Chung36a62fe2012-05-06 18:04:42 -0700825 // We prevent dragging when we are loading the workspace as it is possible to pick up a view
826 // that is subsequently removed from the workspace in startBinding().
Sunny Goyal639e9062015-08-19 19:17:06 -0700827 return !isWorkspaceLoading();
Winson Chung36a62fe2012-05-06 18:04:42 -0700828 }
829
Schneider Victor-tulias5173fd82021-10-19 14:47:23 -0700830 @NonNull
831 @Override
Tony Wickham010d2552017-01-20 08:15:28 -0800832 public PopupDataProvider getPopupDataProvider() {
833 return mPopupDataProvider;
834 }
835
Sunny Goyal0b0847b2018-03-14 12:30:11 -0700836 @Override
Tony Wickhamf34bee82018-12-03 18:11:39 -0800837 public DotInfo getDotInfoForItem(ItemInfo info) {
838 return mPopupDataProvider.getDotInfoForItem(info);
Sunny Goyal0b0847b2018-03-14 12:30:11 -0700839 }
840
841 @Override
842 public void invalidateParent(ItemInfo info) {
Jon Mirandae6f3fa42019-03-04 09:14:40 -0800843 if (info.container >= 0) {
Sunny Goyal0b0847b2018-03-14 12:30:11 -0700844 View folderIcon = getWorkspace().getHomescreenIconByItemId(info.container);
Jon Mirandae6f3fa42019-03-04 09:14:40 -0800845 if (folderIcon instanceof FolderIcon && folderIcon.getTag() instanceof FolderInfo) {
Sunny Goyal11a50742019-08-07 09:24:26 -0700846 if (new FolderGridOrganizer(getDeviceProfile().inv)
847 .setFolderInfo((FolderInfo) folderIcon.getTag())
848 .isItemInPreview(info.rank)) {
Jon Mirandae6f3fa42019-03-04 09:14:40 -0800849 folderIcon.invalidate();
850 }
Sunny Goyal0b0847b2018-03-14 12:30:11 -0700851 }
852 }
853 }
854
Adam Cohenc76e1dd2013-11-14 11:09:14 +0000855 /**
Winson Chung557d6ed2011-07-08 15:34:52 -0700856 * Returns whether we should delay spring loaded mode -- for shortcuts and widgets that have
857 * a configuration step, this allows the proper animations to run after other transitions.
858 */
Sunny Goyalefb7e842018-10-04 15:11:00 -0700859 private int completeAdd(
Sunny Goyal2100c782016-08-22 16:00:03 -0700860 int requestCode, Intent intent, int appWidgetId, PendingRequestArgs info) {
Sunny Goyal669b71f2023-01-27 14:37:07 -0800861 CellPos cellPos = getCellPosMapper().mapModelToPresenter(info);
862 int screenId = cellPos.screenId;
863 if (info.container == CONTAINER_DESKTOP) {
Adam Cohen83079e42014-09-19 17:43:08 -0700864 // When the screen id represents an actual screen (as opposed to a rank) we make sure
865 // that the drop page actually exists.
Sunny Goyal669b71f2023-01-27 14:37:07 -0800866 screenId = ensurePendingDropLayoutExists(cellPos.screenId);
Adam Cohen83079e42014-09-19 17:43:08 -0700867 }
Adam Cohendb364c32014-05-20 14:23:40 -0700868
Sunny Goyal2100c782016-08-22 16:00:03 -0700869 switch (requestCode) {
Patrick Dubroy002cbf42011-03-03 16:36:21 -0800870 case REQUEST_CREATE_SHORTCUT:
Sunny Goyal669b71f2023-01-27 14:37:07 -0800871 completeAddShortcut(intent, info.container, screenId,
872 cellPos.cellX, cellPos.cellY, info);
Pinyao Tingc9074272019-11-11 11:51:44 -0800873 announceForAccessibility(R.string.item_added_to_workspace);
Winson Chungb8472bb2011-08-05 13:49:21 -0700874 break;
Patrick Dubroy002cbf42011-03-03 16:36:21 -0800875 case REQUEST_CREATE_APPWIDGET:
Sunny Goyal2100c782016-08-22 16:00:03 -0700876 completeAddAppWidget(appWidgetId, info, null, null);
Winson Chungb8472bb2011-08-05 13:49:21 -0700877 break;
Sunny Goyalff572272014-07-23 13:58:07 -0700878 case REQUEST_RECONFIGURE_APPWIDGET:
Sunny Goyal977838b2022-06-27 13:15:41 -0700879 getStatsLogManager().logger().withItemInfo(info).log(LAUNCHER_WIDGET_RECONFIGURED);
Sunny Goyal2100c782016-08-22 16:00:03 -0700880 completeRestoreAppWidget(appWidgetId, LauncherAppWidgetInfo.RESTORE_COMPLETED);
Sunny Goyalff572272014-07-23 13:58:07 -0700881 break;
Sunny Goyald478c832016-04-01 12:04:16 -0700882 case REQUEST_BIND_PENDING_APPWIDGET: {
Sunny Goyal2100c782016-08-22 16:00:03 -0700883 int widgetId = appWidgetId;
884 LauncherAppWidgetInfo widgetInfo =
Sunny Goyald478c832016-04-01 12:04:16 -0700885 completeRestoreAppWidget(widgetId, LauncherAppWidgetInfo.FLAG_UI_NOT_READY);
Sunny Goyal2100c782016-08-22 16:00:03 -0700886 if (widgetInfo != null) {
Sunny Goyald478c832016-04-01 12:04:16 -0700887 // Since the view was just bound, also launch the configure activity if needed
888 LauncherAppWidgetProviderInfo provider = mAppWidgetManager
fbaron30d9e3f2023-08-03 17:03:59 -0700889 .getLauncherAppWidgetInfo(widgetId, info.getTargetComponent());
Sunny Goyal04a324a2017-01-20 21:08:59 -0800890 if (provider != null) {
891 new WidgetAddFlowHandler(provider)
Samuel Fufaca37b8a2019-08-19 17:04:36 -0700892 .startConfigActivity(this, widgetInfo,
893 REQUEST_RECONFIGURE_APPWIDGET);
Sunny Goyald478c832016-04-01 12:04:16 -0700894 }
895 }
896 break;
897 }
Patrick Dubroy002cbf42011-03-03 16:36:21 -0800898 }
Adam Cohendb364c32014-05-20 14:23:40 -0700899 return screenId;
Patrick Dubroy002cbf42011-03-03 16:36:21 -0800900 }
901
Adam Cohenc7cd2cb2014-11-17 17:45:34 -0800902 private void handleActivityResult(
Michael Jurka8b805b12012-04-18 14:23:14 -0700903 final int requestCode, final int resultCode, final Intent data) {
Sunny Goyal2100c782016-08-22 16:00:03 -0700904 if (isWorkspaceLoading()) {
905 // process the result once the workspace has loaded.
906 mPendingActivityResult = new ActivityResultInfo(requestCode, resultCode, data);
907 return;
908 }
909 mPendingActivityResult = null;
910
Winson Chunge341d302013-08-16 14:31:00 -0700911 // Reset the startActivity waiting flag
Sunny Goyal2100c782016-08-22 16:00:03 -0700912 final PendingRequestArgs requestArgs = mPendingRequestArgs;
913 setWaitingForResult(null);
914 if (requestArgs == null) {
915 return;
916 }
917
918 final int pendingAddWidgetId = requestArgs.getWidgetId();
Winson Chunge341d302013-08-16 14:31:00 -0700919
Charlie Anderson438d4052023-04-25 14:38:57 -0400920 Runnable exitSpringLoaded = MULTI_SELECT_EDIT_MODE.get() ? null
921 : () -> mStateManager.goToState(NORMAL, SPRING_LOADED_EXIT_DELAY);
Adam Cohenad4e15c2013-10-17 16:21:35 -0700922
Michael Jurka8b805b12012-04-18 14:23:14 -0700923 if (requestCode == REQUEST_BIND_APPWIDGET) {
Winsona1f79d32015-08-05 14:00:45 -0700924 // This is called only if the user did not previously have permissions to bind widgets
Adam Cohenad4e15c2013-10-17 16:21:35 -0700925 final int appWidgetId = data != null ?
Michael Jurka8b805b12012-04-18 14:23:14 -0700926 data.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, -1) : -1;
927 if (resultCode == RESULT_CANCELED) {
Sunny Goyal2100c782016-08-22 16:00:03 -0700928 completeTwoStageWidgetDrop(RESULT_CANCELED, appWidgetId, requestArgs);
Sunny Goyal6e379fc2020-03-19 16:08:14 -0700929 mWorkspace.removeExtraEmptyScreenDelayed(
930 ON_ACTIVITY_RESULT_ANIMATION_DELAY, false, exitSpringLoaded);
Michael Jurka8b805b12012-04-18 14:23:14 -0700931 } else if (resultCode == RESULT_OK) {
Sunny Goyal2100c782016-08-22 16:00:03 -0700932 addAppWidgetImpl(
933 appWidgetId, requestArgs, null,
Sunny Goyal04a324a2017-01-20 21:08:59 -0800934 requestArgs.getWidgetHandler(),
Sunny Goyal2100c782016-08-22 16:00:03 -0700935 ON_ACTIVITY_RESULT_ANIMATION_DELAY);
Michael Jurka8b805b12012-04-18 14:23:14 -0700936 }
937 return;
938 }
Michael Jurka336fd4f2013-09-12 00:05:02 +0200939
Adam Cohened66b2b2012-01-23 17:28:51 -0800940 boolean isWidgetDrop = (requestCode == REQUEST_PICK_APPWIDGET ||
Sunny Goyal5c97f512015-05-19 16:03:28 -0700941 requestCode == REQUEST_CREATE_APPWIDGET);
Romain Guyaad5ef42009-06-10 02:48:37 -0700942
Adam Cohened66b2b2012-01-23 17:28:51 -0800943 // We have special handling for widgets
944 if (isWidgetDrop) {
Adam Cohen4637b5a2013-11-04 18:21:24 -0800945 final int appWidgetId;
946 int widgetId = data != null ? data.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, -1)
947 : -1;
948 if (widgetId < 0) {
949 appWidgetId = pendingAddWidgetId;
950 } else {
951 appWidgetId = widgetId;
952 }
953
Adam Cohenad4e15c2013-10-17 16:21:35 -0700954 final int result;
Adam Cohenf0129b12013-11-04 17:57:36 -0800955 if (appWidgetId < 0 || resultCode == RESULT_CANCELED) {
Adam Cohendb364c32014-05-20 14:23:40 -0700956 Log.e(TAG, "Error: appWidgetId (EXTRA_APPWIDGET_ID) was not " +
957 "returned from the widget configuration activity.");
Adam Cohenad4e15c2013-10-17 16:21:35 -0700958 result = RESULT_CANCELED;
Sunny Goyal2100c782016-08-22 16:00:03 -0700959 completeTwoStageWidgetDrop(result, appWidgetId, requestArgs);
Sunny Goyal6e379fc2020-03-19 16:08:14 -0700960 mWorkspace.removeExtraEmptyScreenDelayed(
961 ON_ACTIVITY_RESULT_ANIMATION_DELAY, false,
962 () -> getStateManager().goToState(NORMAL));
Sunny Goyal2100c782016-08-22 16:00:03 -0700963 } else {
Sunny Goyal669b71f2023-01-27 14:37:07 -0800964 CellPos presenterPos = getCellPosMapper().mapModelToPresenter(requestArgs);
965 if (requestArgs.container == CONTAINER_DESKTOP) {
Sunny Goyal2100c782016-08-22 16:00:03 -0700966 // When the screen id represents an actual screen (as opposed to a rank)
967 // we make sure that the drop page actually exists.
Sunny Goyal669b71f2023-01-27 14:37:07 -0800968 int newScreenId = ensurePendingDropLayoutExists(presenterPos.screenId);
969 requestArgs.screenId = getCellPosMapper().mapPresenterToModel(
970 presenterPos.cellX, presenterPos.cellY, newScreenId, CONTAINER_DESKTOP)
971 .screenId;
Adam Cohendb364c32014-05-20 14:23:40 -0700972 }
Sunny Goyal2100c782016-08-22 16:00:03 -0700973 final CellLayout dropLayout =
Sunny Goyal669b71f2023-01-27 14:37:07 -0800974 mWorkspace.getScreenWithId(presenterPos.screenId);
Sunny Goyal2100c782016-08-22 16:00:03 -0700975
976 dropLayout.setDropPending(true);
977 final Runnable onComplete = new Runnable() {
978 @Override
979 public void run() {
980 completeTwoStageWidgetDrop(resultCode, appWidgetId, requestArgs);
981 dropLayout.setDropPending(false);
982 }
983 };
Sunny Goyal6e379fc2020-03-19 16:08:14 -0700984 mWorkspace.removeExtraEmptyScreenDelayed(
985 ON_ACTIVITY_RESULT_ANIMATION_DELAY, false, onComplete);
Winson Chung5aaab772012-04-27 15:24:02 -0700986 }
Adam Cohened66b2b2012-01-23 17:28:51 -0800987 return;
988 }
989
Sunny Goyald478c832016-04-01 12:04:16 -0700990 if (requestCode == REQUEST_RECONFIGURE_APPWIDGET
991 || requestCode == REQUEST_BIND_PENDING_APPWIDGET) {
Sunny Goyalff572272014-07-23 13:58:07 -0700992 if (resultCode == RESULT_OK) {
993 // Update the widget view.
Sunny Goyal2100c782016-08-22 16:00:03 -0700994 completeAdd(requestCode, data, pendingAddWidgetId, requestArgs);
Sunny Goyalff572272014-07-23 13:58:07 -0700995 }
996 // Leave the widget in the pending state if the user canceled the configure.
997 return;
998 }
999
Sunny Goyalaad90582015-07-09 14:22:50 -07001000 if (requestCode == REQUEST_CREATE_SHORTCUT) {
1001 // Handle custom shortcuts created using ACTION_CREATE_SHORTCUT.
Sunny Goyal2100c782016-08-22 16:00:03 -07001002 if (resultCode == RESULT_OK && requestArgs.container != ItemInfo.NO_ID) {
1003 completeAdd(requestCode, data, -1, requestArgs);
Sunny Goyal6e379fc2020-03-19 16:08:14 -07001004 mWorkspace.removeExtraEmptyScreenDelayed(
1005 ON_ACTIVITY_RESULT_ANIMATION_DELAY, false, exitSpringLoaded);
Sunny Goyal2100c782016-08-22 16:00:03 -07001006
Sunny Goyalaad90582015-07-09 14:22:50 -07001007 } else if (resultCode == RESULT_CANCELED) {
Sunny Goyal6e379fc2020-03-19 16:08:14 -07001008 mWorkspace.removeExtraEmptyScreenDelayed(
1009 ON_ACTIVITY_RESULT_ANIMATION_DELAY, false, exitSpringLoaded);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001010 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001011 }
Hongming Jind91cb6e2020-01-27 16:23:03 -08001012
Adam Cohened66b2b2012-01-23 17:28:51 -08001013 mDragLayer.clearAnimatedView();
Adam Cohenc7cd2cb2014-11-17 17:45:34 -08001014 }
1015
1016 @Override
Sunny Goyal64a75aa2017-07-03 13:50:52 -07001017 public void onActivityResult(
Adam Cohenc7cd2cb2014-11-17 17:45:34 -08001018 final int requestCode, final int resultCode, final Intent data) {
Sunny Goyaldedda052019-05-14 15:23:48 -07001019 mPendingActivityRequestCode = -1;
Adam Cohenc7cd2cb2014-11-17 17:45:34 -08001020 handleActivityResult(requestCode, resultCode, data);
Adam Cohened66b2b2012-01-23 17:28:51 -08001021 }
1022
Adam Cohendb364c32014-05-20 14:23:40 -07001023 /**
1024 * Check to see if a given screen id exists. If not, create it at the end, return the new id.
1025 *
1026 * @param screenId the screen id to check
1027 * @return the new screen, or screenId if it exists
1028 */
Sunny Goyalefb7e842018-10-04 15:11:00 -07001029 private int ensurePendingDropLayoutExists(int screenId) {
Sunny Goyal32554d12015-12-03 15:31:25 -08001030 CellLayout dropLayout = mWorkspace.getScreenWithId(screenId);
Adam Cohendb364c32014-05-20 14:23:40 -07001031 if (dropLayout == null) {
1032 // it's possible that the add screen was removed because it was
1033 // empty and a re-bind occurred
Andras Kloczl408a54f2021-08-28 00:59:08 +01001034 mWorkspace.addExtraEmptyScreens();
1035 IntSet emptyPagesAdded = mWorkspace.commitExtraEmptyScreens();
1036 return emptyPagesAdded.isEmpty() ? -1 : emptyPagesAdded.getArray().get(0);
Adam Cohendb364c32014-05-20 14:23:40 -07001037 }
Andras Kloczl408a54f2021-08-28 00:59:08 +01001038 return screenId;
Adam Cohendb364c32014-05-20 14:23:40 -07001039 }
1040
Samuel Fufaca37b8a2019-08-19 17:04:36 -07001041 @Thunk
1042 void completeTwoStageWidgetDrop(
Sunny Goyal2100c782016-08-22 16:00:03 -07001043 final int resultCode, final int appWidgetId, final PendingRequestArgs requestArgs) {
Sunny Goyal669b71f2023-01-27 14:37:07 -08001044 CellLayout cellLayout = mWorkspace.getScreenWithId(
1045 getCellPosMapper().mapModelToPresenter(requestArgs).screenId);
Adam Cohened66b2b2012-01-23 17:28:51 -08001046 Runnable onCompleteRunnable = null;
1047 int animationType = 0;
1048
Adam Cohen9d5b7d82012-05-09 18:00:44 -07001049 AppWidgetHostView boundWidget = null;
Adam Cohened66b2b2012-01-23 17:28:51 -08001050 if (resultCode == RESULT_OK) {
1051 animationType = Workspace.COMPLETE_TWO_STAGE_WIDGET_DROP_ANIMATION;
Sihua Ma0593a0d2022-10-03 16:01:48 -07001052 final AppWidgetHostView layout = mAppWidgetHolder.createView(this, appWidgetId,
Sunny Goyal04a324a2017-01-20 21:08:59 -08001053 requestArgs.getWidgetHandler().getProviderInfo(this));
Adam Cohen9d5b7d82012-05-09 18:00:44 -07001054 boundWidget = layout;
Charlie Anderson438d4052023-04-25 14:38:57 -04001055 onCompleteRunnable = () -> {
1056 completeAddAppWidget(appWidgetId, requestArgs, layout, null);
1057 if (!isInState(EDIT_MODE)) {
Sunny Goyal3e3f44c2017-10-23 17:14:52 -07001058 mStateManager.goToState(NORMAL, SPRING_LOADED_EXIT_DELAY);
Adam Cohened66b2b2012-01-23 17:28:51 -08001059 }
1060 };
1061 } else if (resultCode == RESULT_CANCELED) {
Sihua Ma0593a0d2022-10-03 16:01:48 -07001062 mAppWidgetHolder.deleteAppWidgetId(appWidgetId);
Adam Cohened66b2b2012-01-23 17:28:51 -08001063 animationType = Workspace.CANCEL_TWO_STAGE_WIDGET_DROP_ANIMATION;
Adam Cohened66b2b2012-01-23 17:28:51 -08001064 }
Adam Cohen9d5b7d82012-05-09 18:00:44 -07001065 if (mDragLayer.getAnimatedView() != null) {
Sunny Goyal2100c782016-08-22 16:00:03 -07001066 mWorkspace.animateWidgetDrop(requestArgs, cellLayout,
Adam Cohen9d5b7d82012-05-09 18:00:44 -07001067 (DragView) mDragLayer.getAnimatedView(), onCompleteRunnable,
1068 animationType, boundWidget, true);
Adam Cohenad4e15c2013-10-17 16:21:35 -07001069 } else if (onCompleteRunnable != null) {
Adam Cohen9d5b7d82012-05-09 18:00:44 -07001070 // The animated view may be null in the case of a rotation during widget configuration
1071 onCompleteRunnable.run();
1072 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001073 }
1074
1075 @Override
Michael Jurkacd496d72013-04-11 11:32:45 -07001076 protected void onStop() {
1077 super.onStop();
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001078 if (mDeferOverlayCallbacks) {
1079 checkIfOverlayStillDeferred();
1080 } else {
1081 mOverlayManager.onActivityStopped(this);
Adam Cohen9211d422014-10-07 18:14:53 -07001082 }
Hyunyoung Song5ee7c132021-05-11 13:52:36 -07001083 hideKeyboard();
Hyunyoung Song95786e02020-09-15 00:34:10 -07001084 logStopAndResume(false /* isResume */);
Sihua Ma0593a0d2022-10-03 16:01:48 -07001085 mAppWidgetHolder.setActivityStarted(false);
Schneider Victor-tulias5173fd82021-10-19 14:47:23 -07001086 NotificationListener.removeNotificationsChangedListener(getPopupDataProvider());
Winson Chung7c500162023-06-14 18:58:27 +00001087 FloatingIconView.resetIconLoadResult();
Michael Jurkacd496d72013-04-11 11:32:45 -07001088 }
1089
1090 @Override
1091 protected void onStart() {
Sunny Goyal67736672023-06-02 13:35:19 +00001092 TraceHelper.INSTANCE.beginSection(ON_START_EVT);
Michael Jurkacd496d72013-04-11 11:32:45 -07001093 super.onStart();
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001094 if (!mDeferOverlayCallbacks) {
1095 mOverlayManager.onActivityStarted(this);
Adam Cohen9211d422014-10-07 18:14:53 -07001096 }
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001097
Sihua Ma0593a0d2022-10-03 16:01:48 -07001098 mAppWidgetHolder.setActivityStarted(true);
Sunny Goyal67736672023-06-02 13:35:19 +00001099 TraceHelper.INSTANCE.endSection();
Michael Jurkacd496d72013-04-11 11:32:45 -07001100 }
1101
Sunny Goyal35e7d382020-05-08 13:37:58 -07001102 @Override
1103 @CallSuper
1104 protected void onDeferredResumed() {
Hyunyoung Song95786e02020-09-15 00:34:10 -07001105 logStopAndResume(true /* isResume */);
Sunny Goyala002c6c2019-02-12 16:20:10 -08001106
Sunny Goyal35e7d382020-05-08 13:37:58 -07001107 // Process any items that were added while Launcher was away.
Sunny Goyal60e68c92020-08-12 13:59:27 -07001108 ItemInstallQueue.INSTANCE.get(this)
1109 .resumeModelPush(FLAG_ACTIVITY_PAUSED);
Sunny Goyale9c6f4c2019-05-30 11:35:25 -07001110
Sunny Goyal35e7d382020-05-08 13:37:58 -07001111 // Refresh shortcuts if the permission changed.
Sunny Goyal8b74cc72020-07-27 17:50:33 -07001112 mModel.validateModelDataOnResume();
Sunny Goyale9c6f4c2019-05-30 11:35:25 -07001113
Sunny Goyal35e7d382020-05-08 13:37:58 -07001114 // Set the notification listener and fetch updated notifications when we resume
Schneider Victor-tulias5173fd82021-10-19 14:47:23 -07001115 NotificationListener.addNotificationsChangedListener(mPopupDataProvider);
Winson Chung87583112019-06-10 14:20:58 -07001116
Sunny Goyal35e7d382020-05-08 13:37:58 -07001117 DiscoveryBounce.showForHomeIfNeeded(this);
Sihua Ma0593a0d2022-10-03 16:01:48 -07001118 mAppWidgetHolder.setActivityResumed(true);
Sunny Goyaldedda052019-05-14 15:23:48 -07001119 }
1120
Hyunyoung Song95786e02020-09-15 00:34:10 -07001121 private void logStopAndResume(boolean isResume) {
Hyunyoung Song77e29772020-08-25 00:53:48 -07001122 if (mPendingExecutor != null) return;
Hyunyoung Song801f81f2020-06-19 02:58:53 -07001123 int pageIndex = mWorkspace.isOverlayShown() ? -1 : mWorkspace.getCurrentPage();
Hyunyoung Song95786e02020-09-15 00:34:10 -07001124 int statsLogOrdinal = mStateManager.getState().statsLogOrdinal;
Hyunyoung Song801f81f2020-06-19 02:58:53 -07001125
1126 StatsLogManager.EventEnum event;
1127 StatsLogManager.StatsLogger logger = getStatsLogManager().logger();
Hyunyoung Song95786e02020-09-15 00:34:10 -07001128 if (isResume) {
Hyunyoung Song801f81f2020-06-19 02:58:53 -07001129 logger.withSrcState(LAUNCHER_STATE_BACKGROUND)
Hyunyoung Song95786e02020-09-15 00:34:10 -07001130 .withDstState(mStateManager.getState().statsLogOrdinal);
Hyunyoung Song801f81f2020-06-19 02:58:53 -07001131 event = LAUNCHER_ONRESUME;
1132 } else { /* command == Action.Command.STOP */
Hyunyoung Song95786e02020-09-15 00:34:10 -07001133 logger.withSrcState(mStateManager.getState().statsLogOrdinal)
Hyunyoung Song801f81f2020-06-19 02:58:53 -07001134 .withDstState(LAUNCHER_STATE_BACKGROUND);
1135 event = LAUNCHER_ONSTOP;
1136 }
1137
Hyunyoung Song95786e02020-09-15 00:34:10 -07001138 if (statsLogOrdinal == LAUNCHER_STATE_HOME && mWorkspace != null) {
Hyunyoung Song801f81f2020-06-19 02:58:53 -07001139 logger.withContainerInfo(LauncherAtom.ContainerInfo.newBuilder()
1140 .setWorkspace(
1141 LauncherAtom.WorkspaceContainer.newBuilder()
1142 .setPageIndex(pageIndex)).build());
Becky Qiubfc2da12019-08-01 11:09:38 -07001143 }
Hyunyoung Song801f81f2020-06-19 02:58:53 -07001144 logger.log(event);
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001145 }
Becky Qiubfc2da12019-08-01 11:09:38 -07001146
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001147 private void scheduleDeferredCheck() {
1148 mHandler.removeCallbacks(mDeferredOverlayCallbacks);
1149 postAsyncCallback(mHandler, mDeferredOverlayCallbacks);
1150 }
1151
1152 private void checkIfOverlayStillDeferred() {
1153 if (!mDeferOverlayCallbacks) {
1154 return;
1155 }
Sunny Goyal8f965462020-04-23 19:00:36 -07001156 if (isStarted() && (!hasBeenResumed()
1157 || mStateManager.getState().hasFlag(FLAG_NON_INTERACTIVE))) {
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001158 return;
1159 }
1160 mDeferOverlayCallbacks = false;
1161
1162 // Move the client to the correct state. Calling the same method twice is no-op.
1163 if (isStarted()) {
1164 mOverlayManager.onActivityStarted(this);
1165 }
1166 if (hasBeenResumed()) {
1167 mOverlayManager.onActivityResumed(this);
1168 } else {
1169 mOverlayManager.onActivityPaused(this);
1170 }
1171 if (!isStarted()) {
1172 mOverlayManager.onActivityStopped(this);
1173 }
1174 }
1175
1176 public void deferOverlayCallbacksUntilNextResumeOrStop() {
1177 mDeferOverlayCallbacks = true;
1178 }
1179
1180 public LauncherOverlayManager getOverlayManager() {
1181 return mOverlayManager;
Becky Qiubfc2da12019-08-01 11:09:38 -07001182 }
1183
Sunny Goyal35e7d382020-05-08 13:37:58 -07001184 @Override
Winson Chungef528762019-09-06 12:05:52 -07001185 public void onStateSetStart(LauncherState state) {
Sunny Goyal35e7d382020-05-08 13:37:58 -07001186 super.onStateSetStart(state);
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001187 if (mDeferOverlayCallbacks) {
1188 scheduleDeferredCheck();
Sunny Goyale9c6f4c2019-05-30 11:35:25 -07001189 }
Sunny Goyal210e1742019-10-17 12:05:38 -07001190 addActivityFlags(ACTIVITY_STATE_TRANSITION_ACTIVE);
Sunny Goyal8f965462020-04-23 19:00:36 -07001191
Charlie Anderson438d4052023-04-25 14:38:57 -04001192 if (state == SPRING_LOADED || state == EDIT_MODE) {
Sunny Goyal8f965462020-04-23 19:00:36 -07001193 // Prevent any Un/InstallShortcutReceivers from updating the db while we are
1194 // not on homescreen
Sunny Goyal60e68c92020-08-12 13:59:27 -07001195 ItemInstallQueue.INSTANCE.get(this).pauseModelPush(FLAG_DRAG_AND_DROP);
Sunny Goyal8f965462020-04-23 19:00:36 -07001196 getRotationHelper().setCurrentStateRequest(REQUEST_LOCK);
1197
1198 mWorkspace.showPageIndicatorAtCurrentScroll();
1199 mWorkspace.setClipChildren(false);
1200 }
1201 // When multiple pages are visible, show persistent page indicator
1202 mWorkspace.getPageIndicator().setShouldAutoHide(!state.hasFlag(FLAG_MULTI_PAGE));
thiruram0eabc782021-04-02 14:30:10 -07001203
thiruramc96873c2021-02-11 15:13:47 -08001204 mPrevLauncherState = mStateManager.getCurrentStableState();
thiruram0eabc782021-04-02 14:30:10 -07001205 if (mPrevLauncherState != state && ALL_APPS.equals(state)
1206 // Making sure mAllAppsSessionLogId is null to avoid double logging.
1207 && mAllAppsSessionLogId == null) {
1208 // creates new instance ID since new all apps session is started.
1209 mAllAppsSessionLogId = new InstanceIdSequence().newInstanceId();
Thiru Ramasamy694407c2022-03-08 12:11:24 -08001210 if (getAllAppsEntryEvent().isPresent()) {
1211 getStatsLogManager().logger()
1212 .withContainerInfo(ContainerInfo.newBuilder()
1213 .setWorkspace(WorkspaceContainer.newBuilder()
1214 .setPageIndex(getWorkspace().getCurrentPage())).build())
1215 .log(getAllAppsEntryEvent().get());
1216 }
thiruram0eabc782021-04-02 14:30:10 -07001217 }
Sunny Goyal1eb11242022-09-09 17:14:45 -07001218 updateDisallowBack();
Sunny Goyaldedda052019-05-14 15:23:48 -07001219 }
1220
Thiru Ramasamy5fbac632022-01-28 15:05:36 -08001221 /**
1222 * Returns {@link EventEnum} that should be logged when Launcher enters into AllApps state.
1223 */
Thiru Ramasamy694407c2022-03-08 12:11:24 -08001224 protected Optional<EventEnum> getAllAppsEntryEvent() {
1225 return Optional.of(FeatureFlags.ENABLE_DEVICE_SEARCH.get()
Thiru Ramasamy5fbac632022-01-28 15:05:36 -08001226 ? LAUNCHER_ALLAPPS_ENTRY_WITH_DEVICE_SEARCH
Thiru Ramasamy694407c2022-03-08 12:11:24 -08001227 : LAUNCHER_ALLAPPS_ENTRY);
Thiru Ramasamy5fbac632022-01-28 15:05:36 -08001228 }
1229
Sunny Goyal35e7d382020-05-08 13:37:58 -07001230 @Override
Winson Chungef528762019-09-06 12:05:52 -07001231 public void onStateSetEnd(LauncherState state) {
Sunny Goyalfee1b252020-12-14 12:30:38 -08001232 super.onStateSetEnd(state);
Sihua Ma0593a0d2022-10-03 16:01:48 -07001233 getAppWidgetHolder().setStateIsNormal(state == LauncherState.NORMAL);
Sunny Goyal8f965462020-04-23 19:00:36 -07001234 getWorkspace().setClipChildren(!state.hasFlag(FLAG_MULTI_PAGE));
1235
Winson Chungef528762019-09-06 12:05:52 -07001236 finishAutoCancelActionMode();
Sunny Goyal210e1742019-10-17 12:05:38 -07001237 removeActivityFlags(ACTIVITY_STATE_TRANSITION_ACTIVE);
Sunny Goyal8f965462020-04-23 19:00:36 -07001238
1239 // dispatch window state changed
1240 getWindow().getDecorView().sendAccessibilityEvent(TYPE_WINDOW_STATE_CHANGED);
1241 AccessibilityManagerCompat.sendStateEventToTest(this, state.ordinal);
1242
1243 if (state == NORMAL) {
1244 // Re-enable any Un/InstallShortcutReceiver and now process any queued items
Sunny Goyal60e68c92020-08-12 13:59:27 -07001245 ItemInstallQueue.INSTANCE.get(this)
1246 .resumeModelPush(FLAG_DRAG_AND_DROP);
Sunny Goyal8f965462020-04-23 19:00:36 -07001247
1248 // Clear any rotation locks when going to normal state
1249 getRotationHelper().setCurrentStateRequest(REQUEST_NONE);
1250 }
thiruramc96873c2021-02-11 15:13:47 -08001251
thiruramea56f842021-06-02 16:02:37 -07001252 if (ALL_APPS.equals(mPrevLauncherState) && !ALL_APPS.equals(state)
thiruram0eabc782021-04-02 14:30:10 -07001253 // Making sure mAllAppsSessionLogId is not null to avoid double logging.
thiruramc96873c2021-02-11 15:13:47 -08001254 && mAllAppsSessionLogId != null) {
Samuel Fuface820f52021-06-18 17:23:48 -05001255 getAppsView().reset(false);
Thiru Ramasamy694407c2022-03-08 12:11:24 -08001256 getAllAppsExitEvent().ifPresent(getStatsLogManager().logger()::log);
thiruramc96873c2021-02-11 15:13:47 -08001257 mAllAppsSessionLogId = null;
1258 }
Winson Chungef528762019-09-06 12:05:52 -07001259 }
1260
Thiru Ramasamy694407c2022-03-08 12:11:24 -08001261 /**
1262 * Returns {@link EventEnum} that should be logged when Launcher exists from AllApps state.
1263 */
1264 protected Optional<EventEnum> getAllAppsExitEvent() {
1265 return Optional.of(LAUNCHER_ALLAPPS_EXIT);
1266 }
1267
Michael Jurkacd496d72013-04-11 11:32:45 -07001268 @Override
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001269 protected void onResume() {
Sunny Goyal67736672023-06-02 13:35:19 +00001270 TraceHelper.INSTANCE.beginSection(ON_RESUME_EVT);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001271 super.onResume();
Sunny Goyalfca6bc92017-09-28 16:28:34 -07001272
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001273 if (mDeferOverlayCallbacks) {
1274 scheduleDeferredCheck();
1275 } else {
1276 mOverlayManager.onActivityResumed(this);
Adam Cohen9211d422014-10-07 18:14:53 -07001277 }
Mario Bertschler0fc6f682017-02-17 12:16:13 -08001278
Jon Mirandaa82a7dc2022-05-10 11:48:32 -07001279 DragView.removeAllViews(this);
Sunny Goyal67736672023-06-02 13:35:19 +00001280 TraceHelper.INSTANCE.endSection();
Adam Cohen06dff352012-06-01 17:17:08 -07001281 }
1282
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001283 @Override
The Android Open Source Project7376fae2009-03-11 12:11:58 -07001284 protected void onPause() {
Winson Chung997a9232013-07-24 15:33:46 -07001285 // Ensure that items added to Launcher are queued until Launcher returns
Sunny Goyal60e68c92020-08-12 13:59:27 -07001286 ItemInstallQueue.INSTANCE.get(this).pauseModelPush(FLAG_ACTIVITY_PAUSED);
Winson Chung997a9232013-07-24 15:33:46 -07001287
The Android Open Source Project7376fae2009-03-11 12:11:58 -07001288 super.onPause();
Joe Onorato24b6fd82009-11-12 13:47:09 -08001289 mDragController.cancelDrag();
Sunny Goyal9b180102020-03-11 10:02:29 -07001290 mLastTouchUpTime = -1;
Hyunyoung Song497708c2019-05-01 16:16:53 -07001291 mDropTargetBar.animateToVisibility(false);
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001292
1293 if (!mDeferOverlayCallbacks) {
1294 mOverlayManager.onActivityPaused(this);
Adam Cohenbffe7452013-07-22 18:21:45 -07001295 }
Sihua Ma0593a0d2022-10-03 16:01:48 -07001296 mAppWidgetHolder.setActivityResumed(false);
Adam Cohenbffe7452013-07-22 18:21:45 -07001297 }
1298
Lucas Dupin87d75202021-07-28 10:24:54 -07001299 /**
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001300 * Restores the previous state, if it exists.
1301 *
1302 * @param savedState The previous state.
1303 */
1304 private void restoreState(Bundle savedState) {
1305 if (savedState == null) {
1306 return;
1307 }
1308
Sunny Goyal3e3f44c2017-10-23 17:14:52 -07001309 int stateOrdinal = savedState.getInt(RUNTIME_STATE, NORMAL.ordinal);
Sunny Goyalf9403d92017-10-18 10:55:56 -07001310 LauncherState[] stateValues = LauncherState.values();
1311 LauncherState state = stateValues[stateOrdinal];
Sunny Goyal6c0c61a2020-12-08 19:19:56 -08001312
1313 NonConfigInstance lastInstance = (NonConfigInstance) getLastNonConfigurationInstance();
1314 boolean forceRestore = lastInstance != null
1315 && (lastInstance.config.diff(mOldConfig) & CONFIG_UI_MODE) != 0;
1316 if (forceRestore || !state.shouldDisableRestore()) {
Sunny Goyal3e3f44c2017-10-23 17:14:52 -07001317 mStateManager.goToState(state, false /* animated */);
Joe Onorato3a8820b2009-11-10 15:06:42 -08001318 }
1319
Samuel Fufaca37b8a2019-08-19 17:04:36 -07001320 PendingRequestArgs requestArgs = savedState.getParcelable(
1321 RUNTIME_STATE_PENDING_REQUEST_ARGS);
Sunny Goyal2100c782016-08-22 16:00:03 -07001322 if (requestArgs != null) {
1323 setWaitingForResult(requestArgs);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001324 }
Sunny Goyaldedda052019-05-14 15:23:48 -07001325 mPendingActivityRequestCode = savedState.getInt(RUNTIME_STATE_PENDING_REQUEST_CODE);
Sunny Goyal2100c782016-08-22 16:00:03 -07001326
1327 mPendingActivityResult = savedState.getParcelable(RUNTIME_STATE_PENDING_ACTIVITY_RESULT);
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -07001328
1329 SparseArray<Parcelable> widgetsState =
1330 savedState.getSparseParcelableArray(RUNTIME_STATE_WIDGET_PANEL);
1331 if (widgetsState != null) {
1332 WidgetsFullSheet.show(this, false).restoreHierarchyState(widgetsState);
1333 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001334 }
1335
1336 /**
1337 * Finds all the views we need and configure them properly.
1338 */
Tony Wickham04fca162020-02-05 15:06:52 -08001339 protected void setupViews() {
Fengjiang Li5a36c172023-04-13 18:18:27 +00001340 mStartupLatencyLogger.logStart(LAUNCHER_LATENCY_STARTUP_VIEW_INFLATION);
Becky Qiu3aec5d52022-09-16 11:17:50 -07001341 inflateRootView(R.layout.launcher);
Fengjiang Li5a36c172023-04-13 18:18:27 +00001342 mStartupLatencyLogger.logEnd(LAUNCHER_LATENCY_STARTUP_VIEW_INFLATION);
1343
Sunny Goyalcc96aa12018-01-11 09:56:07 -08001344 mDragLayer = findViewById(R.id.drag_layer);
Sunny Goyal3333b0c2016-05-09 20:43:21 -07001345 mFocusHandler = mDragLayer.getFocusIndicatorHelper();
Sunny Goyal966d9012017-06-06 16:43:59 -07001346 mWorkspace = mDragLayer.findViewById(R.id.workspace);
Sunny Goyald0a6ae72016-06-16 12:29:03 -07001347 mWorkspace.initParentViews(mDragLayer);
Sreyas321bfae2020-02-21 17:53:02 -08001348 mOverviewPanel = findViewById(R.id.overview_panel);
Sunny Goyal7c7be8c2018-03-07 19:58:07 -08001349 mHotseat = findViewById(R.id.hotseat);
Adam Cohenb66675a2020-05-15 16:16:17 -07001350 mHotseat.setWorkspace(mWorkspace);
Craig Mautner360310b2012-10-26 15:13:08 -07001351
Winson Chung4c98d922011-05-31 16:50:48 -07001352 // Setup the drag layer
Sunny Goyal5d1873a2018-05-08 11:10:44 -07001353 mDragLayer.setup(mDragController, mWorkspace);
Winson Chung4c98d922011-05-31 16:50:48 -07001354
Hyunyoung Song645764e2016-06-06 14:19:02 -07001355 mWorkspace.setup(mDragController);
Winsonc7d2e832016-07-28 12:24:55 -07001356 // Until the workspace is bound, ensure that we keep the wallpaper offset locked to the
1357 // default state, otherwise we will update to the wrong offsets in RTL
1358 mWorkspace.lockWallpaperToDefaultPage();
Sunny Goyalbb030562021-07-19 16:28:39 -07001359 mWorkspace.bindAndInitFirstWorkspaceScreen();
Hyunyoung Song645764e2016-06-06 14:19:02 -07001360 mDragController.addDragListener(mWorkspace);
Winson Chung4c98d922011-05-31 16:50:48 -07001361
Tony Wickham34d2c912015-09-11 09:27:58 -07001362 // Get the search/delete/uninstall bar
Rajeev Kumar43c0f582017-06-23 15:34:55 -07001363 mDropTargetBar = mDragLayer.findViewById(R.id.drop_target_bar);
Patrick Dubroy3ec8bdd2010-08-06 16:01:33 -07001364
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -07001365 // Setup Apps
1366 mAppsView = findViewById(R.id.apps_view);
Fengjiang Lid080b982023-02-01 15:30:30 -08001367 mAppsView.setAllAppsTransitionController(mAllAppsController);
Craig Mautner360310b2012-10-26 15:13:08 -07001368
Govinda Wassermanc06e1512019-04-09 09:56:53 -04001369 // Setup Scrim
1370 mScrimView = findViewById(R.id.scrim_view);
1371
Winson Chung3d503fb2011-07-13 17:25:49 -07001372 // Setup the drag controller (drop targets have to be added in reverse order in priority)
Sunny Goyal47328fd2016-05-25 18:56:41 -07001373 mDropTargetBar.setup(mDragController);
Samuel Fufaacebd1f2021-05-06 10:02:03 -05001374 mAllAppsController.setupViews(mScrimView, mAppsView);
Federico Baron3f255eb2022-12-22 14:40:58 -08001375
1376 if (SHOW_DOT_PAGINATION.get()) {
1377 mWorkspace.getPageIndicator().setShouldAutoHide(true);
Sunny Goyal5cd1b192023-04-06 22:33:11 +00001378 mWorkspace.getPageIndicator().setPaintColor(
1379 Themes.getAttrBoolean(this, R.attr.isWorkspaceDarkText)
1380 ? Color.BLACK
1381 : Color.WHITE);
Federico Baron3f255eb2022-12-22 14:40:58 -08001382 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001383 }
1384
Federico Baron7539d762022-09-29 09:47:04 -07001385 @Override
1386 public View onCreateView(View parent, String name, Context context, AttributeSet attrs) {
Federico Baron3f255eb2022-12-22 14:40:58 -08001387 if (SHOW_DOT_PAGINATION.get() && WorkspacePageIndicator.class.getName().equals(name)) {
Federico Baron7539d762022-09-29 09:47:04 -07001388 return LayoutInflater.from(context).inflate(R.layout.page_indicator_dots,
1389 (ViewGroup) parent, false);
1390 }
1391 return super.onCreateView(parent, name, context, attrs);
1392 }
1393
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001394 /**
1395 * Creates a view representing a shortcut.
1396 *
1397 * @param info The data structure describing the shortcut.
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001398 */
Sunny Goyal95899162019-03-27 16:03:06 -07001399 View createShortcut(WorkspaceItemInfo info) {
Schneider Victor-tulias9f922d32022-04-27 16:39:29 -07001400 // This can be called before PagedView#pageScrollsInitialized returns true, so use the
1401 // first page, which we always assume to be present.
1402 return createShortcut((ViewGroup) mWorkspace.getChildAt(0), info);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001403 }
1404
1405 /**
1406 * Creates a view representing a shortcut inflated from the specified resource.
1407 *
Schneider Victor-tulias9f922d32022-04-27 16:39:29 -07001408 * @param parent The group the shortcut belongs to. This is not necessarily the group where
1409 * the shortcut should be added.
Samuel Fufaca37b8a2019-08-19 17:04:36 -07001410 * @param info The data structure describing the shortcut.
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001411 * @return A View inflated from layoutResId.
1412 */
Fengjiang Li080f9322023-07-12 13:33:54 -07001413 public View createShortcut(@Nullable ViewGroup parent, WorkspaceItemInfo info) {
1414 BubbleTextView favorite =
1415 (BubbleTextView) LayoutInflater.from(parent != null ? parent.getContext() : this)
1416 .inflate(R.layout.app_icon, parent, false);
Sunny Goyal95899162019-03-27 16:03:06 -07001417 favorite.applyFromWorkspaceItem(info);
Tracy Zhouba0b5952022-10-14 01:28:07 -07001418 favorite.setOnClickListener(getItemOnClickListener());
Sunny Goyaldcbcc862014-08-12 15:58:36 -07001419 favorite.setOnFocusChangeListener(mFocusHandler);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001420 return favorite;
1421 }
1422
1423 /**
Jon Mirandac476d6e2017-05-04 16:30:01 -07001424 * Add a shortcut to the workspace or to a Folder.
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001425 *
1426 * @param data The intent describing the shortcut.
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001427 */
sfufa@google.comd0a33232021-09-19 15:59:36 -07001428 protected void completeAddShortcut(Intent data, int container, int screenId, int cellX,
Sunny Goyalfb5096d2016-09-08 14:32:06 -07001429 int cellY, PendingRequestArgs args) {
Holly Sun35b99602023-06-28 15:14:02 -07001430 if (args.getRequestCode() != REQUEST_CREATE_SHORTCUT) {
Sunny Goyalfb5096d2016-09-08 14:32:06 -07001431 return;
1432 }
Adam Cohen558baaf2011-08-15 15:22:57 -07001433
Jon Mirandac476d6e2017-05-04 16:30:01 -07001434 int[] cellXY = mTmpAddItemCellCoordinates;
1435 CellLayout layout = getCellLayout(container, screenId);
1436
Sunny Goyaleaf7a952020-07-29 16:54:20 -07001437 WorkspaceItemInfo info = PinRequestHelper.createWorkspaceItemFromPinItemRequest(
Sunny Goyale7b00122019-10-02 16:13:34 -07001438 this, PinRequestHelper.getPinItemRequest(data), 0);
Sunny Goyal782f0c92017-01-19 10:27:54 -08001439 if (info == null) {
Sunny Goyal84b48d82023-03-29 16:52:27 -07001440 Log.e(TAG, "Unable to parse a valid shortcut result");
1441 return;
Sunny Goyal782f0c92017-01-19 10:27:54 -08001442 }
1443
Jon Mirandac476d6e2017-05-04 16:30:01 -07001444 if (container < 0) {
1445 // Adding a shortcut to the Workspace.
1446 final View view = createShortcut(info);
1447 boolean foundCellSpan = false;
1448 // First we check if we already know the exact location where we want to add this item.
1449 if (cellX >= 0 && cellY >= 0) {
1450 cellXY[0] = cellX;
1451 cellXY[1] = cellY;
1452 foundCellSpan = true;
Adam Cohen558baaf2011-08-15 15:22:57 -07001453
Hyunyoung Song1ae42422020-01-26 23:25:14 -08001454 DragObject dragObject = new DragObject(getApplicationContext());
1455 dragObject.dragInfo = info;
Jon Mirandac476d6e2017-05-04 16:30:01 -07001456 // If appropriate, either create a folder or add to an existing folder
1457 if (mWorkspace.createUserFolderIfNecessary(view, container, layout, cellXY, 0,
Hyunyoung Song1ae42422020-01-26 23:25:14 -08001458 true, dragObject)) {
Jon Mirandac476d6e2017-05-04 16:30:01 -07001459 return;
1460 }
Jon Mirandac476d6e2017-05-04 16:30:01 -07001461 if (mWorkspace.addToExistingFolderIfNecessary(view, layout, cellXY, 0, dragObject,
1462 true)) {
1463 return;
1464 }
1465 } else {
1466 foundCellSpan = layout.findCellForSpan(cellXY, 1, 1);
1467 }
1468
1469 if (!foundCellSpan) {
Yogisha Dixit104d09f2021-07-19 14:05:17 +01001470 mWorkspace.onNoCellFound(layout, info, /* logInstanceId= */ null);
Adam Cohen558baaf2011-08-15 15:22:57 -07001471 return;
1472 }
Jon Mirandac476d6e2017-05-04 16:30:01 -07001473
1474 getModelWriter().addItemToDatabase(info, container, screenId, cellXY[0], cellXY[1]);
1475 mWorkspace.addInScreen(view, info);
Michael Jurkad3ef3062010-11-23 16:23:58 -08001476 } else {
Jon Mirandac476d6e2017-05-04 16:30:01 -07001477 // Adding a shortcut to a Folder.
Sunny Goyale29897f52017-07-20 10:09:42 -07001478 FolderIcon folderIcon = findFolderIcon(container);
Jon Mirandac476d6e2017-05-04 16:30:01 -07001479 if (folderIcon != null) {
1480 FolderInfo folderInfo = (FolderInfo) folderIcon.getTag();
1481 folderInfo.add(info, args.rank, false);
1482 } else {
Sunny Goyale29897f52017-07-20 10:09:42 -07001483 Log.e(TAG, "Could not find folder with id " + container + " to add shortcut.");
Jon Mirandac476d6e2017-05-04 16:30:01 -07001484 }
Michael Jurka0280c3b2010-09-17 15:00:07 -07001485 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001486 }
1487
Tony Wickhamc7cbf252021-05-24 15:46:48 -07001488 @Override
1489 public @Nullable FolderIcon findFolderIcon(final int folderIconId) {
Sunny Goyal83fd25e2018-07-09 16:47:01 -07001490 return (FolderIcon) mWorkspace.getHomescreenIconByItemId(folderIconId);
Sunny Goyale29897f52017-07-20 10:09:42 -07001491 }
1492
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001493 /**
The Android Open Source Project7376fae2009-03-11 12:11:58 -07001494 * Add a widget to the workspace.
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001495 *
Romain Guy5bbc91b2010-08-18 11:38:46 -07001496 * @param appWidgetId The app widget id
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001497 */
Samuel Fufaca37b8a2019-08-19 17:04:36 -07001498 @Thunk
1499 void completeAddAppWidget(int appWidgetId, ItemInfo itemInfo,
Adam Cohen59400422014-03-05 18:07:04 -08001500 AppWidgetHostView hostView, LauncherAppWidgetProviderInfo appWidgetInfo) {
1501
Adam Cohened66b2b2012-01-23 17:28:51 -08001502 if (appWidgetInfo == null) {
fbaron30d9e3f2023-08-03 17:03:59 -07001503 appWidgetInfo = mAppWidgetManager.getLauncherAppWidgetInfo(appWidgetId,
1504 itemInfo.getTargetComponent());
Adam Cohened66b2b2012-01-23 17:28:51 -08001505 }
Romain Guycbb89e42009-06-08 15:52:54 -07001506
Yogisha Dixit0b15c7e2021-05-10 12:01:58 +01001507 if (hostView == null) {
1508 // Perform actual inflation because we're live
Sihua Ma0593a0d2022-10-03 16:01:48 -07001509 hostView = mAppWidgetHolder.createView(this, appWidgetId, appWidgetInfo);
Yogisha Dixit0b15c7e2021-05-10 12:01:58 +01001510 }
1511
Adam Cohen59400422014-03-05 18:07:04 -08001512 LauncherAppWidgetInfo launcherInfo;
Yogisha Dixit0b15c7e2021-05-10 12:01:58 +01001513 launcherInfo =
1514 new LauncherAppWidgetInfo(
1515 appWidgetId, appWidgetInfo.provider, appWidgetInfo, hostView);
Sunny Goyal2100c782016-08-22 16:00:03 -07001516 launcherInfo.spanX = itemInfo.spanX;
1517 launcherInfo.spanY = itemInfo.spanY;
1518 launcherInfo.minSpanX = itemInfo.minSpanX;
1519 launcherInfo.minSpanY = itemInfo.minSpanY;
Sunny Goyal952e63d2017-08-16 04:59:08 -07001520 launcherInfo.user = appWidgetInfo.getProfile();
Yogisha Dixit658c5da2021-05-24 23:23:15 +01001521 if (itemInfo instanceof PendingAddWidgetInfo) {
1522 launcherInfo.sourceContainer = ((PendingAddWidgetInfo) itemInfo).sourceContainer;
1523 } else if (itemInfo instanceof PendingRequestArgs) {
1524 launcherInfo.sourceContainer =
1525 ((PendingRequestArgs) itemInfo).getWidgetSourceContainer();
1526 }
Sunny Goyal669b71f2023-01-27 14:37:07 -08001527 CellPos presenterPos = getCellPosMapper().mapModelToPresenter(itemInfo);
Sunny Goyal43bf11d2017-02-02 13:52:53 -08001528 getModelWriter().addItemToDatabase(launcherInfo,
Sunny Goyal669b71f2023-01-27 14:37:07 -08001529 itemInfo.container, presenterPos.screenId, presenterPos.cellX, presenterPos.cellY);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001530
Sunny Goyal2100c782016-08-22 16:00:03 -07001531 hostView.setVisibility(View.VISIBLE);
Sunny Goyald5462aa2016-11-22 16:52:39 +05301532 prepareAppWidget(hostView, launcherInfo);
1533 mWorkspace.addInScreen(hostView, launcherInfo);
Pinyao Tingc9074272019-11-11 11:51:44 -08001534 announceForAccessibility(R.string.item_added_to_workspace);
Yogisha Dixit037a5362021-03-22 14:13:03 +00001535
1536 // Show the widget resize frame.
1537 if (hostView instanceof LauncherAppWidgetHostView) {
1538 final LauncherAppWidgetHostView launcherHostView = (LauncherAppWidgetHostView) hostView;
Sunny Goyal669b71f2023-01-27 14:37:07 -08001539 CellLayout cellLayout = getCellLayout(launcherInfo.container, presenterPos.screenId);
Yogisha Dixit037a5362021-03-22 14:13:03 +00001540 if (mStateManager.getState() == NORMAL) {
Yogisha Dixit7b1d25b2021-10-14 13:06:40 +01001541 AppWidgetResizeFrame.showForWidget(launcherHostView, cellLayout);
Yogisha Dixit037a5362021-03-22 14:13:03 +00001542 } else {
1543 mStateManager.addStateListener(new StateManager.StateListener<LauncherState>() {
1544 @Override
1545 public void onStateTransitionComplete(LauncherState finalState) {
Charlie Anderson438d4052023-04-25 14:38:57 -04001546 if ((mPrevLauncherState == SPRING_LOADED || mPrevLauncherState == EDIT_MODE)
1547 && finalState == NORMAL) {
Yogisha Dixit037a5362021-03-22 14:13:03 +00001548 AppWidgetResizeFrame.showForWidget(launcherHostView, cellLayout);
1549 mStateManager.removeStateListener(this);
1550 }
1551 }
1552 });
1553 }
1554 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001555 }
Romain Guycbb89e42009-06-08 15:52:54 -07001556
Sunny Goyald5462aa2016-11-22 16:52:39 +05301557 private void prepareAppWidget(AppWidgetHostView hostView, LauncherAppWidgetInfo item) {
Sunny Goyal87af0fd2016-05-16 14:56:02 -07001558 hostView.setTag(item);
1559 item.onBindAppWidget(this, hostView);
Sunny Goyal87af0fd2016-05-16 14:56:02 -07001560 hostView.setFocusable(true);
1561 hostView.setOnFocusChangeListener(mFocusHandler);
Sunny Goyal25c2e3e2015-10-28 23:28:21 -07001562 }
1563
Sunny Goyala992ac92023-01-10 17:50:32 -08001564 private final ScreenOnListener mScreenOnListener = this::onScreenOnChanged;
Adam Cohended9f8d2010-11-03 13:25:16 -07001565
Sunny Goyal9c2b9602020-01-07 13:07:55 -08001566 private void updateNotificationDots(Predicate<PackageUserKey> updatedDots) {
Tony Wickhamf34bee82018-12-03 18:11:39 -08001567 mWorkspace.updateNotificationDots(updatedDots);
1568 mAppsView.getAppsStore().updateNotificationDots(updatedDots);
Tony Wickham010d2552017-01-20 08:15:28 -08001569 }
1570
Adam Cohended9f8d2010-11-03 13:25:16 -07001571 @Override
1572 public void onAttachedToWindow() {
1573 super.onAttachedToWindow();
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001574 mOverlayManager.onAttachedToWindow();
Adam Cohended9f8d2010-11-03 13:25:16 -07001575 }
1576
1577 @Override
1578 public void onDetachedFromWindow() {
1579 super.onDetachedFromWindow();
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001580 mOverlayManager.onDetachedFromWindow();
1581 closeContextMenu();
Adam Cohended9f8d2010-11-03 13:25:16 -07001582 }
1583
Schneider Victor-tulias25ecae12020-09-14 14:07:38 -07001584 @Override
1585 public Object onRetainNonConfigurationInstance() {
Sunny Goyal6c0c61a2020-12-08 19:19:56 -08001586 NonConfigInstance instance = new NonConfigInstance();
1587 instance.config = new Configuration(mOldConfig);
Sunny Goyal6c0c61a2020-12-08 19:19:56 -08001588 return instance;
Schneider Victor-tulias25ecae12020-09-14 14:07:38 -07001589 }
1590
Sunny Goyalc4fa8c32017-11-07 12:23:58 -08001591 public AllAppsTransitionController getAllAppsController() {
1592 return mAllAppsController;
1593 }
1594
Sunny Goyal9d69c8d2018-03-19 13:41:31 -07001595 @Override
Winson Chunga6945242014-01-08 14:04:34 -08001596 public DragLayer getDragLayer() {
1597 return mDragLayer;
1598 }
1599
Brian Isganitis1664c9f2022-01-14 23:15:47 -05001600 @Override
1601 public ActivityAllAppsContainerView<Launcher> getAppsView() {
Winson Chungb745afb2015-03-02 11:51:23 -08001602 return mAppsView;
1603 }
1604
Shikha Malhotra0f2e1b62022-03-27 21:02:21 +00001605 public Workspace<?> getWorkspace() {
Winson Chunga6945242014-01-08 14:04:34 -08001606 return mWorkspace;
1607 }
1608
1609 public Hotseat getHotseat() {
1610 return mHotseat;
1611 }
1612
Sunny Goyal7c7be8c2018-03-07 19:58:07 -08001613 public <T extends View> T getOverviewPanel() {
Winson Chung8ae41982017-11-10 11:42:13 -08001614 return (T) mOverviewPanel;
Winson Chunga6945242014-01-08 14:04:34 -08001615 }
1616
Sunny Goyal47328fd2016-05-25 18:56:41 -07001617 public DropTargetBar getDropTargetBar() {
1618 return mDropTargetBar;
Tony Wickham34d2c912015-09-11 09:27:58 -07001619 }
1620
Tony Wickhamb4821882021-04-23 14:26:45 -07001621 @Override
Tony Wickham490a8ab2020-04-01 17:03:58 -07001622 public ScrimView getScrimView() {
1623 return mScrimView;
1624 }
1625
Sihua Ma0593a0d2022-10-03 16:01:48 -07001626 public LauncherWidgetHolder getAppWidgetHolder() {
1627 return mAppWidgetHolder;
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001628 }
Romain Guycbb89e42009-06-08 15:52:54 -07001629
Sihua Ma0593a0d2022-10-03 16:01:48 -07001630 protected LauncherWidgetHolder createAppWidgetHolder() {
Sihua Ma1db8bc22022-11-08 17:13:13 -08001631 return LauncherWidgetHolder.HolderFactory.newFactory(this).newInstance(
1632 this, appWidgetId -> getWorkspace().removeWidget(appWidgetId));
Cyrus Boadway0d309db2021-04-14 12:29:14 +00001633 }
1634
Winson Chunga9abd0e2010-10-27 17:18:37 -07001635 public LauncherModel getModel() {
1636 return mModel;
1637 }
1638
Sebastian Francoa64f3a62023-05-05 16:00:32 -06001639 /**
1640 * Returns the ModelWriter writer, make sure to call the function every time you want to use it.
1641 */
Sunny Goyal43bf11d2017-02-02 13:52:53 -08001642 public ModelWriter getModelWriter() {
1643 return mModelWriter;
1644 }
1645
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001646 @Override
Adam Cohen79d90c52016-04-22 13:29:20 -07001647 public SharedPreferences getSharedPrefs() {
Winson Chunga6945242014-01-08 14:04:34 -08001648 return mSharedPrefs;
1649 }
1650
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001651 @Override
1652 public SharedPreferences getDevicePrefs() {
Stefan Andonian146701c2022-11-10 23:07:40 +00001653 return LauncherPrefs.getDevicePrefs(this);
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001654 }
1655
Samuel Fufaca37b8a2019-08-19 17:04:36 -07001656 public int getOrientation() {
1657 return mOldConfig.orientation;
1658 }
Jon Miranda6bed3502017-09-19 14:43:17 -07001659
Becky Qiu4ed3dfc2022-10-19 16:58:22 -07001660 public BaseSearchConfig getSearchConfig() {
1661 return mBaseSearchConfig;
Luca Zuccarinibda972b2022-10-03 11:48:27 +00001662 }
1663
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001664 @Override
1665 protected void onNewIntent(Intent intent) {
Brian Isganitisfdd044e2023-03-02 19:45:23 +00001666 if (Utilities.isRunningInTestHarness()) {
vadimtbaf5fbb2019-12-16 18:56:09 -08001667 Log.d(TestProtocol.PERMANENT_DIAG_TAG, "Launcher.onNewIntent: " + intent);
1668 }
Sunny Goyal67736672023-06-02 13:35:19 +00001669 TraceHelper.INSTANCE.beginSection(ON_NEW_INTENT_EVT);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001670 super.onNewIntent(intent);
1671
Sunny Goyalf4aceab2017-12-06 16:16:31 -08001672 boolean alreadyOnHome = hasWindowFocus() && ((intent.getFlags() &
Winson15f8b172015-08-19 11:02:39 -07001673 Intent.FLAG_ACTIVITY_BROUGHT_TO_FRONT)
1674 != Intent.FLAG_ACTIVITY_BROUGHT_TO_FRONT);
Sunny Goyal85313732016-09-28 12:00:07 -07001675
1676 // Check this condition before handling isActionMain, as this will get reset.
Sunny Goyal3e3f44c2017-10-23 17:14:52 -07001677 boolean shouldMoveToDefaultScreen = alreadyOnHome && isInState(NORMAL)
Sunny Goyalf9403d92017-10-18 10:55:56 -07001678 && AbstractFloatingView.getTopOpenView(this) == null;
Winson15f8b172015-08-19 11:02:39 -07001679 boolean isActionMain = Intent.ACTION_MAIN.equals(intent.getAction());
Winson Chung1c2d5222021-06-08 11:50:13 -07001680 boolean internalStateHandled = ACTIVITY_TRACKER.handleNewIntent(this);
kholoud mohamedceec31b2022-02-03 15:44:25 +00001681
Winson15f8b172015-08-19 11:02:39 -07001682 if (isActionMain) {
Sunny Goyald3864fa2017-11-14 15:06:36 -08001683 if (!internalStateHandled) {
Sunny Goyald3864fa2017-11-14 15:06:36 -08001684 // In all these cases, only animate if we're already on home
Schneider Victor-tulias3913e292023-07-21 15:24:57 -07001685 AbstractFloatingView.closeAllOpenViewsExcept(
1686 this, isStarted(), AbstractFloatingView.TYPE_LISTENER);
Jon Mirandafeba90f2016-10-06 10:53:29 -07001687
Sunny Goyala2467272018-03-16 14:53:05 -07001688 if (!isInState(NORMAL)) {
1689 // Only change state, if not already the same. This prevents cancelling any
1690 // animations running as part of resume
Sunny Goyalfee1b252020-12-14 12:30:38 -08001691 mStateManager.goToState(NORMAL, mStateManager.shouldAnimateStateChange());
Sunny Goyala2467272018-03-16 14:53:05 -07001692 }
Sunny Goyald3864fa2017-11-14 15:06:36 -08001693
1694 // Reset the apps view
Sunny Goyal5d1873a2018-05-08 11:10:44 -07001695 if (!alreadyOnHome) {
Sunny Goyal7185dd62018-03-14 17:51:49 -07001696 mAppsView.reset(isStarted() /* animate */);
Sunny Goyald3864fa2017-11-14 15:06:36 -08001697 }
1698
Sunny Goyalaad33592018-08-07 17:20:35 -07001699 if (shouldMoveToDefaultScreen && !mWorkspace.isHandlingTouch()) {
Sunny Goyald3864fa2017-11-14 15:06:36 -08001700 mWorkspace.post(mWorkspace::moveToDefaultScreen);
1701 }
1702 }
Adam Cohen6fecd412013-10-02 17:41:50 -07001703
Adam Cohen9211d422014-10-07 18:14:53 -07001704 if (mLauncherCallbacks != null) {
Sunny Goyal85462132018-04-24 11:39:37 -07001705 mLauncherCallbacks.onHomeIntent(internalStateHandled);
Adam Cohen9211d422014-10-07 18:14:53 -07001706 }
Vinit Nayakf6c2e872023-07-07 13:37:24 -07001707 if (FeatureFlags.ENABLE_SPLIT_FROM_WORKSPACE_TO_WORKSPACE.get()) {
1708 handleSplitAnimationGoingToHome();
1709 }
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001710 mOverlayManager.hideOverlay(isStarted() && !isForceInvisible());
Sunny Goyal30ac97d2020-06-24 23:47:46 -07001711 handleGestureContract(intent);
Sunny Goyal512a2c12020-04-08 12:52:45 -07001712 } else if (Intent.ACTION_ALL_APPS.equals(intent.getAction())) {
Winson Chungdd15ace2020-08-04 15:52:01 -07001713 showAllAppsFromIntent(alreadyOnHome);
Tracy Zhoucb93ec52023-03-31 22:51:17 -07001714 } else if (INTENT_ACTION_ALL_APPS_TOGGLE.equals(intent.getAction())) {
1715 toggleAllAppsFromIntent(alreadyOnHome);
kholoud mohamedceec31b2022-02-03 15:44:25 +00001716 } else if (Intent.ACTION_SHOW_WORK_APPS.equals(intent.getAction())) {
1717 showAllAppsWorkTabFromIntent(alreadyOnHome);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001718 }
Winson15f8b172015-08-19 11:02:39 -07001719
Sunny Goyal67736672023-06-02 13:35:19 +00001720 TraceHelper.INSTANCE.endSection();
Adam Coppa120b8e2013-11-12 16:26:04 +00001721 }
1722
Vinit Nayakf6c2e872023-07-07 13:37:24 -07001723 /** Handle animating away split placeholder view when user taps on home button */
1724 protected void handleSplitAnimationGoingToHome() {
1725 // Overridden
1726 }
1727
Tracy Zhoucb93ec52023-03-31 22:51:17 -07001728 protected void toggleAllAppsFromIntent(boolean alreadyOnHome) {
1729 if (getStateManager().isInStableState(ALL_APPS)) {
1730 getStateManager().goToState(NORMAL, alreadyOnHome);
1731 } else {
Holly Sund9d70ea2023-09-05 13:14:22 -07001732 AbstractFloatingView.closeAllOpenViews(this);
1733 getStateManager().goToState(ALL_APPS, true /* animated */,
1734 new AnimationSuccessListener() {
1735 @Override
1736 public void onAnimationSuccess(Animator animator) {
1737 if (mAppsView.getSearchUiManager().getEditText() != null) {
1738 mAppsView.getSearchUiManager().getEditText().requestFocus();
1739 }
1740 }
1741 });
Tracy Zhoucb93ec52023-03-31 22:51:17 -07001742 }
1743 }
1744
Winson Chungdd15ace2020-08-04 15:52:01 -07001745 protected void showAllAppsFromIntent(boolean alreadyOnHome) {
1746 AbstractFloatingView.closeAllOpenViews(this);
1747 getStateManager().goToState(ALL_APPS, alreadyOnHome);
1748 }
1749
kholoud mohamedceec31b2022-02-03 15:44:25 +00001750 private void showAllAppsWorkTabFromIntent(boolean alreadyOnHome) {
1751 showAllAppsFromIntent(alreadyOnHome);
Sunny Goyal34c499d2023-01-24 12:43:18 -08001752 mAppsView.switchToTab(ActivityAllAppsContainerView.AdapterHolder.WORK);
kholoud mohamedceec31b2022-02-03 15:44:25 +00001753 }
1754
Sunny Goyaldeb91c42020-03-24 02:17:59 -07001755 /**
Sunny Goyal30ac97d2020-06-24 23:47:46 -07001756 * Handles gesture nav contract
1757 */
1758 protected void handleGestureContract(Intent intent) {
1759 GestureNavContract gnc = GestureNavContract.fromIntent(intent);
1760 if (gnc != null) {
1761 AbstractFloatingView.closeOpenViews(this, false, TYPE_ICON_SURFACE);
1762 FloatingSurfaceView.show(this, gnc);
1763 }
1764 }
1765
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001766 @Override
Adam Cohen1462de32012-07-24 22:34:36 -07001767 public void onRestoreInstanceState(Bundle state) {
1768 super.onRestoreInstanceState(state);
Andras Kloczl55edfe52021-05-14 12:21:30 +02001769 if (mSynchronouslyBoundPages != null) {
Sunny Goyal12e3f1f2021-07-15 14:31:58 -07001770 mSynchronouslyBoundPages.forEach(screenId -> {
1771 int pageIndex = mWorkspace.getPageIndexForScreenId(screenId);
1772 if (pageIndex != PagedView.INVALID_PAGE) {
1773 mWorkspace.restoreInstanceStateForChild(pageIndex);
1774 }
1775 });
Andras Kloczl55edfe52021-05-14 12:21:30 +02001776 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001777 }
1778
1779 @Override
1780 protected void onSaveInstanceState(Bundle outState) {
Sunny Goyal12e3f1f2021-07-15 14:31:58 -07001781 outState.putIntArray(RUNTIME_STATE_CURRENT_SCREEN_IDS,
1782 mWorkspace.getCurrentPageScreenIds().getArray().toArray());
Sunny Goyalea609262017-10-25 15:47:38 -07001783 outState.putInt(RUNTIME_STATE, mStateManager.getState().ordinal);
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -07001784
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -07001785 AbstractFloatingView widgets = AbstractFloatingView
1786 .getOpenView(this, AbstractFloatingView.TYPE_WIDGETS_FULL_SHEET);
1787 if (widgets != null) {
1788 SparseArray<Parcelable> widgetsState = new SparseArray<>();
1789 widgets.saveHierarchyState(widgetsState);
1790 outState.putSparseParcelableArray(RUNTIME_STATE_WIDGET_PANEL, widgetsState);
1791 } else {
1792 outState.remove(RUNTIME_STATE_WIDGET_PANEL);
1793 }
1794
Federico Baron8bf1bca2022-09-27 16:19:11 -07001795 // We close any open folders and shortcut containers that are not safe for rebind,
1796 // and we need to make sure this state is reflected.
1797 AbstractFloatingView.closeAllOpenViewsExcept(
1798 this, isStarted() && !isForceInvisible(), TYPE_REBIND_SAFE);
Pinyao Tinga74b63a2019-07-17 23:26:06 -07001799 finishAutoCancelActionMode();
Tony Wickham49c8d292016-07-01 11:44:34 -07001800
Sunny Goyal2100c782016-08-22 16:00:03 -07001801 if (mPendingRequestArgs != null) {
1802 outState.putParcelable(RUNTIME_STATE_PENDING_REQUEST_ARGS, mPendingRequestArgs);
1803 }
Sunny Goyaldedda052019-05-14 15:23:48 -07001804 outState.putInt(RUNTIME_STATE_PENDING_REQUEST_CODE, mPendingActivityRequestCode);
1805
Sunny Goyal2100c782016-08-22 16:00:03 -07001806 if (mPendingActivityResult != null) {
1807 outState.putParcelable(RUNTIME_STATE_PENDING_ACTIVITY_RESULT, mPendingActivityResult);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001808 }
1809
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -07001810 super.onSaveInstanceState(outState);
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001811 mOverlayManager.onActivitySaveInstanceState(this, outState);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001812 }
1813
1814 @Override
1815 public void onDestroy() {
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001816 super.onDestroy();
Sunny Goyale84c5b82019-09-26 17:05:31 -07001817 ACTIVITY_TRACKER.onActivityDestroyed(this);
Romain Guycbb89e42009-06-08 15:52:54 -07001818
Sunny Goyala992ac92023-01-10 17:50:32 -08001819 ScreenOnTracker.INSTANCE.get(this).removeListener(mScreenOnListener);
Sunny Goyalaaf7d1d2016-05-17 13:38:54 -07001820 mWorkspace.removeFolderListeners();
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001821 PluginManagerWrapper.INSTANCE.get(this).removePluginListener(this);
Winson Chunge7a03942011-08-05 15:05:12 -07001822
Sunny Goyala7a5bf32020-01-05 15:35:29 +05301823 mModel.removeCallbacks(this);
Sunny Goyal623eddd2018-03-02 12:24:41 -08001824 mRotationHelper.destroy();
Sunny Goyal745bad92016-05-02 10:54:12 -07001825
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001826 try {
Sihua Ma0593a0d2022-10-03 16:01:48 -07001827 mAppWidgetHolder.stopListening();
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001828 } catch (NullPointerException ex) {
Joe Onoratoa30ce8e2009-11-11 08:16:49 -08001829 Log.w(TAG, "problem while stopping AppWidgetHost during Launcher destruction", ex);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001830 }
Sihua Maaa2b8722022-10-25 15:17:58 -07001831 mAppWidgetHolder.destroy();
Patrick Dubroy2313eff2011-01-11 20:01:31 -08001832
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001833 TextKeyListener.getInstance().release();
Tony2917a8b2017-07-31 23:29:42 -07001834 clearPendingBinds();
Hyunyoung Song31971a32019-01-27 12:31:12 -08001835 LauncherAppState.getIDP(this).removeOnChangeListener(this);
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001836
1837 mOverlayManager.onActivityDestroyed(this);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001838 }
1839
Sunny Goyalae502842016-06-17 08:43:56 -07001840 public LauncherAccessibilityDelegate getAccessibilityDelegate() {
1841 return mAccessibilityDelegate;
1842 }
1843
Adam Cohena9cf38f2011-05-02 15:36:58 -07001844 public DragController getDragController() {
1845 return mDragController;
1846 }
1847
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001848 @Override
Andrew Cole44898c32023-04-05 13:49:32 -07001849 public DropTargetHandler getDropTargetHandler() {
1850 return new DropTargetHandler(this);
1851 }
1852
1853 @Override
Sunny Goyal0eca4e22016-07-20 11:43:06 -07001854 public void startActivityForResult(Intent intent, int requestCode, Bundle options) {
Sunny Goyaldedda052019-05-14 15:23:48 -07001855 if (requestCode != -1) {
1856 mPendingActivityRequestCode = requestCode;
1857 }
Sunny Goyal210e1742019-10-17 12:05:38 -07001858 super.startActivityForResult(intent, requestCode, options);
Adam Cohen173f7112015-03-27 15:14:00 -07001859 }
1860
1861 @Override
Sunny Goyaldedda052019-05-14 15:23:48 -07001862 public void startIntentSenderForResult(IntentSender intent, int requestCode,
Adam Cohen173f7112015-03-27 15:14:00 -07001863 Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags, Bundle options) {
Sunny Goyaldedda052019-05-14 15:23:48 -07001864 if (requestCode != -1) {
1865 mPendingActivityRequestCode = requestCode;
1866 }
Sunny Goyal210e1742019-10-17 12:05:38 -07001867 try {
1868 super.startIntentSenderForResult(intent, requestCode,
1869 fillInIntent, flagsMask, flagsValues, extraFlags, options);
1870 } catch (IntentSender.SendIntentException e) {
1871 throw new ActivityNotFoundException();
Adam Cohen173f7112015-03-27 15:14:00 -07001872 }
1873 }
1874
Winson Chung70d72102011-08-12 11:24:35 -07001875 /**
1876 * Indicates that we want global search for this activity by setting the globalSearch
1877 * argument for {@link #startSearch} to true.
1878 */
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001879 @Override
Romain Guycbb89e42009-06-08 15:52:54 -07001880 public void startSearch(String initialQuery, boolean selectInitialQuery,
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001881 Bundle appSearchData, boolean globalSearch) {
1882 if (appSearchData == null) {
1883 appSearchData = new Bundle();
Bjorn Bringert32b12d22013-06-06 13:00:41 +01001884 appSearchData.putString("source", "launcher-search");
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001885 }
Sunny Goyalda4fe1a2016-05-26 16:05:17 -07001886
Sunny Goyal6f28e712016-09-13 14:19:29 -07001887 if (mLauncherCallbacks == null ||
1888 !mLauncherCallbacks.startSearch(initialQuery, selectInitialQuery, appSearchData)) {
1889 // Starting search from the callbacks failed. Start the default global search.
Sunny Goyalf4aceab2017-12-06 16:16:31 -08001890 super.startSearch(initialQuery, selectInitialQuery, appSearchData, true);
Ian Parkinson047036e2014-09-01 15:40:53 +01001891 }
Winson Chungcd99cd32015-04-29 11:03:24 -07001892
1893 // We need to show the workspace after starting the search
Sunny Goyal3e3f44c2017-10-23 17:14:52 -07001894 mStateManager.goToState(NORMAL);
Bjorn Bringertc459e522013-06-07 19:36:01 +01001895 }
1896
Joe Onorato9c1289c2009-08-17 11:03:03 -04001897 public boolean isWorkspaceLocked() {
Sunny Goyal2100c782016-08-22 16:00:03 -07001898 return mWorkspaceLoading || mPendingRequestArgs != null;
Joe Onorato9c1289c2009-08-17 11:03:03 -04001899 }
1900
Adam Cohen517a7f52014-03-01 12:12:59 -08001901 public boolean isWorkspaceLoading() {
1902 return mWorkspaceLoading;
1903 }
1904
Brian Isganitis099945b2022-01-31 18:15:00 -05001905 @Override
1906 public boolean isBindingItems() {
1907 return mWorkspaceLoading;
1908 }
1909
Anjali Koppalff7ceff2014-05-01 18:26:37 -07001910 private void setWorkspaceLoading(boolean value) {
Anjali Koppalff7ceff2014-05-01 18:26:37 -07001911 mWorkspaceLoading = value;
Anjali Koppalff7ceff2014-05-01 18:26:37 -07001912 }
1913
Sunny Goyal04a324a2017-01-20 21:08:59 -08001914 public void setWaitingForResult(PendingRequestArgs args) {
Sunny Goyal2100c782016-08-22 16:00:03 -07001915 mPendingRequestArgs = args;
Adam Cohen9211d422014-10-07 18:14:53 -07001916 }
Anjali Koppalff7ceff2014-05-01 18:26:37 -07001917
Sunny Goyal2100c782016-08-22 16:00:03 -07001918 void addAppWidgetFromDropImpl(int appWidgetId, ItemInfo info, AppWidgetHostView boundWidget,
Sunny Goyal04a324a2017-01-20 21:08:59 -08001919 WidgetAddFlowHandler addFlowHandler) {
Tony Wickhama0628cc2015-10-14 15:23:04 -07001920 if (LOGD) {
1921 Log.d(TAG, "Adding widget from drop");
1922 }
Sunny Goyal04a324a2017-01-20 21:08:59 -08001923 addAppWidgetImpl(appWidgetId, info, boundWidget, addFlowHandler, 0);
Adam Cohenad4e15c2013-10-17 16:21:35 -07001924 }
1925
Sunny Goyal2100c782016-08-22 16:00:03 -07001926 void addAppWidgetImpl(int appWidgetId, ItemInfo info,
Sunny Goyal04a324a2017-01-20 21:08:59 -08001927 AppWidgetHostView boundWidget, WidgetAddFlowHandler addFlowHandler, int delay) {
Samuel Fufaca37b8a2019-08-19 17:04:36 -07001928 if (!addFlowHandler.startConfigActivity(this, appWidgetId, info,
1929 REQUEST_CREATE_APPWIDGET)) {
Sunny Goyal04a324a2017-01-20 21:08:59 -08001930 // If the configuration flow was not started, add the widget
Michael Jurkaaf442092010-06-10 17:01:57 -07001931
Charlie Anderson438d4052023-04-25 14:38:57 -04001932 // Exit spring loaded mode if necessary after adding the widget
1933 Runnable onComplete = MULTI_SELECT_EDIT_MODE.get() ? null
1934 : () -> mStateManager.goToState(NORMAL, SPRING_LOADED_EXIT_DELAY);
Samuel Fufaca37b8a2019-08-19 17:04:36 -07001935 completeAddAppWidget(appWidgetId, info, boundWidget,
1936 addFlowHandler.getProviderInfo(this));
Sunny Goyal6e379fc2020-03-19 16:08:14 -07001937 mWorkspace.removeExtraEmptyScreenDelayed(delay, false, onComplete);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001938 }
1939 }
Romain Guycbb89e42009-06-08 15:52:54 -07001940
Sunny Goyalefb7e842018-10-04 15:11:00 -07001941 public void addPendingItem(PendingAddItemInfo info, int container, int screenId,
Sunny Goyal71b5c0b2015-01-08 16:59:04 -08001942 int[] cell, int spanX, int spanY) {
Sunny Goyal669b71f2023-01-27 14:37:07 -08001943 if (cell == null) {
1944 CellPos modelPos = getCellPosMapper().mapPresenterToModel(0, 0, screenId, container);
1945 info.screenId = modelPos.screenId;
1946 } else {
1947 CellPos modelPos = getCellPosMapper().mapPresenterToModel(
1948 cell[0], cell[1], screenId, container);
1949 info.screenId = modelPos.screenId;
1950 info.cellX = modelPos.cellX;
1951 info.cellY = modelPos.cellY;
Sunny Goyal2100c782016-08-22 16:00:03 -07001952 }
Sunny Goyal669b71f2023-01-27 14:37:07 -08001953 info.container = container;
Sunny Goyal2100c782016-08-22 16:00:03 -07001954 info.spanX = spanX;
1955 info.spanY = spanY;
1956
Holly Sun35b99602023-06-28 15:14:02 -07001957 if (info instanceof PendingAddWidgetInfo) {
1958 addAppWidgetFromDrop((PendingAddWidgetInfo) info);
1959 } else { // info can only be PendingAddShortcutInfo
1960 processShortcutFromDrop((PendingAddShortcutInfo) info);
Samuel Fufaca37b8a2019-08-19 17:04:36 -07001961 }
Sunny Goyal71b5c0b2015-01-08 16:59:04 -08001962 }
1963
Adam Cohenfbba09b2011-07-18 21:43:05 -07001964 /**
1965 * Process a shortcut drop.
Adam Cohenfbba09b2011-07-18 21:43:05 -07001966 */
Sunny Goyal782f0c92017-01-19 10:27:54 -08001967 private void processShortcutFromDrop(PendingAddShortcutInfo info) {
Sunny Goyalfb5096d2016-09-08 14:32:06 -07001968 Intent intent = new Intent(Intent.ACTION_CREATE_SHORTCUT).setComponent(info.componentName);
1969 setWaitingForResult(PendingRequestArgs.forIntent(REQUEST_CREATE_SHORTCUT, intent, info));
vadimtcf275c12020-04-15 12:43:01 -07001970 TestLogging.recordEvent(TestProtocol.SEQUENCE_MAIN, "start: processShortcutFromDrop");
Sunny Goyal239d6e92023-02-07 13:40:11 -08001971 if (!info.getActivityInfo(this).startConfigActivity(this, REQUEST_CREATE_SHORTCUT)) {
Sunny Goyal782f0c92017-01-19 10:27:54 -08001972 handleActivityResult(REQUEST_CREATE_SHORTCUT, RESULT_CANCELED, null);
1973 }
Michael Jurka0280c3b2010-09-17 15:00:07 -07001974 }
1975
Adam Cohenfbba09b2011-07-18 21:43:05 -07001976 /**
1977 * Process a widget drop.
Adam Cohenfbba09b2011-07-18 21:43:05 -07001978 */
Sunny Goyal2100c782016-08-22 16:00:03 -07001979 private void addAppWidgetFromDrop(PendingAddWidgetInfo info) {
Adam Cohened66b2b2012-01-23 17:28:51 -08001980 AppWidgetHostView hostView = info.boundWidget;
Sunny Goyal952e63d2017-08-16 04:59:08 -07001981 final int appWidgetId;
Sunny Goyal8a0dc382017-01-25 11:30:06 -08001982 WidgetAddFlowHandler addFlowHandler = info.getHandler();
Adam Cohened66b2b2012-01-23 17:28:51 -08001983 if (hostView != null) {
Tony Wickhama0628cc2015-10-14 15:23:04 -07001984 // In the case where we've prebound the widget, we remove it from the DragLayer
1985 if (LOGD) {
1986 Log.d(TAG, "Removing widget view from drag layer and setting boundWidget to null");
1987 }
1988 getDragLayer().removeView(hostView);
1989
Adam Cohened66b2b2012-01-23 17:28:51 -08001990 appWidgetId = hostView.getAppWidgetId();
Sunny Goyal04a324a2017-01-20 21:08:59 -08001991 addAppWidgetFromDropImpl(appWidgetId, info, hostView, addFlowHandler);
Sunny Goyal5b9ebca2015-06-01 18:37:32 -07001992
1993 // Clear the boundWidget so that it doesn't get destroyed.
1994 info.boundWidget = null;
Adam Cohened66b2b2012-01-23 17:28:51 -08001995 } else {
Adam Cohen9d5b7d82012-05-09 18:00:44 -07001996 // In this case, we either need to start an activity to get permission to bind
1997 // the widget, or we need to start an activity to configure the widget, or both.
Pinyao Tingc7a6c292019-08-26 14:36:02 -07001998 if (info.itemType == LauncherSettings.Favorites.ITEM_TYPE_CUSTOM_APPWIDGET) {
fbaron30d9e3f2023-08-03 17:03:59 -07001999 appWidgetId = CustomWidgetManager.INSTANCE.get(this)
2000 .allocateCustomAppWidgetId(info.componentName);
Sunny Goyal952e63d2017-08-16 04:59:08 -07002001 } else {
Sihua Ma0593a0d2022-10-03 16:01:48 -07002002 appWidgetId = getAppWidgetHolder().allocateAppWidgetId();
Sunny Goyal952e63d2017-08-16 04:59:08 -07002003 }
Adam Cohendd70d662012-10-04 16:53:44 -07002004 Bundle options = info.bindOptions;
2005
Sunny Goyalffe83f12014-08-14 17:39:34 -07002006 boolean success = mAppWidgetManager.bindAppWidgetIdIfAllowed(
2007 appWidgetId, info.info, options);
Adam Cohendd70d662012-10-04 16:53:44 -07002008 if (success) {
Sunny Goyal04a324a2017-01-20 21:08:59 -08002009 addAppWidgetFromDropImpl(appWidgetId, info, null, addFlowHandler);
Michael Jurka8b805b12012-04-18 14:23:14 -07002010 } else {
Sunny Goyal04a324a2017-01-20 21:08:59 -08002011 addFlowHandler.startBindFlow(this, appWidgetId, info, REQUEST_BIND_APPWIDGET);
Michael Jurka8b805b12012-04-18 14:23:14 -07002012 }
Adam Cohened66b2b2012-01-23 17:28:51 -08002013 }
Adam Cohenfbba09b2011-07-18 21:43:05 -07002014 }
2015
Samuel Fufa746d4202020-02-02 18:55:44 -08002016 /**
2017 * Creates and adds new folder to CellLayout
2018 */
Samuel Fufa28c3e452020-02-08 16:07:16 -08002019 public FolderIcon addFolder(CellLayout layout, int container, final int screenId, int cellX,
2020 int cellY) {
Michael Jurkac9d95c52011-08-29 14:03:34 -07002021 final FolderInfo folderInfo = new FolderInfo();
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002022
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002023 // Update the model
Sunny Goyal43bf11d2017-02-02 13:52:53 -08002024 getModelWriter().addItemToDatabase(folderInfo, container, screenId, cellX, cellY);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002025
2026 // Create the view
Samuel Fufa746d4202020-02-02 18:55:44 -08002027 FolderIcon newFolder = FolderIcon.inflateFolderAndIcon(R.layout.folder_icon, this, layout,
2028 folderInfo);
Sunny Goyald5462aa2016-11-22 16:52:39 +05302029 mWorkspace.addInScreen(newFolder, folderInfo);
Winson Chung5f8afe62013-08-12 16:19:28 -07002030 // Force measure the new folder icon
2031 CellLayout parent = mWorkspace.getParentCellLayoutForView(newFolder);
2032 parent.getShortcutsAndWidgets().measureChild(newFolder);
Adam Cohendf035382011-04-11 17:22:04 -07002033 return newFolder;
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002034 }
Romain Guycbb89e42009-06-08 15:52:54 -07002035
Tony Wickham1906cc32021-02-11 11:55:24 -08002036 @Override
2037 public Rect getFolderBoundingBox() {
2038 // We need to bound the folder to the currently visible workspace area
Andras Kloczl3a4ba0b2021-03-29 18:47:14 +02002039 return getWorkspace().getPageAreaRelativeToDragLayer();
Tony Wickham1906cc32021-02-11 11:55:24 -08002040 }
2041
2042 @Override
2043 public void updateOpenFolderPosition(int[] inOutPosition, Rect bounds, int width, int height) {
2044 int left = inOutPosition[0];
2045 int top = inOutPosition[1];
2046 DeviceProfile grid = getDeviceProfile();
2047 int distFromEdgeOfScreen = getWorkspace().getPaddingLeft();
2048 if (grid.isPhone && (grid.availableWidthPx - width) < 4 * distFromEdgeOfScreen) {
2049 // Center the folder if it is very close to being centered anyway, by virtue of
2050 // filling the majority of the viewport. ie. remove it from the uncanny valley
2051 // of centeredness.
2052 left = (grid.availableWidthPx - width) / 2;
2053 } else if (width >= bounds.width()) {
2054 // If the folder doesn't fit within the bounds, center it about the desired bounds
2055 left = bounds.left + (bounds.width() - width) / 2;
2056 }
2057 if (height >= bounds.height()) {
2058 // Folder height is greater than page height, center on page
2059 top = bounds.top + (bounds.height() - height) / 2;
2060 } else {
2061 // Folder height is less than page height, so bound it to the absolute open folder
2062 // bounds if necessary
2063 Rect folderBounds = grid.getAbsoluteOpenFolderBounds();
2064 left = Math.max(folderBounds.left, Math.min(left, folderBounds.right - width));
2065 top = Math.max(folderBounds.top, Math.min(top, folderBounds.bottom - height));
2066 }
2067 inOutPosition[0] = left;
2068 inOutPosition[1] = top;
2069 }
2070
Winsonc0b52fe2015-09-09 16:38:15 -07002071 /**
Winsonfa56b3f2015-09-14 12:01:13 -07002072 * Unbinds the view for the specified item, and removes the item and all its children.
2073 *
2074 * @param v the view being removed.
Winsonfa56b3f2015-09-14 12:01:13 -07002075 * @param itemInfo the {@link ItemInfo} for this view.
2076 * @param deleteFromDb whether or not to delete this item from the db.
Winsonc0b52fe2015-09-09 16:38:15 -07002077 */
Tony Wickhambfbf7f92016-05-19 11:19:39 -07002078 public boolean removeItem(View v, final ItemInfo itemInfo, boolean deleteFromDb) {
Pinyao Ting6a41d562022-05-10 23:47:36 +00002079 return removeItem(v, itemInfo, deleteFromDb, null);
2080 }
2081
2082 /**
2083 * Unbinds the view for the specified item, and removes the item and all its children.
2084 *
2085 * @param v the view being removed.
2086 * @param itemInfo the {@link ItemInfo} for this view.
2087 * @param deleteFromDb whether or not to delete this item from the db.
2088 * @param reason the resaon for removal.
2089 */
2090 public boolean removeItem(View v, final ItemInfo itemInfo, boolean deleteFromDb,
2091 @Nullable final String reason) {
Sunny Goyal95899162019-03-27 16:03:06 -07002092 if (itemInfo instanceof WorkspaceItemInfo) {
Winsonfa56b3f2015-09-14 12:01:13 -07002093 // Remove the shortcut from the folder before removing it from launcher
Sunny Goyal44c06432016-04-02 10:56:02 -07002094 View folderIcon = mWorkspace.getHomescreenIconByItemId(itemInfo.container);
2095 if (folderIcon instanceof FolderIcon) {
Sunny Goyal95899162019-03-27 16:03:06 -07002096 ((FolderInfo) folderIcon.getTag()).remove((WorkspaceItemInfo) itemInfo, true);
Winsonfa56b3f2015-09-14 12:01:13 -07002097 } else {
2098 mWorkspace.removeWorkspaceItem(v);
2099 }
Winsonc0b52fe2015-09-09 16:38:15 -07002100 if (deleteFromDb) {
Pinyao Ting6a41d562022-05-10 23:47:36 +00002101 getModelWriter().deleteItemFromDatabase(itemInfo, reason);
Winsonc0b52fe2015-09-09 16:38:15 -07002102 }
2103 } else if (itemInfo instanceof FolderInfo) {
2104 final FolderInfo folderInfo = (FolderInfo) itemInfo;
Sunny Goyalaaf7d1d2016-05-17 13:38:54 -07002105 if (v instanceof FolderIcon) {
2106 ((FolderIcon) v).removeListeners();
2107 }
Winsonc0b52fe2015-09-09 16:38:15 -07002108 mWorkspace.removeWorkspaceItem(v);
2109 if (deleteFromDb) {
Sunny Goyal43bf11d2017-02-02 13:52:53 -08002110 getModelWriter().deleteFolderAndContentsFromDatabase(folderInfo);
Winsonc0b52fe2015-09-09 16:38:15 -07002111 }
2112 } else if (itemInfo instanceof LauncherAppWidgetInfo) {
2113 final LauncherAppWidgetInfo widgetInfo = (LauncherAppWidgetInfo) itemInfo;
Winson44818e02015-10-02 11:25:46 -07002114 mWorkspace.removeWorkspaceItem(v);
Winsonc0b52fe2015-09-09 16:38:15 -07002115 if (deleteFromDb) {
Sihua Ma0593a0d2022-10-03 16:01:48 -07002116 getModelWriter().deleteWidgetInfo(widgetInfo, getAppWidgetHolder(), reason);
Winsonc0b52fe2015-09-09 16:38:15 -07002117 }
2118 } else {
2119 return false;
2120 }
2121 return true;
2122 }
2123
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002124 @Override
2125 public boolean dispatchKeyEvent(KeyEvent event) {
vadimt6b534ee2021-08-06 15:49:02 -07002126 TestLogging.recordKeyEvent(TestProtocol.SEQUENCE_MAIN, "Key event", event);
Hyunyoung Song3c7d9cb2017-01-30 15:11:27 -08002127 return (event.getKeyCode() == KeyEvent.KEYCODE_HOME) || super.dispatchKeyEvent(event);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002128 }
2129
Joe Onorato88ec0992009-11-19 13:16:06 -08002130 @Override
vadimt9af34a72020-01-21 11:19:13 -08002131 public boolean dispatchTouchEvent(MotionEvent ev) {
Sunny Goyala306e592020-03-24 01:51:41 -07002132 switch (ev.getAction()) {
2133 case MotionEvent.ACTION_DOWN:
2134 mTouchInProgress = true;
2135 break;
2136 case MotionEvent.ACTION_UP:
Riddle Hsub30adcb2020-10-07 15:57:44 +08002137 mLastTouchUpTime = SystemClock.uptimeMillis();
Sunny Goyala306e592020-03-24 01:51:41 -07002138 // Follow through
2139 case MotionEvent.ACTION_CANCEL:
2140 mTouchInProgress = false;
2141 break;
Sunny Goyal9b180102020-03-11 10:02:29 -07002142 }
vadimtd633c9c2020-01-22 18:00:37 -08002143 TestLogging.recordMotionEvent(TestProtocol.SEQUENCE_MAIN, "Touch event", ev);
vadimt9af34a72020-01-21 11:19:13 -08002144 return super.dispatchTouchEvent(ev);
2145 }
2146
Sunny Goyala306e592020-03-24 01:51:41 -07002147 /**
2148 * Returns true if a touch interaction is in progress
2149 */
2150 public boolean isTouchInProgress() {
2151 return mTouchInProgress;
2152 }
2153
vadimt9af34a72020-01-21 11:19:13 -08002154 @Override
Fengjiang Lib7860bd2023-03-15 10:50:50 -07002155 @TargetApi(Build.VERSION_CODES.UPSIDE_DOWN_CAKE)
Joe Onorato88ec0992009-11-19 13:16:06 -08002156 public void onBackPressed() {
Fengjiang Lib7860bd2023-03-15 10:50:50 -07002157 getOnBackAnimationCallback().onBackInvoked();
Joe Onorato88ec0992009-11-19 13:16:06 -08002158 }
2159
Sunny Goyal3f2637f2022-05-05 12:24:08 -07002160 protected void onStateBack() {
2161 mStateManager.getState().onBackPressed(this);
2162 }
2163
Sunny Goyala992ac92023-01-10 17:50:32 -08002164 protected void onScreenOnChanged(boolean isOn) {
Tracy Zhouf20a4bd2021-04-19 21:37:08 -07002165 // Reset AllApps to its initial state only if we are not in the middle of
2166 // processing a multi-step drop
Sunny Goyala992ac92023-01-10 17:50:32 -08002167 if (!isOn && mPendingRequestArgs == null) {
Tracy Zhouf20a4bd2021-04-19 21:37:08 -07002168 if (!isInState(NORMAL)) {
2169 onUiChangedWhileSleeping();
2170 }
2171 mStateManager.goToState(NORMAL);
2172 }
2173 }
2174
Hyunyoung Song46d07f72018-05-22 15:41:25 -07002175 @Override
Sunny Goyal4fdc9182023-05-12 12:08:53 -07002176 public RunnableList startActivitySafely(View v, Intent intent, ItemInfo item) {
Winson Chung0b70cd42019-06-17 22:34:33 -07002177 if (!hasBeenResumed()) {
Sunny Goyal4fdc9182023-05-12 12:08:53 -07002178 RunnableList result = new RunnableList();
Winson Chung0b70cd42019-06-17 22:34:33 -07002179 // Workaround an issue where the WM launch animation is clobbered when finishing the
2180 // recents animation into launcher. Defer launching the activity until Launcher is
2181 // next resumed.
Sunny Goyal4fdc9182023-05-12 12:08:53 -07002182 addOnResumeCallback(() -> {
2183 RunnableList actualResult = startActivitySafely(v, intent, item);
2184 if (actualResult != null) {
2185 actualResult.add(result::executeAllAndDestroy);
2186 } else {
2187 result.executeAllAndDestroy();
2188 }
2189 });
Winson Chungc9bf6d42019-10-04 15:33:18 -07002190 if (mOnDeferredActivityLaunchCallback != null) {
2191 mOnDeferredActivityLaunchCallback.run();
2192 mOnDeferredActivityLaunchCallback = null;
2193 }
Sunny Goyal4fdc9182023-05-12 12:08:53 -07002194 return result;
Winson Chung0b70cd42019-06-17 22:34:33 -07002195 }
2196
Sunny Goyal4fdc9182023-05-12 12:08:53 -07002197 RunnableList result = super.startActivitySafely(v, intent, item);
2198 if (result != null && v instanceof BubbleTextView) {
Sunny Goyal0b0847b2018-03-14 12:30:11 -07002199 // This is set to the view that launched the activity that navigated the user away
2200 // from launcher. Since there is no callback for when the activity has finished
2201 // launching, enable the press state and keep this reference to reset the press
2202 // state when we return to launcher.
2203 BubbleTextView btv = (BubbleTextView) v;
2204 btv.setStayPressed(true);
Sunny Goyal4fdc9182023-05-12 12:08:53 -07002205 result.add(() -> btv.setStayPressed(false));
Sunny Goyala7ce1662016-05-31 15:01:35 -07002206 }
Sunny Goyal4fdc9182023-05-12 12:08:53 -07002207 return result;
Michael Jurka86a720e2012-05-09 11:23:23 -07002208 }
2209
Winson Chung3d503fb2011-07-13 17:25:49 -07002210 boolean isHotseatLayout(View layout) {
Sunny Goyalc13403c2016-11-18 23:44:48 -08002211 // TODO: Remove this method
Sunny Goyal876e4622018-11-02 13:50:40 -07002212 return mHotseat != null && (layout == mHotseat);
Winson Chung3d503fb2011-07-13 17:25:49 -07002213 }
Romain Guy1fbc1c82009-11-09 20:43:08 -08002214
Winson Chung3d503fb2011-07-13 17:25:49 -07002215 /**
2216 * Returns the CellLayout of the specified container at the specified screen.
fbaron5a7ea302023-07-12 10:16:49 -07002217 *
2218 * @param screenId must be presenterPos and not modelPos.
Winson Chung3d503fb2011-07-13 17:25:49 -07002219 */
Sunny Goyalefb7e842018-10-04 15:11:00 -07002220 public CellLayout getCellLayout(int container, int screenId) {
Sunny Goyal876e4622018-11-02 13:50:40 -07002221 return (container == LauncherSettings.Favorites.CONTAINER_HOTSEAT)
2222 ? mHotseat : mWorkspace.getScreenWithId(screenId);
Romain Guya6abce82009-11-10 02:54:41 -08002223 }
2224
Michael Jurkae326f182011-11-21 14:05:46 -08002225 @Override
2226 public void onTrimMemory(int level) {
2227 super.onTrimMemory(level);
Adam Cohen3f9c9712014-10-31 11:48:25 -07002228 if (level >= ComponentCallbacks2.TRIM_MEMORY_UI_HIDDEN) {
2229 // The widget preview db can result in holding onto over
2230 // 3MB of memory for caching which isn't necessary.
2231 SQLiteDatabase.releaseMemory();
2232
Adam Cohenc8f4e1b2014-11-19 16:03:20 -08002233 // This clears all widget bitmaps from the widget tray
Hyunyoung Song3f471442015-04-08 19:01:34 -07002234 // TODO(hyunyoungs)
Michael Jurkae326f182011-11-21 14:05:46 -08002235 }
2236 }
2237
Michael Jurkad7c28052012-04-27 15:43:36 -07002238 @Override
2239 public boolean dispatchPopulateAccessibilityEvent(AccessibilityEvent event) {
alanv1d4fde62012-10-17 13:15:47 -07002240 final boolean result = super.dispatchPopulateAccessibilityEvent(event);
Michael Jurkad7c28052012-04-27 15:43:36 -07002241 final List<CharSequence> text = event.getText();
2242 text.clear();
alanv1d4fde62012-10-17 13:15:47 -07002243 // Populate event with a fake title based on the current state.
Sunny Goyal3e3f44c2017-10-23 17:14:52 -07002244 // TODO: When can workspace be null?
2245 text.add(mWorkspace == null
Sunny Goyal52e25452020-07-20 12:38:01 -07002246 ? getString(R.string.home_screen)
Sunny Goyalea609262017-10-25 15:47:38 -07002247 : mStateManager.getState().getDescription(this));
Michael Jurkad7c28052012-04-27 15:43:36 -07002248 return result;
2249 }
2250
Michael Jurka7607c2f2013-04-03 14:33:19 -07002251 /**
Winson Chungc9bf6d42019-10-04 15:33:18 -07002252 * Persistant callback which notifies when an activity launch is deferred because the activity
2253 * was not yet resumed.
2254 */
2255 public void setOnDeferredActivityLaunchCallback(Runnable callback) {
2256 mOnDeferredActivityLaunchCallback = callback;
2257 }
2258
2259 /**
Andras Kloczl55edfe52021-05-14 12:21:30 +02002260 * Sets the next pages to bind synchronously on next bind.
2261 * @param pages should not be null.
Sunny Goyala7a5bf32020-01-05 15:35:29 +05302262 */
Andras Kloczl55edfe52021-05-14 12:21:30 +02002263 public void setPagesToBindSynchronously(@NonNull IntSet pages) {
2264 mPagesToBindSynchronously = pages;
Sunny Goyala7a5bf32020-01-05 15:35:29 +05302265 }
2266
Sunny Goyal93f878c2016-03-30 17:31:24 -07002267 @Override
Sunny Goyal12e3f1f2021-07-15 14:31:58 -07002268 public IntSet getPagesToBindSynchronously(IntArray orderedScreenIds) {
Alex Chau49354042021-08-25 13:21:58 +01002269 IntSet visibleIds;
2270 if (!mPagesToBindSynchronously.isEmpty()) {
2271 visibleIds = mPagesToBindSynchronously;
2272 } else if (!mWorkspaceLoading) {
2273 visibleIds = mWorkspace.getCurrentPageScreenIds();
2274 } else {
2275 // If workspace binding is still in progress, getCurrentPageScreenIds won't be accurate,
2276 // and we should use mSynchronouslyBoundPages that's set during initial binding.
2277 visibleIds = mSynchronouslyBoundPages;
2278 }
Sunny Goyal12e3f1f2021-07-15 14:31:58 -07002279 IntArray actualIds = new IntArray();
2280
Sunny Goyal12e3f1f2021-07-15 14:31:58 -07002281 IntSet result = new IntSet();
2282 if (visibleIds.isEmpty()) {
2283 return result;
2284 }
2285 for (int id : orderedScreenIds.toArray()) {
Alex Chau1e448462021-08-13 21:48:35 +01002286 actualIds.add(id);
Sunny Goyal12e3f1f2021-07-15 14:31:58 -07002287 }
2288 int firstId = visibleIds.getArray().get(0);
Steven Ng4b346102021-09-14 19:17:09 +01002289 int pairId = mWorkspace.getScreenPair(firstId);
Alex Chau62f129b2021-09-03 16:54:27 +01002290 // Double check that actual screenIds contains the visibleId, as empty screens are hidden
2291 // in single panel.
Sunny Goyal12e3f1f2021-07-15 14:31:58 -07002292 if (actualIds.contains(firstId)) {
2293 result.add(firstId);
Alex Chau62f129b2021-09-03 16:54:27 +01002294 if (mDeviceProfile.isTwoPanels && actualIds.contains(pairId)) {
2295 result.add(pairId);
Sunny Goyal12e3f1f2021-07-15 14:31:58 -07002296 }
Alex Chau62f129b2021-09-03 16:54:27 +01002297 } else if (LauncherAppState.getIDP(this).supportedProfiles.stream().anyMatch(
2298 deviceProfile -> deviceProfile.isTwoPanels) && actualIds.contains(pairId)) {
2299 // Add the right panel if left panel is hidden when switching display, due to empty
2300 // pages being hidden in single panel.
2301 result.add(pairId);
Sunny Goyal12e3f1f2021-07-15 14:31:58 -07002302 }
2303 return result;
Joe Onorato9c1289c2009-08-17 11:03:03 -04002304 }
The Android Open Source Projectf96811c2009-03-18 17:39:48 -07002305
Joe Onorato9c1289c2009-08-17 11:03:03 -04002306 /**
Sunny Goyal527c7d32015-08-28 15:19:36 -07002307 * Clear any pending bind callbacks. This is called when is loader is planning to
2308 * perform a full rebind from scratch.
2309 */
2310 @Override
2311 public void clearPendingBinds() {
Sunny Goyal527c7d32015-08-28 15:19:36 -07002312 if (mPendingExecutor != null) {
Sunny Goyal4a48a982021-06-17 15:15:46 -07002313 mPendingExecutor.cancel();
Sunny Goyal527c7d32015-08-28 15:19:36 -07002314 mPendingExecutor = null;
Sunny Goyal6b6d0a32019-08-05 17:19:32 -07002315
2316 // We might have set this flag previously and forgot to clear it.
2317 mAppsView.getAppsStore()
2318 .disableDeferUpdatesSilently(AllAppsStore.DEFER_UPDATES_NEXT_DRAW);
Sunny Goyal527c7d32015-08-28 15:19:36 -07002319 }
2320 }
2321
2322 /**
Joe Onorato9c1289c2009-08-17 11:03:03 -04002323 * Refreshes the shortcuts shown on the workspace.
Schneider Victor-tuliasfff7cef2023-04-10 15:59:23 -07002324 * <p>
Joe Onorato9c1289c2009-08-17 11:03:03 -04002325 * Implementation of the method from LauncherModel.Callbacks.
2326 */
Liran Binyamina833af32023-08-02 16:30:27 -04002327 @Override
Joe Onorato9c1289c2009-08-17 11:03:03 -04002328 public void startBinding() {
Sunny Goyal67736672023-06-02 13:35:19 +00002329 TraceHelper.INSTANCE.beginSection("startBinding");
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -07002330 // Floating panels (except the full widget sheet) are associated with individual icons. If
2331 // we are starting a fresh bind, close all such panels as all the icons are about
2332 // to go away.
Pinyao Tinga74b63a2019-07-17 23:26:06 -07002333 AbstractFloatingView.closeOpenViews(this, true, TYPE_ALL & ~TYPE_REBIND_SAFE);
Jon Miranda6dc7f1e2017-02-21 12:37:51 -08002334
Anjali Koppalff7ceff2014-05-01 18:26:37 -07002335 setWorkspaceLoading(true);
Adam Cohen517a7f52014-03-01 12:12:59 -08002336
Winson Chungd64d1762013-08-20 14:37:16 -07002337 // Clear the workspace because it's going to be rebound
Sunny Goyal2db53422019-03-01 16:06:12 -08002338 mDragController.cancelDrag();
2339
Adam Cohendf035382011-04-11 17:22:04 -07002340 mWorkspace.clearDropTargets();
Winson Chung9e6a0a22013-08-27 11:58:12 -07002341 mWorkspace.removeAllWorkspaceScreens();
Sihua Ma0593a0d2022-10-03 16:01:48 -07002342 mAppWidgetHolder.clearViews();
Winson Chungd64d1762013-08-20 14:37:16 -07002343
Winson Chung3d503fb2011-07-13 17:25:49 -07002344 if (mHotseat != null) {
Sunny Goyalc4d32012020-04-03 17:10:11 -07002345 mHotseat.resetLayout(getDeviceProfile().isVerticalBarLayout());
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002346 }
Sunny Goyal67736672023-06-02 13:35:19 +00002347 TraceHelper.INSTANCE.endSection();
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002348 }
2349
Adam Cohendcd297f2013-06-18 13:13:40 -07002350 @Override
Sunny Goyalefb7e842018-10-04 15:11:00 -07002351 public void bindScreens(IntArray orderedScreenIds) {
fbaronc7a605e2023-08-10 23:39:56 -07002352 mWorkspace.mPageIndicator.setAreScreensBinding(true);
Alex Chau1e448462021-08-13 21:48:35 +01002353 int firstScreenPosition = 0;
Jon Miranda7143ba62019-03-15 09:00:05 -07002354 if (FeatureFlags.QSB_ON_FIRST_SCREEN &&
Andras Kloczldbf577a2021-05-26 15:02:52 +02002355 orderedScreenIds.indexOf(Workspace.FIRST_SCREEN_ID) != firstScreenPosition) {
Sunny Goyalefb7e842018-10-04 15:11:00 -07002356 orderedScreenIds.removeValue(Workspace.FIRST_SCREEN_ID);
Andras Kloczldbf577a2021-05-26 15:02:52 +02002357 orderedScreenIds.add(firstScreenPosition, Workspace.FIRST_SCREEN_ID);
Jon Miranda7143ba62019-03-15 09:00:05 -07002358 } else if (!FeatureFlags.QSB_ON_FIRST_SCREEN && orderedScreenIds.isEmpty()) {
Sunny Goyala9e2f5a2016-06-10 12:22:04 -07002359 // If there are no screens, we need to have an empty screen
Andras Kloczl408a54f2021-08-28 00:59:08 +01002360 mWorkspace.addExtraEmptyScreens();
Adam Cohen5084cba2013-09-03 12:01:16 -07002361 }
Sunny Goyalda4fe1a2016-05-26 16:05:17 -07002362 bindAddScreens(orderedScreenIds);
Winson Chung0e6a7132013-08-23 12:55:10 -07002363
Winsonc7d2e832016-07-28 12:24:55 -07002364 // After we have added all the screens, if the wallpaper was locked to the default state,
2365 // then notify to indicate that it can be released and a proper wallpaper offset can be
2366 // computed before the next layout
2367 mWorkspace.unlockWallpaperFromDefaultPageOnNextLayout();
Winson Chung64359a52013-07-08 17:17:08 -07002368 }
2369
Sebastian Francoddd04502023-07-26 15:09:10 -07002370 /**
2371 * Remove odd number because they are already included when isTwoPanels and add the pair screen
2372 * if not present.
2373 */
2374 private IntArray filterTwoPanelScreenIds(IntArray orderedScreenIds) {
2375 IntSet screenIds = IntSet.wrap(orderedScreenIds);
2376 orderedScreenIds.forEach(screenId -> {
2377 if (screenId % 2 == 1) {
2378 screenIds.remove(screenId);
2379 // In case the pair is not added, add it
2380 if (!mWorkspace.containsScreenId(screenId - 1)) {
2381 screenIds.add(screenId - 1);
2382 }
2383 }
2384 });
2385 return screenIds.getArray();
2386 }
2387
Sunny Goyalefb7e842018-10-04 15:11:00 -07002388 private void bindAddScreens(IntArray orderedScreenIds) {
Sebastian Francoddd04502023-07-26 15:09:10 -07002389
Andras Kloczl8c574de2021-08-17 23:12:17 +02002390 if (mDeviceProfile.isTwoPanels) {
Sebastian Francoddd04502023-07-26 15:09:10 -07002391 if (FOLDABLE_SINGLE_PAGE.get()) {
2392 orderedScreenIds = filterTwoPanelScreenIds(orderedScreenIds);
2393 } else {
2394 // Some empty pages might have been removed while the phone was in a single panel
2395 // mode, so we want to add those empty pages back.
2396 IntSet screenIds = IntSet.wrap(orderedScreenIds);
2397 orderedScreenIds.forEach(
2398 screenId -> screenIds.add(mWorkspace.getScreenPair(screenId)));
2399 orderedScreenIds = screenIds.getArray();
2400 }
Andras Kloczl8c574de2021-08-17 23:12:17 +02002401 }
2402
Adam Cohendcd297f2013-06-18 13:13:40 -07002403 int count = orderedScreenIds.size();
2404 for (int i = 0; i < count; i++) {
Sunny Goyalefb7e842018-10-04 15:11:00 -07002405 int screenId = orderedScreenIds.get(i);
Andras Kloczldbf577a2021-05-26 15:02:52 +02002406 if (FeatureFlags.QSB_ON_FIRST_SCREEN && screenId == Workspace.FIRST_SCREEN_ID) {
Sunny Goyalda4fe1a2016-05-26 16:05:17 -07002407 // No need to bind the first screen, as its always bound.
Andras Kloczldbf577a2021-05-26 15:02:52 +02002408 continue;
Sunny Goyalda4fe1a2016-05-26 16:05:17 -07002409 }
Andras Kloczldbf577a2021-05-26 15:02:52 +02002410 mWorkspace.insertNewWorkspaceScreenBeforeEmptyScreen(screenId);
Adam Cohendcd297f2013-06-18 13:13:40 -07002411 }
Adam Cohendcd297f2013-06-18 13:13:40 -07002412 }
2413
Sunny Goyalb23980c2017-08-17 07:45:25 -07002414 @Override
Tony Wickham6a71a5b2018-08-21 11:40:23 -07002415 public void preAddApps() {
2416 // If there's an undo snackbar, force it to complete to ensure empty screens are removed
2417 // before trying to add new items.
2418 mModelWriter.commitDelete();
2419 AbstractFloatingView snackbar = AbstractFloatingView.getOpenView(this, TYPE_SNACKBAR);
2420 if (snackbar != null) {
2421 snackbar.post(() -> snackbar.close(true));
2422 }
2423 }
2424
2425 @Override
Sunny Goyalefb7e842018-10-04 15:11:00 -07002426 public void bindAppsAdded(IntArray newScreens, ArrayList<ItemInfo> addNotAnimated,
Sunny Goyal29947f02017-12-18 13:49:44 -08002427 ArrayList<ItemInfo> addAnimated) {
Winson Chungd64d1762013-08-20 14:37:16 -07002428 // Add the new screens
Adam Cohen76a47a12014-02-05 11:47:43 -08002429 if (newScreens != null) {
Alex Chau817e0fa2021-09-08 20:46:32 +01002430 // newScreens can contain an empty right panel that is already bound, but not known
2431 // by BgDataModel.
2432 newScreens.removeAllValues(mWorkspace.mScreenOrder);
Adam Cohen76a47a12014-02-05 11:47:43 -08002433 bindAddScreens(newScreens);
2434 }
Winson Chungd64d1762013-08-20 14:37:16 -07002435
2436 // We add the items without animation on non-visible pages, and with
2437 // animations on the new page (which we will try and snap to).
Adam Cohen76a47a12014-02-05 11:47:43 -08002438 if (addNotAnimated != null && !addNotAnimated.isEmpty()) {
Sunny Goyalb23980c2017-08-17 07:45:25 -07002439 bindItems(addNotAnimated, false);
Winson Chungd64d1762013-08-20 14:37:16 -07002440 }
Adam Cohen76a47a12014-02-05 11:47:43 -08002441 if (addAnimated != null && !addAnimated.isEmpty()) {
Sunny Goyalb23980c2017-08-17 07:45:25 -07002442 bindItems(addAnimated, true);
Winson Chungd64d1762013-08-20 14:37:16 -07002443 }
Winson Chungc58497e2013-09-03 17:48:37 -07002444
Winson Chung87412982013-10-03 18:34:14 -07002445 // Remove the extra empty screen
Sunny Goyal6e379fc2020-03-19 16:08:14 -07002446 mWorkspace.removeExtraEmptyScreen(false);
Winson Chungd64d1762013-08-20 14:37:16 -07002447 }
2448
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002449 /**
Joe Onorato9c1289c2009-08-17 11:03:03 -04002450 * Bind the items start-end from the list.
2451 *
2452 * Implementation of the method from LauncherModel.Callbacks.
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002453 */
Tony Wickham0bb211a2015-10-02 16:22:08 -07002454 @Override
Sunny Goyalb23980c2017-08-17 07:45:25 -07002455 public void bindItems(final List<ItemInfo> items, final boolean forceAnimateIcons) {
Schneider Victor-tulias68706eb2021-04-29 15:24:54 -07002456 bindItems(items, forceAnimateIcons, /* focusFirstItemForAccessibility= */ false);
2457 }
2458
2459
2460 /**
2461 * Bind the items start-end from the list.
2462 *
2463 * Implementation of the method from LauncherModel.Callbacks.
2464 *
2465 * @param focusFirstItemForAccessibility true iff the first item to be added to the workspace
2466 * should be focused for accessibility.
2467 */
2468 public void bindItems(
2469 final List<ItemInfo> items,
2470 final boolean forceAnimateIcons,
2471 final boolean focusFirstItemForAccessibility) {
Sunny Goyal3be633b2016-12-08 09:59:25 -08002472 // Get the list of added items and intersect them with the set of items here
Rajeev Kumar43c0f582017-06-23 15:34:55 -07002473 final Collection<Animator> bounceAnims = new ArrayList<>();
Schneider Victor-tulias68fb4162021-09-16 13:24:01 -07002474 boolean canAnimatePageChange = canAnimatePageChange();
Shikha Malhotraf78da1b2022-04-11 10:23:18 +00002475 Workspace<?> workspace = mWorkspace;
Sunny Goyalefb7e842018-10-04 15:11:00 -07002476 int newItemsScreenId = -1;
Sunny Goyalb23980c2017-08-17 07:45:25 -07002477 int end = items.size();
Schneider Victor-tulias68706eb2021-04-29 15:24:54 -07002478 View newView = null;
Sunny Goyalb23980c2017-08-17 07:45:25 -07002479 for (int i = 0; i < end; i++) {
Sunny Goyal3be633b2016-12-08 09:59:25 -08002480 final ItemInfo item = items.get(i);
Winson Chung4d279d92011-07-21 11:46:32 -07002481
2482 // Short circuit if we are loading dock items for a configuration which has no dock
2483 if (item.container == LauncherSettings.Favorites.CONTAINER_HOTSEAT &&
2484 mHotseat == null) {
2485 continue;
2486 }
2487
Sunny Goyal639e9062015-08-19 19:17:06 -07002488 final View view;
Joe Onorato9c1289c2009-08-17 11:03:03 -04002489 switch (item.itemType) {
2490 case LauncherSettings.Favorites.ITEM_TYPE_APPLICATION:
Sunny Goyal3be633b2016-12-08 09:59:25 -08002491 case LauncherSettings.Favorites.ITEM_TYPE_DEEP_SHORTCUT: {
Sunny Goyal95899162019-03-27 16:03:06 -07002492 WorkspaceItemInfo info = (WorkspaceItemInfo) item;
Sunny Goyal639e9062015-08-19 19:17:06 -07002493 view = createShortcut(info);
Joe Onorato9c1289c2009-08-17 11:03:03 -04002494 break;
Sunny Goyal3be633b2016-12-08 09:59:25 -08002495 }
2496 case LauncherSettings.Favorites.ITEM_TYPE_FOLDER: {
Tracy Zhou4d7b2442019-12-09 13:42:57 -08002497 view = FolderIcon.inflateFolderAndIcon(R.layout.folder_icon, this,
Michael Jurka0142d492010-08-25 17:46:15 -07002498 (ViewGroup) workspace.getChildAt(workspace.getCurrentPage()),
Sunny Goyal1cd01b02016-11-09 10:43:58 -08002499 (FolderInfo) item);
Joe Onorato9c1289c2009-08-17 11:03:03 -04002500 break;
Sunny Goyal3be633b2016-12-08 09:59:25 -08002501 }
Jeremy Sim7cf0dd92023-03-24 22:39:45 -07002502 case LauncherSettings.Favorites.ITEM_TYPE_APP_PAIR: {
Jeremy Sim94fd07e2023-04-19 20:56:49 -07002503 view = AppPairIcon.inflateIcon(R.layout.app_pair_icon, this,
2504 (ViewGroup) workspace.getChildAt(workspace.getCurrentPage()),
2505 (FolderInfo) item);
Jeremy Sim7cf0dd92023-03-24 22:39:45 -07002506 break;
2507 }
Sunny Goyal952e63d2017-08-16 04:59:08 -07002508 case LauncherSettings.Favorites.ITEM_TYPE_APPWIDGET:
2509 case LauncherSettings.Favorites.ITEM_TYPE_CUSTOM_APPWIDGET: {
Sunny Goyala9a1a212017-08-18 01:03:21 -07002510 view = inflateAppWidget((LauncherAppWidgetInfo) item);
Sunny Goyalb23980c2017-08-17 07:45:25 -07002511 if (view == null) {
2512 continue;
Sunny Goyal3be633b2016-12-08 09:59:25 -08002513 }
Sunny Goyal3be633b2016-12-08 09:59:25 -08002514 break;
2515 }
Winson Chungc763c4e2013-07-19 13:49:06 -07002516 default:
2517 throw new RuntimeException("Invalid Item Type");
Joe Onorato9c1289c2009-08-17 11:03:03 -04002518 }
Sunny Goyal639e9062015-08-19 19:17:06 -07002519
Samuel Fufaca37b8a2019-08-19 17:04:36 -07002520 /*
Sunny Goyalda4fe1a2016-05-26 16:05:17 -07002521 * Remove colliding items.
2522 */
Sunny Goyal669b71f2023-01-27 14:37:07 -08002523 CellPos presenterPos = getCellPosMapper().mapModelToPresenter(item);
2524 if (item.container == CONTAINER_DESKTOP) {
2525 CellLayout cl = mWorkspace.getScreenWithId(presenterPos.screenId);
2526 if (cl != null && cl.isOccupied(presenterPos.cellX, presenterPos.cellY)) {
2527 View v = cl.getChildAt(presenterPos.cellX, presenterPos.cellY);
Jon Miranda0aff1152021-11-05 16:36:07 -07002528 if (v == null) {
2529 Log.e(TAG, "bindItems failed when removing colliding item=" + item);
2530 }
Sunny Goyalda4fe1a2016-05-26 16:05:17 -07002531 Object tag = v.getTag();
2532 String desc = "Collision while binding workspace item: " + item
2533 + ". Collides with " + tag;
Zak Cohen3eeb41d2020-02-14 14:15:13 -08002534 if (FeatureFlags.IS_STUDIO_BUILD) {
Sunny Goyalda4fe1a2016-05-26 16:05:17 -07002535 throw (new RuntimeException(desc));
2536 } else {
Pinyao Ting6a41d562022-05-10 23:47:36 +00002537 getModelWriter().deleteItemFromDatabase(item, desc);
Sunny Goyalda4fe1a2016-05-26 16:05:17 -07002538 continue;
2539 }
2540 }
2541 }
Sunny Goyald5462aa2016-11-22 16:52:39 +05302542 workspace.addInScreenFromBind(view, item);
Schneider Victor-tulias68fb4162021-09-16 13:24:01 -07002543 if (forceAnimateIcons) {
Sunny Goyal639e9062015-08-19 19:17:06 -07002544 // Animate all the applications up now
2545 view.setAlpha(0f);
2546 view.setScaleX(0f);
2547 view.setScaleY(0f);
2548 bounceAnims.add(createNewAppBounceAnimation(view, i));
Sunny Goyal669b71f2023-01-27 14:37:07 -08002549 newItemsScreenId = presenterPos.screenId;
Sunny Goyal639e9062015-08-19 19:17:06 -07002550 }
Schneider Victor-tulias68706eb2021-04-29 15:24:54 -07002551
2552 if (newView == null) {
2553 newView = view;
2554 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002555 }
Winson Chungf0c6ae02012-03-21 16:10:31 -07002556
Schneider Victor-tulias68706eb2021-04-29 15:24:54 -07002557 View viewToFocus = newView;
2558 // Animate to the correct pager
Schneider Victor-tulias68fb4162021-09-16 13:24:01 -07002559 if (forceAnimateIcons && newItemsScreenId > -1) {
Sunny Goyalf0b6db72018-08-13 16:10:14 -07002560 AnimatorSet anim = new AnimatorSet();
2561 anim.playTogether(bounceAnims);
Schneider Victor-tulias68706eb2021-04-29 15:24:54 -07002562 if (focusFirstItemForAccessibility && viewToFocus != null) {
2563 anim.addListener(new AnimatorListenerAdapter() {
2564 @Override
2565 public void onAnimationEnd(Animator animation) {
2566 viewToFocus.sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_FOCUSED);
2567 }
2568 });
2569 }
Jon Miranda64eb8ea2018-03-29 11:43:58 -07002570
Sunny Goyalefb7e842018-10-04 15:11:00 -07002571 int currentScreenId = mWorkspace.getScreenIdForPageIndex(mWorkspace.getNextPage());
Sunny Goyalf0b6db72018-08-13 16:10:14 -07002572 final int newScreenIndex = mWorkspace.getPageIndexForScreenId(newItemsScreenId);
2573 final Runnable startBounceAnimRunnable = anim::start;
2574
Schneider Victor-tulias68fb4162021-09-16 13:24:01 -07002575 if (canAnimatePageChange && newItemsScreenId != currentScreenId) {
Sunny Goyalf0b6db72018-08-13 16:10:14 -07002576 // We post the animation slightly delayed to prevent slowdowns
2577 // when we are loading right after we return to launcher.
2578 mWorkspace.postDelayed(new Runnable() {
2579 public void run() {
2580 if (mWorkspace != null) {
Andy Wickham65ced1b2020-03-07 02:14:19 +00002581 closeOpenViews(false);
Sunny Goyalf0b6db72018-08-13 16:10:14 -07002582
2583 mWorkspace.snapToPage(newScreenIndex);
2584 mWorkspace.postDelayed(startBounceAnimRunnable,
2585 NEW_APPS_ANIMATION_DELAY);
Winson Chung94d67682013-09-25 16:29:40 -07002586 }
Sunny Goyalf0b6db72018-08-13 16:10:14 -07002587 }
2588 }, NEW_APPS_PAGE_MOVE_DELAY);
2589 } else {
2590 mWorkspace.postDelayed(startBounceAnimRunnable, NEW_APPS_ANIMATION_DELAY);
Winson Chung997a9232013-07-24 15:33:46 -07002591 }
Schneider Victor-tulias68706eb2021-04-29 15:24:54 -07002592 } else if (focusFirstItemForAccessibility && viewToFocus != null) {
2593 viewToFocus.sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_FOCUSED);
Winson Chung64359a52013-07-08 17:17:08 -07002594 }
Joe Onorato9c1289c2009-08-17 11:03:03 -04002595 workspace.requestLayout();
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002596 }
2597
Joe Onorato9c1289c2009-08-17 11:03:03 -04002598 /**
2599 * Add the views for a widget to the workspace.
Joe Onorato9c1289c2009-08-17 11:03:03 -04002600 */
Sunny Goyala9a1a212017-08-18 01:03:21 -07002601 public void bindAppWidget(LauncherAppWidgetInfo item) {
2602 View view = inflateAppWidget(item);
2603 if (view != null) {
2604 mWorkspace.addInScreen(view, item);
2605 mWorkspace.requestLayout();
2606 }
2607 }
2608
2609 private View inflateAppWidget(LauncherAppWidgetInfo item) {
Samuel Fufaca37b8a2019-08-19 17:04:36 -07002610 if (item.hasOptionFlag(LauncherAppWidgetInfo.OPTION_SEARCH_WIDGET)) {
2611 item.providerName = QsbContainerView.getSearchComponentName(this);
2612 if (item.providerName == null) {
Pinyao Ting6a41d562022-05-10 23:47:36 +00002613 getModelWriter().deleteItemFromDatabase(item,
2614 "search widget removed because search component cannot be found");
Samuel Fufaca37b8a2019-08-19 17:04:36 -07002615 return null;
2616 }
2617 }
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002618 final AppWidgetHostView view;
Sunny Goyal2e1efb42016-03-03 16:58:55 -08002619 if (mIsSafeModeEnabled) {
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002620 view = new PendingAppWidgetHostView(this, item, mIconCache, true);
Sunny Goyald5462aa2016-11-22 16:52:39 +05302621 prepareAppWidget(view, item);
Sunny Goyalb23980c2017-08-17 07:45:25 -07002622 return view;
Sunny Goyal2e1efb42016-03-03 16:58:55 -08002623 }
2624
Sunny Goyal67736672023-06-02 13:35:19 +00002625 TraceHelper.INSTANCE.beginSection("BIND_WIDGET_id=" + item.appWidgetId);
Joe Onorato9c1289c2009-08-17 11:03:03 -04002626
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002627 try {
2628 final LauncherAppWidgetProviderInfo appWidgetInfo;
Steven Ngacd9d792021-06-25 11:51:44 +01002629 String removalReason = "";
Adam Cohen59400422014-03-05 18:07:04 -08002630
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002631 if (item.hasRestoreFlag(LauncherAppWidgetInfo.FLAG_PROVIDER_NOT_READY)) {
2632 // If the provider is not ready, bind as a pending widget.
2633 appWidgetInfo = null;
Steven Ngacd9d792021-06-25 11:51:44 +01002634 removalReason = "the provider isn't ready.";
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002635 } else if (item.hasRestoreFlag(LauncherAppWidgetInfo.FLAG_ID_NOT_VALID)) {
2636 // The widget id is not valid. Try to find the widget based on the provider info.
2637 appWidgetInfo = mAppWidgetManager.findProvider(item.providerName, item.user);
Pinyao Tingbbb9a9c2021-05-11 15:42:54 -07002638 if (appWidgetInfo == null) {
2639 if (WidgetsModel.GO_DISABLE_WIDGETS) {
Steven Ngacd9d792021-06-25 11:51:44 +01002640 removalReason = "widgets are disabled on go device.";
Pinyao Tingbbb9a9c2021-05-11 15:42:54 -07002641 } else {
Steven Ngacd9d792021-06-25 11:51:44 +01002642 removalReason =
2643 "WidgetManagerHelper cannot find a provider from provider info.";
Pinyao Tingbbb9a9c2021-05-11 15:42:54 -07002644 }
2645 }
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002646 } else {
fbaron30d9e3f2023-08-03 17:03:59 -07002647 appWidgetInfo = mAppWidgetManager.getLauncherAppWidgetInfo(item.appWidgetId,
2648 item.getTargetComponent());
Pinyao Tingbbb9a9c2021-05-11 15:42:54 -07002649 if (appWidgetInfo == null) {
fbaron30d9e3f2023-08-03 17:03:59 -07002650 if (item.appWidgetId <= CUSTOM_WIDGET_ID) {
Steven Ngacd9d792021-06-25 11:51:44 +01002651 removalReason =
2652 "CustomWidgetManager cannot find provider from that widget id.";
Pinyao Tingbbb9a9c2021-05-11 15:42:54 -07002653 } else {
Steven Ngacd9d792021-06-25 11:51:44 +01002654 removalReason = "AppWidgetManager cannot find provider for that widget id."
2655 + " It could be because AppWidgetService is not available, or the"
Pinyao Tingbbb9a9c2021-05-11 15:42:54 -07002656 + " appWidgetId has not been bound to a the provider yet, or you"
2657 + " don't have access to that appWidgetId.";
2658 }
2659 }
Sunny Goyalff572272014-07-23 13:58:07 -07002660 }
Sunny Goyalff572272014-07-23 13:58:07 -07002661
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002662 // If the provider is ready, but the width is not yet restored, try to restore it.
2663 if (!item.hasRestoreFlag(LauncherAppWidgetInfo.FLAG_PROVIDER_NOT_READY)
2664 && (item.restoreStatus != LauncherAppWidgetInfo.RESTORE_COMPLETED)) {
2665 if (appWidgetInfo == null) {
Pinyao Ting6a41d562022-05-10 23:47:36 +00002666 getModelWriter().deleteItemFromDatabase(item,
2667 "Removing restored widget: id=" + item.appWidgetId
Pinyao Tingbbb9a9c2021-05-11 15:42:54 -07002668 + " belongs to component " + item.providerName + " user " + item.user
Steven Ngacd9d792021-06-25 11:51:44 +01002669 + ", as the provider is null and " + removalReason);
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002670 return null;
2671 }
Sunny Goyalff572272014-07-23 13:58:07 -07002672
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002673 // If we do not have a valid id, try to bind an id.
2674 if (item.hasRestoreFlag(LauncherAppWidgetInfo.FLAG_ID_NOT_VALID)) {
2675 if (!item.hasRestoreFlag(LauncherAppWidgetInfo.FLAG_ID_ALLOCATED)) {
2676 // Id has not been allocated yet. Allocate a new id.
Sihua Ma0593a0d2022-10-03 16:01:48 -07002677 item.appWidgetId = mAppWidgetHolder.allocateAppWidgetId();
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002678 item.restoreStatus |= LauncherAppWidgetInfo.FLAG_ID_ALLOCATED;
Sunny Goyal86df1382016-08-10 15:03:22 -07002679
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002680 // Also try to bind the widget. If the bind fails, the user will be shown
2681 // a click to setup UI, which will ask for the bind permission.
Yogisha Dixit658c5da2021-05-24 23:23:15 +01002682 PendingAddWidgetInfo pendingInfo =
2683 new PendingAddWidgetInfo(appWidgetInfo, item.sourceContainer);
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002684 pendingInfo.spanX = item.spanX;
2685 pendingInfo.spanY = item.spanY;
2686 pendingInfo.minSpanX = item.minSpanX;
2687 pendingInfo.minSpanY = item.minSpanY;
Sunny Goyal19ff7282021-04-22 10:12:54 -07002688 Bundle options = pendingInfo.getDefaultSizeOptions(this);
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002689
2690 boolean isDirectConfig =
2691 item.hasRestoreFlag(LauncherAppWidgetInfo.FLAG_DIRECT_CONFIG);
2692 if (isDirectConfig && item.bindOptions != null) {
2693 Bundle newOptions = item.bindOptions.getExtras();
2694 if (options != null) {
2695 newOptions.putAll(options);
2696 }
2697 options = newOptions;
Sunny Goyal86df1382016-08-10 15:03:22 -07002698 }
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002699 boolean success = mAppWidgetManager.bindAppWidgetIdIfAllowed(
2700 item.appWidgetId, appWidgetInfo, options);
2701
2702 // We tried to bind once. If we were not able to bind, we would need to
2703 // go through the permission dialog, which means we cannot skip the config
2704 // activity.
2705 item.bindOptions = null;
2706 item.restoreStatus &= ~LauncherAppWidgetInfo.FLAG_DIRECT_CONFIG;
2707
2708 // Bind succeeded
2709 if (success) {
2710 // If the widget has a configure activity, it is still needs to set it
2711 // up, otherwise the widget is ready to go.
2712 item.restoreStatus = (appWidgetInfo.configure == null) || isDirectConfig
2713 ? LauncherAppWidgetInfo.RESTORE_COMPLETED
2714 : LauncherAppWidgetInfo.FLAG_UI_NOT_READY;
2715 }
2716
2717 getModelWriter().updateItemInDatabase(item);
Sunny Goyal86df1382016-08-10 15:03:22 -07002718 }
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002719 } else if (item.hasRestoreFlag(LauncherAppWidgetInfo.FLAG_UI_NOT_READY)
2720 && (appWidgetInfo.configure == null)) {
2721 // The widget was marked as UI not ready, but there is no configure activity to
2722 // update the UI.
2723 item.restoreStatus = LauncherAppWidgetInfo.RESTORE_COMPLETED;
Sunny Goyal43bf11d2017-02-02 13:52:53 -08002724 getModelWriter().updateItemInDatabase(item);
Sunny Goyalff572272014-07-23 13:58:07 -07002725 }
Samuel Fufa9151c012020-02-24 17:06:28 -08002726 else if (item.hasRestoreFlag(LauncherAppWidgetInfo.FLAG_UI_NOT_READY)
2727 && appWidgetInfo.configure != null) {
2728 if (mAppWidgetManager.isAppWidgetRestored(item.appWidgetId)) {
2729 item.restoreStatus = LauncherAppWidgetInfo.RESTORE_COMPLETED;
2730 getModelWriter().updateItemInDatabase(item);
2731 }
2732 }
Sunny Goyal56c73602015-09-25 12:55:01 -07002733 }
2734
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002735 if (item.restoreStatus == LauncherAppWidgetInfo.RESTORE_COMPLETED) {
2736 // Verify that we own the widget
2737 if (appWidgetInfo == null) {
Pinyao Ting0d97f8d2020-12-04 15:12:26 -08002738 FileLog.e(TAG, "Removing invalid widget: id=" + item.appWidgetId);
Sihua Ma0593a0d2022-10-03 16:01:48 -07002739 getModelWriter().deleteWidgetInfo(item, getAppWidgetHolder(), removalReason);
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002740 return null;
2741 }
Joe Onorato9c1289c2009-08-17 11:03:03 -04002742
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002743 item.minSpanX = appWidgetInfo.minSpanX;
2744 item.minSpanY = appWidgetInfo.minSpanY;
Sihua Ma0593a0d2022-10-03 16:01:48 -07002745 view = mAppWidgetHolder.createView(this, item.appWidgetId, appWidgetInfo);
Samuel Fufa9151c012020-02-24 17:06:28 -08002746 } else if (!item.hasRestoreFlag(LauncherAppWidgetInfo.FLAG_ID_NOT_VALID)
2747 && appWidgetInfo != null) {
Sihua Ma0593a0d2022-10-03 16:01:48 -07002748 mAppWidgetHolder.addPendingView(item.appWidgetId,
Samuel Fufa9151c012020-02-24 17:06:28 -08002749 new PendingAppWidgetHostView(this, item, mIconCache, false));
Sihua Ma0593a0d2022-10-03 16:01:48 -07002750 view = mAppWidgetHolder.createView(this, item.appWidgetId, appWidgetInfo);
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002751 } else {
2752 view = new PendingAppWidgetHostView(this, item, mIconCache, false);
2753 }
2754 prepareAppWidget(view, item);
2755 } finally {
Sunny Goyal67736672023-06-02 13:35:19 +00002756 TraceHelper.INSTANCE.endSection();
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002757 }
2758
Sunny Goyalb23980c2017-08-17 07:45:25 -07002759 return view;
Joe Onorato9c1289c2009-08-17 11:03:03 -04002760 }
2761
Sunny Goyalff572272014-07-23 13:58:07 -07002762 /**
2763 * Restores a pending widget.
2764 *
2765 * @param appWidgetId The app widget id
Sunny Goyalff572272014-07-23 13:58:07 -07002766 */
Sunny Goyald478c832016-04-01 12:04:16 -07002767 private LauncherAppWidgetInfo completeRestoreAppWidget(int appWidgetId, int finalRestoreFlag) {
Sunny Goyalff572272014-07-23 13:58:07 -07002768 LauncherAppWidgetHostView view = mWorkspace.getWidgetForAppWidgetId(appWidgetId);
2769 if ((view == null) || !(view instanceof PendingAppWidgetHostView)) {
2770 Log.e(TAG, "Widget update called, when the widget no longer exists.");
Sunny Goyald478c832016-04-01 12:04:16 -07002771 return null;
Sunny Goyalff572272014-07-23 13:58:07 -07002772 }
2773
Sunny Goyal0fc1be12014-08-11 17:05:23 -07002774 LauncherAppWidgetInfo info = (LauncherAppWidgetInfo) view.getTag();
Sunny Goyald478c832016-04-01 12:04:16 -07002775 info.restoreStatus = finalRestoreFlag;
Jon Miranda2b823f42017-05-02 18:36:18 -07002776 if (info.restoreStatus == LauncherAppWidgetInfo.RESTORE_COMPLETED) {
2777 info.pendingItemInfo = null;
2778 }
Sunny Goyalff572272014-07-23 13:58:07 -07002779
Sunny Goyalba47faa2017-10-04 16:50:57 -07002780 if (((PendingAppWidgetHostView) view).isReinflateIfNeeded()) {
Sunny Goyal29947f02017-12-18 13:49:44 -08002781 view.reInflate();
Sunny Goyalba47faa2017-10-04 16:50:57 -07002782 }
2783
Sunny Goyal43bf11d2017-02-02 13:52:53 -08002784 getModelWriter().updateItemInDatabase(info);
Sunny Goyald478c832016-04-01 12:04:16 -07002785 return info;
Sunny Goyalff572272014-07-23 13:58:07 -07002786 }
2787
Sunny Goyal527c7d32015-08-28 15:19:36 -07002788 public void clearPendingExecutor(ViewOnDrawExecutor executor) {
2789 if (mPendingExecutor == executor) {
2790 mPendingExecutor = null;
2791 }
2792 }
2793
Sunny Goyalb5b9ad62016-04-02 11:23:39 -07002794 @Override
Schneider Victor-tulias927d6dc2021-08-26 11:56:47 -07002795 @TargetApi(Build.VERSION_CODES.S)
Fengjiang Li5a36c172023-04-13 18:18:27 +00002796 public void onInitialBindComplete(IntSet boundPages, RunnableList pendingTasks,
2797 int workspaceItemCount, boolean isBindSync) {
Sunny Goyal4a48a982021-06-17 15:15:46 -07002798 mSynchronouslyBoundPages = boundPages;
Sunny Goyal4a48a982021-06-17 15:15:46 -07002799 mPagesToBindSynchronously = new IntSet();
2800
2801 clearPendingBinds();
2802 ViewOnDrawExecutor executor = new ViewOnDrawExecutor(pendingTasks);
2803 mPendingExecutor = executor;
2804 if (!isInState(ALL_APPS)) {
2805 mAppsView.getAppsStore().enableDeferUpdates(AllAppsStore.DEFER_UPDATES_NEXT_DRAW);
2806 pendingTasks.add(() -> mAppsView.getAppsStore().disableDeferUpdates(
2807 AllAppsStore.DEFER_UPDATES_NEXT_DRAW));
2808 }
2809
Sunny Goyal7b8d63f2022-04-14 16:37:32 -07002810 if (mOnInitialBindListener != null) {
2811 getRootView().getViewTreeObserver().removeOnPreDrawListener(mOnInitialBindListener);
2812 mOnInitialBindListener = null;
Sunny Goyalb5b9ad62016-04-02 11:23:39 -07002813 }
Sunny Goyal7b8d63f2022-04-14 16:37:32 -07002814
2815 executor.onLoadAnimationCompleted();
Sunny Goyal4a48a982021-06-17 15:15:46 -07002816 executor.attachTo(this);
Schneider Victor-tulias927d6dc2021-08-26 11:56:47 -07002817 if (Utilities.ATLEAST_S) {
2818 Trace.endAsyncSection(DISPLAY_WORKSPACE_TRACE_METHOD_NAME,
2819 DISPLAY_WORKSPACE_TRACE_COOKIE);
2820 }
Fengjiang Li5a36c172023-04-13 18:18:27 +00002821 mStartupLatencyLogger
2822 .logCardinality(workspaceItemCount)
2823 .logEnd(isBindSync
2824 ? LAUNCHER_LATENCY_STARTUP_WORKSPACE_LOADER_SYNC
2825 : LAUNCHER_LATENCY_STARTUP_WORKSPACE_LOADER_ASYNC);
2826 // In the first rootview's onDraw after onInitialBindComplete(), log end of startup latency.
2827 getRootView().getViewTreeObserver().addOnDrawListener(
2828 new ViewTreeObserver.OnDrawListener() {
2829
2830 @Override
2831 public void onDraw() {
2832 mStartupLatencyLogger
2833 .logEnd(LAUNCHER_LATENCY_STARTUP_TOTAL_DURATION)
2834 .log()
2835 .reset();
2836 MAIN_EXECUTOR.getHandler().postAtFrontOfQueue(
2837 () -> getRootView().getViewTreeObserver()
2838 .removeOnDrawListener(this));
2839 }
2840 });
Sunny Goyalb5b9ad62016-04-02 11:23:39 -07002841 }
2842
Joe Onorato9c1289c2009-08-17 11:03:03 -04002843 /**
2844 * Callback saying that there aren't any more items to bind.
Schneider Victor-tuliasfff7cef2023-04-10 15:59:23 -07002845 * <p>
Joe Onorato9c1289c2009-08-17 11:03:03 -04002846 * Implementation of the method from LauncherModel.Callbacks.
2847 */
Andras Kloczl55edfe52021-05-14 12:21:30 +02002848 public void finishBindingItems(IntSet pagesBoundFirst) {
Sunny Goyal67736672023-06-02 13:35:19 +00002849 TraceHelper.INSTANCE.beginSection("finishBindingItems");
Adam Cohen1462de32012-07-24 22:34:36 -07002850 mWorkspace.restoreInstanceStateForRemainingPages();
Joe Onorato9c1289c2009-08-17 11:03:03 -04002851
Anjali Koppalff7ceff2014-05-01 18:26:37 -07002852 setWorkspaceLoading(false);
Adam Cohendb364c32014-05-20 14:23:40 -07002853
Sunny Goyal2100c782016-08-22 16:00:03 -07002854 if (mPendingActivityResult != null) {
2855 handleActivityResult(mPendingActivityResult.requestCode,
2856 mPendingActivityResult.resultCode, mPendingActivityResult.data);
2857 mPendingActivityResult = null;
Adam Cohendb364c32014-05-20 14:23:40 -07002858 }
2859
Andras Kloczl55edfe52021-05-14 12:21:30 +02002860 int currentPage = pagesBoundFirst != null && !pagesBoundFirst.isEmpty()
Sunny Goyal12e3f1f2021-07-15 14:31:58 -07002861 ? mWorkspace.getPageIndexForScreenId(pagesBoundFirst.getArray().get(0))
2862 : PagedView.INVALID_PAGE;
Tonyf80e8932018-12-21 11:58:04 -08002863 // When undoing the removal of the last item on a page, return to that page.
Tony Wickham03f27012019-04-25 14:22:54 -07002864 // Since we are just resetting the current page without user interaction,
2865 // override the previous page so we don't log the page switch.
Andras Kloczl55edfe52021-05-14 12:21:30 +02002866 mWorkspace.setCurrentPage(currentPage, currentPage /* overridePrevPage */);
2867 mPagesToBindSynchronously = new IntSet();
Tony Wickham6a71a5b2018-08-21 11:40:23 -07002868
Sunny Goyalac6f69f2019-08-16 11:59:55 -07002869 // Cache one page worth of icons
2870 getViewCache().setCacheSize(R.layout.folder_application,
2871 mDeviceProfile.inv.numFolderColumns * mDeviceProfile.inv.numFolderRows);
2872 getViewCache().setCacheSize(R.layout.folder_page, 2);
2873
Sunny Goyal67736672023-06-02 13:35:19 +00002874 TraceHelper.INSTANCE.endSection();
fbaronc7a605e2023-08-10 23:39:56 -07002875 mWorkspace.removeExtraEmptyScreen(/* stripEmptyScreens= */ true);
2876 mWorkspace.mPageIndicator.setAreScreensBinding(false);
Winson Chungf0c6ae02012-03-21 16:10:31 -07002877 }
2878
Schneider Victor-tulias68fb4162021-09-16 13:24:01 -07002879 private boolean canAnimatePageChange() {
Sunny Goyal9b180102020-03-11 10:02:29 -07002880 if (mDragController.isDragging()) {
2881 return false;
2882 } else {
Riddle Hsu979da642020-09-22 21:52:40 +08002883 return (SystemClock.uptimeMillis() - mLastTouchUpTime)
Sunny Goyal9b180102020-03-11 10:02:29 -07002884 > (NEW_APPS_ANIMATION_INACTIVE_TIMEOUT_SECONDS * 1000);
2885 }
Winson Chunga2413752012-04-03 14:22:34 -07002886 }
2887
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002888 /**
2889 * Similar to {@link #getFirstMatch} but optimized to finding a suitable view for the app close
2890 * animation.
2891 *
2892 * @param preferredItemId The id of the preferred item to match to if it exists.
2893 * @param packageName The package name of the app to match.
2894 * @param user The user of the app to match.
Jon Mirandab42e1242022-03-08 16:37:35 -08002895 * @param supportsAllAppsState If true and we are in All Apps state, looks for view in All Apps.
2896 * Else we only looks on the workspace.
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002897 */
Jon Mirandaf58db152022-06-02 16:06:37 -07002898 public @Nullable View getFirstMatchForAppClose(int preferredItemId, String packageName,
2899 UserHandle user, boolean supportsAllAppsState) {
Sunny Goyal32084d42022-05-02 10:00:07 -07002900 final Predicate<ItemInfo> preferredItem = info ->
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002901 info != null && info.id == preferredItemId;
Sunny Goyal32084d42022-05-02 10:00:07 -07002902 final Predicate<ItemInfo> packageAndUserAndApp = info ->
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002903 info != null
2904 && info.itemType == ITEM_TYPE_APPLICATION
2905 && info.user.equals(user)
2906 && info.getTargetComponent() != null
2907 && TextUtils.equals(info.getTargetComponent().getPackageName(),
2908 packageName);
2909
Jon Mirandab42e1242022-03-08 16:37:35 -08002910 if (supportsAllAppsState && isInState(LauncherState.ALL_APPS)) {
Jon Mirandaf58db152022-06-02 16:06:37 -07002911 AllAppsRecyclerView activeRecyclerView = mAppsView.getActiveRecyclerView();
2912 View v = getFirstMatch(Collections.singletonList(activeRecyclerView),
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002913 preferredItem, packageAndUserAndApp);
Jon Mirandaf58db152022-06-02 16:06:37 -07002914
Sunny Goyalf34811d2022-10-21 20:42:34 +00002915 if (v != null && activeRecyclerView.computeVerticalScrollOffset() > 0) {
Jon Mirandaf58db152022-06-02 16:06:37 -07002916 RectF locationBounds = new RectF();
2917 FloatingIconView.getLocationBoundsForView(this, v, false, locationBounds,
2918 new Rect());
2919 if (locationBounds.top < mAppsView.getHeaderBottom()) {
2920 // Icon is covered by scrim, return null to play fallback animation.
2921 return null;
2922 }
2923 }
2924
2925 return v;
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002926 }
Federico Baron8bf1bca2022-09-27 16:19:11 -07002927
2928 // Look for the item inside the folder at the current page
2929 Folder folder = Folder.getOpen(this);
2930 if (folder != null) {
2931 View v = getFirstMatch(Collections.singletonList(
2932 folder.getContent().getCurrentCellLayout().getShortcutsAndWidgets()),
2933 preferredItem,
2934 packageAndUserAndApp);
2935 if (v == null) {
2936 folder.close(isStarted() && !isForceInvisible());
2937 } else {
2938 return v;
2939 }
2940 }
2941
2942 List<ViewGroup> containers = new ArrayList<>(mWorkspace.getPanelCount() + 1);
2943 containers.add(mWorkspace.getHotseat().getShortcutsAndWidgets());
2944 mWorkspace.forEachVisiblePage(page
2945 -> containers.add(((CellLayout) page).getShortcutsAndWidgets()));
2946
2947 // Order: Preferred item by itself or in folder, then by matching package/user
2948 return getFirstMatch(containers, preferredItem, forFolderMatch(preferredItem),
2949 packageAndUserAndApp, forFolderMatch(packageAndUserAndApp));
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002950 }
2951
2952 /**
2953 * Finds the first view matching the ordered operators across the given viewgroups in order.
2954 * @param containers List of ViewGroups to scan, in order of preference.
2955 * @param operators List of operators, in order starting from best matching operator.
2956 */
Jon Mirandaf26bdcb2022-06-09 16:09:30 -07002957 @Nullable
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002958 private static View getFirstMatch(Iterable<ViewGroup> containers,
Sunny Goyal32084d42022-05-02 10:00:07 -07002959 final Predicate<ItemInfo>... operators) {
2960 for (Predicate<ItemInfo> operator : operators) {
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002961 for (ViewGroup container : containers) {
2962 View match = mapOverViewGroup(container, operator);
2963 if (match != null) {
2964 return match;
2965 }
2966 }
2967 }
2968 return null;
2969 }
2970
2971 /**
2972 * Returns the first view matching the operator in the given ViewGroups, or null if none.
2973 * Forward iteration matters.
2974 */
Jon Mirandaf26bdcb2022-06-09 16:09:30 -07002975 @Nullable
Sunny Goyal32084d42022-05-02 10:00:07 -07002976 private static View mapOverViewGroup(ViewGroup container, Predicate<ItemInfo> op) {
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002977 final int itemCount = container.getChildCount();
2978 for (int itemIdx = 0; itemIdx < itemCount; itemIdx++) {
2979 View item = container.getChildAt(itemIdx);
Sunny Goyal32084d42022-05-02 10:00:07 -07002980 if (op.test((ItemInfo) item.getTag())) {
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002981 return item;
2982 }
2983 }
2984 return null;
2985 }
2986
Winson Chungc9168342013-06-26 14:54:55 -07002987 private ValueAnimator createNewAppBounceAnimation(View v, int i) {
Sunny Goyalf0b6db72018-08-13 16:10:14 -07002988 ValueAnimator bounceAnim = new PropertyListBuilder().alpha(1).scale(1).build(v)
Sunny Goyal60e68c92020-08-12 13:59:27 -07002989 .setDuration(ItemInstallQueue.NEW_SHORTCUT_BOUNCE_DURATION);
2990 bounceAnim.setStartDelay(i * ItemInstallQueue.NEW_SHORTCUT_STAGGER_DELAY);
Sunny Goyal5a1f53b2015-05-27 10:24:24 -07002991 bounceAnim.setInterpolator(new OvershootInterpolator(BOUNCE_ANIMATION_TENSION));
Winson Chungc9168342013-06-26 14:54:55 -07002992 return bounceAnim;
2993 }
2994
Pinyao Tingc9074272019-11-11 11:51:44 -08002995 private void announceForAccessibility(@StringRes int stringResId) {
2996 getDragLayer().announceForAccessibility(getString(stringResId));
2997 }
2998
Amith Yamasani6d7fe502010-11-16 09:05:07 -08002999 /**
Josh Tsuji231c9222022-01-11 20:43:59 -05003000 * Informs us that the overlay (-1 screen, typically), has either become visible or invisible.
3001 */
Sunny Goyal82379182022-11-02 18:58:49 -07003002 public void onOverlayVisibilityChanged(boolean visible) {
3003 getStatsLogManager().logger()
3004 .withSrcState(LAUNCHER_STATE_HOME)
3005 .withDstState(LAUNCHER_STATE_HOME)
3006 .withContainerInfo(LauncherAtom.ContainerInfo.newBuilder()
3007 .setWorkspace(WorkspaceContainer.newBuilder()
3008 .setPageIndex(visible ? 0 : -1))
3009 .build())
3010 .log(visible ? LAUNCHER_SWIPELEFT : LAUNCHER_SWIPERIGHT);
3011 }
Josh Tsuji231c9222022-01-11 20:43:59 -05003012
3013 /**
3014 * Informs us that the page transition has ended, so that we can react to the newly selected
3015 * page if we want to.
3016 */
3017 public void onPageEndTransition() {}
3018
3019 /**
Joe Onorato9c1289c2009-08-17 11:03:03 -04003020 * Add the icons for all apps.
3021 *
3022 * Implementation of the method from LauncherModel.Callbacks.
3023 */
Sunny Goyal28daf4a2020-06-08 17:06:09 -07003024 @Override
Schneider Victor-tulias927d6dc2021-08-26 11:56:47 -07003025 @TargetApi(Build.VERSION_CODES.S)
Anushree Ganjam97434ee2023-05-18 22:03:16 +00003026 @UiThread
3027 public void bindAllApplications(AppInfo[] apps, int flags,
3028 Map<PackageUserKey, Integer> packageUserKeytoUidMap) {
3029 Preconditions.assertUIThread();
Sunny Goyalc80e60d2023-06-07 12:52:30 -07003030 boolean hadWorkApps = mAppsView.shouldShowTabs();
Brian Isganitise9eacb32023-07-06 22:25:18 +00003031 AllAppsStore<Launcher> appsStore = mAppsView.getAppsStore();
Anushree Ganjam97434ee2023-05-18 22:03:16 +00003032 appsStore.setApps(apps, flags, packageUserKeytoUidMap);
Sunny Goyal1818fb72020-11-09 14:32:48 -08003033 PopupContainerWithArrow.dismissInvalidPopup(this);
Sunny Goyalc80e60d2023-06-07 12:52:30 -07003034 if (hadWorkApps != mAppsView.shouldShowTabs()) {
3035 getStateManager().goToState(NORMAL);
3036 }
3037
Schneider Victor-tulias927d6dc2021-08-26 11:56:47 -07003038 if (Utilities.ATLEAST_S) {
3039 Trace.endAsyncSection(DISPLAY_ALL_APPS_TRACE_METHOD_NAME,
3040 DISPLAY_ALL_APPS_TRACE_COOKIE);
3041 }
Joe Onorato9c1289c2009-08-17 11:03:03 -04003042 }
3043
3044 /**
Zak Cohen658c67a2018-10-19 14:21:05 -07003045 * Copies LauncherModel's map of activities to shortcut counts to Launcher's. This is necessary
Tony Wickhambfbf7f92016-05-19 11:19:39 -07003046 * because LauncherModel's map is updated in the background, while Launcher runs on the UI.
3047 */
3048 @Override
Zak Cohen658c67a2018-10-19 14:21:05 -07003049 public void bindDeepShortcutMap(HashMap<ComponentKey, Integer> deepShortcutMapCopy) {
Tony Wickham010d2552017-01-20 08:15:28 -08003050 mPopupDataProvider.setDeepShortcutMap(deepShortcutMapCopy);
Tony Wickham1bce7fd2016-04-28 17:39:03 -07003051 }
3052
Sunny Goyal4390ace2014-10-13 11:33:11 -07003053 @Override
Schneider Victor-tulias6a5f4312021-01-12 19:30:02 +00003054 public void bindIncrementalDownloadProgressUpdated(AppInfo app) {
3055 mAppsView.getAppsStore().updateProgressBar(app);
Mario Bertschler08ffaae2017-03-20 11:30:27 -07003056 }
3057
3058 @Override
Sunny Goyal29947f02017-12-18 13:49:44 -08003059 public void bindWidgetsRestored(ArrayList<LauncherAppWidgetInfo> widgets) {
Sunny Goyal4390ace2014-10-13 11:33:11 -07003060 mWorkspace.widgetsRestored(widgets);
3061 }
3062
Joe Onorato9c1289c2009-08-17 11:03:03 -04003063 /**
Sunny Goyalb50cc8c2014-10-06 16:23:56 -07003064 * Some shortcuts were updated in the background.
Sunny Goyalb50cc8c2014-10-06 16:23:56 -07003065 * Implementation of the method from LauncherModel.Callbacks.
Sunny Goyald3b87ef2016-07-28 12:11:54 -07003066 *
3067 * @param updated list of shortcuts which have changed.
Sunny Goyalb50cc8c2014-10-06 16:23:56 -07003068 */
Sunny Goyal4390ace2014-10-13 11:33:11 -07003069 @Override
Sunny Goyal28f50752020-07-21 14:15:13 -07003070 public void bindWorkspaceItemsChanged(List<WorkspaceItemInfo> updated) {
Sunny Goyal4390ace2014-10-13 11:33:11 -07003071 if (!updated.isEmpty()) {
Sunny Goyal711c5962021-06-23 12:36:18 -07003072 mWorkspace.updateWorkspaceItems(updated, this);
Sunny Goyal1818fb72020-11-09 14:32:48 -08003073 PopupContainerWithArrow.dismissInvalidPopup(this);
Sunny Goyal4390ace2014-10-13 11:33:11 -07003074 }
Sunny Goyalb50cc8c2014-10-06 16:23:56 -07003075 }
3076
3077 /**
Chris Wrenaeff7ea2014-02-14 16:59:24 -05003078 * Update the state of a package, typically related to install state.
3079 *
3080 * Implementation of the method from LauncherModel.Callbacks.
3081 */
Sunny Goyale755d462014-07-22 13:48:29 -07003082 @Override
Sunny Goyal29947f02017-12-18 13:49:44 -08003083 public void bindRestoreItemsChange(HashSet<ItemInfo> updates) {
Sunny Goyal711c5962021-06-23 12:36:18 -07003084 mWorkspace.updateRestoreItems(updates, this);
Sunny Goyala22666f2014-09-18 13:25:15 -07003085 }
3086
3087 /**
Sunny Goyal3bbbabc2016-03-15 09:16:30 -07003088 * A package was uninstalled/updated. We take both the super set of packageNames
Winson Chung83892cc2013-05-01 16:53:33 -07003089 * in addition to specific applications to remove, the reason being that
3090 * this can be called when a package is updated as well. In that scenario,
Sunny Goyal3bbbabc2016-03-15 09:16:30 -07003091 * we only remove specific components from the workspace and hotseat, where as
Winson Chung83892cc2013-05-01 16:53:33 -07003092 * package-removal should clear all items by package name.
Joe Onorato9c1289c2009-08-17 11:03:03 -04003093 */
Sunny Goyal1a745e82014-10-02 15:58:31 -07003094 @Override
Sunny Goyal32084d42022-05-02 10:00:07 -07003095 public void bindWorkspaceComponentsRemoved(Predicate<ItemInfo> matcher) {
Sunny Goyal6e13dd32017-08-17 03:01:19 -07003096 mWorkspace.removeItemsByMatcher(matcher);
3097 mDragController.onAppsRemoved(matcher);
Sunny Goyal1818fb72020-11-09 14:32:48 -08003098 PopupContainerWithArrow.dismissInvalidPopup(this);
Sunny Goyal3bbbabc2016-03-15 09:16:30 -07003099 }
Sunny Goyal4390ace2014-10-13 11:33:11 -07003100
Sunny Goyal3bbbabc2016-03-15 09:16:30 -07003101 @Override
Steven Ng2f5648a2021-02-08 17:18:25 +00003102 public void bindAllWidgets(final List<WidgetsListBaseEntry> allWidgets) {
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -07003103 mPopupDataProvider.setAllWidgets(allWidgets);
Tony Wickham26b17462017-03-20 17:12:24 -07003104 }
3105
kholoud mohamedc76b2032021-12-20 16:47:38 +00003106 @Override
3107 public void bindStringCache(StringCache cache) {
3108 mStringCache = cache;
Brandon Dayauon076dcdf2023-06-08 13:52:06 -07003109 mAppsView.updateWorkUI();
kholoud mohamedc76b2032021-12-20 16:47:38 +00003110 }
3111
3112 @Override
3113 public StringCache getStringCache() {
3114 return mStringCache;
3115 }
3116
Tony Wickham86222d22017-03-29 15:30:43 -07003117 /**
3118 * @param packageUser if null, refreshes all widgets and shortcuts, otherwise only
3119 * refreshes the widgets and shortcuts associated with the given package/user
3120 */
3121 public void refreshAndBindWidgetsForPackageUser(@Nullable PackageUserKey packageUser) {
Sunny Goyalc6e97692017-06-02 13:46:55 -07003122 mModel.refreshAndBindWidgetsAndShortcuts(packageUser);
Sunny Goyal2e1efb42016-03-03 16:58:55 -08003123 }
3124
Winson Chung80baf5a2010-08-09 16:03:15 -07003125 /**
Hyunyoung Song3c7d9cb2017-01-30 15:11:27 -08003126 * $ adb shell dumpsys activity com.android.launcher3.Launcher [--all]
Joe Onoratobe386092009-11-17 17:32:16 -08003127 */
Adam Cohen16d7ffc2011-10-05 17:49:14 -07003128 @Override
3129 public void dump(String prefix, FileDescriptor fd, PrintWriter writer, String[] args) {
3130 super.dump(prefix, fd, writer, args);
Sunny Goyala1365452015-10-01 15:46:24 -07003131
Hyunyoung Song3c7d9cb2017-01-30 15:11:27 -08003132 if (args.length > 0 && TextUtils.equals(args[0], "--all")) {
3133 writer.println(prefix + "Workspace Items");
Sunny Goyal7ce471b2017-08-02 03:37:39 -07003134 for (int i = 0; i < mWorkspace.getPageCount(); i++) {
Hyunyoung Song3c7d9cb2017-01-30 15:11:27 -08003135 writer.println(prefix + " Homescreen " + i);
3136
3137 ViewGroup layout = ((CellLayout) mWorkspace.getPageAt(i)).getShortcutsAndWidgets();
3138 for (int j = 0; j < layout.getChildCount(); j++) {
3139 Object tag = layout.getChildAt(j).getTag();
3140 if (tag != null) {
3141 writer.println(prefix + " " + tag.toString());
3142 }
3143 }
3144 }
3145
3146 writer.println(prefix + " Hotseat");
Sunny Goyal876e4622018-11-02 13:50:40 -07003147 ViewGroup layout = mHotseat.getShortcutsAndWidgets();
Sunny Goyala1365452015-10-01 15:46:24 -07003148 for (int j = 0; j < layout.getChildCount(); j++) {
3149 Object tag = layout.getChildAt(j).getTag();
3150 if (tag != null) {
3151 writer.println(prefix + " " + tag.toString());
3152 }
Adam Cohen4caf2982013-08-20 18:54:31 -07003153 }
Sunny Goyala1365452015-10-01 15:46:24 -07003154 }
3155
Hyunyoung Song3c7d9cb2017-01-30 15:11:27 -08003156 writer.println(prefix + "Misc:");
Winson Chungef528762019-09-06 12:05:52 -07003157 dumpMisc(prefix + "\t", writer);
3158 writer.println(prefix + "\tmWorkspaceLoading=" + mWorkspaceLoading);
3159 writer.println(prefix + "\tmPendingRequestArgs=" + mPendingRequestArgs
3160 + " mPendingActivityResult=" + mPendingActivityResult);
3161 writer.println(prefix + "\tmRotationHelper: " + mRotationHelper);
Sihua Ma0593a0d2022-10-03 16:01:48 -07003162 writer.println(prefix + "\tmAppWidgetHolder.isListening: "
3163 + mAppWidgetHolder.isListening());
Winson Chungef528762019-09-06 12:05:52 -07003164
Tony Wickham646e4482020-04-06 17:25:53 -07003165 // Extra logging for general debugging
Hyunyoung Songa310a802019-04-25 13:57:16 -07003166 mDragLayer.dump(prefix, writer);
3167 mStateManager.dump(prefix, writer);
Tony Wickham646e4482020-04-06 17:25:53 -07003168 mPopupDataProvider.dump(prefix, writer);
Pat Manning5f74bfd2022-07-20 12:08:54 +01003169 mDeviceProfile.dump(this, prefix, writer);
Sunny Goyal2bba1902018-02-27 12:20:50 -08003170
3171 try {
3172 FileLog.flushAll(writer);
3173 } catch (Exception e) {
3174 // Ignore
3175 }
Hyunyoung Song3c7d9cb2017-01-30 15:11:27 -08003176
3177 mModel.dumpState(prefix, fd, writer, args);
Sunny Goyala1365452015-10-01 15:46:24 -07003178
Adam Cohen9211d422014-10-07 18:14:53 -07003179 if (mLauncherCallbacks != null) {
3180 mLauncherCallbacks.dump(prefix, fd, writer, args);
3181 }
Sunny Goyalb1d7de22019-09-06 10:36:54 -07003182 mOverlayManager.dump(prefix, writer);
Adam Cohen16d7ffc2011-10-05 17:49:14 -07003183 }
Adam Cohen487f7dd2012-06-28 18:12:10 -07003184
Sebastian Franco4080fdd2023-09-19 14:17:23 -07003185 /**
3186 * Populates the list of shortcuts. Logic delegated to {@Link KeyboardShortcutsDelegate}.
3187 *
3188 * @param data The data list to populate with shortcuts.
3189 * @param menu The current menu, which may be null.
3190 * @param deviceId The id for the connected device the shortcuts should be provided for.
3191 */
Sunny Goyal66b24572016-09-21 15:57:55 -07003192 @Override
Sunny Goyal66b24572016-09-21 15:57:55 -07003193 public void onProvideKeyboardShortcuts(
3194 List<KeyboardShortcutGroup> data, Menu menu, int deviceId) {
Sebastian Franco4080fdd2023-09-19 14:17:23 -07003195 mKeyboardShortcutsDelegate.onProvideKeyboardShortcuts(data, menu, deviceId);
Sunny Goyal66b24572016-09-21 15:57:55 -07003196 super.onProvideKeyboardShortcuts(data, menu, deviceId);
3197 }
3198
Sebastian Franco4080fdd2023-09-19 14:17:23 -07003199 /**
3200 * Logic delegated to {@Link KeyboardShortcutsDelegate}.
3201 * @param keyCode The value in event.getKeyCode().
3202 * @param event Description of the key event.
3203 */
Sunny Goyal66b24572016-09-21 15:57:55 -07003204 @Override
3205 public boolean onKeyShortcut(int keyCode, KeyEvent event) {
Sebastian Franco4080fdd2023-09-19 14:17:23 -07003206 Boolean result = mKeyboardShortcutsDelegate.onKeyShortcut(keyCode, event);
3207 return result != null ? result : super.onKeyShortcut(keyCode, event);
Sunny Goyal66b24572016-09-21 15:57:55 -07003208 }
3209
Sebastian Franco4080fdd2023-09-19 14:17:23 -07003210 /**
3211 * Logic delegated to {@Link KeyboardShortcutsDelegate}.
3212 * @param keyCode The value in event.getKeyCode().
3213 * @param event Description of the key event.
3214 */
Vadim Tryshev646a0dd2018-02-05 16:27:50 -08003215 @Override
Josep del Rio1d976c62023-05-04 16:07:50 +00003216 public boolean onKeyDown(int keyCode, KeyEvent event) {
Sebastian Franco4080fdd2023-09-19 14:17:23 -07003217 Boolean result = mKeyboardShortcutsDelegate.onKeyDown(keyCode, event);
3218 return result != null ? result : super.onKeyDown(keyCode, event);
Josep del Rio1d976c62023-05-04 16:07:50 +00003219 }
3220
Sebastian Franco4080fdd2023-09-19 14:17:23 -07003221 /**
3222 * Logic delegated to {@Link KeyboardShortcutsDelegate}.
3223 * @param keyCode The value in event.getKeyCode().
3224 * @param event Description of the key event.
3225 */
Josep del Rio1d976c62023-05-04 16:07:50 +00003226 @Override
Vadim Tryshev646a0dd2018-02-05 16:27:50 -08003227 public boolean onKeyUp(int keyCode, KeyEvent event) {
Sebastian Franco4080fdd2023-09-19 14:17:23 -07003228 Boolean result = mKeyboardShortcutsDelegate.onKeyUp(keyCode, event);
3229 return result != null ? result : super.onKeyUp(keyCode, event);
Vadim Tryshev646a0dd2018-02-05 16:27:50 -08003230 }
3231
Sunny Goyal831212e2021-05-14 14:24:09 -07003232 /**
3233 * Shows the default options popup
3234 */
3235 public void showDefaultOptions(float x, float y) {
Brian Isganitisa85ae692021-09-23 19:56:24 -04003236 OptionsPopupView.show(this, getPopupTarget(x, y), OptionsPopupView.getOptions(this),
3237 false);
3238 }
3239
3240 /**
3241 * Returns target rectangle for anchoring a popup menu.
3242 */
3243 protected RectF getPopupTarget(float x, float y) {
Sunny Goyal831212e2021-05-14 14:24:09 -07003244 float halfSize = getResources().getDimension(R.dimen.options_menu_thumb_size) / 2;
3245 if (x < 0 || y < 0) {
3246 x = mDragLayer.getWidth() / 2;
3247 y = mDragLayer.getHeight() / 2;
3248 }
Brian Isganitisa85ae692021-09-23 19:56:24 -04003249 return new RectF(x - halfSize, y - halfSize, x + halfSize, y + halfSize);
3250 }
3251
3252 @Override
Charlie Anderson8ad91442023-01-09 13:55:59 -05003253 public boolean canUseMultipleShadesForPopup() {
Brian Isganitisa85ae692021-09-23 19:56:24 -04003254 return getTopOpenViewWithType(this, TYPE_FOLDER) == null
3255 && getStateManager().getState() != LauncherState.ALL_APPS;
Sunny Goyal831212e2021-05-14 14:24:09 -07003256 }
3257
Sunny Goyalb5181c82021-03-10 07:39:12 +00003258 @Override
3259 protected void collectStateHandlers(List<StateHandler> out) {
3260 out.add(getAllAppsController());
3261 out.add(getWorkspace());
Andrew Sappersteinabef55a2016-06-19 12:49:00 -07003262 }
3263
Sunny Goyal210e1742019-10-17 12:05:38 -07003264 public TouchController[] createTouchControllers() {
3265 return new TouchController[] {getDragController(), new AllAppsSwipeController(this)};
3266 }
3267
Sunny Goyal1eb11242022-09-09 17:14:45 -07003268 public void onDragLayerHierarchyChanged() {
3269 updateDisallowBack();
3270 }
3271
Vinit Nayak65460402023-08-11 15:40:07 -07003272 protected void addBackAnimationCallback(BackPressHandler callback) {
3273 mBackPressedHandlers.add(callback);
3274 }
3275
3276 protected void removeBackAnimationCallback(BackPressHandler callback) {
3277 mBackPressedHandlers.remove(callback);
3278 }
3279
Sunny Goyal1eb11242022-09-09 17:14:45 -07003280 private void updateDisallowBack() {
Sukesh Ram3f2338a2023-08-28 18:31:54 +00003281 if (DESKTOP_MODE_SUPPORTED) {
Ats Jenk8121e0d2022-12-01 11:34:43 -08003282 // Do not disable back in launcher when prototype behavior is enabled
3283 return;
3284 }
Sunny Goyal1eb11242022-09-09 17:14:45 -07003285 LauncherRootView rv = getRootView();
3286 if (rv != null) {
Vinit Nayak65460402023-08-11 15:40:07 -07003287 boolean isSplitSelectionEnabled = isSplitSelectionEnabled();
Sunny Goyal1eb11242022-09-09 17:14:45 -07003288 boolean disableBack = getStateManager().getState() == NORMAL
Vinit Nayak65460402023-08-11 15:40:07 -07003289 && AbstractFloatingView.getTopOpenView(this) == null
3290 && !isSplitSelectionEnabled;
Sunny Goyal1eb11242022-09-09 17:14:45 -07003291 rv.setDisallowBackGesture(disableBack);
3292 }
3293 }
Sunny Goyal210e1742019-10-17 12:05:38 -07003294
Vinit Nayak65460402023-08-11 15:40:07 -07003295 /** To be overridden by subclasses */
3296 protected boolean isSplitSelectionEnabled() {
3297 // Overridden
3298 return false;
3299 }
3300
Vinit Nayakf9b585b2019-07-10 14:25:32 -07003301 @Override
3302 public void returnToHomescreen() {
3303 super.returnToHomescreen();
3304 getStateManager().goToState(LauncherState.NORMAL);
3305 }
3306
Sebastian Franco4080fdd2023-09-19 14:17:23 -07003307 public void closeOpenViews() {
Andy Wickham65ced1b2020-03-07 02:14:19 +00003308 closeOpenViews(true);
3309 }
3310
3311 protected void closeOpenViews(boolean animate) {
3312 AbstractFloatingView.closeAllOpenViews(this, animate);
3313 }
3314
Sunny Goyal3a1eadd2019-10-23 17:44:27 -07003315 public Stream<SystemShortcut.Factory> getSupportedShortcuts() {
Samuel Fufa5cf3e862020-02-03 20:22:54 -08003316 return Stream.of(APP_INFO, WIDGETS, INSTALL);
Sunny Goyal3a1eadd2019-10-23 17:44:27 -07003317 }
3318
Sunny Goyal384b5782021-02-09 22:50:02 -08003319 protected LauncherAccessibilityDelegate createAccessibilityDelegate() {
3320 return new LauncherAccessibilityDelegate(this);
3321 }
Sunny Goyalf2393f12020-04-01 20:13:12 -07003322
Schneider Victor-tulias7cd0ae32023-03-21 11:46:18 -07003323 /** Enables/disabled the hotseat prediction icon long press edu for testing. */
3324 @VisibleForTesting
3325 public void enableHotseatEdu(boolean enable) {}
3326
Sunny Goyalf2393f12020-04-01 20:13:12 -07003327 /**
3328 * @see LauncherState#getOverviewScaleAndOffset(Launcher)
3329 */
3330 public float[] getNormalOverviewScaleAndOffset() {
Tony Wickham82d5a062021-05-14 14:37:12 -07003331 return new float[] {NO_SCALE, NO_OFFSET};
Sunny Goyalf2393f12020-04-01 20:13:12 -07003332 }
3333
Sunny Goyal210e1742019-10-17 12:05:38 -07003334 public static Launcher getLauncher(Context context) {
Winson Chung8687bc22020-02-27 23:34:24 -08003335 return fromContext(context);
Sunny Goyal210e1742019-10-17 12:05:38 -07003336 }
3337
Sunny Goyal3dce5f32017-10-05 11:40:05 -07003338 /**
Sunny Goyalab770a12018-11-14 15:17:26 -08003339 * Just a wrapper around the type cast to allow easier tracking of calls.
3340 */
3341 public static <T extends Launcher> T cast(ActivityContext activityContext) {
3342 return (T) activityContext;
3343 }
3344
Sunny Goyalb65d7662021-03-07 15:09:11 -08003345 public boolean supportsAdaptiveIconAnimation(View clickedView) {
3346 return false;
3347 }
3348
Schneider Victor-tulias9b6babf2022-03-24 14:47:32 -07003349 /**
3350 * Animates Launcher elements during a transition to the All Apps page.
3351 *
3352 * @param progress Transition progress from 0 to 1; where 0 => home and 1 => all apps.
3353 */
3354 public void onAllAppsTransition(float progress) {
3355 // No-Op
3356 }
3357
3358 /**
3359 * Animates Launcher elements during a transition to the Widgets pages.
3360 *
3361 * @param progress Transition progress from 0 to 1; where 0 => home and 1 => widgets.
3362 */
3363 public void onWidgetsTransition(float progress) {
Alex Chau3d2c0622022-09-01 21:28:14 +01003364 float scale = Utilities.mapToRange(progress, 0f, 1f, 1f,
3365 mDeviceProfile.bottomSheetWorkspaceScale, EMPHASIZED);
3366 WORKSPACE_WIDGET_SCALE.set(getWorkspace(), scale);
3367 HOTSEAT_WIDGET_SCALE.set(getHotseat(), scale);
Schneider Victor-tulias9b6babf2022-03-24 14:47:32 -07003368 }
3369
Sunny Goyal6c0c61a2020-12-08 19:19:56 -08003370 private static class NonConfigInstance {
3371 public Configuration config;
Sunny Goyal6c0c61a2020-12-08 19:19:56 -08003372 }
thiruramc96873c2021-02-11 15:13:47 -08003373
3374 @Override
3375 public StatsLogManager getStatsLogManager() {
3376 return super.getStatsLogManager().withDefaultInstanceId(mAllAppsSessionLogId);
3377 }
Brian Isganitis149dbcb2021-11-08 18:12:38 -05003378
3379 /**
3380 * Returns the current popup for testing, if any.
3381 */
3382 @VisibleForTesting
3383 @Nullable
3384 public ArrowPopup<?> getOptionsPopup() {
3385 return findViewById(R.id.popup_container);
3386 }
Schneider Victor-tulias789a6a92022-03-04 12:06:09 -08003387
3388 /** Pauses view updates that should not be run during the app launch animation. */
3389 public void pauseExpensiveViewUpdates() {
3390 // Pause page indicator animations as they lead to layer trashing.
Shikha Malhotrae957b602022-04-11 07:57:18 +00003391 getWorkspace().getPageIndicator().pauseAnimations();
Jon Miranda46ecc0c2022-06-02 11:34:15 -07003392
3393 getWorkspace().mapOverItems((info, view) -> {
3394 if (view instanceof LauncherAppWidgetHostView) {
3395 ((LauncherAppWidgetHostView) view).beginDeferringUpdates();
3396 }
3397 return false; // Return false to continue iterating through all the items.
3398 });
Schneider Victor-tulias789a6a92022-03-04 12:06:09 -08003399 }
3400
3401 /** Resumes view updates at the end of the app launch animation. */
3402 public void resumeExpensiveViewUpdates() {
Shikha Malhotrae957b602022-04-11 07:57:18 +00003403 getWorkspace().getPageIndicator().skipAnimationsToEnd();
Shikha Malhotra0f2e1b62022-03-27 21:02:21 +00003404
Jon Miranda46ecc0c2022-06-02 11:34:15 -07003405 getWorkspace().mapOverItems((info, view) -> {
3406 if (view instanceof LauncherAppWidgetHostView) {
3407 ((LauncherAppWidgetHostView) view).endDeferringUpdates();
3408 }
3409 return false; // Return false to continue iterating through all the items.
3410 });
3411 }
Ats Jenkca009e42023-01-06 09:52:40 -08003412
3413 /**
3414 * Returns {@code true} if there are visible tasks with windowing mode set to
3415 * {@link android.app.WindowConfiguration#WINDOWING_MODE_FREEFORM}
3416 */
3417 public boolean areFreeformTasksVisible() {
3418 return false; // Base launcher does not track freeform tasks
3419 }
Brian Isganitisf54c6fa2023-07-11 12:47:08 -04003420
3421 @Override
3422 public View.OnLongClickListener getAllAppsItemLongClickListener() {
3423 return ItemLongClickListener.INSTANCE_ALL_APPS;
3424 }
Jeremy Sim94fd07e2023-04-19 20:56:49 -07003425
3426 /**
3427 * Handles an app pair launch; overridden in
3428 * {@link com.android.launcher3.uioverrides.QuickstepLauncher}
3429 */
3430 public void launchAppPair(WorkspaceItemInfo app1, WorkspaceItemInfo app2) {
3431 // Overridden
3432 }
Sunny Goyal0ee66472023-08-17 16:19:22 -07003433
3434 /**
3435 * Returns the animation coordinator for playing one-off animations
3436 */
3437 public CannedAnimationCoordinator getAnimationCoordinator() {
3438 return mAnimationCoordinator;
3439 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08003440}