blob: 79325311a6b9e8c3dfed69807de335ff6555e542 [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;
Andy Wickhama6013412024-01-18 18:45:52 -080022import static android.view.WindowInsetsAnimation.Callback.DISPATCH_MODE_CONTINUE_ON_SUBTREE;
Sunny Goyal8f965462020-04-23 19:00:36 -070023import static android.view.accessibility.AccessibilityEvent.TYPE_WINDOW_STATE_CHANGED;
Vinit Nayak48b28022020-04-27 20:48:49 +000024
Kateryna Ivanova71203732023-05-24 15:09:00 +000025import static com.android.app.animation.Interpolators.EMPHASIZED;
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;
Brian Isganitisa85ae692021-09-23 19:56:24 -040029import static com.android.launcher3.AbstractFloatingView.getTopOpenViewWithType;
Fengjiang Li8bd66ee2024-01-26 10:00:47 -080030import static com.android.launcher3.Flags.enableAddAppWidgetViaConfigActivityV2;
fbaron9d08e0f2024-04-24 11:26:01 -070031import static com.android.launcher3.Flags.enableSmartspaceRemovalToggle;
Sunny Goyal72a74662024-02-14 12:32:59 -080032import static com.android.launcher3.Flags.enableWorkspaceInflation;
Alex Chau0c4e11b2022-07-08 18:41:36 +010033import static com.android.launcher3.LauncherAnimUtils.HOTSEAT_SCALE_PROPERTY_FACTORY;
34import static com.android.launcher3.LauncherAnimUtils.SCALE_INDEX_WIDGET_TRANSITION;
Sunny Goyal4c7f2152017-10-17 17:17:16 -070035import static com.android.launcher3.LauncherAnimUtils.SPRING_LOADED_EXIT_DELAY;
Alex Chau0c4e11b2022-07-08 18:41:36 +010036import static com.android.launcher3.LauncherAnimUtils.WORKSPACE_SCALE_PROPERTY_FACTORY;
Sebastian Franco974cc942023-10-19 14:22:06 -070037import static com.android.launcher3.LauncherConstants.ActivityCodes.REQUEST_BIND_APPWIDGET;
38import static com.android.launcher3.LauncherConstants.ActivityCodes.REQUEST_BIND_PENDING_APPWIDGET;
39import static com.android.launcher3.LauncherConstants.ActivityCodes.REQUEST_CREATE_APPWIDGET;
40import static com.android.launcher3.LauncherConstants.ActivityCodes.REQUEST_CREATE_SHORTCUT;
Himanshu Gupta261a6222024-05-31 12:35:09 +010041import static com.android.launcher3.LauncherConstants.ActivityCodes.REQUEST_HOME_ROLE;
Sebastian Franco974cc942023-10-19 14:22:06 -070042import static com.android.launcher3.LauncherConstants.ActivityCodes.REQUEST_PICK_APPWIDGET;
43import static com.android.launcher3.LauncherConstants.ActivityCodes.REQUEST_RECONFIGURE_APPWIDGET;
44import static com.android.launcher3.LauncherConstants.SavedInstanceKeys.RUNTIME_STATE;
45import static com.android.launcher3.LauncherConstants.SavedInstanceKeys.RUNTIME_STATE_CURRENT_SCREEN_IDS;
46import static com.android.launcher3.LauncherConstants.SavedInstanceKeys.RUNTIME_STATE_PENDING_ACTIVITY_RESULT;
47import static com.android.launcher3.LauncherConstants.SavedInstanceKeys.RUNTIME_STATE_PENDING_REQUEST_ARGS;
48import static com.android.launcher3.LauncherConstants.SavedInstanceKeys.RUNTIME_STATE_PENDING_REQUEST_CODE;
Alex Chau007abe82024-12-02 14:29:38 +000049import static com.android.launcher3.LauncherConstants.SavedInstanceKeys.RUNTIME_STATE_RECREATE_TO_UPDATE_THEME;
Sebastian Franco974cc942023-10-19 14:22:06 -070050import static com.android.launcher3.LauncherConstants.SavedInstanceKeys.RUNTIME_STATE_WIDGET_PANEL;
51import static com.android.launcher3.LauncherConstants.TraceEvents.COLD_STARTUP_TRACE_COOKIE;
52import static com.android.launcher3.LauncherConstants.TraceEvents.COLD_STARTUP_TRACE_METHOD_NAME;
53import static com.android.launcher3.LauncherConstants.TraceEvents.DISPLAY_ALL_APPS_TRACE_COOKIE;
54import static com.android.launcher3.LauncherConstants.TraceEvents.DISPLAY_ALL_APPS_TRACE_METHOD_NAME;
Sebastian Franco974cc942023-10-19 14:22:06 -070055import static com.android.launcher3.LauncherConstants.TraceEvents.DISPLAY_WORKSPACE_TRACE_COOKIE;
Sebastian Franco50b74c32023-11-16 11:36:49 -060056import static com.android.launcher3.LauncherConstants.TraceEvents.DISPLAY_WORKSPACE_TRACE_METHOD_NAME;
Sebastian Franco974cc942023-10-19 14:22:06 -070057import static com.android.launcher3.LauncherConstants.TraceEvents.ON_CREATE_EVT;
58import static com.android.launcher3.LauncherConstants.TraceEvents.ON_NEW_INTENT_EVT;
59import static com.android.launcher3.LauncherConstants.TraceEvents.ON_RESUME_EVT;
60import static com.android.launcher3.LauncherConstants.TraceEvents.ON_START_EVT;
Sunny Goyal669b71f2023-01-27 14:37:07 -080061import static com.android.launcher3.LauncherSettings.Favorites.CONTAINER_DESKTOP;
Jon Mirandac4a99bf2021-11-04 16:53:45 -070062import static com.android.launcher3.LauncherSettings.Favorites.ITEM_TYPE_APPLICATION;
Sunny Goyal3e3f44c2017-10-23 17:14:52 -070063import static com.android.launcher3.LauncherState.ALL_APPS;
Charlie Anderson438d4052023-04-25 14:38:57 -040064import static com.android.launcher3.LauncherState.EDIT_MODE;
Sunny Goyal8f965462020-04-23 19:00:36 -070065import static com.android.launcher3.LauncherState.FLAG_MULTI_PAGE;
66import static com.android.launcher3.LauncherState.FLAG_NON_INTERACTIVE;
Sunny Goyal3e3f44c2017-10-23 17:14:52 -070067import static com.android.launcher3.LauncherState.NORMAL;
Sunny Goyalf2393f12020-04-01 20:13:12 -070068import static com.android.launcher3.LauncherState.NO_OFFSET;
69import static com.android.launcher3.LauncherState.NO_SCALE;
Sunny Goyal8f965462020-04-23 19:00:36 -070070import static com.android.launcher3.LauncherState.SPRING_LOADED;
Sunny Goyalb1d7de22019-09-06 10:36:54 -070071import static com.android.launcher3.Utilities.postAsyncCallback;
Sebastián Franco1f4d56c2023-08-08 03:29:10 +000072import static com.android.launcher3.config.FeatureFlags.FOLDABLE_SINGLE_PAGE;
Charlie Anderson438d4052023-04-25 14:38:57 -040073import static com.android.launcher3.config.FeatureFlags.MULTI_SELECT_EDIT_MODE;
Sebastian Francoc794aca2024-07-17 16:18:20 -070074import static com.android.launcher3.folder.FolderGridOrganizer.createFolderGridOrganizer;
Andy Wickhama6013412024-01-18 18:45:52 -080075import static com.android.launcher3.logging.KeyboardStateManager.KeyboardState.HIDE;
76import static com.android.launcher3.logging.KeyboardStateManager.KeyboardState.SHOW;
Thiru Ramasamy5fbac632022-01-28 15:05:36 -080077import static com.android.launcher3.logging.StatsLogManager.EventEnum;
Hyunyoung Song801f81f2020-06-19 02:58:53 -070078import static com.android.launcher3.logging.StatsLogManager.LAUNCHER_STATE_BACKGROUND;
Hyunyoung Song95786e02020-09-15 00:34:10 -070079import static com.android.launcher3.logging.StatsLogManager.LAUNCHER_STATE_HOME;
thiruram9f53d612021-02-24 10:54:01 -080080import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_ALLAPPS_ENTRY_WITH_DEVICE_SEARCH;
thiruramc96873c2021-02-11 15:13:47 -080081import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_ALLAPPS_EXIT;
Hyunyoung Song801f81f2020-06-19 02:58:53 -070082import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_ONRESUME;
83import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_ONSTOP;
Vinit Nayak5a9d4af2024-01-31 12:49:05 -080084import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_SPLIT_SELECTION_EXIT_HOME;
Sunny Goyal82379182022-11-02 18:58:49 -070085import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_SWIPELEFT;
86import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_SWIPERIGHT;
Yogisha Dixit4ff5ee32021-05-04 14:58:34 +010087import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_WIDGET_RECONFIGURED;
Fengjiang Li5a36c172023-04-13 18:18:27 +000088import static com.android.launcher3.logging.StatsLogManager.LauncherLatencyEvent.LAUNCHER_LATENCY_STARTUP_ACTIVITY_ON_CREATE;
89import static com.android.launcher3.logging.StatsLogManager.LauncherLatencyEvent.LAUNCHER_LATENCY_STARTUP_TOTAL_DURATION;
90import static com.android.launcher3.logging.StatsLogManager.LauncherLatencyEvent.LAUNCHER_LATENCY_STARTUP_VIEW_INFLATION;
Fengjiang Li5a36c172023-04-13 18:18:27 +000091import static com.android.launcher3.logging.StatsLogManager.StatsLatencyLogger.LatencyType.COLD;
92import static com.android.launcher3.logging.StatsLogManager.StatsLatencyLogger.LatencyType.COLD_DEVICE_REBOOTING;
93import static com.android.launcher3.logging.StatsLogManager.StatsLatencyLogger.LatencyType.WARM;
Sunny Goyal60e68c92020-08-12 13:59:27 -070094import static com.android.launcher3.model.ItemInstallQueue.FLAG_ACTIVITY_PAUSED;
95import static com.android.launcher3.model.ItemInstallQueue.FLAG_DRAG_AND_DROP;
Sunny Goyal3a1eadd2019-10-23 17:44:27 -070096import static com.android.launcher3.popup.SystemShortcut.APP_INFO;
Sunny Goyal3a1eadd2019-10-23 17:44:27 -070097import static com.android.launcher3.popup.SystemShortcut.INSTALL;
98import static com.android.launcher3.popup.SystemShortcut.WIDGETS;
Sunny Goyal8f965462020-04-23 19:00:36 -070099import static com.android.launcher3.states.RotationHelper.REQUEST_LOCK;
Sunny Goyalbe8c3402019-05-22 15:17:52 -0700100import static com.android.launcher3.states.RotationHelper.REQUEST_NONE;
Vadim Tryshev1b058fd2023-11-28 18:26:43 -0800101import static com.android.launcher3.testing.shared.TestProtocol.LAUNCHER_ACTIVITY_STOPPED_MESSAGE;
Jeremy Sim7cf0dd92023-03-24 22:39:45 -0700102import static com.android.launcher3.util.Executors.MAIN_EXECUTOR;
Jon Mirandac4a99bf2021-11-04 16:53:45 -0700103import static com.android.launcher3.util.ItemInfoMatcher.forFolderMatch;
Tracy Zhoude8e25c2023-10-07 00:00:57 -0700104import static com.android.launcher3.util.SettingsCache.TOUCHPAD_NATURAL_SCROLLING;
Sunny Goyal326403e2017-10-02 12:45:10 -0700105
Gilles Debunnedd6c9922010-10-25 11:23:41 -0700106import android.animation.Animator;
Gilles Debunnedd6c9922010-10-25 11:23:41 -0700107import android.animation.AnimatorSet;
Gilles Debunnedd6c9922010-10-25 11:23:41 -0700108import android.animation.ValueAnimator;
Adam Cohen0b395352014-06-09 22:54:36 +0000109import android.annotation.TargetApi;
Tony Wickhame78a70b2021-03-29 16:45:59 -0700110import android.app.Notification;
111import android.app.NotificationChannel;
112import android.app.NotificationManager;
113import android.app.PendingIntent;
Adam Cohen0cf2a7c2011-11-08 15:07:01 -0800114import android.appwidget.AppWidgetHostView;
Michael Jurkaaf442092010-06-10 17:01:57 -0700115import android.appwidget.AppWidgetManager;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800116import android.content.ActivityNotFoundException;
Michael Jurkae326f182011-11-21 14:05:46 -0800117import android.content.ComponentCallbacks2;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800118import android.content.Context;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800119import android.content.Intent;
Adam Cohen173f7112015-03-27 15:14:00 -0700120import android.content.IntentSender;
Winson Chung82f55532011-08-09 14:14:23 -0700121import android.content.SharedPreferences;
Sunny Goyalf8d56fc2018-01-31 15:18:11 -0800122import android.content.res.Configuration;
Adam Cohen3f9c9712014-10-31 11:48:25 -0700123import android.database.sqlite.SQLiteDatabase;
Fengjiang Li8bd66ee2024-01-26 10:00:47 -0800124import android.graphics.Bitmap;
125import android.graphics.Canvas;
Sunny Goyal5cd1b192023-04-06 22:33:11 +0000126import android.graphics.Color;
Tony Wickham1906cc32021-02-11 11:55:24 -0800127import android.graphics.Rect;
Sunny Goyal831212e2021-05-14 14:24:09 -0700128import android.graphics.RectF;
Adam Cohen0f668f32014-09-08 19:54:17 +0200129import android.os.Build;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800130import android.os.Bundle;
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -0700131import android.os.Parcelable;
Winson Chunga2413752012-04-03 14:22:34 -0700132import android.os.StrictMode;
Riddle Hsu979da642020-09-22 21:52:40 +0800133import android.os.SystemClock;
Schneider Victor-tulias927d6dc2021-08-26 11:56:47 -0700134import android.os.Trace;
Jon Mirandac4a99bf2021-11-04 16:53:45 -0700135import android.os.UserHandle;
Michael Jurkaa33411c2012-06-14 16:18:21 -0700136import android.text.TextUtils;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800137import android.text.method.TextKeyListener;
Alex Chau0c4e11b2022-07-08 18:41:36 +0100138import android.util.FloatProperty;
Joe Onorato7c312c12009-08-13 21:36:53 -0700139import android.util.Log;
Sunny Goyaleb5684c2024-01-29 13:37:08 -0800140import android.util.Pair;
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -0700141import android.util.SparseArray;
Adam Cohen96d30a12013-07-16 18:13:21 -0700142import android.view.KeyEvent;
Sunny Goyal66b24572016-09-21 15:57:55 -0700143import android.view.KeyboardShortcutGroup;
Adam Cohen96d30a12013-07-16 18:13:21 -0700144import android.view.Menu;
vadimt9af34a72020-01-21 11:19:13 -0800145import android.view.MotionEvent;
Adam Cohen96d30a12013-07-16 18:13:21 -0700146import android.view.View;
Adam Cohen96d30a12013-07-16 18:13:21 -0700147import android.view.ViewGroup;
Sunny Goyal7b8d63f2022-04-14 16:37:32 -0700148import android.view.ViewTreeObserver.OnPreDrawListener;
Andy Wickhama6013412024-01-18 18:45:52 -0800149import android.view.WindowInsets;
150import android.view.WindowInsetsAnimation;
Schneider Victor-tulias25ecae12020-09-14 14:07:38 -0700151import android.view.WindowManager.LayoutParams;
Svetoslav Ganov815ba2d2011-01-07 14:55:17 -0800152import android.view.accessibility.AccessibilityEvent;
Sunny Goyal5a1f53b2015-05-27 10:24:24 -0700153import android.view.animation.OvershootInterpolator;
Himanshu Gupta261a6222024-05-31 12:35:09 +0100154import android.widget.Toast;
Fengjiang Lib7860bd2023-03-15 10:50:50 -0700155import android.window.BackEvent;
156import android.window.OnBackAnimationCallback;
Sunny Goyala1d1bf32015-06-26 13:24:53 -0700157
Sunny Goyal35e7d382020-05-08 13:37:58 -0700158import androidx.annotation.CallSuper;
Andras Kloczl55edfe52021-05-14 12:21:30 +0200159import androidx.annotation.NonNull;
Sunny Goyal11a50742019-08-07 09:24:26 -0700160import androidx.annotation.Nullable;
Fengjiang Lid0c23592023-04-20 16:42:25 -0700161import androidx.annotation.RequiresApi;
Pinyao Tingc9074272019-11-11 11:51:44 -0800162import androidx.annotation.StringRes;
Anushree Ganjam97434ee2023-05-18 22:03:16 +0000163import androidx.annotation.UiThread;
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700164import androidx.annotation.VisibleForTesting;
Anton Vayvodee382242024-05-28 21:26:25 -0400165import androidx.core.os.BuildCompat;
Sebastian Franco9ae40322023-10-10 10:50:28 -0700166import androidx.window.embedding.RuleController;
Sunny Goyal11a50742019-08-07 09:24:26 -0700167
Sunny Goyal651077b2014-06-30 14:15:31 -0700168import com.android.launcher3.DropTarget.DragObject;
Sunny Goyalae502842016-06-17 08:43:56 -0700169import com.android.launcher3.accessibility.LauncherAccessibilityDelegate;
Brian Isganitis1664c9f2022-01-14 23:15:47 -0500170import com.android.launcher3.allapps.ActivityAllAppsContainerView;
Jon Mirandaf58db152022-06-02 16:06:37 -0700171import com.android.launcher3.allapps.AllAppsRecyclerView;
Hyunyoung Song645764e2016-06-06 14:19:02 -0700172import com.android.launcher3.allapps.AllAppsTransitionController;
Sunny Goyal7ede6112017-12-05 15:11:21 -0800173import com.android.launcher3.allapps.DiscoveryBounce;
Holly Sund9d70ea2023-09-05 13:14:22 -0700174import com.android.launcher3.anim.AnimationSuccessListener;
Sunny Goyalf0b6db72018-08-13 16:10:14 -0700175import com.android.launcher3.anim.PropertyListBuilder;
Jeremy Sim94fd07e2023-04-19 20:56:49 -0700176import com.android.launcher3.apppairs.AppPairIcon;
Sunny Goyal669b71f2023-01-27 14:37:07 -0800177import com.android.launcher3.celllayout.CellPosMapper;
178import com.android.launcher3.celllayout.CellPosMapper.CellPos;
Sebastian Franco09589322022-11-02 15:25:58 -0700179import com.android.launcher3.celllayout.CellPosMapper.TwoPanelCellPosMapper;
Sunny Goyal8f965462020-04-23 19:00:36 -0700180import com.android.launcher3.compat.AccessibilityManagerCompat;
Tony Wickhame0c33232016-02-08 11:37:04 -0800181import com.android.launcher3.config.FeatureFlags;
Sebastian Franco224f67a2024-04-18 18:40:40 -0700182import com.android.launcher3.debug.TestEvent;
183import com.android.launcher3.debug.TestEventEmitter;
vadimt00d42552018-12-11 17:59:36 -0800184import com.android.launcher3.dot.DotInfo;
Vadim Tryshevfedca432015-08-19 17:55:02 -0700185import com.android.launcher3.dragndrop.DragController;
186import com.android.launcher3.dragndrop.DragLayer;
187import com.android.launcher3.dragndrop.DragView;
Sunny Goyal59969372021-05-06 12:11:44 -0700188import com.android.launcher3.dragndrop.LauncherDragController;
Federico Baron8bf1bca2022-09-27 16:19:11 -0700189import com.android.launcher3.folder.Folder;
Sunny Goyal26119432016-02-18 22:09:23 +0000190import com.android.launcher3.folder.FolderIcon;
Sunny Goyalf840f102018-09-21 14:41:05 -0700191import com.android.launcher3.icons.IconCache;
Sunny Goyal3333b0c2016-05-09 20:43:21 -0700192import com.android.launcher3.keyboard.ViewGroupFocusHelper;
Hyunyoung Song801f81f2020-06-19 02:58:53 -0700193import com.android.launcher3.logger.LauncherAtom;
Thiru Ramasamy5fbac632022-01-28 15:05:36 -0800194import com.android.launcher3.logger.LauncherAtom.ContainerInfo;
195import com.android.launcher3.logger.LauncherAtom.WorkspaceContainer;
Fengjiang Lie5f91a42023-11-16 16:12:04 -0800196import com.android.launcher3.logging.ColdRebootStartupLatencyLogger;
Sunny Goyala7ce1662016-05-31 15:01:35 -0700197import com.android.launcher3.logging.FileLog;
thiruramc96873c2021-02-11 15:13:47 -0800198import com.android.launcher3.logging.InstanceId;
199import com.android.launcher3.logging.InstanceIdSequence;
Fengjiang Li5a36c172023-04-13 18:18:27 +0000200import com.android.launcher3.logging.StartupLatencyLogger;
Hyunyoung Song801f81f2020-06-19 02:58:53 -0700201import com.android.launcher3.logging.StatsLogManager;
Sebastian Franco0b461ef2023-12-08 12:20:07 -0600202import com.android.launcher3.logging.StatsLogManager.LauncherLatencyEvent;
Sunny Goyal87dcde62019-07-17 20:35:56 -0700203import com.android.launcher3.model.BgDataModel.Callbacks;
Sunny Goyal60e68c92020-08-12 13:59:27 -0700204import com.android.launcher3.model.ItemInstallQueue;
Sunny Goyala535ae42017-02-27 10:07:13 -0800205import com.android.launcher3.model.ModelWriter;
kholoud mohamedc76b2032021-12-20 16:47:38 +0000206import com.android.launcher3.model.StringCache;
Sunny Goyale396abf2020-04-06 15:11:17 -0700207import com.android.launcher3.model.data.AppInfo;
Jeremy Sim742630c2024-03-22 22:11:18 -0700208import com.android.launcher3.model.data.AppPairInfo;
209import com.android.launcher3.model.data.CollectionInfo;
Sunny Goyale396abf2020-04-06 15:11:17 -0700210import com.android.launcher3.model.data.FolderInfo;
211import com.android.launcher3.model.data.ItemInfo;
212import com.android.launcher3.model.data.LauncherAppWidgetInfo;
Sunny Goyale396abf2020-04-06 15:11:17 -0700213import com.android.launcher3.model.data.WorkspaceItemInfo;
Sunny Goyala535ae42017-02-27 10:07:13 -0800214import com.android.launcher3.notification.NotificationListener;
Sunny Goyale7b00122019-10-02 16:13:34 -0700215import com.android.launcher3.pm.PinRequestHelper;
Brian Isganitis149dbcb2021-11-08 18:12:38 -0500216import com.android.launcher3.popup.ArrowPopup;
Sunny Goyala535ae42017-02-27 10:07:13 -0800217import com.android.launcher3.popup.PopupDataProvider;
Sunny Goyal3a1eadd2019-10-23 17:44:27 -0700218import com.android.launcher3.popup.SystemShortcut;
Sunny Goyal35e7d382020-05-08 13:37:58 -0700219import com.android.launcher3.statemanager.StateManager;
220import com.android.launcher3.statemanager.StateManager.StateHandler;
Sunny Goyal35e7d382020-05-08 13:37:58 -0700221import com.android.launcher3.statemanager.StatefulActivity;
Sunny Goyal623eddd2018-03-02 12:24:41 -0800222import com.android.launcher3.states.RotationHelper;
vadimt9af34a72020-01-21 11:19:13 -0800223import com.android.launcher3.testing.TestLogging;
vadimtf6ef8792022-07-26 13:54:31 -0700224import com.android.launcher3.testing.shared.TestProtocol;
Sunny Goyal210e1742019-10-17 12:05:38 -0700225import com.android.launcher3.touch.AllAppsSwipeController;
Brian Isganitisf54c6fa2023-07-11 12:47:08 -0400226import com.android.launcher3.touch.ItemLongClickListener;
Sunny Goyal2100c782016-08-22 16:00:03 -0700227import com.android.launcher3.util.ActivityResultInfo;
Vinit Nayak65460402023-08-11 15:40:07 -0700228import com.android.launcher3.util.BackPressHandler;
Sukesh Ram3f2338a2023-08-28 18:31:54 +0000229import com.android.launcher3.util.CannedAnimationCoordinator;
Winson Chung6b1c73f2015-06-18 11:38:42 -0700230import com.android.launcher3.util.ComponentKey;
Schneider Victor-Tulias8463dc42024-10-22 15:29:59 -0400231import com.android.launcher3.util.ContextTracker;
Sunny Goyalefb7e842018-10-04 15:11:00 -0700232import com.android.launcher3.util.IntArray;
Andras Kloczl55edfe52021-05-14 12:21:30 +0200233import com.android.launcher3.util.IntSet;
Sunny Goyal4e014232024-01-18 13:53:45 -0800234import com.android.launcher3.util.ItemInflater;
Sebastian Franco4080fdd2023-09-19 14:17:23 -0700235import com.android.launcher3.util.KeyboardShortcutsDelegate;
Fengjiang Li5a36c172023-04-13 18:18:27 +0000236import com.android.launcher3.util.LockedUserState;
Juan Sebastian Martinez4c35e502024-11-13 12:07:32 -0800237import com.android.launcher3.util.MSDLPlayerWrapper;
Tony Wickham010d2552017-01-20 08:15:28 -0800238import com.android.launcher3.util.PackageUserKey;
Sunny Goyal2100c782016-08-22 16:00:03 -0700239import com.android.launcher3.util.PendingRequestArgs;
Sunny Goyal4a22ed82024-04-08 11:56:50 -0700240import com.android.launcher3.util.PluginManagerWrapper;
Sunny Goyal4a48a982021-06-17 15:15:46 -0700241import com.android.launcher3.util.RunnableList;
Sunny Goyala992ac92023-01-10 17:50:32 -0800242import com.android.launcher3.util.ScreenOnTracker;
243import com.android.launcher3.util.ScreenOnTracker.ScreenOnListener;
Tracy Zhoude8e25c2023-10-07 00:00:57 -0700244import com.android.launcher3.util.SettingsCache;
Sunny Goyalf1582862024-09-05 16:49:10 -0700245import com.android.launcher3.util.StableViewInfo;
Sunny Goyal8392c822017-06-20 10:03:56 -0700246import com.android.launcher3.util.SystemUiController;
Mario Bertschlera6936942017-05-31 14:48:19 -0700247import com.android.launcher3.util.Themes;
Adam Cohen091440a2015-03-18 14:16:05 -0700248import com.android.launcher3.util.Thunk;
Sunny Goyal210e1742019-10-17 12:05:38 -0700249import com.android.launcher3.util.TouchController;
Sunny Goyalfca6bc92017-09-28 16:28:34 -0700250import com.android.launcher3.util.TraceHelper;
Sunny Goyalab770a12018-11-14 15:17:26 -0800251import com.android.launcher3.views.ActivityContext;
Xiaowen Lei3c0f30a2023-04-12 16:59:45 -0700252import com.android.launcher3.views.ComposeInitializer;
Jon Mirandaf58db152022-06-02 16:06:37 -0700253import com.android.launcher3.views.FloatingIconView;
Sunny Goyal30ac97d2020-06-24 23:47:46 -0700254import com.android.launcher3.views.FloatingSurfaceView;
Sunny Goyal7c7be8c2018-03-07 19:58:07 -0800255import com.android.launcher3.views.OptionsPopupView;
Govinda Wassermanc06e1512019-04-09 09:56:53 -0400256import com.android.launcher3.views.ScrimView;
Sunny Goyal29947f02017-12-18 13:49:44 -0800257import com.android.launcher3.widget.LauncherAppWidgetHostView;
Yogisha Dixit741fae92021-02-22 14:03:44 +0000258import com.android.launcher3.widget.LauncherAppWidgetProviderInfo;
Sihua Ma8bbfcb62022-11-08 16:46:07 -0800259import com.android.launcher3.widget.LauncherWidgetHolder;
Sunny Goyal782f0c92017-01-19 10:27:54 -0800260import com.android.launcher3.widget.PendingAddShortcutInfo;
Hyunyoung Song3f471442015-04-08 19:01:34 -0700261import com.android.launcher3.widget.PendingAddWidgetInfo;
Sunny Goyal29947f02017-12-18 13:49:44 -0800262import com.android.launcher3.widget.PendingAppWidgetHostView;
Sunny Goyal04a324a2017-01-20 21:08:59 -0800263import com.android.launcher3.widget.WidgetAddFlowHandler;
Sunny Goyal337c81f2019-12-10 12:19:13 -0800264import com.android.launcher3.widget.WidgetManagerHelper;
Pinyao Tingc7a6c292019-08-26 14:36:02 -0700265import com.android.launcher3.widget.custom.CustomWidgetManager;
Steven Ng2f5648a2021-02-08 17:18:25 +0000266import com.android.launcher3.widget.model.WidgetsListBaseEntry;
267import com.android.launcher3.widget.picker.WidgetsFullSheet;
Shamali P74d9fbd2024-07-19 21:07:05 +0000268import com.android.launcher3.widget.picker.model.WidgetPickerDataProvider;
Fengjiang Li6f8069a2024-03-20 12:04:29 -0700269import com.android.launcher3.widget.util.WidgetSizes;
Sunny Goyal80a071b2021-12-27 13:30:08 +0530270import com.android.systemui.plugins.LauncherOverlayPlugin;
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700271import com.android.systemui.plugins.PluginListener;
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700272import com.android.systemui.plugins.shared.LauncherOverlayManager;
Sunny Goyaldc7cdd82024-02-13 14:56:36 -0800273import com.android.systemui.plugins.shared.LauncherOverlayManager.LauncherOverlayTouchProxy;
Eghosa Ewansiha-Vlachavas80232ea2024-02-20 16:08:45 +0000274import com.android.window.flags.Flags;
Adam Cohen6c5891a2014-07-09 23:53:15 -0700275
Adam Cohen16d7ffc2011-10-05 17:49:14 -0700276import java.io.FileDescriptor;
Adam Cohen16d7ffc2011-10-05 17:49:14 -0700277import java.io.PrintWriter;
Adam Cohenc0dcf592011-06-01 15:30:43 -0700278import java.util.ArrayList;
Jon Mirandac4a99bf2021-11-04 16:53:45 -0700279import java.util.Collections;
Zak Cohen658c67a2018-10-19 14:21:05 -0700280import java.util.HashMap;
Sunny Goyal4390ace2014-10-13 11:33:11 -0700281import java.util.HashSet;
Michael Jurkad7c28052012-04-27 15:43:36 -0700282import java.util.List;
Anushree Ganjam97434ee2023-05-18 22:03:16 +0000283import java.util.Map;
Sebastian Franco9e4c99b2024-10-02 15:16:37 -0700284import java.util.Objects;
Thiru Ramasamy694407c2022-03-08 12:11:24 -0800285import java.util.Optional;
Sunny Goyalaae6fbb2019-01-31 16:05:58 -0800286import java.util.function.Predicate;
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700287import java.util.function.Supplier;
Sunny Goyal3a1eadd2019-10-23 17:44:27 -0700288import java.util.stream.Stream;
Jon Mirandaf5197fc2019-09-04 16:55:41 -0700289
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800290/**
291 * Default launcher application.
292 */
Shikha Malhotra0f2e1b62022-03-27 21:02:21 +0000293public class Launcher extends StatefulActivity<LauncherState>
Sunny Goyal576f7a52023-10-06 11:28:25 -0700294 implements Callbacks, InvariantDeviceProfile.OnIDPChangeListener,
Sunny Goyal82379182022-11-02 18:58:49 -0700295 PluginListener<LauncherOverlayPlugin> {
Vadim Tryshevfedca432015-08-19 17:55:02 -0700296 public static final String TAG = "Launcher";
Sunny Goyale84c5b82019-09-26 17:05:31 -0700297
Schneider Victor-Tulias8463dc42024-10-22 15:29:59 -0400298 public static final ContextTracker.ActivityTracker<Launcher> ACTIVITY_TRACKER =
299 new ContextTracker.ActivityTracker<>();
Sunny Goyale84c5b82019-09-26 17:05:31 -0700300
Sunny Goyal2bba4c32015-05-18 15:42:48 -0700301 static final boolean LOGD = false;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800302
Winson Chunga2413752012-04-03 14:22:34 -0700303 static final boolean DEBUG_STRICT_MODE = false;
Romain Guy6fefcf12009-06-11 13:07:43 -0700304
Sunny Goyal5a1f53b2015-05-27 10:24:24 -0700305 private static final float BOUNCE_ANIMATION_TENSION = 1.3f;
306
Mathew Inwood876a8462013-06-14 14:12:41 +0100307 /**
308 * IntentStarter uses request codes starting with this. This must be greater than all activity
309 * request codes used internally.
310 */
311 protected static final int REQUEST_LAST = 100;
312
Tracy Zhoucb93ec52023-03-31 22:51:17 -0700313 public static final String INTENT_ACTION_ALL_APPS_TOGGLE =
314 "launcher.intent_action_all_apps_toggle";
315
Fengjiang Li5a36c172023-04-13 18:18:27 +0000316 private static boolean sIsNewProcess = true;
317
randypfohl176ce852024-05-08 14:50:50 -0700318 private StateManager<LauncherState, Launcher> mStateManager;
Patrick Dubroy6b509c12010-08-23 15:08:16 -0700319
Adam Cohenad4e15c2013-10-17 16:21:35 -0700320 private static final int ON_ACTIVITY_RESULT_ANIMATION_DELAY = 500;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800321
Winson Chunga2413752012-04-03 14:22:34 -0700322 // How long to wait before the new-shortcut animation automatically pans the workspace
Jon Mirandaf5197fc2019-09-04 16:55:41 -0700323 @VisibleForTesting public static final int NEW_APPS_PAGE_MOVE_DELAY = 500;
Rajeev Kumar43c0f582017-06-23 15:34:55 -0700324 private static final int NEW_APPS_ANIMATION_INACTIVE_TIMEOUT_SECONDS = 5;
Jon Mirandaf5197fc2019-09-04 16:55:41 -0700325 @Thunk @VisibleForTesting public static final int NEW_APPS_ANIMATION_DELAY = 500;
Winson Chunga2413752012-04-03 14:22:34 -0700326
Alex Chau0c4e11b2022-07-08 18:41:36 +0100327 private static final FloatProperty<Workspace<?>> WORKSPACE_WIDGET_SCALE =
328 WORKSPACE_SCALE_PROPERTY_FACTORY.get(SCALE_INDEX_WIDGET_TRANSITION);
329 private static final FloatProperty<Hotseat> HOTSEAT_WIDGET_SCALE =
330 HOTSEAT_SCALE_PROPERTY_FACTORY.get(SCALE_INDEX_WIDGET_TRANSITION);
331
Sebastian Francobd7919c2023-09-19 10:55:37 -0700332 private final ModelCallbacks mModelCallbacks = createModelCallbacks();
333
334 private final KeyboardShortcutsDelegate mKeyboardShortcutsDelegate =
335 new KeyboardShortcutsDelegate(this);
336
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;
Sunny Goyal4e014232024-01-18 13:53:45 -0800344 private ItemInflater<Launcher> mItemInflater;
Romain Guycbb89e42009-06-08 15:52:54 -0700345
Rajeev Kumar43c0f582017-06-23 15:34:55 -0700346 private final int[] mTmpAddItemCellCoordinates = new int[2];
Michael Jurka0280c3b2010-09-17 15:00:07 -0700347
Samuel Fufaca37b8a2019-08-19 17:04:36 -0700348 @Thunk
349 Hotseat mHotseat;
Adam Cohenf358a4b2013-07-23 16:47:31 -0700350
Sunny Goyal47328fd2016-05-25 18:56:41 -0700351 private DropTargetBar mDropTargetBar;
Hyunyoung Song3f471442015-04-08 19:01:34 -0700352
353 // Main container view for the all apps screen.
Samuel Fufaca37b8a2019-08-19 17:04:36 -0700354 @Thunk
Brian Isganitis1664c9f2022-01-14 23:15:47 -0500355 ActivityAllAppsContainerView<Launcher> mAppsView;
Hyunyoung Song645764e2016-06-06 14:19:02 -0700356 AllAppsTransitionController mAllAppsController;
Hyunyoung Song3f471442015-04-08 19:01:34 -0700357
Govinda Wassermanc06e1512019-04-09 09:56:53 -0400358 // Scrim view for the all apps and overview state.
Samuel Fufaca37b8a2019-08-19 17:04:36 -0700359 @Thunk
360 ScrimView mScrimView;
Govinda Wassermanc06e1512019-04-09 09:56:53 -0400361
Winson Chung8ae41982017-11-10 11:42:13 -0800362 // UI and state for the overview panel
Sunny Goyal7c7be8c2018-03-07 19:58:07 -0800363 private View mOverviewPanel;
Winson Chung8ae41982017-11-10 11:42:13 -0800364
Winson Chungc9bf6d42019-10-04 15:33:18 -0700365 // Used to notify when an activity launch has been deferred because launcher is not yet resumed
366 // TODO: See if we can remove this later
367 private Runnable mOnDeferredActivityLaunchCallback;
Sunny Goyal7b8d63f2022-04-14 16:37:32 -0700368 private OnPreDrawListener mOnInitialBindListener;
Michael Jurka7607c2f2013-04-03 14:33:19 -0700369
Joe Onorato9c1289c2009-08-17 11:03:03 -0400370 private LauncherModel mModel;
Sunny Goyal43bf11d2017-02-02 13:52:53 -0800371 private ModelWriter mModelWriter;
Joe Onorato0589f0f2010-02-08 13:44:00 -0800372 private IconCache mIconCache;
Sunny Goyalae502842016-06-17 08:43:56 -0700373 private LauncherAccessibilityDelegate mAccessibilityDelegate;
Joe Onorato9c1289c2009-08-17 11:03:03 -0400374
Tony Wickham010d2552017-01-20 08:15:28 -0800375 private PopupDataProvider mPopupDataProvider;
Shamali P74d9fbd2024-07-19 21:07:05 +0000376 private WidgetPickerDataProvider mWidgetPickerDataProvider;
Tony Wickhambfbf7f92016-05-19 11:19:39 -0700377
Winson Chung46353de2012-02-16 14:05:10 -0800378 // We only want to get the SharedPreferences once since it does an FS stat each time we get
379 // it from the context.
380 private SharedPreferences mSharedPrefs;
381
Sunny Goyal2100c782016-08-22 16:00:03 -0700382 // Activity result which needs to be processed after workspace has loaded.
383 private ActivityResultInfo mPendingActivityResult;
384 /**
385 * Holds extra information required to handle a result from an external call, like
386 * {@link #startActivityForResult(Intent, int)} or {@link #requestPermissions(String[], int)}
387 */
388 private PendingRequestArgs mPendingRequestArgs;
Sunny Goyaldedda052019-05-14 15:23:48 -0700389 // Request id for any pending activity result
Sunny Goyal210e1742019-10-17 12:05:38 -0700390 protected int mPendingActivityRequestCode = -1;
Patrick Dubroy002cbf42011-03-03 16:36:21 -0800391
Tracy Zhou4d7b2442019-12-09 13:42:57 -0800392 private ViewGroupFocusHelper mFocusHandler;
Hyunyoung Song7fb3ccc2017-10-17 15:39:46 -0700393
Sunny Goyal623eddd2018-03-02 12:24:41 -0800394 private RotationHelper mRotationHelper;
Sunny Goyal7779d622015-06-11 16:18:39 -0700395
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700396 protected LauncherOverlayManager mOverlayManager;
Abhilasha Chahalcb329352022-05-31 15:50:53 +0000397 protected DragController mDragController;
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700398 // If true, overlay callbacks are deferred
399 private boolean mDeferOverlayCallbacks;
400 private final Runnable mDeferredOverlayCallbacks = this::checkIfOverlayStillDeferred;
401
Riddle Hsu979da642020-09-22 21:52:40 +0800402 protected long mLastTouchUpTime = -1;
Sunny Goyala306e592020-03-24 01:51:41 -0700403 private boolean mTouchInProgress;
Sunny Goyal9b180102020-03-11 10:02:29 -0700404
thiruramc96873c2021-02-11 15:13:47 -0800405 // New InstanceId is assigned to mAllAppsSessionLogId for each AllApps sessions.
406 // When Launcher is not in AllApps state mAllAppsSessionLogId will be null.
407 // User actions within AllApps state are logged with this InstanceId, to recreate AllApps
408 // session on the server side.
409 protected InstanceId mAllAppsSessionLogId;
410 private LauncherState mPrevLauncherState;
Fengjiang Li5a36c172023-04-13 18:18:27 +0000411 private StartupLatencyLogger mStartupLatencyLogger;
Sunny Goyal669b71f2023-01-27 14:37:07 -0800412 private CellPosMapper mCellPosMapper = CellPosMapper.DEFAULT;
413
Sunny Goyal0ee66472023-08-17 16:19:22 -0700414 private final CannedAnimationCoordinator mAnimationCoordinator =
415 new CannedAnimationCoordinator(this);
416
Vinit Nayak65460402023-08-11 15:40:07 -0700417 private final List<BackPressHandler> mBackPressedHandlers = new ArrayList<>();
Mark Fashehf547a7f62023-09-11 23:57:41 +0000418 private boolean mIsColdStartupAfterReboot;
Brandon Dayauon05105162024-10-11 15:13:17 -0700419 private boolean mForceConfigUpdate;
Vinit Nayak65460402023-08-11 15:40:07 -0700420
Tracy Zhoude8e25c2023-10-07 00:00:57 -0700421 private boolean mIsNaturalScrollingEnabled;
422
423 private final SettingsCache.OnChangeListener mNaturalScrollingChangedListener =
424 enabled -> mIsNaturalScrollingEnabled = enabled;
425
Alex Chau007abe82024-12-02 14:29:38 +0000426 private boolean mRecreateToUpdateTheme = false;
427
Sebastian Franco8a3de212023-09-05 18:54:01 -0700428 public static Launcher getLauncher(Context context) {
429 return fromContext(context);
430 }
431
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800432 @Override
Schneider Victor-tulias927d6dc2021-08-26 11:56:47 -0700433 @TargetApi(Build.VERSION_CODES.S)
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800434 protected void onCreate(Bundle savedInstanceState) {
Fengjiang Li5a36c172023-04-13 18:18:27 +0000435 mStartupLatencyLogger = createStartupLatencyLogger(
436 sIsNewProcess
437 ? LockedUserState.get(this).isUserUnlockedAtLauncherStartup()
438 ? COLD
439 : COLD_DEVICE_REBOOTING
440 : WARM);
Mark Fashehf547a7f62023-09-11 23:57:41 +0000441
442 mIsColdStartupAfterReboot = sIsNewProcess
443 && !LockedUserState.get(this).isUserUnlockedAtLauncherStartup();
444 if (mIsColdStartupAfterReboot) {
Mark Fasheh4baa30d2024-07-31 22:39:45 +0000445 /*
446 * This trace is used to calculate the time from create to the point that icons are
447 * visible.
448 */
Mark Fashehf547a7f62023-09-11 23:57:41 +0000449 Trace.beginAsyncSection(
450 COLD_STARTUP_TRACE_METHOD_NAME, COLD_STARTUP_TRACE_COOKIE);
451 }
452
Fengjiang Li5a36c172023-04-13 18:18:27 +0000453 sIsNewProcess = false;
454 mStartupLatencyLogger
455 .logStart(LAUNCHER_LATENCY_STARTUP_TOTAL_DURATION)
456 .logStart(LAUNCHER_LATENCY_STARTUP_ACTIVITY_ON_CREATE);
Schneider Victor-tulias927d6dc2021-08-26 11:56:47 -0700457 // Only use a hard-coded cookie since we only want to trace this once.
Sunny Goyal621918f2024-09-18 11:31:58 -0700458 Trace.beginAsyncSection(
459 DISPLAY_WORKSPACE_TRACE_METHOD_NAME, DISPLAY_WORKSPACE_TRACE_COOKIE);
460 Trace.beginAsyncSection(DISPLAY_ALL_APPS_TRACE_METHOD_NAME,
461 DISPLAY_ALL_APPS_TRACE_COOKIE);
Sunny Goyal67736672023-06-02 13:35:19 +0000462 TraceHelper.INSTANCE.beginSection(ON_CREATE_EVT);
Winson Chunga2413752012-04-03 14:22:34 -0700463 if (DEBUG_STRICT_MODE) {
464 StrictMode.setThreadPolicy(new StrictMode.ThreadPolicy.Builder()
465 .detectDiskReads()
466 .detectDiskWrites()
467 .detectNetwork() // or .detectAll() for all detectable problems
468 .penaltyLog()
469 .build());
470 StrictMode.setVmPolicy(new StrictMode.VmPolicy.Builder()
471 .detectLeakedSqlLiteObjects()
472 .detectLeakedClosableObjects()
473 .penaltyLog()
474 .penaltyDeath()
475 .build());
476 }
477
Tony Wickhame78a70b2021-03-29 16:45:59 -0700478 if (Utilities.IS_DEBUG_DEVICE && FeatureFlags.NOTIFY_CRASHES.get()) {
479 final String notificationChannelId = "com.android.launcher3.Debug";
480 final String notificationChannelName = "Debug";
481 final String notificationTag = "Debug";
482 final int notificationId = 0;
483
484 NotificationManager notificationManager = getSystemService(NotificationManager.class);
485 notificationManager.createNotificationChannel(new NotificationChannel(
486 notificationChannelId, notificationChannelName,
487 NotificationManager.IMPORTANCE_HIGH));
488
489 Thread.currentThread().setUncaughtExceptionHandler((thread, throwable) -> {
490 String stackTrace = Log.getStackTraceString(throwable);
491
492 Intent shareIntent = new Intent(Intent.ACTION_SEND);
493 shareIntent.setType("text/plain");
494 shareIntent.putExtra(Intent.EXTRA_TEXT, stackTrace);
495 shareIntent = Intent.createChooser(shareIntent, null);
496 PendingIntent sharePendingIntent = PendingIntent.getActivity(
Sunny Goyalcd2ac0f2022-04-14 21:21:47 -0700497 this, 0, shareIntent, FLAG_UPDATE_CURRENT | FLAG_IMMUTABLE);
Tony Wickhame78a70b2021-03-29 16:45:59 -0700498
499 Notification notification = new Notification.Builder(this, notificationChannelId)
500 .setSmallIcon(android.R.drawable.ic_menu_close_clear_cancel)
501 .setContentTitle("Launcher crash detected!")
502 .setStyle(new Notification.BigTextStyle().bigText(stackTrace))
503 .addAction(android.R.drawable.ic_menu_share, "Share", sharePendingIntent)
504 .build();
505 notificationManager.notify(notificationTag, notificationId, notification);
506
507 Thread.UncaughtExceptionHandler defaultUncaughtExceptionHandler =
508 Thread.getDefaultUncaughtExceptionHandler();
509 if (defaultUncaughtExceptionHandler != null) {
510 defaultUncaughtExceptionHandler.uncaughtException(thread, throwable);
511 }
512 });
513 }
514
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800515 super.onCreate(savedInstanceState);
Daniel Sandlere060b0b2013-06-27 21:47:55 -0400516
Sunny Goyal87f784c2017-01-11 10:48:34 -0800517 LauncherAppState app = LauncherAppState.getInstance(this);
Sunny Goyala7a5bf32020-01-05 15:35:29 +0530518 mModel = app.getModel();
Sunny Goyal9d89f752020-06-19 11:09:24 -0700519
Sunny Goyal41d51a02019-05-14 09:44:34 -0700520 mRotationHelper = new RotationHelper(this);
Hyunyoung Song31971a32019-01-27 12:31:12 -0800521 InvariantDeviceProfile idp = app.getInvariantDeviceProfile();
522 initDeviceProfile(idp);
523 idp.addOnChangeListener(this);
Stefan Andonian146701c2022-11-10 23:07:40 +0000524 mSharedPrefs = LauncherPrefs.getPrefs(this);
Joe Onorato0589f0f2010-02-08 13:44:00 -0800525 mIconCache = app.getIconCache();
Sunny Goyal384b5782021-02-09 22:50:02 -0800526 mAccessibilityDelegate = createAccessibilityDelegate();
Adam Cohen2e6da152015-05-06 11:42:25 -0700527
Abhilasha Chahalcb329352022-05-31 15:50:53 +0000528 initDragController();
Hyunyoung Song645764e2016-06-06 14:19:02 -0700529 mAllAppsController = new AllAppsTransitionController(this);
Sunny Goyal35e7d382020-05-08 13:37:58 -0700530 mStateManager = new StateManager<>(this, NORMAL);
Romain Guycbb89e42009-06-08 15:52:54 -0700531
Schneider Victor-tuliasfb2affa2023-05-26 15:09:41 -0700532 setupViews();
Johannes Gallmann9e913352024-01-11 13:20:01 +0100533 updateDisallowBack();
Schneider Victor-tuliasfb2affa2023-05-26 15:09:41 -0700534
Sunny Goyal337c81f2019-12-10 12:19:13 -0800535 mAppWidgetManager = new WidgetManagerHelper(this);
Sihua Ma0593a0d2022-10-03 16:01:48 -0700536 mAppWidgetHolder = createAppWidgetHolder();
537 mAppWidgetHolder.startListening();
Sunny Goyaleb293132023-11-17 12:23:40 -0800538 mAppWidgetHolder.addProviderChangeListener(() -> refreshAndBindWidgetsForPackageUser(null));
Sunny Goyal4e014232024-01-18 13:53:45 -0800539 mItemInflater = new ItemInflater<>(this, mAppWidgetHolder, getItemOnClickListener(),
Sebastian Franco2986e0b2024-01-25 10:23:39 -0800540 mFocusHandler, new CellLayout(mWorkspace.getContext(), mWorkspace));
Romain Guycbb89e42009-06-08 15:52:54 -0700541
Sunny Goyal9c2b9602020-01-07 13:07:55 -0800542 mPopupDataProvider = new PopupDataProvider(this::updateNotificationDots);
Shamali P74d9fbd2024-07-19 21:07:05 +0000543 mWidgetPickerDataProvider = new WidgetPickerDataProvider();
Ana Salazar Maldonadobdbad822024-10-22 21:20:20 +0000544 PillColorProvider.getInstance(mWorkspace.getContext()).registerObserver();
Tony Wickham010d2552017-01-20 08:15:28 -0800545
Sunny Goyale84c5b82019-09-26 17:05:31 -0700546 boolean internalStateHandled = ACTIVITY_TRACKER.handleCreate(this);
Sunny Goyald3864fa2017-11-14 15:06:36 -0800547 if (internalStateHandled) {
Sunny Goyald3864fa2017-11-14 15:06:36 -0800548 if (savedInstanceState != null) {
549 // InternalStateHandler has already set the appropriate state.
550 // We dont need to do anything.
551 savedInstanceState.remove(RUNTIME_STATE);
552 }
553 }
554 restoreState(savedInstanceState);
Sunny Goyalbbece862019-03-01 13:13:52 -0800555 mStateManager.reapplyState();
Winson Chungb63b44c2017-11-10 17:54:44 -0800556
Sunny Goyalfe770c92016-09-27 14:38:58 -0700557 if (savedInstanceState != null) {
Sunny Goyal12e3f1f2021-07-15 14:31:58 -0700558 int[] pageIds = savedInstanceState.getIntArray(RUNTIME_STATE_CURRENT_SCREEN_IDS);
559 if (pageIds != null) {
Sebastian Franco69fd7422023-10-06 16:48:58 -0700560 mModelCallbacks.setPagesToBindSynchronously(IntSet.wrap(pageIds));
Sunny Goyal12e3f1f2021-07-15 14:31:58 -0700561 }
Sunny Goyalfe770c92016-09-27 14:38:58 -0700562 }
Sunny Goyald3864fa2017-11-14 15:06:36 -0800563
Fengjiang Li5a36c172023-04-13 18:18:27 +0000564 mStartupLatencyLogger.logWorkspaceLoadStartTime();
Sunny Goyala7a5bf32020-01-05 15:35:29 +0530565 if (!mModel.addCallbacksAndLoad(this)) {
Sunny Goyald3864fa2017-11-14 15:06:36 -0800566 if (!internalStateHandled) {
Sunny Goyal7b8d63f2022-04-14 16:37:32 -0700567 // If we are not binding synchronously, pause drawing until initial bind complete,
568 // so that the system could continue to show the device loading prompt
569 mOnInitialBindListener = Boolean.FALSE::booleanValue;
Sunny Goyald3864fa2017-11-14 15:06:36 -0800570 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800571 }
572
573 // For handling default keys
Sunny Goyalf4aceab2017-12-06 16:16:31 -0800574 setDefaultKeyMode(DEFAULT_KEYS_SEARCH_LOCAL);
Joe Onorato34a0e1b2009-12-14 17:44:51 -0800575
Sunny Goyal9d89f752020-06-19 11:09:24 -0700576 setContentView(getRootView());
Xiaowen Lei3c0f30a2023-04-12 16:59:45 -0700577 ComposeInitializer.initCompose(this);
578
Sunny Goyal7b8d63f2022-04-14 16:37:32 -0700579 if (mOnInitialBindListener != null) {
580 getRootView().getViewTreeObserver().addOnPreDrawListener(mOnInitialBindListener);
581 }
Sunny Goyalf8d56fc2018-01-31 15:18:11 -0800582 getRootView().dispatchInsets();
Mario Bertschlera6936942017-05-31 14:48:19 -0700583
Tracy Zhoude8e25c2023-10-07 00:00:57 -0700584 final SettingsCache settingsCache = SettingsCache.INSTANCE.get(this);
585 settingsCache.register(TOUCHPAD_NATURAL_SCROLLING, mNaturalScrollingChangedListener);
586 mIsNaturalScrollingEnabled = settingsCache.getValue(TOUCHPAD_NATURAL_SCROLLING);
587
Sunny Goyala992ac92023-01-10 17:50:32 -0800588 // Listen for screen turning off
589 ScreenOnTracker.INSTANCE.get(this).addListener(mScreenOnListener);
Sunny Goyal8392c822017-06-20 10:03:56 -0700590 getSystemUiController().updateUiState(SystemUiController.UI_STATE_BASE_WINDOW,
591 Themes.getAttrBoolean(this, R.attr.isWorkspaceDarkText));
Sunny Goyal14b32402017-07-31 10:03:28 -0700592
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700593 mOverlayManager = getDefaultOverlay();
Sunny Goyal4a22ed82024-04-08 11:56:50 -0700594 PluginManagerWrapper.INSTANCE.get(this)
595 .addPluginListener(this, LauncherOverlayPlugin.class);
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700596
Sunny Goyal623eddd2018-03-02 12:24:41 -0800597 mRotationHelper.initialize();
Sunny Goyal67736672023-06-02 13:35:19 +0000598 TraceHelper.INSTANCE.endSection();
Samuel Fufa41d909f2020-03-20 16:27:09 -0700599
Andy Wickhamb922dcc2024-01-24 14:38:48 -0800600 getWindow().setSoftInputMode(LayoutParams.SOFT_INPUT_ADJUST_NOTHING);
Stefan Andonian45fc3012022-05-05 22:48:09 +0000601 setTitle(R.string.home_screen);
Fengjiang Li5a36c172023-04-13 18:18:27 +0000602 mStartupLatencyLogger.logEnd(LAUNCHER_LATENCY_STARTUP_ACTIVITY_ON_CREATE);
Sebastian Franco9ae40322023-10-10 10:50:28 -0700603
Anton Vayvodee382242024-05-28 21:26:25 -0400604 if (BuildCompat.isAtLeastV()
605 && com.android.launcher3.Flags.enableTwoPaneLauncherSettings()) {
Sebastian Franco9ae40322023-10-10 10:50:28 -0700606 RuleController.getInstance(this).setRules(
607 RuleController.parseRules(this, R.xml.split_configuration));
608 }
Sebastian Franco224f67a2024-04-18 18:40:40 -0700609 TestEventEmitter.INSTANCE.get(this).sendEvent(TestEvent.LAUNCHER_ON_CREATE);
Fengjiang Li5a36c172023-04-13 18:18:27 +0000610 }
611
Sebastian Francobd7919c2023-09-19 10:55:37 -0700612 protected ModelCallbacks createModelCallbacks() {
613 return new ModelCallbacks(this);
614 }
615
Fengjiang Li5a36c172023-04-13 18:18:27 +0000616 /**
Fengjiang Lie5f91a42023-11-16 16:12:04 -0800617 * We only log startup latency in {@link COLD_DEVICE_REBOOTING} type. For other latency types,
618 * create a no op implementation.
619 */
620 private StartupLatencyLogger createStartupLatencyLogger(
621 StatsLogManager.StatsLatencyLogger.LatencyType latencyType) {
622 if (latencyType == COLD_DEVICE_REBOOTING) {
623 return createColdRebootStartupLatencyLogger();
624 }
625 return StartupLatencyLogger.Companion.getNO_OP();
626 }
627
628 /**
629 * Create {@link ColdRebootStartupLatencyLogger} that only collects launcher startup latency
630 * metrics without sending them anywhere. Child class can override this method to create logger
Fengjiang Li5a36c172023-04-13 18:18:27 +0000631 * that overrides {@link StartupLatencyLogger#log()} to report those metrics.
632 */
Fengjiang Lie5f91a42023-11-16 16:12:04 -0800633 protected ColdRebootStartupLatencyLogger createColdRebootStartupLatencyLogger() {
634 return new ColdRebootStartupLatencyLogger();
Adam Cohen9211d422014-10-07 18:14:53 -0700635 }
636
Fengjiang Li6bb8d792023-01-12 16:20:58 -0800637 /**
Fengjiang Lib7860bd2023-03-15 10:50:50 -0700638 * Provide {@link OnBackAnimationCallback} in below order:
Fengjiang Li6bb8d792023-01-12 16:20:58 -0800639 * <ol>
640 * <li> auto cancel action mode handler
641 * <li> drag handler
642 * <li> view handler
Vinit Nayak65460402023-08-11 15:40:07 -0700643 * <li> registered {@link BackPressHandler}
Fengjiang Li6bb8d792023-01-12 16:20:58 -0800644 * <li> state handler
645 * </ol>
646 *
647 * A back gesture (a single click on back button, or a swipe back gesture that contains a series
648 * of swipe events) should be handled by the same handler from above list. For a new back
649 * gesture, a new handler should be regenerated.
650 *
651 * Note that state handler will always be handling the back press event if the previous 3 don't.
652 */
653 @NonNull
Fengjiang Lid0c23592023-04-20 16:42:25 -0700654 @RequiresApi(Build.VERSION_CODES.UPSIDE_DOWN_CAKE)
Fengjiang Lib7860bd2023-03-15 10:50:50 -0700655 protected OnBackAnimationCallback getOnBackAnimationCallback() {
Fengjiang Li6bb8d792023-01-12 16:20:58 -0800656 // #1 auto cancel action mode handler
657 if (isInAutoCancelActionMode()) {
658 return this::finishAutoCancelActionMode;
659 }
660
661 // #2 drag handler
662 if (mDragController.isDragging()) {
663 return mDragController::cancelDrag;
664 }
665
666 // #3 view handler
667 AbstractFloatingView topView =
668 AbstractFloatingView.getTopOpenView(Launcher.this);
669 if (topView != null && topView.canHandleBack()) {
670 return topView;
671 }
672
Vinit Nayak65460402023-08-11 15:40:07 -0700673 // #4 Custom back handlers
674 for (BackPressHandler handler : mBackPressedHandlers) {
675 if (handler.canHandleBack()) {
676 return handler;
677 }
678 }
679
680 // #5 state handler
Fengjiang Lib7860bd2023-03-15 10:50:50 -0700681 return new OnBackAnimationCallback() {
Fengjiang Li6bb8d792023-01-12 16:20:58 -0800682 @Override
Fengjiang Li10c03e42024-03-26 16:21:01 -0700683 public void onBackStarted(BackEvent backEvent) {
684 Launcher.this.onBackStarted();
685 }
686
687 @Override
Fengjiang Li6bb8d792023-01-12 16:20:58 -0800688 public void onBackInvoked() {
689 onStateBack();
690 }
691
692 @Override
Fengjiang Lib7860bd2023-03-15 10:50:50 -0700693 public void onBackProgressed(@NonNull BackEvent backEvent) {
Fengjiang Li6bb8d792023-01-12 16:20:58 -0800694 mStateManager.getState().onBackProgressed(
Fengjiang Lib7860bd2023-03-15 10:50:50 -0700695 Launcher.this, backEvent.getProgress());
Fengjiang Li6bb8d792023-01-12 16:20:58 -0800696 }
697
698 @Override
699 public void onBackCancelled() {
Fengjiang Li01cc2732024-03-28 16:24:39 -0700700 Launcher.this.onBackCancelled();
Fengjiang Li6bb8d792023-01-12 16:20:58 -0800701 }
702 };
703 }
704
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700705 protected LauncherOverlayManager getDefaultOverlay() {
706 return new LauncherOverlayManager() { };
707 }
708
709 @Override
Sunny Goyal80a071b2021-12-27 13:30:08 +0530710 public void onPluginConnected(LauncherOverlayPlugin overlayManager, Context context) {
Sunny Goyal576f7a52023-10-06 11:28:25 -0700711 switchOverlay(() -> overlayManager.createOverlayManager(this));
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700712 }
713
714 @Override
Sunny Goyal80a071b2021-12-27 13:30:08 +0530715 public void onPluginDisconnected(LauncherOverlayPlugin plugin) {
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700716 switchOverlay(this::getDefaultOverlay);
717 }
718
719 private void switchOverlay(Supplier<LauncherOverlayManager> overlaySupplier) {
720 if (mOverlayManager != null) {
Sunny Goyale82a20a2023-10-19 13:52:49 -0700721 mOverlayManager.onActivityDestroyed();
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700722 }
723 mOverlayManager = overlaySupplier.get();
724 if (getRootView().isAttachedToWindow()) {
725 mOverlayManager.onAttachedToWindow();
726 }
727 mDeferOverlayCallbacks = true;
728 checkIfOverlayStillDeferred();
729 }
730
731 @Override
Brian Isganitis099945b2022-01-31 18:15:00 -0500732 public void dispatchDeviceProfileChanged() {
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700733 super.dispatchDeviceProfileChanged();
734 mOverlayManager.onDeviceProvideChanged();
735 }
736
Sunny Goyal7779d622015-06-11 16:18:39 -0700737 @Override
Winson Chung8eb49e02018-07-16 13:33:31 -0700738 public void onEnterAnimationComplete() {
739 super.onEnterAnimationComplete();
Sunny Goyalbe8c3402019-05-22 15:17:52 -0700740 mRotationHelper.setCurrentTransitionRequest(REQUEST_NONE);
Winson Chung8eb49e02018-07-16 13:33:31 -0700741 }
742
743 @Override
Jerry Chang09b40242021-08-27 13:29:01 +0800744 public void onMultiWindowModeChanged(boolean isInMultiWindowMode, Configuration newConfig) {
745 super.onMultiWindowModeChanged(isInMultiWindowMode, newConfig);
746 // Always update device profile when multi window mode changed.
747 initDeviceProfile(mDeviceProfile.inv);
748 dispatchDeviceProfileChanged();
749 }
750
Abhilasha Chahalcb329352022-05-31 15:50:53 +0000751 /**
752 * Initializes the drag controller.
753 */
754 protected void initDragController() {
755 mDragController = new LauncherDragController(this);
756 }
757
Sunny Goyal605bcf32018-03-02 15:16:12 -0800758 @Override
Sunny Goyal6e6f7992021-08-24 16:23:29 -0700759 public void onIdpChanged(boolean modelPropertiesChanged) {
Alex Chau360ec032022-08-10 16:11:42 +0100760 onHandleConfigurationChanged();
761 }
762
763 @Override
764 protected void onHandleConfigurationChanged() {
Nicolo' Mazzucatoe120fcf2023-08-04 15:33:15 +0000765 Trace.beginSection("Launcher#onHandleconfigurationChanged");
766 try {
Brandon Dayauon05105162024-10-11 15:13:17 -0700767 if (!initDeviceProfile(mDeviceProfile.inv) && !mForceConfigUpdate) {
Nicolo' Mazzucatoe120fcf2023-08-04 15:33:15 +0000768 return;
769 }
Nicolo' Mazzucatoe120fcf2023-08-04 15:33:15 +0000770 dispatchDeviceProfileChanged();
771 reapplyUi();
772 mDragLayer.recreateControllers();
773
774 // Calling onSaveInstanceState ensures that static cache used by listWidgets is
775 // initialized properly.
776 onSaveInstanceState(new Bundle());
777 mModel.rebindCallbacks();
Sebastian Franco00ed8cc2024-07-03 13:51:43 -0700778 updateDisallowBack();
Nicolo' Mazzucatoe120fcf2023-08-04 15:33:15 +0000779 } finally {
Brandon Dayauon05105162024-10-11 15:13:17 -0700780 mForceConfigUpdate = false;
Nicolo' Mazzucatoe120fcf2023-08-04 15:33:15 +0000781 Trace.endSection();
Alex Chau6209af62022-07-27 14:08:23 +0100782 }
Hyunyoung Song31971a32019-01-27 12:31:12 -0800783 }
784
Sebastian Franco9e4c99b2024-10-02 15:16:37 -0700785 private void updateFixedLandscape() {
786 if (!com.android.launcher3.Flags.oneGridSpecs()) {
787 return;
788 }
Sebastian Franco52ae78d2024-11-13 17:36:22 -0800789 // When the flag oneGridSpecs is on we want to disable ALLOW_ROTATION which is replaced
790 // by FIXED_LANDSCAPE_MODE, ALLOW_ROTATION will only be used on Tablets afterwards.
Sebastian Francocb8f82a2024-11-20 15:42:43 -0800791 if (getDeviceProfile().isPhone || getDeviceProfile().isTwoPanels) {
Sebastian Franco52ae78d2024-11-13 17:36:22 -0800792 LauncherPrefs.get(this).put(LauncherPrefs.ALLOW_ROTATION, false);
793 }
Sebastian Francob1c47092024-11-08 10:55:36 -0800794 getRotationHelper().setFixedLandscape(
795 Objects.requireNonNull(mDeviceProfile.inv).isFixedLandscapeMode
796 );
Sebastian Franco9e4c99b2024-10-02 15:16:37 -0700797 }
798
Govinda Wassermanc06e1512019-04-09 09:56:53 -0400799 public void onAssistantVisibilityChanged(float visibility) {
Sunny Goyal0b5b8d42021-03-31 14:56:47 -0700800 mHotseat.getQsb().setAlpha(1f - visibility);
Govinda Wassermanc06e1512019-04-09 09:56:53 -0400801 }
802
Bill Lina1221bc2021-06-03 01:49:27 +0800803 /**
Alex Chau6209af62022-07-27 14:08:23 +0100804 * Returns {@code true} if a new DeviceProfile is initialized, and {@code false} otherwise.
805 */
806 protected boolean initDeviceProfile(InvariantDeviceProfile idp) {
Sunny Goyalf8d56fc2018-01-31 15:18:11 -0800807 // Load configuration-specific DeviceProfile
Alex Chau6209af62022-07-27 14:08:23 +0100808 DeviceProfile deviceProfile = idp.getDeviceProfile(this);
809 if (mDeviceProfile == deviceProfile) {
810 return false;
811 }
812
813 mDeviceProfile = deviceProfile;
Jerry Changbfac46a2021-09-08 08:20:58 +0800814 if (isInMultiWindowMode()) {
815 mDeviceProfile = mDeviceProfile.getMultiWindowProfile(
816 this, getMultiWindowDisplaySize());
817 }
Sunny Goyalae6e3182019-04-30 12:04:37 -0700818
Sunny Goyal59d086c2018-05-07 17:31:40 -0700819 onDeviceProfileInitiated();
Sebastián Franco1f4d56c2023-08-08 03:29:10 +0000820 if (FOLDABLE_SINGLE_PAGE.get() && mDeviceProfile.isTwoPanels) {
Sebastian Franco09589322022-11-02 15:25:58 -0700821 mCellPosMapper = new TwoPanelCellPosMapper(mDeviceProfile.inv.numColumns);
822 } else {
Sebastian Franco2d023e22023-11-15 16:48:34 -0600823 mCellPosMapper = new CellPosMapper(mDeviceProfile.isVerticalBarLayout(),
824 mDeviceProfile.numShownHotseatIcons);
Sebastian Franco09589322022-11-02 15:25:58 -0700825 }
Sebastian Franco2d023e22023-11-15 16:48:34 -0600826 mModelWriter = mModel.getWriter(true, mCellPosMapper, this);
Sebastian Franco9e4c99b2024-10-02 15:16:37 -0700827 updateFixedLandscape();
Alex Chau6209af62022-07-27 14:08:23 +0100828 return true;
Sunny Goyalf8d56fc2018-01-31 15:18:11 -0800829 }
830
Sunny Goyal0b0847b2018-03-14 12:30:11 -0700831 @Override
832 public void invalidateParent(ItemInfo info) {
Jon Mirandae6f3fa42019-03-04 09:14:40 -0800833 if (info.container >= 0) {
Jeremy Sim742630c2024-03-22 22:11:18 -0700834 View collectionIcon = getWorkspace().getHomescreenIconByItemId(info.container);
835 if (collectionIcon instanceof FolderIcon folderIcon
836 && collectionIcon.getTag() instanceof FolderInfo) {
Sebastian Francoc794aca2024-07-17 16:18:20 -0700837 if (createFolderGridOrganizer(getDeviceProfile())
Sunny Goyal11a50742019-08-07 09:24:26 -0700838 .setFolderInfo((FolderInfo) folderIcon.getTag())
839 .isItemInPreview(info.rank)) {
Jon Mirandae6f3fa42019-03-04 09:14:40 -0800840 folderIcon.invalidate();
841 }
Jeremy Sim742630c2024-03-22 22:11:18 -0700842 } else if (collectionIcon instanceof AppPairIcon appPairIcon
843 && collectionIcon.getTag() instanceof AppPairInfo appPairInfo) {
844 if (appPairInfo.getContents().contains(info)) {
845 appPairIcon.getIconDrawableArea().redraw();
846 }
Sunny Goyal0b0847b2018-03-14 12:30:11 -0700847 }
848 }
849 }
850
Adam Cohenc76e1dd2013-11-14 11:09:14 +0000851 /**
Winson Chung557d6ed2011-07-08 15:34:52 -0700852 * Returns whether we should delay spring loaded mode -- for shortcuts and widgets that have
853 * a configuration step, this allows the proper animations to run after other transitions.
854 */
Sunny Goyalefb7e842018-10-04 15:11:00 -0700855 private int completeAdd(
Sunny Goyal2100c782016-08-22 16:00:03 -0700856 int requestCode, Intent intent, int appWidgetId, PendingRequestArgs info) {
Sunny Goyal669b71f2023-01-27 14:37:07 -0800857 CellPos cellPos = getCellPosMapper().mapModelToPresenter(info);
858 int screenId = cellPos.screenId;
859 if (info.container == CONTAINER_DESKTOP) {
Adam Cohen83079e42014-09-19 17:43:08 -0700860 // When the screen id represents an actual screen (as opposed to a rank) we make sure
861 // that the drop page actually exists.
Sunny Goyal669b71f2023-01-27 14:37:07 -0800862 screenId = ensurePendingDropLayoutExists(cellPos.screenId);
Adam Cohen83079e42014-09-19 17:43:08 -0700863 }
Adam Cohendb364c32014-05-20 14:23:40 -0700864
Sunny Goyal2100c782016-08-22 16:00:03 -0700865 switch (requestCode) {
Patrick Dubroy002cbf42011-03-03 16:36:21 -0800866 case REQUEST_CREATE_SHORTCUT:
Sunny Goyal669b71f2023-01-27 14:37:07 -0800867 completeAddShortcut(intent, info.container, screenId,
868 cellPos.cellX, cellPos.cellY, info);
Pinyao Tingc9074272019-11-11 11:51:44 -0800869 announceForAccessibility(R.string.item_added_to_workspace);
Winson Chungb8472bb2011-08-05 13:49:21 -0700870 break;
Patrick Dubroy002cbf42011-03-03 16:36:21 -0800871 case REQUEST_CREATE_APPWIDGET:
Fengjiang Li6f8069a2024-03-20 12:04:29 -0700872 completeAddAppWidget(appWidgetId, info, null, null, false, true, null);
Winson Chungb8472bb2011-08-05 13:49:21 -0700873 break;
Sunny Goyalff572272014-07-23 13:58:07 -0700874 case REQUEST_RECONFIGURE_APPWIDGET:
Sunny Goyal977838b2022-06-27 13:15:41 -0700875 getStatsLogManager().logger().withItemInfo(info).log(LAUNCHER_WIDGET_RECONFIGURED);
Sunny Goyal2100c782016-08-22 16:00:03 -0700876 completeRestoreAppWidget(appWidgetId, LauncherAppWidgetInfo.RESTORE_COMPLETED);
Sunny Goyalff572272014-07-23 13:58:07 -0700877 break;
Sunny Goyald478c832016-04-01 12:04:16 -0700878 case REQUEST_BIND_PENDING_APPWIDGET: {
Sunny Goyal2100c782016-08-22 16:00:03 -0700879 int widgetId = appWidgetId;
880 LauncherAppWidgetInfo widgetInfo =
Sunny Goyald478c832016-04-01 12:04:16 -0700881 completeRestoreAppWidget(widgetId, LauncherAppWidgetInfo.FLAG_UI_NOT_READY);
Sunny Goyal2100c782016-08-22 16:00:03 -0700882 if (widgetInfo != null) {
Sunny Goyald478c832016-04-01 12:04:16 -0700883 // Since the view was just bound, also launch the configure activity if needed
884 LauncherAppWidgetProviderInfo provider = mAppWidgetManager
fbaron30d9e3f2023-08-03 17:03:59 -0700885 .getLauncherAppWidgetInfo(widgetId, info.getTargetComponent());
Sunny Goyal04a324a2017-01-20 21:08:59 -0800886 if (provider != null) {
887 new WidgetAddFlowHandler(provider)
Samuel Fufaca37b8a2019-08-19 17:04:36 -0700888 .startConfigActivity(this, widgetInfo,
889 REQUEST_RECONFIGURE_APPWIDGET);
Sunny Goyald478c832016-04-01 12:04:16 -0700890 }
891 }
892 break;
893 }
Patrick Dubroy002cbf42011-03-03 16:36:21 -0800894 }
Adam Cohendb364c32014-05-20 14:23:40 -0700895 return screenId;
Patrick Dubroy002cbf42011-03-03 16:36:21 -0800896 }
897
Sebastian Franco6196b902023-12-06 11:39:52 -0600898 /**
899 * Process any pending activity result if it was put on hold for any reason like item binding.
900 */
901 public void processActivityResult() {
902 if (mPendingActivityResult != null) {
903 handleActivityResult(mPendingActivityResult.requestCode,
904 mPendingActivityResult.resultCode, mPendingActivityResult.data);
905 mPendingActivityResult = null;
906 }
907 }
908
Adam Cohenc7cd2cb2014-11-17 17:45:34 -0800909 private void handleActivityResult(
Michael Jurka8b805b12012-04-18 14:23:14 -0700910 final int requestCode, final int resultCode, final Intent data) {
Sunny Goyal2100c782016-08-22 16:00:03 -0700911 if (isWorkspaceLoading()) {
912 // process the result once the workspace has loaded.
913 mPendingActivityResult = new ActivityResultInfo(requestCode, resultCode, data);
914 return;
915 }
916 mPendingActivityResult = null;
917
Himanshu Gupta261a6222024-05-31 12:35:09 +0100918 if (requestCode == REQUEST_HOME_ROLE) {
919 if (resultCode != RESULT_OK) {
920 Toast.makeText(
921 this,
922 this.getString(R.string.set_default_home_app,
923 this.getString(R.string.derived_app_name)),
924 Toast.LENGTH_LONG).show();
925 }
926 return;
927 }
928
Winson Chunge341d302013-08-16 14:31:00 -0700929 // Reset the startActivity waiting flag
Sunny Goyal2100c782016-08-22 16:00:03 -0700930 final PendingRequestArgs requestArgs = mPendingRequestArgs;
931 setWaitingForResult(null);
932 if (requestArgs == null) {
933 return;
934 }
935
936 final int pendingAddWidgetId = requestArgs.getWidgetId();
Winson Chunge341d302013-08-16 14:31:00 -0700937
Charlie Anderson438d4052023-04-25 14:38:57 -0400938 Runnable exitSpringLoaded = MULTI_SELECT_EDIT_MODE.get() ? null
939 : () -> mStateManager.goToState(NORMAL, SPRING_LOADED_EXIT_DELAY);
Adam Cohenad4e15c2013-10-17 16:21:35 -0700940
Michael Jurka8b805b12012-04-18 14:23:14 -0700941 if (requestCode == REQUEST_BIND_APPWIDGET) {
Winsona1f79d32015-08-05 14:00:45 -0700942 // This is called only if the user did not previously have permissions to bind widgets
Adam Cohenad4e15c2013-10-17 16:21:35 -0700943 final int appWidgetId = data != null ?
Michael Jurka8b805b12012-04-18 14:23:14 -0700944 data.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, -1) : -1;
945 if (resultCode == RESULT_CANCELED) {
Sunny Goyal2100c782016-08-22 16:00:03 -0700946 completeTwoStageWidgetDrop(RESULT_CANCELED, appWidgetId, requestArgs);
Sunny Goyal6e379fc2020-03-19 16:08:14 -0700947 mWorkspace.removeExtraEmptyScreenDelayed(
948 ON_ACTIVITY_RESULT_ANIMATION_DELAY, false, exitSpringLoaded);
Michael Jurka8b805b12012-04-18 14:23:14 -0700949 } else if (resultCode == RESULT_OK) {
Sunny Goyal2100c782016-08-22 16:00:03 -0700950 addAppWidgetImpl(
951 appWidgetId, requestArgs, null,
Sunny Goyal04a324a2017-01-20 21:08:59 -0800952 requestArgs.getWidgetHandler(),
Sunny Goyal2100c782016-08-22 16:00:03 -0700953 ON_ACTIVITY_RESULT_ANIMATION_DELAY);
Michael Jurka8b805b12012-04-18 14:23:14 -0700954 }
955 return;
956 }
Michael Jurka336fd4f2013-09-12 00:05:02 +0200957
Adam Cohened66b2b2012-01-23 17:28:51 -0800958 boolean isWidgetDrop = (requestCode == REQUEST_PICK_APPWIDGET ||
Sunny Goyal5c97f512015-05-19 16:03:28 -0700959 requestCode == REQUEST_CREATE_APPWIDGET);
Romain Guyaad5ef42009-06-10 02:48:37 -0700960
Adam Cohened66b2b2012-01-23 17:28:51 -0800961 // We have special handling for widgets
962 if (isWidgetDrop) {
Adam Cohen4637b5a2013-11-04 18:21:24 -0800963 final int appWidgetId;
964 int widgetId = data != null ? data.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, -1)
965 : -1;
966 if (widgetId < 0) {
967 appWidgetId = pendingAddWidgetId;
968 } else {
969 appWidgetId = widgetId;
970 }
971
Adam Cohenad4e15c2013-10-17 16:21:35 -0700972 final int result;
Adam Cohenf0129b12013-11-04 17:57:36 -0800973 if (appWidgetId < 0 || resultCode == RESULT_CANCELED) {
Adam Cohendb364c32014-05-20 14:23:40 -0700974 Log.e(TAG, "Error: appWidgetId (EXTRA_APPWIDGET_ID) was not " +
975 "returned from the widget configuration activity.");
Adam Cohenad4e15c2013-10-17 16:21:35 -0700976 result = RESULT_CANCELED;
Sunny Goyal2100c782016-08-22 16:00:03 -0700977 completeTwoStageWidgetDrop(result, appWidgetId, requestArgs);
Sunny Goyal6e379fc2020-03-19 16:08:14 -0700978 mWorkspace.removeExtraEmptyScreenDelayed(
979 ON_ACTIVITY_RESULT_ANIMATION_DELAY, false,
980 () -> getStateManager().goToState(NORMAL));
Sunny Goyal2100c782016-08-22 16:00:03 -0700981 } else {
Sunny Goyal669b71f2023-01-27 14:37:07 -0800982 CellPos presenterPos = getCellPosMapper().mapModelToPresenter(requestArgs);
983 if (requestArgs.container == CONTAINER_DESKTOP) {
Sunny Goyal2100c782016-08-22 16:00:03 -0700984 // When the screen id represents an actual screen (as opposed to a rank)
985 // we make sure that the drop page actually exists.
Sunny Goyal669b71f2023-01-27 14:37:07 -0800986 int newScreenId = ensurePendingDropLayoutExists(presenterPos.screenId);
987 requestArgs.screenId = getCellPosMapper().mapPresenterToModel(
988 presenterPos.cellX, presenterPos.cellY, newScreenId, CONTAINER_DESKTOP)
989 .screenId;
Adam Cohendb364c32014-05-20 14:23:40 -0700990 }
Sunny Goyal2100c782016-08-22 16:00:03 -0700991 final CellLayout dropLayout =
Sunny Goyal669b71f2023-01-27 14:37:07 -0800992 mWorkspace.getScreenWithId(presenterPos.screenId);
Sunny Goyal2100c782016-08-22 16:00:03 -0700993
994 dropLayout.setDropPending(true);
995 final Runnable onComplete = new Runnable() {
996 @Override
997 public void run() {
998 completeTwoStageWidgetDrop(resultCode, appWidgetId, requestArgs);
999 dropLayout.setDropPending(false);
1000 }
1001 };
Sunny Goyal6e379fc2020-03-19 16:08:14 -07001002 mWorkspace.removeExtraEmptyScreenDelayed(
1003 ON_ACTIVITY_RESULT_ANIMATION_DELAY, false, onComplete);
Winson Chung5aaab772012-04-27 15:24:02 -07001004 }
Adam Cohened66b2b2012-01-23 17:28:51 -08001005 return;
1006 }
1007
Sunny Goyald478c832016-04-01 12:04:16 -07001008 if (requestCode == REQUEST_RECONFIGURE_APPWIDGET
1009 || requestCode == REQUEST_BIND_PENDING_APPWIDGET) {
Sunny Goyalff572272014-07-23 13:58:07 -07001010 if (resultCode == RESULT_OK) {
1011 // Update the widget view.
Sunny Goyal2100c782016-08-22 16:00:03 -07001012 completeAdd(requestCode, data, pendingAddWidgetId, requestArgs);
Sunny Goyalff572272014-07-23 13:58:07 -07001013 }
1014 // Leave the widget in the pending state if the user canceled the configure.
1015 return;
1016 }
1017
Sunny Goyalaad90582015-07-09 14:22:50 -07001018 if (requestCode == REQUEST_CREATE_SHORTCUT) {
1019 // Handle custom shortcuts created using ACTION_CREATE_SHORTCUT.
Sunny Goyal2100c782016-08-22 16:00:03 -07001020 if (resultCode == RESULT_OK && requestArgs.container != ItemInfo.NO_ID) {
1021 completeAdd(requestCode, data, -1, requestArgs);
Sunny Goyal6e379fc2020-03-19 16:08:14 -07001022 mWorkspace.removeExtraEmptyScreenDelayed(
1023 ON_ACTIVITY_RESULT_ANIMATION_DELAY, false, exitSpringLoaded);
Sunny Goyal2100c782016-08-22 16:00:03 -07001024
Sunny Goyalaad90582015-07-09 14:22:50 -07001025 } else if (resultCode == RESULT_CANCELED) {
Sunny Goyal6e379fc2020-03-19 16:08:14 -07001026 mWorkspace.removeExtraEmptyScreenDelayed(
1027 ON_ACTIVITY_RESULT_ANIMATION_DELAY, false, exitSpringLoaded);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001028 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001029 }
Hongming Jind91cb6e2020-01-27 16:23:03 -08001030
Adam Cohened66b2b2012-01-23 17:28:51 -08001031 mDragLayer.clearAnimatedView();
Adam Cohenc7cd2cb2014-11-17 17:45:34 -08001032 }
1033
1034 @Override
Sunny Goyal64a75aa2017-07-03 13:50:52 -07001035 public void onActivityResult(
Adam Cohenc7cd2cb2014-11-17 17:45:34 -08001036 final int requestCode, final int resultCode, final Intent data) {
Sunny Goyaldedda052019-05-14 15:23:48 -07001037 mPendingActivityRequestCode = -1;
Adam Cohenc7cd2cb2014-11-17 17:45:34 -08001038 handleActivityResult(requestCode, resultCode, data);
Adam Cohened66b2b2012-01-23 17:28:51 -08001039 }
1040
Adam Cohendb364c32014-05-20 14:23:40 -07001041 /**
1042 * Check to see if a given screen id exists. If not, create it at the end, return the new id.
1043 *
1044 * @param screenId the screen id to check
1045 * @return the new screen, or screenId if it exists
1046 */
Sunny Goyalefb7e842018-10-04 15:11:00 -07001047 private int ensurePendingDropLayoutExists(int screenId) {
Sunny Goyal32554d12015-12-03 15:31:25 -08001048 CellLayout dropLayout = mWorkspace.getScreenWithId(screenId);
Adam Cohendb364c32014-05-20 14:23:40 -07001049 if (dropLayout == null) {
1050 // it's possible that the add screen was removed because it was
1051 // empty and a re-bind occurred
Andras Kloczl408a54f2021-08-28 00:59:08 +01001052 mWorkspace.addExtraEmptyScreens();
1053 IntSet emptyPagesAdded = mWorkspace.commitExtraEmptyScreens();
1054 return emptyPagesAdded.isEmpty() ? -1 : emptyPagesAdded.getArray().get(0);
Adam Cohendb364c32014-05-20 14:23:40 -07001055 }
Andras Kloczl408a54f2021-08-28 00:59:08 +01001056 return screenId;
Adam Cohendb364c32014-05-20 14:23:40 -07001057 }
1058
Samuel Fufaca37b8a2019-08-19 17:04:36 -07001059 @Thunk
1060 void completeTwoStageWidgetDrop(
Sunny Goyal2100c782016-08-22 16:00:03 -07001061 final int resultCode, final int appWidgetId, final PendingRequestArgs requestArgs) {
Sunny Goyal669b71f2023-01-27 14:37:07 -08001062 CellLayout cellLayout = mWorkspace.getScreenWithId(
1063 getCellPosMapper().mapModelToPresenter(requestArgs).screenId);
Adam Cohened66b2b2012-01-23 17:28:51 -08001064 Runnable onCompleteRunnable = null;
1065 int animationType = 0;
1066
Adam Cohen9d5b7d82012-05-09 18:00:44 -07001067 AppWidgetHostView boundWidget = null;
Adam Cohened66b2b2012-01-23 17:28:51 -08001068 if (resultCode == RESULT_OK) {
1069 animationType = Workspace.COMPLETE_TWO_STAGE_WIDGET_DROP_ANIMATION;
Fengjiang Li8bd66ee2024-01-26 10:00:47 -08001070
1071 // Now that we are exiting the config activity with RESULT_OK.
1072 // If FLAG_ENABLE_ADD_APP_WIDGET_VIA_CONFIG_ACTIVITY_V2 is enabled, we can retrieve the
1073 // PendingAppWidgetHostView from LauncherWidgetHolder (it was added to
1074 // LauncherWidgetHolder when starting the config activity).
1075 final AppWidgetHostView layout = enableAddAppWidgetViaConfigActivityV2()
1076 ? getWorkspace().getWidgetForAppWidgetId(appWidgetId)
1077 : mAppWidgetHolder.createView(appWidgetId,
1078 requestArgs.getWidgetHandler().getProviderInfo(this));
Adam Cohen9d5b7d82012-05-09 18:00:44 -07001079 boundWidget = layout;
Charlie Anderson438d4052023-04-25 14:38:57 -04001080 onCompleteRunnable = () -> {
Fengjiang Li6f8069a2024-03-20 12:04:29 -07001081 completeAddAppWidget(appWidgetId, requestArgs, layout, null, false, true, null);
Charlie Anderson438d4052023-04-25 14:38:57 -04001082 if (!isInState(EDIT_MODE)) {
Sunny Goyal3e3f44c2017-10-23 17:14:52 -07001083 mStateManager.goToState(NORMAL, SPRING_LOADED_EXIT_DELAY);
Adam Cohened66b2b2012-01-23 17:28:51 -08001084 }
1085 };
1086 } else if (resultCode == RESULT_CANCELED) {
Sihua Ma0593a0d2022-10-03 16:01:48 -07001087 mAppWidgetHolder.deleteAppWidgetId(appWidgetId);
Adam Cohened66b2b2012-01-23 17:28:51 -08001088 animationType = Workspace.CANCEL_TWO_STAGE_WIDGET_DROP_ANIMATION;
Adam Cohened66b2b2012-01-23 17:28:51 -08001089 }
Adam Cohen9d5b7d82012-05-09 18:00:44 -07001090 if (mDragLayer.getAnimatedView() != null) {
Sunny Goyal2100c782016-08-22 16:00:03 -07001091 mWorkspace.animateWidgetDrop(requestArgs, cellLayout,
Adam Cohen9d5b7d82012-05-09 18:00:44 -07001092 (DragView) mDragLayer.getAnimatedView(), onCompleteRunnable,
1093 animationType, boundWidget, true);
Adam Cohenad4e15c2013-10-17 16:21:35 -07001094 } else if (onCompleteRunnable != null) {
Adam Cohen9d5b7d82012-05-09 18:00:44 -07001095 // The animated view may be null in the case of a rotation during widget configuration
1096 onCompleteRunnable.run();
1097 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001098 }
1099
1100 @Override
Michael Jurkacd496d72013-04-11 11:32:45 -07001101 protected void onStop() {
1102 super.onStop();
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001103 if (mDeferOverlayCallbacks) {
1104 checkIfOverlayStillDeferred();
1105 } else {
Sunny Goyale82a20a2023-10-19 13:52:49 -07001106 mOverlayManager.onActivityStopped();
Adam Cohen9211d422014-10-07 18:14:53 -07001107 }
Hyunyoung Song5ee7c132021-05-11 13:52:36 -07001108 hideKeyboard();
Hyunyoung Song95786e02020-09-15 00:34:10 -07001109 logStopAndResume(false /* isResume */);
Sihua Ma0593a0d2022-10-03 16:01:48 -07001110 mAppWidgetHolder.setActivityStarted(false);
Schneider Victor-tulias5173fd82021-10-19 14:47:23 -07001111 NotificationListener.removeNotificationsChangedListener(getPopupDataProvider());
Winson Chung7c500162023-06-14 18:58:27 +00001112 FloatingIconView.resetIconLoadResult();
Vadim Tryshev1b058fd2023-11-28 18:26:43 -08001113 AccessibilityManagerCompat.sendTestProtocolEventToTest(
1114 this, LAUNCHER_ACTIVITY_STOPPED_MESSAGE);
Michael Jurkacd496d72013-04-11 11:32:45 -07001115 }
1116
1117 @Override
1118 protected void onStart() {
Sunny Goyal67736672023-06-02 13:35:19 +00001119 TraceHelper.INSTANCE.beginSection(ON_START_EVT);
Michael Jurkacd496d72013-04-11 11:32:45 -07001120 super.onStart();
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001121 if (!mDeferOverlayCallbacks) {
Sunny Goyale82a20a2023-10-19 13:52:49 -07001122 mOverlayManager.onActivityStarted();
Adam Cohen9211d422014-10-07 18:14:53 -07001123 }
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001124
Sihua Ma0593a0d2022-10-03 16:01:48 -07001125 mAppWidgetHolder.setActivityStarted(true);
Sunny Goyal67736672023-06-02 13:35:19 +00001126 TraceHelper.INSTANCE.endSection();
Michael Jurkacd496d72013-04-11 11:32:45 -07001127 }
1128
Sunny Goyal35e7d382020-05-08 13:37:58 -07001129 @Override
1130 @CallSuper
1131 protected void onDeferredResumed() {
Hyunyoung Song95786e02020-09-15 00:34:10 -07001132 logStopAndResume(true /* isResume */);
Sunny Goyala002c6c2019-02-12 16:20:10 -08001133
Sunny Goyal35e7d382020-05-08 13:37:58 -07001134 // Process any items that were added while Launcher was away.
Sunny Goyal60e68c92020-08-12 13:59:27 -07001135 ItemInstallQueue.INSTANCE.get(this)
1136 .resumeModelPush(FLAG_ACTIVITY_PAUSED);
Sunny Goyale9c6f4c2019-05-30 11:35:25 -07001137
Sunny Goyal35e7d382020-05-08 13:37:58 -07001138 // Refresh shortcuts if the permission changed.
Sunny Goyal8b74cc72020-07-27 17:50:33 -07001139 mModel.validateModelDataOnResume();
Sunny Goyale9c6f4c2019-05-30 11:35:25 -07001140
Sunny Goyal35e7d382020-05-08 13:37:58 -07001141 // Set the notification listener and fetch updated notifications when we resume
Schneider Victor-tulias5173fd82021-10-19 14:47:23 -07001142 NotificationListener.addNotificationsChangedListener(mPopupDataProvider);
Winson Chung87583112019-06-10 14:20:58 -07001143
Sunny Goyal35e7d382020-05-08 13:37:58 -07001144 DiscoveryBounce.showForHomeIfNeeded(this);
Sihua Ma0593a0d2022-10-03 16:01:48 -07001145 mAppWidgetHolder.setActivityResumed(true);
Andy Wickhama6013412024-01-18 18:45:52 -08001146
1147 // Listen for IME changes to keep state up to date.
1148 getRootView().setWindowInsetsAnimationCallback(
1149 new WindowInsetsAnimation.Callback(DISPATCH_MODE_CONTINUE_ON_SUBTREE) {
1150 @Override
1151 public WindowInsets onProgress(WindowInsets windowInsets,
1152 List<WindowInsetsAnimation> windowInsetsAnimations) {
1153 return windowInsets;
1154 }
1155
1156 @Override
1157 public void onEnd(WindowInsetsAnimation animation) {
1158 WindowInsets insets = getRootView().getRootWindowInsets();
1159 boolean isImeVisible =
1160 insets != null && insets.isVisible(WindowInsets.Type.ime());
1161 getStatsLogManager().keyboardStateManager().setKeyboardState(
1162 isImeVisible ? SHOW : HIDE);
1163 }
1164 });
Sunny Goyaldedda052019-05-14 15:23:48 -07001165 }
1166
Hyunyoung Song95786e02020-09-15 00:34:10 -07001167 private void logStopAndResume(boolean isResume) {
Sebastian Francoe4965122023-12-01 13:27:42 -06001168 if (mModelCallbacks.getPendingExecutor() != null) return;
Hyunyoung Song801f81f2020-06-19 02:58:53 -07001169 int pageIndex = mWorkspace.isOverlayShown() ? -1 : mWorkspace.getCurrentPage();
Hyunyoung Song95786e02020-09-15 00:34:10 -07001170 int statsLogOrdinal = mStateManager.getState().statsLogOrdinal;
Hyunyoung Song801f81f2020-06-19 02:58:53 -07001171
1172 StatsLogManager.EventEnum event;
1173 StatsLogManager.StatsLogger logger = getStatsLogManager().logger();
Hyunyoung Song95786e02020-09-15 00:34:10 -07001174 if (isResume) {
Hyunyoung Song801f81f2020-06-19 02:58:53 -07001175 logger.withSrcState(LAUNCHER_STATE_BACKGROUND)
Hyunyoung Song95786e02020-09-15 00:34:10 -07001176 .withDstState(mStateManager.getState().statsLogOrdinal);
Hyunyoung Song801f81f2020-06-19 02:58:53 -07001177 event = LAUNCHER_ONRESUME;
1178 } else { /* command == Action.Command.STOP */
Hyunyoung Song95786e02020-09-15 00:34:10 -07001179 logger.withSrcState(mStateManager.getState().statsLogOrdinal)
Hyunyoung Song801f81f2020-06-19 02:58:53 -07001180 .withDstState(LAUNCHER_STATE_BACKGROUND);
1181 event = LAUNCHER_ONSTOP;
1182 }
1183
Hyunyoung Song95786e02020-09-15 00:34:10 -07001184 if (statsLogOrdinal == LAUNCHER_STATE_HOME && mWorkspace != null) {
Hyunyoung Song801f81f2020-06-19 02:58:53 -07001185 logger.withContainerInfo(LauncherAtom.ContainerInfo.newBuilder()
1186 .setWorkspace(
1187 LauncherAtom.WorkspaceContainer.newBuilder()
1188 .setPageIndex(pageIndex)).build());
Becky Qiubfc2da12019-08-01 11:09:38 -07001189 }
Hyunyoung Song801f81f2020-06-19 02:58:53 -07001190 logger.log(event);
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001191 }
Becky Qiubfc2da12019-08-01 11:09:38 -07001192
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001193 private void scheduleDeferredCheck() {
1194 mHandler.removeCallbacks(mDeferredOverlayCallbacks);
1195 postAsyncCallback(mHandler, mDeferredOverlayCallbacks);
1196 }
1197
1198 private void checkIfOverlayStillDeferred() {
1199 if (!mDeferOverlayCallbacks) {
1200 return;
1201 }
Sunny Goyal8f965462020-04-23 19:00:36 -07001202 if (isStarted() && (!hasBeenResumed()
1203 || mStateManager.getState().hasFlag(FLAG_NON_INTERACTIVE))) {
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001204 return;
1205 }
1206 mDeferOverlayCallbacks = false;
1207
1208 // Move the client to the correct state. Calling the same method twice is no-op.
1209 if (isStarted()) {
Sunny Goyale82a20a2023-10-19 13:52:49 -07001210 mOverlayManager.onActivityStarted();
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001211 }
1212 if (hasBeenResumed()) {
Sunny Goyale82a20a2023-10-19 13:52:49 -07001213 mOverlayManager.onActivityResumed();
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001214 } else {
Sunny Goyale82a20a2023-10-19 13:52:49 -07001215 mOverlayManager.onActivityPaused();
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001216 }
1217 if (!isStarted()) {
Sunny Goyale82a20a2023-10-19 13:52:49 -07001218 mOverlayManager.onActivityStopped();
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001219 }
1220 }
1221
1222 public void deferOverlayCallbacksUntilNextResumeOrStop() {
1223 mDeferOverlayCallbacks = true;
1224 }
1225
Sunny Goyal35e7d382020-05-08 13:37:58 -07001226 @Override
Winson Chungef528762019-09-06 12:05:52 -07001227 public void onStateSetStart(LauncherState state) {
Sunny Goyal35e7d382020-05-08 13:37:58 -07001228 super.onStateSetStart(state);
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001229 if (mDeferOverlayCallbacks) {
1230 scheduleDeferredCheck();
Sunny Goyale9c6f4c2019-05-30 11:35:25 -07001231 }
Sunny Goyal210e1742019-10-17 12:05:38 -07001232 addActivityFlags(ACTIVITY_STATE_TRANSITION_ACTIVE);
Sunny Goyal8f965462020-04-23 19:00:36 -07001233
Charlie Anderson438d4052023-04-25 14:38:57 -04001234 if (state == SPRING_LOADED || state == EDIT_MODE) {
Sunny Goyal8f965462020-04-23 19:00:36 -07001235 // Prevent any Un/InstallShortcutReceivers from updating the db while we are
1236 // not on homescreen
Sunny Goyal60e68c92020-08-12 13:59:27 -07001237 ItemInstallQueue.INSTANCE.get(this).pauseModelPush(FLAG_DRAG_AND_DROP);
Sunny Goyal8f965462020-04-23 19:00:36 -07001238 getRotationHelper().setCurrentStateRequest(REQUEST_LOCK);
1239
1240 mWorkspace.showPageIndicatorAtCurrentScroll();
1241 mWorkspace.setClipChildren(false);
1242 }
1243 // When multiple pages are visible, show persistent page indicator
1244 mWorkspace.getPageIndicator().setShouldAutoHide(!state.hasFlag(FLAG_MULTI_PAGE));
thiruram0eabc782021-04-02 14:30:10 -07001245
thiruramc96873c2021-02-11 15:13:47 -08001246 mPrevLauncherState = mStateManager.getCurrentStableState();
thiruram0eabc782021-04-02 14:30:10 -07001247 if (mPrevLauncherState != state && ALL_APPS.equals(state)
1248 // Making sure mAllAppsSessionLogId is null to avoid double logging.
1249 && mAllAppsSessionLogId == null) {
1250 // creates new instance ID since new all apps session is started.
1251 mAllAppsSessionLogId = new InstanceIdSequence().newInstanceId();
Thiru Ramasamy694407c2022-03-08 12:11:24 -08001252 if (getAllAppsEntryEvent().isPresent()) {
1253 getStatsLogManager().logger()
1254 .withContainerInfo(ContainerInfo.newBuilder()
1255 .setWorkspace(WorkspaceContainer.newBuilder()
1256 .setPageIndex(getWorkspace().getCurrentPage())).build())
1257 .log(getAllAppsEntryEvent().get());
1258 }
thiruram0eabc782021-04-02 14:30:10 -07001259 }
Sunny Goyal1eb11242022-09-09 17:14:45 -07001260 updateDisallowBack();
Sunny Goyaldedda052019-05-14 15:23:48 -07001261 }
1262
Thiru Ramasamy5fbac632022-01-28 15:05:36 -08001263 /**
1264 * Returns {@link EventEnum} that should be logged when Launcher enters into AllApps state.
1265 */
Thiru Ramasamy694407c2022-03-08 12:11:24 -08001266 protected Optional<EventEnum> getAllAppsEntryEvent() {
Sunny Goyal4f9ba252024-09-13 14:20:44 -07001267 return Optional.of(LAUNCHER_ALLAPPS_ENTRY_WITH_DEVICE_SEARCH);
Thiru Ramasamy5fbac632022-01-28 15:05:36 -08001268 }
1269
Sunny Goyal35e7d382020-05-08 13:37:58 -07001270 @Override
Winson Chungef528762019-09-06 12:05:52 -07001271 public void onStateSetEnd(LauncherState state) {
Sunny Goyalfee1b252020-12-14 12:30:38 -08001272 super.onStateSetEnd(state);
Sihua Ma0593a0d2022-10-03 16:01:48 -07001273 getAppWidgetHolder().setStateIsNormal(state == LauncherState.NORMAL);
Sunny Goyal8f965462020-04-23 19:00:36 -07001274 getWorkspace().setClipChildren(!state.hasFlag(FLAG_MULTI_PAGE));
1275
Winson Chungef528762019-09-06 12:05:52 -07001276 finishAutoCancelActionMode();
Sunny Goyal210e1742019-10-17 12:05:38 -07001277 removeActivityFlags(ACTIVITY_STATE_TRANSITION_ACTIVE);
Sunny Goyal8f965462020-04-23 19:00:36 -07001278
1279 // dispatch window state changed
1280 getWindow().getDecorView().sendAccessibilityEvent(TYPE_WINDOW_STATE_CHANGED);
1281 AccessibilityManagerCompat.sendStateEventToTest(this, state.ordinal);
1282
1283 if (state == NORMAL) {
1284 // Re-enable any Un/InstallShortcutReceiver and now process any queued items
Sunny Goyal60e68c92020-08-12 13:59:27 -07001285 ItemInstallQueue.INSTANCE.get(this)
1286 .resumeModelPush(FLAG_DRAG_AND_DROP);
Sunny Goyal8f965462020-04-23 19:00:36 -07001287
1288 // Clear any rotation locks when going to normal state
1289 getRotationHelper().setCurrentStateRequest(REQUEST_NONE);
1290 }
thiruramc96873c2021-02-11 15:13:47 -08001291
thiruramea56f842021-06-02 16:02:37 -07001292 if (ALL_APPS.equals(mPrevLauncherState) && !ALL_APPS.equals(state)
thiruram0eabc782021-04-02 14:30:10 -07001293 // Making sure mAllAppsSessionLogId is not null to avoid double logging.
thiruramc96873c2021-02-11 15:13:47 -08001294 && mAllAppsSessionLogId != null) {
Samuel Fuface820f52021-06-18 17:23:48 -05001295 getAppsView().reset(false);
Thiru Ramasamy694407c2022-03-08 12:11:24 -08001296 getAllAppsExitEvent().ifPresent(getStatsLogManager().logger()::log);
thiruramc96873c2021-02-11 15:13:47 -08001297 mAllAppsSessionLogId = null;
1298 }
Holly Sun47b9cb82024-04-25 10:31:37 -07001299
1300 // Set screen title for Talkback
Jordan Silva8181dfd2024-05-29 14:40:46 +01001301 setTitle(state.getTitle());
Winson Chungef528762019-09-06 12:05:52 -07001302 }
1303
Thiru Ramasamy694407c2022-03-08 12:11:24 -08001304 /**
1305 * Returns {@link EventEnum} that should be logged when Launcher exists from AllApps state.
1306 */
1307 protected Optional<EventEnum> getAllAppsExitEvent() {
1308 return Optional.of(LAUNCHER_ALLAPPS_EXIT);
1309 }
1310
Michael Jurkacd496d72013-04-11 11:32:45 -07001311 @Override
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001312 protected void onResume() {
Sunny Goyal67736672023-06-02 13:35:19 +00001313 TraceHelper.INSTANCE.beginSection(ON_RESUME_EVT);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001314 super.onResume();
Sunny Goyalfca6bc92017-09-28 16:28:34 -07001315
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001316 if (mDeferOverlayCallbacks) {
1317 scheduleDeferredCheck();
1318 } else {
Sunny Goyale82a20a2023-10-19 13:52:49 -07001319 mOverlayManager.onActivityResumed();
Adam Cohen9211d422014-10-07 18:14:53 -07001320 }
Mario Bertschler0fc6f682017-02-17 12:16:13 -08001321
Jon Mirandaa82a7dc2022-05-10 11:48:32 -07001322 DragView.removeAllViews(this);
Sunny Goyal67736672023-06-02 13:35:19 +00001323 TraceHelper.INSTANCE.endSection();
Adam Cohen06dff352012-06-01 17:17:08 -07001324 }
1325
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001326 @Override
The Android Open Source Project7376fae2009-03-11 12:11:58 -07001327 protected void onPause() {
Winson Chung997a9232013-07-24 15:33:46 -07001328 // Ensure that items added to Launcher are queued until Launcher returns
Sunny Goyal60e68c92020-08-12 13:59:27 -07001329 ItemInstallQueue.INSTANCE.get(this).pauseModelPush(FLAG_ACTIVITY_PAUSED);
Winson Chung997a9232013-07-24 15:33:46 -07001330
The Android Open Source Project7376fae2009-03-11 12:11:58 -07001331 super.onPause();
Joe Onorato24b6fd82009-11-12 13:47:09 -08001332 mDragController.cancelDrag();
Sunny Goyal9b180102020-03-11 10:02:29 -07001333 mLastTouchUpTime = -1;
Hyunyoung Song497708c2019-05-01 16:16:53 -07001334 mDropTargetBar.animateToVisibility(false);
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001335
1336 if (!mDeferOverlayCallbacks) {
Sunny Goyale82a20a2023-10-19 13:52:49 -07001337 mOverlayManager.onActivityPaused();
Adam Cohenbffe7452013-07-22 18:21:45 -07001338 }
Sihua Ma0593a0d2022-10-03 16:01:48 -07001339 mAppWidgetHolder.setActivityResumed(false);
Adam Cohenbffe7452013-07-22 18:21:45 -07001340 }
1341
Lucas Dupin87d75202021-07-28 10:24:54 -07001342 /**
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001343 * Restores the previous state, if it exists.
1344 *
1345 * @param savedState The previous state.
1346 */
1347 private void restoreState(Bundle savedState) {
1348 if (savedState == null) {
1349 return;
1350 }
1351
Sunny Goyal3e3f44c2017-10-23 17:14:52 -07001352 int stateOrdinal = savedState.getInt(RUNTIME_STATE, NORMAL.ordinal);
Sunny Goyalf9403d92017-10-18 10:55:56 -07001353 LauncherState[] stateValues = LauncherState.values();
1354 LauncherState state = stateValues[stateOrdinal];
Sunny Goyal6c0c61a2020-12-08 19:19:56 -08001355
1356 NonConfigInstance lastInstance = (NonConfigInstance) getLastNonConfigurationInstance();
1357 boolean forceRestore = lastInstance != null
Alex Chau007abe82024-12-02 14:29:38 +00001358 && ((lastInstance.config.diff(mOldConfig) & CONFIG_UI_MODE) != 0
1359 || savedState.getBoolean(RUNTIME_STATE_RECREATE_TO_UPDATE_THEME));
Sunny Goyal6c0c61a2020-12-08 19:19:56 -08001360 if (forceRestore || !state.shouldDisableRestore()) {
Sunny Goyal3e3f44c2017-10-23 17:14:52 -07001361 mStateManager.goToState(state, false /* animated */);
Joe Onorato3a8820b2009-11-10 15:06:42 -08001362 }
1363
Samuel Fufaca37b8a2019-08-19 17:04:36 -07001364 PendingRequestArgs requestArgs = savedState.getParcelable(
1365 RUNTIME_STATE_PENDING_REQUEST_ARGS);
Sunny Goyal2100c782016-08-22 16:00:03 -07001366 if (requestArgs != null) {
1367 setWaitingForResult(requestArgs);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001368 }
Fengjiang Lidd7d8542024-10-24 12:52:26 +08001369 mPendingActivityRequestCode = savedState.getInt(
1370 RUNTIME_STATE_PENDING_REQUEST_CODE, mPendingActivityRequestCode);
Sunny Goyal2100c782016-08-22 16:00:03 -07001371
1372 mPendingActivityResult = savedState.getParcelable(RUNTIME_STATE_PENDING_ACTIVITY_RESULT);
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -07001373
1374 SparseArray<Parcelable> widgetsState =
1375 savedState.getSparseParcelableArray(RUNTIME_STATE_WIDGET_PANEL);
1376 if (widgetsState != null) {
1377 WidgetsFullSheet.show(this, false).restoreHierarchyState(widgetsState);
1378 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001379 }
1380
1381 /**
1382 * Finds all the views we need and configure them properly.
1383 */
Tony Wickham04fca162020-02-05 15:06:52 -08001384 protected void setupViews() {
Fengjiang Li5a36c172023-04-13 18:18:27 +00001385 mStartupLatencyLogger.logStart(LAUNCHER_LATENCY_STARTUP_VIEW_INFLATION);
Becky Qiu3aec5d52022-09-16 11:17:50 -07001386 inflateRootView(R.layout.launcher);
Fengjiang Li5a36c172023-04-13 18:18:27 +00001387 mStartupLatencyLogger.logEnd(LAUNCHER_LATENCY_STARTUP_VIEW_INFLATION);
1388
Sunny Goyalcc96aa12018-01-11 09:56:07 -08001389 mDragLayer = findViewById(R.id.drag_layer);
Sunny Goyal3333b0c2016-05-09 20:43:21 -07001390 mFocusHandler = mDragLayer.getFocusIndicatorHelper();
Sunny Goyal966d9012017-06-06 16:43:59 -07001391 mWorkspace = mDragLayer.findViewById(R.id.workspace);
Sunny Goyald0a6ae72016-06-16 12:29:03 -07001392 mWorkspace.initParentViews(mDragLayer);
Sreyas321bfae2020-02-21 17:53:02 -08001393 mOverviewPanel = findViewById(R.id.overview_panel);
Sunny Goyal7c7be8c2018-03-07 19:58:07 -08001394 mHotseat = findViewById(R.id.hotseat);
Adam Cohenb66675a2020-05-15 16:16:17 -07001395 mHotseat.setWorkspace(mWorkspace);
Craig Mautner360310b2012-10-26 15:13:08 -07001396
Winson Chung4c98d922011-05-31 16:50:48 -07001397 // Setup the drag layer
Sunny Goyal5d1873a2018-05-08 11:10:44 -07001398 mDragLayer.setup(mDragController, mWorkspace);
Winson Chung4c98d922011-05-31 16:50:48 -07001399
Hyunyoung Song645764e2016-06-06 14:19:02 -07001400 mWorkspace.setup(mDragController);
Winsonc7d2e832016-07-28 12:24:55 -07001401 // Until the workspace is bound, ensure that we keep the wallpaper offset locked to the
1402 // default state, otherwise we will update to the wrong offsets in RTL
1403 mWorkspace.lockWallpaperToDefaultPage();
fbaron9d08e0f2024-04-24 11:26:01 -07001404 if (!enableSmartspaceRemovalToggle()) {
fbaronc0e687b2023-10-04 12:11:20 -07001405 mWorkspace.bindAndInitFirstWorkspaceScreen();
1406 }
Hyunyoung Song645764e2016-06-06 14:19:02 -07001407 mDragController.addDragListener(mWorkspace);
Winson Chung4c98d922011-05-31 16:50:48 -07001408
Tony Wickham34d2c912015-09-11 09:27:58 -07001409 // Get the search/delete/uninstall bar
Rajeev Kumar43c0f582017-06-23 15:34:55 -07001410 mDropTargetBar = mDragLayer.findViewById(R.id.drop_target_bar);
Patrick Dubroy3ec8bdd2010-08-06 16:01:33 -07001411
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -07001412 // Setup Apps
1413 mAppsView = findViewById(R.id.apps_view);
Fengjiang Lid080b982023-02-01 15:30:30 -08001414 mAppsView.setAllAppsTransitionController(mAllAppsController);
Craig Mautner360310b2012-10-26 15:13:08 -07001415
Govinda Wassermanc06e1512019-04-09 09:56:53 -04001416 // Setup Scrim
1417 mScrimView = findViewById(R.id.scrim_view);
1418
Winson Chung3d503fb2011-07-13 17:25:49 -07001419 // Setup the drag controller (drop targets have to be added in reverse order in priority)
Sunny Goyal47328fd2016-05-25 18:56:41 -07001420 mDropTargetBar.setup(mDragController);
Samuel Fufaacebd1f2021-05-06 10:02:03 -05001421 mAllAppsController.setupViews(mScrimView, mAppsView);
Federico Baron3f255eb2022-12-22 14:40:58 -08001422
fbaron80b0ce82023-09-27 16:23:15 -07001423 mWorkspace.getPageIndicator().setShouldAutoHide(true);
1424 mWorkspace.getPageIndicator().setPaintColor(Themes.getAttrBoolean(
1425 this, R.attr.isWorkspaceDarkText) ? Color.BLACK : Color.WHITE);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001426 }
1427
1428 /**
Jon Mirandac476d6e2017-05-04 16:30:01 -07001429 * Add a shortcut to the workspace or to a Folder.
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001430 *
1431 * @param data The intent describing the shortcut.
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001432 */
sfufa@google.comd0a33232021-09-19 15:59:36 -07001433 protected void completeAddShortcut(Intent data, int container, int screenId, int cellX,
Sunny Goyalfb5096d2016-09-08 14:32:06 -07001434 int cellY, PendingRequestArgs args) {
Holly Sun35b99602023-06-28 15:14:02 -07001435 if (args.getRequestCode() != REQUEST_CREATE_SHORTCUT) {
Sunny Goyalfb5096d2016-09-08 14:32:06 -07001436 return;
1437 }
Adam Cohen558baaf2011-08-15 15:22:57 -07001438
Jon Mirandac476d6e2017-05-04 16:30:01 -07001439 int[] cellXY = mTmpAddItemCellCoordinates;
1440 CellLayout layout = getCellLayout(container, screenId);
1441
Sunny Goyaleaf7a952020-07-29 16:54:20 -07001442 WorkspaceItemInfo info = PinRequestHelper.createWorkspaceItemFromPinItemRequest(
Sunny Goyale7b00122019-10-02 16:13:34 -07001443 this, PinRequestHelper.getPinItemRequest(data), 0);
Sunny Goyal782f0c92017-01-19 10:27:54 -08001444 if (info == null) {
Sunny Goyal84b48d82023-03-29 16:52:27 -07001445 Log.e(TAG, "Unable to parse a valid shortcut result");
1446 return;
Sunny Goyal782f0c92017-01-19 10:27:54 -08001447 }
1448
Jon Mirandac476d6e2017-05-04 16:30:01 -07001449 if (container < 0) {
1450 // Adding a shortcut to the Workspace.
Sunny Goyal4e014232024-01-18 13:53:45 -08001451 final View view = mItemInflater.inflateItem(info, getModelWriter());
Jon Mirandac476d6e2017-05-04 16:30:01 -07001452 boolean foundCellSpan = false;
1453 // First we check if we already know the exact location where we want to add this item.
1454 if (cellX >= 0 && cellY >= 0) {
1455 cellXY[0] = cellX;
1456 cellXY[1] = cellY;
1457 foundCellSpan = true;
Adam Cohen558baaf2011-08-15 15:22:57 -07001458
Hyunyoung Song1ae42422020-01-26 23:25:14 -08001459 DragObject dragObject = new DragObject(getApplicationContext());
1460 dragObject.dragInfo = info;
Jon Mirandac476d6e2017-05-04 16:30:01 -07001461 // If appropriate, either create a folder or add to an existing folder
1462 if (mWorkspace.createUserFolderIfNecessary(view, container, layout, cellXY, 0,
Hyunyoung Song1ae42422020-01-26 23:25:14 -08001463 true, dragObject)) {
Jon Mirandac476d6e2017-05-04 16:30:01 -07001464 return;
1465 }
Jon Mirandac476d6e2017-05-04 16:30:01 -07001466 if (mWorkspace.addToExistingFolderIfNecessary(view, layout, cellXY, 0, dragObject,
1467 true)) {
1468 return;
1469 }
1470 } else {
1471 foundCellSpan = layout.findCellForSpan(cellXY, 1, 1);
1472 }
1473
1474 if (!foundCellSpan) {
Yogisha Dixit104d09f2021-07-19 14:05:17 +01001475 mWorkspace.onNoCellFound(layout, info, /* logInstanceId= */ null);
Adam Cohen558baaf2011-08-15 15:22:57 -07001476 return;
1477 }
Jon Mirandac476d6e2017-05-04 16:30:01 -07001478
1479 getModelWriter().addItemToDatabase(info, container, screenId, cellXY[0], cellXY[1]);
1480 mWorkspace.addInScreen(view, info);
Michael Jurkad3ef3062010-11-23 16:23:58 -08001481 } else {
Jon Mirandac476d6e2017-05-04 16:30:01 -07001482 // Adding a shortcut to a Folder.
Sunny Goyale29897f52017-07-20 10:09:42 -07001483 FolderIcon folderIcon = findFolderIcon(container);
Jon Mirandac476d6e2017-05-04 16:30:01 -07001484 if (folderIcon != null) {
1485 FolderInfo folderInfo = (FolderInfo) folderIcon.getTag();
1486 folderInfo.add(info, args.rank, false);
1487 } else {
Sunny Goyale29897f52017-07-20 10:09:42 -07001488 Log.e(TAG, "Could not find folder with id " + container + " to add shortcut.");
Jon Mirandac476d6e2017-05-04 16:30:01 -07001489 }
Michael Jurka0280c3b2010-09-17 15:00:07 -07001490 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001491 }
1492
Tony Wickhamc7cbf252021-05-24 15:46:48 -07001493 @Override
1494 public @Nullable FolderIcon findFolderIcon(final int folderIconId) {
Sunny Goyal83fd25e2018-07-09 16:47:01 -07001495 return (FolderIcon) mWorkspace.getHomescreenIconByItemId(folderIconId);
Sunny Goyale29897f52017-07-20 10:09:42 -07001496 }
1497
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001498 /**
The Android Open Source Project7376fae2009-03-11 12:11:58 -07001499 * Add a widget to the workspace.
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001500 *
Romain Guy5bbc91b2010-08-18 11:38:46 -07001501 * @param appWidgetId The app widget id
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001502 */
Samuel Fufaca37b8a2019-08-19 17:04:36 -07001503 @Thunk
1504 void completeAddAppWidget(int appWidgetId, ItemInfo itemInfo,
Fengjiang Li8bd66ee2024-01-26 10:00:47 -08001505 @Nullable AppWidgetHostView hostView, LauncherAppWidgetProviderInfo appWidgetInfo,
Fengjiang Li6f8069a2024-03-20 12:04:29 -07001506 boolean showPendingWidget, boolean updateWidgetSize,
1507 @Nullable Bitmap widgetPreviewBitmap) {
Adam Cohen59400422014-03-05 18:07:04 -08001508
Adam Cohened66b2b2012-01-23 17:28:51 -08001509 if (appWidgetInfo == null) {
fbaron30d9e3f2023-08-03 17:03:59 -07001510 appWidgetInfo = mAppWidgetManager.getLauncherAppWidgetInfo(appWidgetId,
1511 itemInfo.getTargetComponent());
Adam Cohened66b2b2012-01-23 17:28:51 -08001512 }
Romain Guycbb89e42009-06-08 15:52:54 -07001513
Fengjiang Li8bd66ee2024-01-26 10:00:47 -08001514 if (hostView == null && !showPendingWidget) {
Yogisha Dixit0b15c7e2021-05-10 12:01:58 +01001515 // Perform actual inflation because we're live
Sunny Goyalfdeb19e2024-01-05 09:29:06 -08001516 hostView = mAppWidgetHolder.createView(appWidgetId, appWidgetInfo);
Yogisha Dixit0b15c7e2021-05-10 12:01:58 +01001517 }
1518
Adam Cohen59400422014-03-05 18:07:04 -08001519 LauncherAppWidgetInfo launcherInfo;
Yogisha Dixit0b15c7e2021-05-10 12:01:58 +01001520 launcherInfo =
1521 new LauncherAppWidgetInfo(
1522 appWidgetId, appWidgetInfo.provider, appWidgetInfo, hostView);
Sunny Goyal2100c782016-08-22 16:00:03 -07001523 launcherInfo.spanX = itemInfo.spanX;
1524 launcherInfo.spanY = itemInfo.spanY;
1525 launcherInfo.minSpanX = itemInfo.minSpanX;
1526 launcherInfo.minSpanY = itemInfo.minSpanY;
Sunny Goyal952e63d2017-08-16 04:59:08 -07001527 launcherInfo.user = appWidgetInfo.getProfile();
Fengjiang Li8bd66ee2024-01-26 10:00:47 -08001528 CellPos presenterPos = getCellPosMapper().mapModelToPresenter(itemInfo);
1529 if (showPendingWidget) {
1530 launcherInfo.restoreStatus = LauncherAppWidgetInfo.FLAG_UI_NOT_READY;
Sunny Goyal72a74662024-02-14 12:32:59 -08001531 PendingAppWidgetHostView pendingAppWidgetHostView = new PendingAppWidgetHostView(
Fengjiang Lifb165172024-03-04 15:36:08 -08001532 this, mAppWidgetHolder, launcherInfo, appWidgetInfo, widgetPreviewBitmap);
Fengjiang Li8bd66ee2024-01-26 10:00:47 -08001533 hostView = pendingAppWidgetHostView;
1534 } else if (hostView instanceof PendingAppWidgetHostView) {
Fengjiang Lifb165172024-03-04 15:36:08 -08001535 ((PendingAppWidgetHostView) hostView).setPreviewBitmapAndUpdateBackground(null);
Fengjiang Li8bd66ee2024-01-26 10:00:47 -08001536 // User has selected a widget config and exited the config activity, we can trigger
1537 // re-inflation of PendingAppWidgetHostView to replace it with
1538 // LauncherAppWidgetHostView in workspace.
1539 completeRestoreAppWidget(appWidgetId, LauncherAppWidgetInfo.RESTORE_COMPLETED);
1540
1541 // Show resize frame on the newly inflated LauncherAppWidgetHostView.
1542 LauncherAppWidgetHostView reInflatedHostView =
1543 getWorkspace().getWidgetForAppWidgetId(appWidgetId);
1544 showWidgetResizeFrame(
1545 reInflatedHostView,
1546 (LauncherAppWidgetInfo) reInflatedHostView.getTag(),
1547 presenterPos);
Fengjiang Li6f8069a2024-03-20 12:04:29 -07001548 // We always update widget size after re-inflating PendingAppWidgetHostView
1549 WidgetSizes.updateWidgetSizeRanges(
1550 reInflatedHostView, this, itemInfo.spanX, itemInfo.spanY);
Fengjiang Li8bd66ee2024-01-26 10:00:47 -08001551 return;
1552 }
Fengjiang Li6f8069a2024-03-20 12:04:29 -07001553 if (updateWidgetSize) {
1554 WidgetSizes.updateWidgetSizeRanges(hostView, this, itemInfo.spanX, itemInfo.spanY);
1555 }
Yogisha Dixit658c5da2021-05-24 23:23:15 +01001556 if (itemInfo instanceof PendingAddWidgetInfo) {
1557 launcherInfo.sourceContainer = ((PendingAddWidgetInfo) itemInfo).sourceContainer;
1558 } else if (itemInfo instanceof PendingRequestArgs) {
1559 launcherInfo.sourceContainer =
1560 ((PendingRequestArgs) itemInfo).getWidgetSourceContainer();
1561 }
Sunny Goyal43bf11d2017-02-02 13:52:53 -08001562 getModelWriter().addItemToDatabase(launcherInfo,
Sunny Goyal669b71f2023-01-27 14:37:07 -08001563 itemInfo.container, presenterPos.screenId, presenterPos.cellX, presenterPos.cellY);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001564
Sunny Goyal2100c782016-08-22 16:00:03 -07001565 hostView.setVisibility(View.VISIBLE);
Sunny Goyal4e014232024-01-18 13:53:45 -08001566 mItemInflater.prepareAppWidget(hostView, launcherInfo);
Fengjiang Li8bd66ee2024-01-26 10:00:47 -08001567 if (!enableAddAppWidgetViaConfigActivityV2() || hostView.getParent() == null) {
1568 mWorkspace.addInScreen(hostView, launcherInfo);
1569 }
Pinyao Tingc9074272019-11-11 11:51:44 -08001570 announceForAccessibility(R.string.item_added_to_workspace);
Yogisha Dixit037a5362021-03-22 14:13:03 +00001571
1572 // Show the widget resize frame.
1573 if (hostView instanceof LauncherAppWidgetHostView) {
1574 final LauncherAppWidgetHostView launcherHostView = (LauncherAppWidgetHostView) hostView;
Fengjiang Li8bd66ee2024-01-26 10:00:47 -08001575 showWidgetResizeFrame(launcherHostView, launcherInfo, presenterPos);
1576 }
1577 }
1578
1579 /** Show widget resize frame. */
1580 private void showWidgetResizeFrame(
1581 LauncherAppWidgetHostView launcherHostView,
1582 LauncherAppWidgetInfo launcherInfo,
1583 CellPos presenterPos) {
1584 CellLayout cellLayout = getCellLayout(launcherInfo.container, presenterPos.screenId);
Fengjiang Li59091e42024-04-08 18:13:23 -07001585 // We should wait until launcher is not animating to show resize frame so that
1586 // {@link View#hasIdentityMatrix()} returns true (no scale effect) from CellLayout and
1587 // Workspace (they are widget's parent view). Otherwise widget's
1588 // {@link View#getLocationInWindow(int[])} will set skewed location, causing resize
1589 // frame not showing at skewed location in
1590 // {@link AppWidgetResizeFrame#snapToWidget(boolean)}.
1591 if (mStateManager.getState() == NORMAL && !mStateManager.isInTransition()) {
Fengjiang Li8bd66ee2024-01-26 10:00:47 -08001592 AppWidgetResizeFrame.showForWidget(launcherHostView, cellLayout);
1593 } else {
1594 mStateManager.addStateListener(new StateManager.StateListener<LauncherState>() {
1595 @Override
1596 public void onStateTransitionComplete(LauncherState finalState) {
1597 if ((mPrevLauncherState == SPRING_LOADED || mPrevLauncherState == EDIT_MODE)
1598 && finalState == NORMAL) {
1599 AppWidgetResizeFrame.showForWidget(launcherHostView, cellLayout);
1600 mStateManager.removeStateListener(this);
Yogisha Dixit037a5362021-03-22 14:13:03 +00001601 }
Fengjiang Li8bd66ee2024-01-26 10:00:47 -08001602 }
1603 });
Yogisha Dixit037a5362021-03-22 14:13:03 +00001604 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001605 }
Romain Guycbb89e42009-06-08 15:52:54 -07001606
Sunny Goyala992ac92023-01-10 17:50:32 -08001607 private final ScreenOnListener mScreenOnListener = this::onScreenOnChanged;
Adam Cohended9f8d2010-11-03 13:25:16 -07001608
Sunny Goyal9c2b9602020-01-07 13:07:55 -08001609 private void updateNotificationDots(Predicate<PackageUserKey> updatedDots) {
Tony Wickhamf34bee82018-12-03 18:11:39 -08001610 mWorkspace.updateNotificationDots(updatedDots);
1611 mAppsView.getAppsStore().updateNotificationDots(updatedDots);
Tony Wickham010d2552017-01-20 08:15:28 -08001612 }
1613
Adam Cohended9f8d2010-11-03 13:25:16 -07001614 @Override
1615 public void onAttachedToWindow() {
1616 super.onAttachedToWindow();
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001617 mOverlayManager.onAttachedToWindow();
Adam Cohended9f8d2010-11-03 13:25:16 -07001618 }
1619
1620 @Override
1621 public void onDetachedFromWindow() {
1622 super.onDetachedFromWindow();
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001623 mOverlayManager.onDetachedFromWindow();
1624 closeContextMenu();
Adam Cohended9f8d2010-11-03 13:25:16 -07001625 }
1626
Schneider Victor-tulias25ecae12020-09-14 14:07:38 -07001627 @Override
1628 public Object onRetainNonConfigurationInstance() {
Sunny Goyal6c0c61a2020-12-08 19:19:56 -08001629 NonConfigInstance instance = new NonConfigInstance();
1630 instance.config = new Configuration(mOldConfig);
Sunny Goyal6c0c61a2020-12-08 19:19:56 -08001631 return instance;
Schneider Victor-tulias25ecae12020-09-14 14:07:38 -07001632 }
1633
Sihua Ma0593a0d2022-10-03 16:01:48 -07001634 protected LauncherWidgetHolder createAppWidgetHolder() {
Sihua Ma1db8bc22022-11-08 17:13:13 -08001635 return LauncherWidgetHolder.HolderFactory.newFactory(this).newInstance(
1636 this, appWidgetId -> getWorkspace().removeWidget(appWidgetId));
Cyrus Boadway0d309db2021-04-14 12:29:14 +00001637 }
1638
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001639 @Override
1640 protected void onNewIntent(Intent intent) {
Brian Isganitisfdd044e2023-03-02 19:45:23 +00001641 if (Utilities.isRunningInTestHarness()) {
vadimtbaf5fbb2019-12-16 18:56:09 -08001642 Log.d(TestProtocol.PERMANENT_DIAG_TAG, "Launcher.onNewIntent: " + intent);
1643 }
Sunny Goyal67736672023-06-02 13:35:19 +00001644 TraceHelper.INSTANCE.beginSection(ON_NEW_INTENT_EVT);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001645 super.onNewIntent(intent);
1646
Sunny Goyalf4aceab2017-12-06 16:16:31 -08001647 boolean alreadyOnHome = hasWindowFocus() && ((intent.getFlags() &
Winson15f8b172015-08-19 11:02:39 -07001648 Intent.FLAG_ACTIVITY_BROUGHT_TO_FRONT)
1649 != Intent.FLAG_ACTIVITY_BROUGHT_TO_FRONT);
Sunny Goyal85313732016-09-28 12:00:07 -07001650
1651 // Check this condition before handling isActionMain, as this will get reset.
Sunny Goyal3e3f44c2017-10-23 17:14:52 -07001652 boolean shouldMoveToDefaultScreen = alreadyOnHome && isInState(NORMAL)
Sunny Goyalf9403d92017-10-18 10:55:56 -07001653 && AbstractFloatingView.getTopOpenView(this) == null;
Winson15f8b172015-08-19 11:02:39 -07001654 boolean isActionMain = Intent.ACTION_MAIN.equals(intent.getAction());
Winson Chung1c2d5222021-06-08 11:50:13 -07001655 boolean internalStateHandled = ACTIVITY_TRACKER.handleNewIntent(this);
kholoud mohamedceec31b2022-02-03 15:44:25 +00001656
Winson15f8b172015-08-19 11:02:39 -07001657 if (isActionMain) {
Sunny Goyald3864fa2017-11-14 15:06:36 -08001658 if (!internalStateHandled) {
Sunny Goyald3864fa2017-11-14 15:06:36 -08001659 // In all these cases, only animate if we're already on home
Schneider Victor-tulias3913e292023-07-21 15:24:57 -07001660 AbstractFloatingView.closeAllOpenViewsExcept(
1661 this, isStarted(), AbstractFloatingView.TYPE_LISTENER);
Jon Mirandafeba90f2016-10-06 10:53:29 -07001662
Sunny Goyala2467272018-03-16 14:53:05 -07001663 if (!isInState(NORMAL)) {
1664 // Only change state, if not already the same. This prevents cancelling any
1665 // animations running as part of resume
Sunny Goyalfee1b252020-12-14 12:30:38 -08001666 mStateManager.goToState(NORMAL, mStateManager.shouldAnimateStateChange());
Sunny Goyala2467272018-03-16 14:53:05 -07001667 }
Sunny Goyald3864fa2017-11-14 15:06:36 -08001668
1669 // Reset the apps view
Sunny Goyal5d1873a2018-05-08 11:10:44 -07001670 if (!alreadyOnHome) {
Sunny Goyal7185dd62018-03-14 17:51:49 -07001671 mAppsView.reset(isStarted() /* animate */);
Sunny Goyald3864fa2017-11-14 15:06:36 -08001672 }
1673
Sunny Goyalaad33592018-08-07 17:20:35 -07001674 if (shouldMoveToDefaultScreen && !mWorkspace.isHandlingTouch()) {
Sunny Goyald3864fa2017-11-14 15:06:36 -08001675 mWorkspace.post(mWorkspace::moveToDefaultScreen);
1676 }
1677 }
Adam Cohen6fecd412013-10-02 17:41:50 -07001678
Vinit Nayaka1be4c12023-10-24 16:57:39 -07001679 if (FeatureFlags.enableSplitContextually()) {
Vinit Nayak5a9d4af2024-01-31 12:49:05 -08001680 handleSplitAnimationGoingToHome(LAUNCHER_SPLIT_SELECTION_EXIT_HOME);
Vinit Nayakf6c2e872023-07-07 13:37:24 -07001681 }
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001682 mOverlayManager.hideOverlay(isStarted() && !isForceInvisible());
Sunny Goyal30ac97d2020-06-24 23:47:46 -07001683 handleGestureContract(intent);
Sunny Goyal512a2c12020-04-08 12:52:45 -07001684 } else if (Intent.ACTION_ALL_APPS.equals(intent.getAction())) {
Winson Chungdd15ace2020-08-04 15:52:01 -07001685 showAllAppsFromIntent(alreadyOnHome);
Tracy Zhoucb93ec52023-03-31 22:51:17 -07001686 } else if (INTENT_ACTION_ALL_APPS_TOGGLE.equals(intent.getAction())) {
Brian Isganitis84fbec02024-04-09 10:55:58 -07001687 toggleAllAppsSearch(alreadyOnHome);
kholoud mohamedceec31b2022-02-03 15:44:25 +00001688 } else if (Intent.ACTION_SHOW_WORK_APPS.equals(intent.getAction())) {
Himanshu Guptab3cd9802024-02-25 14:49:06 +00001689 showAllAppsWithSelectedTabFromIntent(alreadyOnHome,
1690 ActivityAllAppsContainerView.AdapterHolder.WORK);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001691 }
Winson15f8b172015-08-19 11:02:39 -07001692
Sunny Goyal67736672023-06-02 13:35:19 +00001693 TraceHelper.INSTANCE.endSection();
Adam Coppa120b8e2013-11-12 16:26:04 +00001694 }
1695
Vinit Nayakf6c2e872023-07-07 13:37:24 -07001696 /** Handle animating away split placeholder view when user taps on home button */
Vinit Nayak5a9d4af2024-01-31 12:49:05 -08001697 protected void handleSplitAnimationGoingToHome(EventEnum splitDismissReason) {
Vinit Nayakf6c2e872023-07-07 13:37:24 -07001698 // Overridden
1699 }
1700
Brian Isganitis84fbec02024-04-09 10:55:58 -07001701 /** Toggles Launcher All Apps with keyboard ready for search. */
1702 public void toggleAllAppsSearch() {
1703 toggleAllAppsSearch(/* alreadyOnHome= */ true);
1704 }
1705
1706 protected void toggleAllAppsSearch(boolean alreadyOnHome) {
Tracy Zhoucb93ec52023-03-31 22:51:17 -07001707 if (getStateManager().isInStableState(ALL_APPS)) {
1708 getStateManager().goToState(NORMAL, alreadyOnHome);
1709 } else {
Anushree Ganjamb7369822023-11-06 18:00:12 -08001710 if (mWorkspace.isOverlayShown()) {
1711 mOverlayManager.hideOverlay(/* animate */true);
1712 }
Holly Sund9d70ea2023-09-05 13:14:22 -07001713 AbstractFloatingView.closeAllOpenViews(this);
1714 getStateManager().goToState(ALL_APPS, true /* animated */,
1715 new AnimationSuccessListener() {
1716 @Override
1717 public void onAnimationSuccess(Animator animator) {
1718 if (mAppsView.getSearchUiManager().getEditText() != null) {
1719 mAppsView.getSearchUiManager().getEditText().requestFocus();
1720 }
1721 }
1722 });
Tracy Zhoucb93ec52023-03-31 22:51:17 -07001723 }
1724 }
1725
Winson Chungdd15ace2020-08-04 15:52:01 -07001726 protected void showAllAppsFromIntent(boolean alreadyOnHome) {
Himanshu Guptab3cd9802024-02-25 14:49:06 +00001727 showAllAppsWithSelectedTabFromIntent(alreadyOnHome,
1728 ActivityAllAppsContainerView.AdapterHolder.MAIN);
Winson Chungdd15ace2020-08-04 15:52:01 -07001729 }
1730
Himanshu Guptab3cd9802024-02-25 14:49:06 +00001731 private void showAllAppsWithSelectedTabFromIntent(boolean alreadyOnHome, int tab) {
1732 AbstractFloatingView.closeAllOpenViews(this);
1733 getStateManager().goToState(ALL_APPS, alreadyOnHome);
1734 if (mAppsView.isSearching()) {
Holly Sun7bb92472024-04-26 14:21:33 -07001735 mAppsView.getSearchUiManager().resetSearch();
Himanshu Guptab3cd9802024-02-25 14:49:06 +00001736 }
1737 if (mAppsView.getCurrentPage() != tab) {
1738 mAppsView.switchToTab(tab);
1739 }
kholoud mohamedceec31b2022-02-03 15:44:25 +00001740 }
1741
Sunny Goyaldeb91c42020-03-24 02:17:59 -07001742 /**
Sunny Goyal30ac97d2020-06-24 23:47:46 -07001743 * Handles gesture nav contract
1744 */
1745 protected void handleGestureContract(Intent intent) {
1746 GestureNavContract gnc = GestureNavContract.fromIntent(intent);
1747 if (gnc != null) {
1748 AbstractFloatingView.closeOpenViews(this, false, TYPE_ICON_SURFACE);
1749 FloatingSurfaceView.show(this, gnc);
1750 }
1751 }
1752
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001753 @Override
Alex Chau007abe82024-12-02 14:29:38 +00001754 protected void recreateToUpdateTheme() {
1755 mRecreateToUpdateTheme = true;
1756 super.recreateToUpdateTheme();
1757 }
1758
1759 @Override
Adam Cohen1462de32012-07-24 22:34:36 -07001760 public void onRestoreInstanceState(Bundle state) {
1761 super.onRestoreInstanceState(state);
Sebastian Franco69fd7422023-10-06 16:48:58 -07001762 IntSet synchronouslyBoundPages = mModelCallbacks.getSynchronouslyBoundPages();
1763 if (synchronouslyBoundPages != null) {
1764 synchronouslyBoundPages.forEach(screenId -> {
Sunny Goyal12e3f1f2021-07-15 14:31:58 -07001765 int pageIndex = mWorkspace.getPageIndexForScreenId(screenId);
1766 if (pageIndex != PagedView.INVALID_PAGE) {
1767 mWorkspace.restoreInstanceStateForChild(pageIndex);
1768 }
1769 });
Andras Kloczl55edfe52021-05-14 12:21:30 +02001770 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001771 }
1772
1773 @Override
1774 protected void onSaveInstanceState(Bundle outState) {
Sunny Goyal12e3f1f2021-07-15 14:31:58 -07001775 outState.putIntArray(RUNTIME_STATE_CURRENT_SCREEN_IDS,
1776 mWorkspace.getCurrentPageScreenIds().getArray().toArray());
Sunny Goyalea609262017-10-25 15:47:38 -07001777 outState.putInt(RUNTIME_STATE, mStateManager.getState().ordinal);
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -07001778
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -07001779 AbstractFloatingView widgets = AbstractFloatingView
1780 .getOpenView(this, AbstractFloatingView.TYPE_WIDGETS_FULL_SHEET);
1781 if (widgets != null) {
1782 SparseArray<Parcelable> widgetsState = new SparseArray<>();
1783 widgets.saveHierarchyState(widgetsState);
1784 outState.putSparseParcelableArray(RUNTIME_STATE_WIDGET_PANEL, widgetsState);
1785 } else {
1786 outState.remove(RUNTIME_STATE_WIDGET_PANEL);
1787 }
1788
Federico Baron8bf1bca2022-09-27 16:19:11 -07001789 // We close any open folders and shortcut containers that are not safe for rebind,
1790 // and we need to make sure this state is reflected.
1791 AbstractFloatingView.closeAllOpenViewsExcept(
1792 this, isStarted() && !isForceInvisible(), TYPE_REBIND_SAFE);
Pinyao Tinga74b63a2019-07-17 23:26:06 -07001793 finishAutoCancelActionMode();
Tony Wickham49c8d292016-07-01 11:44:34 -07001794
Sunny Goyal2100c782016-08-22 16:00:03 -07001795 if (mPendingRequestArgs != null) {
1796 outState.putParcelable(RUNTIME_STATE_PENDING_REQUEST_ARGS, mPendingRequestArgs);
1797 }
Sunny Goyaldedda052019-05-14 15:23:48 -07001798 outState.putInt(RUNTIME_STATE_PENDING_REQUEST_CODE, mPendingActivityRequestCode);
1799
Sunny Goyal2100c782016-08-22 16:00:03 -07001800 if (mPendingActivityResult != null) {
1801 outState.putParcelable(RUNTIME_STATE_PENDING_ACTIVITY_RESULT, mPendingActivityResult);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001802 }
1803
Alex Chau007abe82024-12-02 14:29:38 +00001804 outState.putBoolean(RUNTIME_STATE_RECREATE_TO_UPDATE_THEME, mRecreateToUpdateTheme);
1805
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -07001806 super.onSaveInstanceState(outState);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001807 }
1808
1809 @Override
1810 public void onDestroy() {
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001811 super.onDestroy();
Schneider Victor-Tulias8463dc42024-10-22 15:29:59 -04001812 ACTIVITY_TRACKER.onContextDestroyed(this);
Romain Guycbb89e42009-06-08 15:52:54 -07001813
Tracy Zhoude8e25c2023-10-07 00:00:57 -07001814 SettingsCache.INSTANCE.get(this).unregister(TOUCHPAD_NATURAL_SCROLLING,
1815 mNaturalScrollingChangedListener);
Sunny Goyala992ac92023-01-10 17:50:32 -08001816 ScreenOnTracker.INSTANCE.get(this).removeListener(mScreenOnListener);
Sunny Goyalaaf7d1d2016-05-17 13:38:54 -07001817 mWorkspace.removeFolderListeners();
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001818 PluginManagerWrapper.INSTANCE.get(this).removePluginListener(this);
Winson Chunge7a03942011-08-05 15:05:12 -07001819
Sunny Goyala7a5bf32020-01-05 15:35:29 +05301820 mModel.removeCallbacks(this);
Sunny Goyal623eddd2018-03-02 12:24:41 -08001821 mRotationHelper.destroy();
Sunny Goyal745bad92016-05-02 10:54:12 -07001822
Sunny Goyal4df719a2024-01-03 19:31:32 -08001823 mAppWidgetHolder.stopListening();
Sihua Maaa2b8722022-10-25 15:17:58 -07001824 mAppWidgetHolder.destroy();
Patrick Dubroy2313eff2011-01-11 20:01:31 -08001825
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001826 TextKeyListener.getInstance().release();
Sebastian Francoe4965122023-12-01 13:27:42 -06001827 mModelCallbacks.clearPendingBinds();
Hyunyoung Song31971a32019-01-27 12:31:12 -08001828 LauncherAppState.getIDP(this).removeOnChangeListener(this);
Fengjiang Li17720f12023-12-07 11:03:11 -08001829 // if Launcher activity is recreated, {@link Window} including {@link ViewTreeObserver}
1830 // could be preserved in {@link ActivityThread#scheduleRelaunchActivity(IBinder)} if the
1831 // previous activity has not stopped, which could happen when wallpaper detects a color
1832 // changes while launcher is still loading.
1833 getRootView().getViewTreeObserver().removeOnPreDrawListener(mOnInitialBindListener);
Sunny Goyale82a20a2023-10-19 13:52:49 -07001834 mOverlayManager.onActivityDestroyed();
Ana Salazar Maldonadobdbad822024-10-22 21:20:20 +00001835 PillColorProvider.getInstance(mWorkspace.getContext()).unregisterObserver();
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001836 }
1837
Sunny Goyalae502842016-06-17 08:43:56 -07001838 public LauncherAccessibilityDelegate getAccessibilityDelegate() {
1839 return mAccessibilityDelegate;
1840 }
1841
Adam Cohena9cf38f2011-05-02 15:36:58 -07001842 public DragController getDragController() {
1843 return mDragController;
1844 }
1845
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001846 @Override
Andrew Cole44898c32023-04-05 13:49:32 -07001847 public DropTargetHandler getDropTargetHandler() {
1848 return new DropTargetHandler(this);
1849 }
1850
1851 @Override
Sunny Goyal0eca4e22016-07-20 11:43:06 -07001852 public void startActivityForResult(Intent intent, int requestCode, Bundle options) {
Sunny Goyaldedda052019-05-14 15:23:48 -07001853 if (requestCode != -1) {
1854 mPendingActivityRequestCode = requestCode;
1855 }
Sunny Goyal210e1742019-10-17 12:05:38 -07001856 super.startActivityForResult(intent, requestCode, options);
Adam Cohen173f7112015-03-27 15:14:00 -07001857 }
1858
1859 @Override
Sunny Goyaldedda052019-05-14 15:23:48 -07001860 public void startIntentSenderForResult(IntentSender intent, int requestCode,
Adam Cohen173f7112015-03-27 15:14:00 -07001861 Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags, Bundle options) {
Sunny Goyaldedda052019-05-14 15:23:48 -07001862 if (requestCode != -1) {
1863 mPendingActivityRequestCode = requestCode;
1864 }
Sunny Goyal210e1742019-10-17 12:05:38 -07001865 try {
1866 super.startIntentSenderForResult(intent, requestCode,
1867 fillInIntent, flagsMask, flagsValues, extraFlags, options);
Sunny Goyale82a20a2023-10-19 13:52:49 -07001868 } catch (Exception e) {
Sunny Goyal210e1742019-10-17 12:05:38 -07001869 throw new ActivityNotFoundException();
Adam Cohen173f7112015-03-27 15:14:00 -07001870 }
1871 }
1872
Sunny Goyal2100c782016-08-22 16:00:03 -07001873 void addAppWidgetFromDropImpl(int appWidgetId, ItemInfo info, AppWidgetHostView boundWidget,
Sunny Goyal04a324a2017-01-20 21:08:59 -08001874 WidgetAddFlowHandler addFlowHandler) {
Tony Wickhama0628cc2015-10-14 15:23:04 -07001875 if (LOGD) {
1876 Log.d(TAG, "Adding widget from drop");
1877 }
Sunny Goyal04a324a2017-01-20 21:08:59 -08001878 addAppWidgetImpl(appWidgetId, info, boundWidget, addFlowHandler, 0);
Adam Cohenad4e15c2013-10-17 16:21:35 -07001879 }
1880
Fengjiang Li8bd66ee2024-01-26 10:00:47 -08001881 /**
1882 * If FLAG_ENABLE_ADD_APP_WIDGET_VIA_CONFIG_ACTIVITY_V2 is enabled, we always add widget
1883 * host view to workspace, otherwise we only add widget to host view if config activity is
1884 * not started.
1885 */
Sunny Goyal2100c782016-08-22 16:00:03 -07001886 void addAppWidgetImpl(int appWidgetId, ItemInfo info,
Sunny Goyal04a324a2017-01-20 21:08:59 -08001887 AppWidgetHostView boundWidget, WidgetAddFlowHandler addFlowHandler, int delay) {
Fengjiang Li8bd66ee2024-01-26 10:00:47 -08001888 final boolean isActivityStarted = addFlowHandler.startConfigActivity(
1889 this, appWidgetId, info, REQUEST_CREATE_APPWIDGET);
Michael Jurkaaf442092010-06-10 17:01:57 -07001890
Fengjiang Li8bd66ee2024-01-26 10:00:47 -08001891 if (!enableAddAppWidgetViaConfigActivityV2() && isActivityStarted) {
1892 return;
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001893 }
Fengjiang Li8bd66ee2024-01-26 10:00:47 -08001894
1895 // If FLAG_ENABLE_ADD_APP_WIDGET_VIA_CONFIG_ACTIVITY_V2 is enabled and config activity is
1896 // started, we should remove the dropped AppWidgetHostView from drag layer and extract the
1897 // Bitmap that shows the preview. Then pass the Bitmap to completeAddAppWidget() to create
1898 // a PendingWidgetHostView.
1899 Bitmap widgetPreviewBitmap = null;
1900 if (isActivityStarted) {
1901 DragView dropView = getDragLayer().clearAnimatedView();
1902 if (dropView != null && dropView.containsAppWidgetHostView()) {
Fengjiang Lifb165172024-03-04 15:36:08 -08001903 // Extracting Bitmap from dropView instead of its content view produces the correct
1904 // bitmap.
1905 widgetPreviewBitmap = getBitmapFromView(dropView);
Fengjiang Li8bd66ee2024-01-26 10:00:47 -08001906 }
1907 }
1908
Shamali Pdfcec9c2024-10-08 23:20:26 +00001909 // Exit spring loaded mode if necessary after adding the widget; unless config activity was
1910 // started.
1911 Runnable onComplete = MULTI_SELECT_EDIT_MODE.get() ? null : () -> mStateManager.goToState(
1912 NORMAL, SPRING_LOADED_EXIT_DELAY);
Fengjiang Li8bd66ee2024-01-26 10:00:47 -08001913 completeAddAppWidget(appWidgetId, info, boundWidget,
1914 addFlowHandler.getProviderInfo(this), addFlowHandler.needsConfigure(),
Fengjiang Li6f8069a2024-03-20 12:04:29 -07001915 false, widgetPreviewBitmap);
Shamali Pdfcec9c2024-10-08 23:20:26 +00001916 // Remove extra screen if widget drop concluded. If a config activity was started, extra
1917 // screen will be removed when we get back its result.
1918 if (!isActivityStarted) {
1919 mWorkspace.removeExtraEmptyScreenDelayed(delay, false, onComplete);
1920 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001921 }
Romain Guycbb89e42009-06-08 15:52:54 -07001922
Sunny Goyalefb7e842018-10-04 15:11:00 -07001923 public void addPendingItem(PendingAddItemInfo info, int container, int screenId,
Sunny Goyal71b5c0b2015-01-08 16:59:04 -08001924 int[] cell, int spanX, int spanY) {
Sunny Goyal669b71f2023-01-27 14:37:07 -08001925 if (cell == null) {
1926 CellPos modelPos = getCellPosMapper().mapPresenterToModel(0, 0, screenId, container);
1927 info.screenId = modelPos.screenId;
1928 } else {
1929 CellPos modelPos = getCellPosMapper().mapPresenterToModel(
1930 cell[0], cell[1], screenId, container);
1931 info.screenId = modelPos.screenId;
1932 info.cellX = modelPos.cellX;
1933 info.cellY = modelPos.cellY;
Sunny Goyal2100c782016-08-22 16:00:03 -07001934 }
Sunny Goyal669b71f2023-01-27 14:37:07 -08001935 info.container = container;
Sunny Goyal2100c782016-08-22 16:00:03 -07001936 info.spanX = spanX;
1937 info.spanY = spanY;
1938
Holly Sun35b99602023-06-28 15:14:02 -07001939 if (info instanceof PendingAddWidgetInfo) {
1940 addAppWidgetFromDrop((PendingAddWidgetInfo) info);
1941 } else { // info can only be PendingAddShortcutInfo
1942 processShortcutFromDrop((PendingAddShortcutInfo) info);
Samuel Fufaca37b8a2019-08-19 17:04:36 -07001943 }
Sunny Goyal71b5c0b2015-01-08 16:59:04 -08001944 }
1945
Adam Cohenfbba09b2011-07-18 21:43:05 -07001946 /**
1947 * Process a shortcut drop.
Adam Cohenfbba09b2011-07-18 21:43:05 -07001948 */
Sunny Goyal782f0c92017-01-19 10:27:54 -08001949 private void processShortcutFromDrop(PendingAddShortcutInfo info) {
Sunny Goyalfb5096d2016-09-08 14:32:06 -07001950 Intent intent = new Intent(Intent.ACTION_CREATE_SHORTCUT).setComponent(info.componentName);
1951 setWaitingForResult(PendingRequestArgs.forIntent(REQUEST_CREATE_SHORTCUT, intent, info));
vadimtcf275c12020-04-15 12:43:01 -07001952 TestLogging.recordEvent(TestProtocol.SEQUENCE_MAIN, "start: processShortcutFromDrop");
Sunny Goyal239d6e92023-02-07 13:40:11 -08001953 if (!info.getActivityInfo(this).startConfigActivity(this, REQUEST_CREATE_SHORTCUT)) {
Sunny Goyal782f0c92017-01-19 10:27:54 -08001954 handleActivityResult(REQUEST_CREATE_SHORTCUT, RESULT_CANCELED, null);
1955 }
Michael Jurka0280c3b2010-09-17 15:00:07 -07001956 }
1957
Adam Cohenfbba09b2011-07-18 21:43:05 -07001958 /**
1959 * Process a widget drop.
Adam Cohenfbba09b2011-07-18 21:43:05 -07001960 */
Sunny Goyal2100c782016-08-22 16:00:03 -07001961 private void addAppWidgetFromDrop(PendingAddWidgetInfo info) {
Adam Cohened66b2b2012-01-23 17:28:51 -08001962 AppWidgetHostView hostView = info.boundWidget;
Sunny Goyal952e63d2017-08-16 04:59:08 -07001963 final int appWidgetId;
Sunny Goyal8a0dc382017-01-25 11:30:06 -08001964 WidgetAddFlowHandler addFlowHandler = info.getHandler();
Adam Cohened66b2b2012-01-23 17:28:51 -08001965 if (hostView != null) {
Tony Wickhama0628cc2015-10-14 15:23:04 -07001966 // In the case where we've prebound the widget, we remove it from the DragLayer
1967 if (LOGD) {
1968 Log.d(TAG, "Removing widget view from drag layer and setting boundWidget to null");
1969 }
1970 getDragLayer().removeView(hostView);
1971
Adam Cohened66b2b2012-01-23 17:28:51 -08001972 appWidgetId = hostView.getAppWidgetId();
Sunny Goyal04a324a2017-01-20 21:08:59 -08001973 addAppWidgetFromDropImpl(appWidgetId, info, hostView, addFlowHandler);
Sunny Goyal5b9ebca2015-06-01 18:37:32 -07001974
1975 // Clear the boundWidget so that it doesn't get destroyed.
1976 info.boundWidget = null;
Adam Cohened66b2b2012-01-23 17:28:51 -08001977 } else {
Adam Cohen9d5b7d82012-05-09 18:00:44 -07001978 // In this case, we either need to start an activity to get permission to bind
1979 // the widget, or we need to start an activity to configure the widget, or both.
Pinyao Tingc7a6c292019-08-26 14:36:02 -07001980 if (info.itemType == LauncherSettings.Favorites.ITEM_TYPE_CUSTOM_APPWIDGET) {
fbaron30d9e3f2023-08-03 17:03:59 -07001981 appWidgetId = CustomWidgetManager.INSTANCE.get(this)
1982 .allocateCustomAppWidgetId(info.componentName);
Sunny Goyal952e63d2017-08-16 04:59:08 -07001983 } else {
Sihua Ma0593a0d2022-10-03 16:01:48 -07001984 appWidgetId = getAppWidgetHolder().allocateAppWidgetId();
Sunny Goyal952e63d2017-08-16 04:59:08 -07001985 }
Adam Cohendd70d662012-10-04 16:53:44 -07001986 Bundle options = info.bindOptions;
1987
Sunny Goyalffe83f12014-08-14 17:39:34 -07001988 boolean success = mAppWidgetManager.bindAppWidgetIdIfAllowed(
1989 appWidgetId, info.info, options);
Adam Cohendd70d662012-10-04 16:53:44 -07001990 if (success) {
Sunny Goyal04a324a2017-01-20 21:08:59 -08001991 addAppWidgetFromDropImpl(appWidgetId, info, null, addFlowHandler);
Michael Jurka8b805b12012-04-18 14:23:14 -07001992 } else {
Sunny Goyal04a324a2017-01-20 21:08:59 -08001993 addFlowHandler.startBindFlow(this, appWidgetId, info, REQUEST_BIND_APPWIDGET);
Michael Jurka8b805b12012-04-18 14:23:14 -07001994 }
Adam Cohened66b2b2012-01-23 17:28:51 -08001995 }
Adam Cohenfbba09b2011-07-18 21:43:05 -07001996 }
1997
Samuel Fufa746d4202020-02-02 18:55:44 -08001998 /**
1999 * Creates and adds new folder to CellLayout
2000 */
Samuel Fufa28c3e452020-02-08 16:07:16 -08002001 public FolderIcon addFolder(CellLayout layout, int container, final int screenId, int cellX,
2002 int cellY) {
Michael Jurkac9d95c52011-08-29 14:03:34 -07002003 final FolderInfo folderInfo = new FolderInfo();
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002004
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002005 // Update the model
Sunny Goyal43bf11d2017-02-02 13:52:53 -08002006 getModelWriter().addItemToDatabase(folderInfo, container, screenId, cellX, cellY);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002007
2008 // Create the view
Samuel Fufa746d4202020-02-02 18:55:44 -08002009 FolderIcon newFolder = FolderIcon.inflateFolderAndIcon(R.layout.folder_icon, this, layout,
2010 folderInfo);
Sunny Goyald5462aa2016-11-22 16:52:39 +05302011 mWorkspace.addInScreen(newFolder, folderInfo);
Winson Chung5f8afe62013-08-12 16:19:28 -07002012 // Force measure the new folder icon
2013 CellLayout parent = mWorkspace.getParentCellLayoutForView(newFolder);
2014 parent.getShortcutsAndWidgets().measureChild(newFolder);
Adam Cohendf035382011-04-11 17:22:04 -07002015 return newFolder;
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002016 }
Romain Guycbb89e42009-06-08 15:52:54 -07002017
Tony Wickham1906cc32021-02-11 11:55:24 -08002018 @Override
2019 public Rect getFolderBoundingBox() {
2020 // We need to bound the folder to the currently visible workspace area
Andras Kloczl3a4ba0b2021-03-29 18:47:14 +02002021 return getWorkspace().getPageAreaRelativeToDragLayer();
Tony Wickham1906cc32021-02-11 11:55:24 -08002022 }
2023
2024 @Override
2025 public void updateOpenFolderPosition(int[] inOutPosition, Rect bounds, int width, int height) {
2026 int left = inOutPosition[0];
2027 int top = inOutPosition[1];
2028 DeviceProfile grid = getDeviceProfile();
2029 int distFromEdgeOfScreen = getWorkspace().getPaddingLeft();
2030 if (grid.isPhone && (grid.availableWidthPx - width) < 4 * distFromEdgeOfScreen) {
2031 // Center the folder if it is very close to being centered anyway, by virtue of
2032 // filling the majority of the viewport. ie. remove it from the uncanny valley
2033 // of centeredness.
2034 left = (grid.availableWidthPx - width) / 2;
2035 } else if (width >= bounds.width()) {
2036 // If the folder doesn't fit within the bounds, center it about the desired bounds
2037 left = bounds.left + (bounds.width() - width) / 2;
2038 }
2039 if (height >= bounds.height()) {
2040 // Folder height is greater than page height, center on page
2041 top = bounds.top + (bounds.height() - height) / 2;
2042 } else {
2043 // Folder height is less than page height, so bound it to the absolute open folder
2044 // bounds if necessary
2045 Rect folderBounds = grid.getAbsoluteOpenFolderBounds();
2046 left = Math.max(folderBounds.left, Math.min(left, folderBounds.right - width));
2047 top = Math.max(folderBounds.top, Math.min(top, folderBounds.bottom - height));
2048 }
2049 inOutPosition[0] = left;
2050 inOutPosition[1] = top;
2051 }
2052
Winsonc0b52fe2015-09-09 16:38:15 -07002053 /**
Winsonfa56b3f2015-09-14 12:01:13 -07002054 * Unbinds the view for the specified item, and removes the item and all its children.
2055 *
2056 * @param v the view being removed.
Winsonfa56b3f2015-09-14 12:01:13 -07002057 * @param itemInfo the {@link ItemInfo} for this view.
2058 * @param deleteFromDb whether or not to delete this item from the db.
Winsonc0b52fe2015-09-09 16:38:15 -07002059 */
Tony Wickhambfbf7f92016-05-19 11:19:39 -07002060 public boolean removeItem(View v, final ItemInfo itemInfo, boolean deleteFromDb) {
Pinyao Ting6a41d562022-05-10 23:47:36 +00002061 return removeItem(v, itemInfo, deleteFromDb, null);
2062 }
2063
2064 /**
2065 * Unbinds the view for the specified item, and removes the item and all its children.
2066 *
2067 * @param v the view being removed.
2068 * @param itemInfo the {@link ItemInfo} for this view.
2069 * @param deleteFromDb whether or not to delete this item from the db.
2070 * @param reason the resaon for removal.
2071 */
2072 public boolean removeItem(View v, final ItemInfo itemInfo, boolean deleteFromDb,
2073 @Nullable final String reason) {
Sunny Goyal95899162019-03-27 16:03:06 -07002074 if (itemInfo instanceof WorkspaceItemInfo) {
Jeremy Sim742630c2024-03-22 22:11:18 -07002075 View collectionIcon = mWorkspace.getHomescreenIconByItemId(itemInfo.container);
2076 if (collectionIcon instanceof FolderIcon) {
2077 // Remove the shortcut from the folder before removing it from launcher
2078 ((FolderInfo) collectionIcon.getTag()).remove((WorkspaceItemInfo) itemInfo, true);
2079 } else if (collectionIcon instanceof AppPairIcon appPairIcon) {
2080 removeItem(appPairIcon, appPairIcon.getInfo(), deleteFromDb,
2081 "removing app pair because one of its member apps was removed");
Winsonfa56b3f2015-09-14 12:01:13 -07002082 } else {
2083 mWorkspace.removeWorkspaceItem(v);
2084 }
Winsonc0b52fe2015-09-09 16:38:15 -07002085 if (deleteFromDb) {
Pinyao Ting6a41d562022-05-10 23:47:36 +00002086 getModelWriter().deleteItemFromDatabase(itemInfo, reason);
Winsonc0b52fe2015-09-09 16:38:15 -07002087 }
Jeremy Sim742630c2024-03-22 22:11:18 -07002088 } else if (itemInfo instanceof CollectionInfo ci) {
Sunny Goyalaaf7d1d2016-05-17 13:38:54 -07002089 if (v instanceof FolderIcon) {
2090 ((FolderIcon) v).removeListeners();
2091 }
Winsonc0b52fe2015-09-09 16:38:15 -07002092 mWorkspace.removeWorkspaceItem(v);
2093 if (deleteFromDb) {
Jeremy Sim742630c2024-03-22 22:11:18 -07002094 getModelWriter().deleteCollectionAndContentsFromDatabase(ci);
Winsonc0b52fe2015-09-09 16:38:15 -07002095 }
2096 } else if (itemInfo instanceof LauncherAppWidgetInfo) {
2097 final LauncherAppWidgetInfo widgetInfo = (LauncherAppWidgetInfo) itemInfo;
Winson44818e02015-10-02 11:25:46 -07002098 mWorkspace.removeWorkspaceItem(v);
Winsonc0b52fe2015-09-09 16:38:15 -07002099 if (deleteFromDb) {
Sihua Ma0593a0d2022-10-03 16:01:48 -07002100 getModelWriter().deleteWidgetInfo(widgetInfo, getAppWidgetHolder(), reason);
Winsonc0b52fe2015-09-09 16:38:15 -07002101 }
2102 } else {
2103 return false;
2104 }
2105 return true;
2106 }
2107
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002108 @Override
2109 public boolean dispatchKeyEvent(KeyEvent event) {
vadimt6b534ee2021-08-06 15:49:02 -07002110 TestLogging.recordKeyEvent(TestProtocol.SEQUENCE_MAIN, "Key event", event);
Hyunyoung Song3c7d9cb2017-01-30 15:11:27 -08002111 return (event.getKeyCode() == KeyEvent.KEYCODE_HOME) || super.dispatchKeyEvent(event);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002112 }
2113
Joe Onorato88ec0992009-11-19 13:16:06 -08002114 @Override
vadimt9af34a72020-01-21 11:19:13 -08002115 public boolean dispatchTouchEvent(MotionEvent ev) {
Sunny Goyala306e592020-03-24 01:51:41 -07002116 switch (ev.getAction()) {
2117 case MotionEvent.ACTION_DOWN:
2118 mTouchInProgress = true;
2119 break;
2120 case MotionEvent.ACTION_UP:
Riddle Hsub30adcb2020-10-07 15:57:44 +08002121 mLastTouchUpTime = SystemClock.uptimeMillis();
Sunny Goyala306e592020-03-24 01:51:41 -07002122 // Follow through
2123 case MotionEvent.ACTION_CANCEL:
2124 mTouchInProgress = false;
2125 break;
Sunny Goyal9b180102020-03-11 10:02:29 -07002126 }
vadimtd633c9c2020-01-22 18:00:37 -08002127 TestLogging.recordMotionEvent(TestProtocol.SEQUENCE_MAIN, "Touch event", ev);
vadimt9af34a72020-01-21 11:19:13 -08002128 return super.dispatchTouchEvent(ev);
2129 }
2130
2131 @Override
Fengjiang Lib7860bd2023-03-15 10:50:50 -07002132 @TargetApi(Build.VERSION_CODES.UPSIDE_DOWN_CAKE)
Joe Onorato88ec0992009-11-19 13:16:06 -08002133 public void onBackPressed() {
Fengjiang Lib7860bd2023-03-15 10:50:50 -07002134 getOnBackAnimationCallback().onBackInvoked();
Joe Onorato88ec0992009-11-19 13:16:06 -08002135 }
2136
Fengjiang Li10c03e42024-03-26 16:21:01 -07002137 protected void onBackStarted() {
2138 mStateManager.getState().onBackStarted(this);
2139 }
2140
Sunny Goyal3f2637f2022-05-05 12:24:08 -07002141 protected void onStateBack() {
Fengjiang Li10c03e42024-03-26 16:21:01 -07002142 mStateManager.getState().onBackInvoked(this);
Sunny Goyal3f2637f2022-05-05 12:24:08 -07002143 }
2144
Fengjiang Li01cc2732024-03-28 16:24:39 -07002145 protected void onBackCancelled() {
2146 mStateManager.getState().onBackCancelled(this);
2147 }
2148
Sunny Goyala992ac92023-01-10 17:50:32 -08002149 protected void onScreenOnChanged(boolean isOn) {
Tracy Zhouf20a4bd2021-04-19 21:37:08 -07002150 // Reset AllApps to its initial state only if we are not in the middle of
2151 // processing a multi-step drop
Sunny Goyala992ac92023-01-10 17:50:32 -08002152 if (!isOn && mPendingRequestArgs == null) {
Tracy Zhouf20a4bd2021-04-19 21:37:08 -07002153 if (!isInState(NORMAL)) {
2154 onUiChangedWhileSleeping();
2155 }
2156 mStateManager.goToState(NORMAL);
2157 }
2158 }
2159
Hyunyoung Song46d07f72018-05-22 15:41:25 -07002160 @Override
Sunny Goyal4fdc9182023-05-12 12:08:53 -07002161 public RunnableList startActivitySafely(View v, Intent intent, ItemInfo item) {
Winson Chung0b70cd42019-06-17 22:34:33 -07002162 if (!hasBeenResumed()) {
Sunny Goyal4fdc9182023-05-12 12:08:53 -07002163 RunnableList result = new RunnableList();
Winson Chung0b70cd42019-06-17 22:34:33 -07002164 // Workaround an issue where the WM launch animation is clobbered when finishing the
2165 // recents animation into launcher. Defer launching the activity until Launcher is
2166 // next resumed.
Sunny Goyale82a20a2023-10-19 13:52:49 -07002167 addEventCallback(EVENT_RESUMED, () -> {
Sunny Goyal4fdc9182023-05-12 12:08:53 -07002168 RunnableList actualResult = startActivitySafely(v, intent, item);
2169 if (actualResult != null) {
2170 actualResult.add(result::executeAllAndDestroy);
2171 } else {
2172 result.executeAllAndDestroy();
2173 }
2174 });
Winson Chungc9bf6d42019-10-04 15:33:18 -07002175 if (mOnDeferredActivityLaunchCallback != null) {
2176 mOnDeferredActivityLaunchCallback.run();
2177 mOnDeferredActivityLaunchCallback = null;
2178 }
Sunny Goyal4fdc9182023-05-12 12:08:53 -07002179 return result;
Winson Chung0b70cd42019-06-17 22:34:33 -07002180 }
2181
Sunny Goyal4fdc9182023-05-12 12:08:53 -07002182 RunnableList result = super.startActivitySafely(v, intent, item);
2183 if (result != null && v instanceof BubbleTextView) {
Sunny Goyal0b0847b2018-03-14 12:30:11 -07002184 // This is set to the view that launched the activity that navigated the user away
2185 // from launcher. Since there is no callback for when the activity has finished
2186 // launching, enable the press state and keep this reference to reset the press
2187 // state when we return to launcher.
2188 BubbleTextView btv = (BubbleTextView) v;
2189 btv.setStayPressed(true);
Sunny Goyal4fdc9182023-05-12 12:08:53 -07002190 result.add(() -> btv.setStayPressed(false));
Sunny Goyala7ce1662016-05-31 15:01:35 -07002191 }
Sunny Goyal4fdc9182023-05-12 12:08:53 -07002192 return result;
Michael Jurka86a720e2012-05-09 11:23:23 -07002193 }
2194
Winson Chung3d503fb2011-07-13 17:25:49 -07002195 boolean isHotseatLayout(View layout) {
Sunny Goyalc13403c2016-11-18 23:44:48 -08002196 // TODO: Remove this method
Sunny Goyal876e4622018-11-02 13:50:40 -07002197 return mHotseat != null && (layout == mHotseat);
Winson Chung3d503fb2011-07-13 17:25:49 -07002198 }
Romain Guy1fbc1c82009-11-09 20:43:08 -08002199
Michael Jurkae326f182011-11-21 14:05:46 -08002200 @Override
2201 public void onTrimMemory(int level) {
2202 super.onTrimMemory(level);
Adam Cohen3f9c9712014-10-31 11:48:25 -07002203 if (level >= ComponentCallbacks2.TRIM_MEMORY_UI_HIDDEN) {
2204 // The widget preview db can result in holding onto over
2205 // 3MB of memory for caching which isn't necessary.
2206 SQLiteDatabase.releaseMemory();
2207
Adam Cohenc8f4e1b2014-11-19 16:03:20 -08002208 // This clears all widget bitmaps from the widget tray
Hyunyoung Song3f471442015-04-08 19:01:34 -07002209 // TODO(hyunyoungs)
Michael Jurkae326f182011-11-21 14:05:46 -08002210 }
2211 }
2212
Michael Jurkad7c28052012-04-27 15:43:36 -07002213 @Override
2214 public boolean dispatchPopulateAccessibilityEvent(AccessibilityEvent event) {
alanv1d4fde62012-10-17 13:15:47 -07002215 final boolean result = super.dispatchPopulateAccessibilityEvent(event);
Michael Jurkad7c28052012-04-27 15:43:36 -07002216 final List<CharSequence> text = event.getText();
2217 text.clear();
alanv1d4fde62012-10-17 13:15:47 -07002218 // Populate event with a fake title based on the current state.
Sunny Goyal3e3f44c2017-10-23 17:14:52 -07002219 // TODO: When can workspace be null?
2220 text.add(mWorkspace == null
Sunny Goyal52e25452020-07-20 12:38:01 -07002221 ? getString(R.string.home_screen)
Sunny Goyalea609262017-10-25 15:47:38 -07002222 : mStateManager.getState().getDescription(this));
Michael Jurkad7c28052012-04-27 15:43:36 -07002223 return result;
2224 }
2225
Sunny Goyal93f878c2016-03-30 17:31:24 -07002226 @Override
Sunny Goyal12e3f1f2021-07-15 14:31:58 -07002227 public IntSet getPagesToBindSynchronously(IntArray orderedScreenIds) {
Sebastian Franco69fd7422023-10-06 16:48:58 -07002228 return mModelCallbacks.getPagesToBindSynchronously(orderedScreenIds);
Joe Onorato9c1289c2009-08-17 11:03:03 -04002229 }
The Android Open Source Projectf96811c2009-03-18 17:39:48 -07002230
Liran Binyamina833af32023-08-02 16:30:27 -04002231 @Override
Joe Onorato9c1289c2009-08-17 11:03:03 -04002232 public void startBinding() {
Sebastian Francoe4965122023-12-01 13:27:42 -06002233 mModelCallbacks.startBinding();
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002234 }
2235
Adam Cohendcd297f2013-06-18 13:13:40 -07002236 @Override
fbaronc0e687b2023-10-04 12:11:20 -07002237 public void setIsFirstPagePinnedItemEnabled(boolean isFirstPagePinnedItemEnabled) {
Sebastian Franco6dda7c72023-11-17 18:03:00 -06002238 mModelCallbacks.setIsFirstPagePinnedItemEnabled(isFirstPagePinnedItemEnabled);
fbaronc0e687b2023-10-04 12:11:20 -07002239 }
2240
2241 @Override
Sunny Goyalefb7e842018-10-04 15:11:00 -07002242 public void bindScreens(IntArray orderedScreenIds) {
Sebastian Franco6dda7c72023-11-17 18:03:00 -06002243 mModelCallbacks.bindScreens(orderedScreenIds);
Winson Chung64359a52013-07-08 17:17:08 -07002244 }
2245
Sebastian Francoddd04502023-07-26 15:09:10 -07002246 /**
2247 * Remove odd number because they are already included when isTwoPanels and add the pair screen
2248 * if not present.
2249 */
2250 private IntArray filterTwoPanelScreenIds(IntArray orderedScreenIds) {
2251 IntSet screenIds = IntSet.wrap(orderedScreenIds);
2252 orderedScreenIds.forEach(screenId -> {
2253 if (screenId % 2 == 1) {
2254 screenIds.remove(screenId);
2255 // In case the pair is not added, add it
2256 if (!mWorkspace.containsScreenId(screenId - 1)) {
2257 screenIds.add(screenId - 1);
2258 }
2259 }
2260 });
2261 return screenIds.getArray();
2262 }
2263
Sunny Goyalb23980c2017-08-17 07:45:25 -07002264 @Override
Tony Wickham6a71a5b2018-08-21 11:40:23 -07002265 public void preAddApps() {
Sebastian Francobd7919c2023-09-19 10:55:37 -07002266 mModelCallbacks.preAddApps();
Tony Wickham6a71a5b2018-08-21 11:40:23 -07002267 }
2268
2269 @Override
Sunny Goyalefb7e842018-10-04 15:11:00 -07002270 public void bindAppsAdded(IntArray newScreens, ArrayList<ItemInfo> addNotAnimated,
Sunny Goyal29947f02017-12-18 13:49:44 -08002271 ArrayList<ItemInfo> addAnimated) {
Sebastian Franco6dda7c72023-11-17 18:03:00 -06002272 mModelCallbacks.bindAppsAdded(newScreens, addNotAnimated, addAnimated);
Winson Chungd64d1762013-08-20 14:37:16 -07002273 }
2274
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002275 /**
Joe Onorato9c1289c2009-08-17 11:03:03 -04002276 * Bind the items start-end from the list.
2277 *
2278 * Implementation of the method from LauncherModel.Callbacks.
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002279 */
Tony Wickham0bb211a2015-10-02 16:22:08 -07002280 @Override
Sunny Goyalb23980c2017-08-17 07:45:25 -07002281 public void bindItems(final List<ItemInfo> items, final boolean forceAnimateIcons) {
Sunny Goyal72a74662024-02-14 12:32:59 -08002282 bindInflatedItems(items.stream().map(i -> Pair.create(
Sunny Goyaleb5684c2024-01-29 13:37:08 -08002283 i, getItemInflater().inflateItem(i, getModelWriter()))).toList(),
2284 forceAnimateIcons ? new AnimatorSet() : null);
Schneider Victor-tulias68706eb2021-04-29 15:24:54 -07002285 }
2286
Sunny Goyal72a74662024-02-14 12:32:59 -08002287 @Override
2288 public void bindInflatedItems(List<Pair<ItemInfo, View>> items) {
2289 bindInflatedItems(items, null);
2290 }
2291
Schneider Victor-tulias68706eb2021-04-29 15:24:54 -07002292 /**
Sunny Goyaleb5684c2024-01-29 13:37:08 -08002293 * Bind all the items in the map, ignoring any null views
Schneider Victor-tulias68706eb2021-04-29 15:24:54 -07002294 *
Sunny Goyaleb5684c2024-01-29 13:37:08 -08002295 * @param boundAnim if non-null, uses it to create and play the bounce animation for added views
Schneider Victor-tulias68706eb2021-04-29 15:24:54 -07002296 */
Sunny Goyal72a74662024-02-14 12:32:59 -08002297 public void bindInflatedItems(
2298 List<Pair<ItemInfo, View>> shortcuts, @Nullable AnimatorSet boundAnim) {
Sunny Goyal3be633b2016-12-08 09:59:25 -08002299 // Get the list of added items and intersect them with the set of items here
Shikha Malhotraf78da1b2022-04-11 10:23:18 +00002300 Workspace<?> workspace = mWorkspace;
Sunny Goyalefb7e842018-10-04 15:11:00 -07002301 int newItemsScreenId = -1;
Sunny Goyaleb5684c2024-01-29 13:37:08 -08002302 int index = 0;
2303 for (Pair<ItemInfo, View> e : shortcuts) {
2304 final ItemInfo item = e.first;
Winson Chung4d279d92011-07-21 11:46:32 -07002305
Sunny Goyal4e014232024-01-18 13:53:45 -08002306 // Remove colliding items.
Sunny Goyal669b71f2023-01-27 14:37:07 -08002307 CellPos presenterPos = getCellPosMapper().mapModelToPresenter(item);
2308 if (item.container == CONTAINER_DESKTOP) {
2309 CellLayout cl = mWorkspace.getScreenWithId(presenterPos.screenId);
2310 if (cl != null && cl.isOccupied(presenterPos.cellX, presenterPos.cellY)) {
Sunny Goyal4e014232024-01-18 13:53:45 -08002311 Object tag = cl.getChildAt(presenterPos.cellX, presenterPos.cellY).getTag();
Sunny Goyalda4fe1a2016-05-26 16:05:17 -07002312 String desc = "Collision while binding workspace item: " + item
2313 + ". Collides with " + tag;
Zak Cohen3eeb41d2020-02-14 14:15:13 -08002314 if (FeatureFlags.IS_STUDIO_BUILD) {
Sunny Goyalda4fe1a2016-05-26 16:05:17 -07002315 throw (new RuntimeException(desc));
2316 } else {
Pinyao Ting6a41d562022-05-10 23:47:36 +00002317 getModelWriter().deleteItemFromDatabase(item, desc);
Sunny Goyalda4fe1a2016-05-26 16:05:17 -07002318 continue;
2319 }
2320 }
2321 }
Sunny Goyal4e014232024-01-18 13:53:45 -08002322
Sunny Goyal72a74662024-02-14 12:32:59 -08002323 View view = e.second;
Sunny Goyal4e014232024-01-18 13:53:45 -08002324 if (view == null) {
2325 continue;
2326 }
Sunny Goyal72a74662024-02-14 12:32:59 -08002327 if (enableWorkspaceInflation() && view instanceof LauncherAppWidgetHostView lv) {
2328 view = getAppWidgetHolder().attachViewToHostAndGetAttachedView(lv);
2329 }
Sunny Goyald5462aa2016-11-22 16:52:39 +05302330 workspace.addInScreenFromBind(view, item);
Sunny Goyaleb5684c2024-01-29 13:37:08 -08002331 if (boundAnim != null) {
Sunny Goyal639e9062015-08-19 19:17:06 -07002332 // Animate all the applications up now
2333 view.setAlpha(0f);
2334 view.setScaleX(0f);
2335 view.setScaleY(0f);
Sunny Goyaleb5684c2024-01-29 13:37:08 -08002336 boundAnim.play(createNewAppBounceAnimation(view, index++));
Sunny Goyal669b71f2023-01-27 14:37:07 -08002337 newItemsScreenId = presenterPos.screenId;
Sunny Goyal639e9062015-08-19 19:17:06 -07002338 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002339 }
Winson Chungf0c6ae02012-03-21 16:10:31 -07002340
Sunny Goyal4e014232024-01-18 13:53:45 -08002341 // Animate to the correct page
Sunny Goyaleb5684c2024-01-29 13:37:08 -08002342 if (boundAnim != null && newItemsScreenId > -1) {
Sunny Goyalefb7e842018-10-04 15:11:00 -07002343 int currentScreenId = mWorkspace.getScreenIdForPageIndex(mWorkspace.getNextPage());
Sunny Goyalf0b6db72018-08-13 16:10:14 -07002344 final int newScreenIndex = mWorkspace.getPageIndexForScreenId(newItemsScreenId);
Sunny Goyaleb5684c2024-01-29 13:37:08 -08002345 final Runnable startBounceAnimRunnable = boundAnim::start;
Sunny Goyalf0b6db72018-08-13 16:10:14 -07002346
Sunny Goyal4e014232024-01-18 13:53:45 -08002347 if (canAnimatePageChange() && newItemsScreenId != currentScreenId) {
Sunny Goyalf0b6db72018-08-13 16:10:14 -07002348 // We post the animation slightly delayed to prevent slowdowns
2349 // when we are loading right after we return to launcher.
Sunny Goyal4e014232024-01-18 13:53:45 -08002350 mWorkspace.postDelayed(() -> {
2351 closeOpenViews(false);
2352 mWorkspace.snapToPage(newScreenIndex);
2353 mWorkspace.postDelayed(startBounceAnimRunnable, NEW_APPS_ANIMATION_DELAY);
Sunny Goyalf0b6db72018-08-13 16:10:14 -07002354 }, NEW_APPS_PAGE_MOVE_DELAY);
2355 } else {
2356 mWorkspace.postDelayed(startBounceAnimRunnable, NEW_APPS_ANIMATION_DELAY);
Winson Chung997a9232013-07-24 15:33:46 -07002357 }
Winson Chung64359a52013-07-08 17:17:08 -07002358 }
Joe Onorato9c1289c2009-08-17 11:03:03 -04002359 workspace.requestLayout();
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002360 }
2361
Joe Onorato9c1289c2009-08-17 11:03:03 -04002362 /**
2363 * Add the views for a widget to the workspace.
Joe Onorato9c1289c2009-08-17 11:03:03 -04002364 */
Sunny Goyala9a1a212017-08-18 01:03:21 -07002365 public void bindAppWidget(LauncherAppWidgetInfo item) {
Sunny Goyal4e014232024-01-18 13:53:45 -08002366 View view = mItemInflater.inflateItem(item, getModelWriter());
Sunny Goyala9a1a212017-08-18 01:03:21 -07002367 if (view != null) {
2368 mWorkspace.addInScreen(view, item);
2369 mWorkspace.requestLayout();
2370 }
2371 }
2372
Sunny Goyalff572272014-07-23 13:58:07 -07002373 /**
2374 * Restores a pending widget.
2375 *
2376 * @param appWidgetId The app widget id
Sunny Goyalff572272014-07-23 13:58:07 -07002377 */
Sunny Goyald478c832016-04-01 12:04:16 -07002378 private LauncherAppWidgetInfo completeRestoreAppWidget(int appWidgetId, int finalRestoreFlag) {
Sunny Goyalff572272014-07-23 13:58:07 -07002379 LauncherAppWidgetHostView view = mWorkspace.getWidgetForAppWidgetId(appWidgetId);
Sunny Goyal4df719a2024-01-03 19:31:32 -08002380 if (!(view instanceof PendingAppWidgetHostView)) {
Sunny Goyalff572272014-07-23 13:58:07 -07002381 Log.e(TAG, "Widget update called, when the widget no longer exists.");
Sunny Goyald478c832016-04-01 12:04:16 -07002382 return null;
Sunny Goyalff572272014-07-23 13:58:07 -07002383 }
2384
Sunny Goyal0fc1be12014-08-11 17:05:23 -07002385 LauncherAppWidgetInfo info = (LauncherAppWidgetInfo) view.getTag();
Sunny Goyald478c832016-04-01 12:04:16 -07002386 info.restoreStatus = finalRestoreFlag;
Jon Miranda2b823f42017-05-02 18:36:18 -07002387 if (info.restoreStatus == LauncherAppWidgetInfo.RESTORE_COMPLETED) {
2388 info.pendingItemInfo = null;
2389 }
Sunny Goyalff572272014-07-23 13:58:07 -07002390
Sunny Goyal4df719a2024-01-03 19:31:32 -08002391 PendingAppWidgetHostView pv = (PendingAppWidgetHostView) view;
2392 if (pv.isReinflateIfNeeded()) {
2393 pv.reInflate();
Sunny Goyalba47faa2017-10-04 16:50:57 -07002394 }
2395
Sunny Goyal43bf11d2017-02-02 13:52:53 -08002396 getModelWriter().updateItemInDatabase(info);
Sunny Goyald478c832016-04-01 12:04:16 -07002397 return info;
Sunny Goyalff572272014-07-23 13:58:07 -07002398 }
2399
Sebastian Franco0b461ef2023-12-08 12:20:07 -06002400 /**
2401 * Call back when ModelCallbacks finish binding the Launcher data.
2402 */
Schneider Victor-tulias927d6dc2021-08-26 11:56:47 -07002403 @TargetApi(Build.VERSION_CODES.S)
Sebastian Franco0b461ef2023-12-08 12:20:07 -06002404 public void bindComplete(int workspaceItemCount, boolean isBindSync) {
Sunny Goyal7b8d63f2022-04-14 16:37:32 -07002405 if (mOnInitialBindListener != null) {
2406 getRootView().getViewTreeObserver().removeOnPreDrawListener(mOnInitialBindListener);
2407 mOnInitialBindListener = null;
Sunny Goyalb5b9ad62016-04-02 11:23:39 -07002408 }
Fengjiang Lie5f91a42023-11-16 16:12:04 -08002409 if (!isBindSync) {
2410 mStartupLatencyLogger
2411 .logCardinality(workspaceItemCount)
Sebastian Franco0b461ef2023-12-08 12:20:07 -06002412 .logEnd(LauncherLatencyEvent.LAUNCHER_LATENCY_STARTUP_WORKSPACE_LOADER_ASYNC);
Fengjiang Lie5f91a42023-11-16 16:12:04 -08002413 }
Fengjiang Li6dff0922023-10-14 07:10:10 -07002414 MAIN_EXECUTOR.getHandler().postAtFrontOfQueue(() -> {
2415 mStartupLatencyLogger
Fengjiang Li6dff0922023-10-14 07:10:10 -07002416 .logEnd(LAUNCHER_LATENCY_STARTUP_TOTAL_DURATION)
2417 .log()
2418 .reset();
Fengjiang Li6dff0922023-10-14 07:10:10 -07002419 });
Sebastian Franco0b461ef2023-12-08 12:20:07 -06002420 }
2421
2422 @Override
2423 public void onInitialBindComplete(IntSet boundPages, RunnableList pendingTasks,
Sunny Goyal72a74662024-02-14 12:32:59 -08002424 RunnableList onCompleteSignal, int workspaceItemCount, boolean isBindSync) {
2425 mModelCallbacks.onInitialBindComplete(boundPages, pendingTasks, onCompleteSignal,
2426 workspaceItemCount, isBindSync);
Mark Fasheh4baa30d2024-07-31 22:39:45 +00002427 if (mIsColdStartupAfterReboot) {
2428 Trace.endAsyncSection(COLD_STARTUP_TRACE_METHOD_NAME,
2429 COLD_STARTUP_TRACE_COOKIE);
2430 }
Sunny Goyalb5b9ad62016-04-02 11:23:39 -07002431 }
2432
Joe Onorato9c1289c2009-08-17 11:03:03 -04002433 /**
2434 * Callback saying that there aren't any more items to bind.
Schneider Victor-tuliasfff7cef2023-04-10 15:59:23 -07002435 * <p>
Joe Onorato9c1289c2009-08-17 11:03:03 -04002436 * Implementation of the method from LauncherModel.Callbacks.
2437 */
Andras Kloczl55edfe52021-05-14 12:21:30 +02002438 public void finishBindingItems(IntSet pagesBoundFirst) {
Sebastian Franco6196b902023-12-06 11:39:52 -06002439 mModelCallbacks.finishBindingItems(pagesBoundFirst);
Winson Chungf0c6ae02012-03-21 16:10:31 -07002440 }
2441
Schneider Victor-tulias68fb4162021-09-16 13:24:01 -07002442 private boolean canAnimatePageChange() {
Sunny Goyal9b180102020-03-11 10:02:29 -07002443 if (mDragController.isDragging()) {
2444 return false;
2445 } else {
Riddle Hsu979da642020-09-22 21:52:40 +08002446 return (SystemClock.uptimeMillis() - mLastTouchUpTime)
Sunny Goyal9b180102020-03-11 10:02:29 -07002447 > (NEW_APPS_ANIMATION_INACTIVE_TIMEOUT_SECONDS * 1000);
2448 }
Winson Chunga2413752012-04-03 14:22:34 -07002449 }
2450
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002451 /**
2452 * Similar to {@link #getFirstMatch} but optimized to finding a suitable view for the app close
2453 * animation.
2454 *
Sunny Goyalf1582862024-09-05 16:49:10 -07002455 * @param svi The StableViewInfo of the preferred item to match to if it exists or null
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002456 * @param packageName The package name of the app to match.
2457 * @param user The user of the app to match.
Jon Mirandab42e1242022-03-08 16:37:35 -08002458 * @param supportsAllAppsState If true and we are in All Apps state, looks for view in All Apps.
2459 * Else we only looks on the workspace.
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002460 */
Sunny Goyalf1582862024-09-05 16:49:10 -07002461 public @Nullable View getFirstMatchForAppClose(
2462 @Nullable StableViewInfo svi, String packageName,
Jon Mirandaf58db152022-06-02 16:06:37 -07002463 UserHandle user, boolean supportsAllAppsState) {
Sunny Goyalf1582862024-09-05 16:49:10 -07002464 final Predicate<ItemInfo> preferredItem = svi == null ? i -> false : svi::matches;
Sunny Goyal32084d42022-05-02 10:00:07 -07002465 final Predicate<ItemInfo> packageAndUserAndApp = info ->
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002466 info != null
2467 && info.itemType == ITEM_TYPE_APPLICATION
2468 && info.user.equals(user)
2469 && info.getTargetComponent() != null
2470 && TextUtils.equals(info.getTargetComponent().getPackageName(),
2471 packageName);
2472
Jon Mirandab42e1242022-03-08 16:37:35 -08002473 if (supportsAllAppsState && isInState(LauncherState.ALL_APPS)) {
Jon Mirandaf58db152022-06-02 16:06:37 -07002474 AllAppsRecyclerView activeRecyclerView = mAppsView.getActiveRecyclerView();
2475 View v = getFirstMatch(Collections.singletonList(activeRecyclerView),
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002476 preferredItem, packageAndUserAndApp);
Jon Mirandaf58db152022-06-02 16:06:37 -07002477
Sunny Goyalf34811d2022-10-21 20:42:34 +00002478 if (v != null && activeRecyclerView.computeVerticalScrollOffset() > 0) {
Jon Mirandaf58db152022-06-02 16:06:37 -07002479 RectF locationBounds = new RectF();
2480 FloatingIconView.getLocationBoundsForView(this, v, false, locationBounds,
2481 new Rect());
2482 if (locationBounds.top < mAppsView.getHeaderBottom()) {
2483 // Icon is covered by scrim, return null to play fallback animation.
2484 return null;
2485 }
2486 }
2487
2488 return v;
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002489 }
Federico Baron8bf1bca2022-09-27 16:19:11 -07002490
2491 // Look for the item inside the folder at the current page
2492 Folder folder = Folder.getOpen(this);
2493 if (folder != null) {
2494 View v = getFirstMatch(Collections.singletonList(
2495 folder.getContent().getCurrentCellLayout().getShortcutsAndWidgets()),
2496 preferredItem,
2497 packageAndUserAndApp);
2498 if (v == null) {
2499 folder.close(isStarted() && !isForceInvisible());
2500 } else {
2501 return v;
2502 }
2503 }
2504
2505 List<ViewGroup> containers = new ArrayList<>(mWorkspace.getPanelCount() + 1);
2506 containers.add(mWorkspace.getHotseat().getShortcutsAndWidgets());
2507 mWorkspace.forEachVisiblePage(page
2508 -> containers.add(((CellLayout) page).getShortcutsAndWidgets()));
2509
2510 // Order: Preferred item by itself or in folder, then by matching package/user
2511 return getFirstMatch(containers, preferredItem, forFolderMatch(preferredItem),
2512 packageAndUserAndApp, forFolderMatch(packageAndUserAndApp));
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002513 }
2514
2515 /**
2516 * Finds the first view matching the ordered operators across the given viewgroups in order.
2517 * @param containers List of ViewGroups to scan, in order of preference.
2518 * @param operators List of operators, in order starting from best matching operator.
2519 */
Jon Mirandaf26bdcb2022-06-09 16:09:30 -07002520 @Nullable
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002521 private static View getFirstMatch(Iterable<ViewGroup> containers,
Sunny Goyal32084d42022-05-02 10:00:07 -07002522 final Predicate<ItemInfo>... operators) {
2523 for (Predicate<ItemInfo> operator : operators) {
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002524 for (ViewGroup container : containers) {
2525 View match = mapOverViewGroup(container, operator);
2526 if (match != null) {
2527 return match;
2528 }
2529 }
2530 }
2531 return null;
2532 }
2533
Fengjiang Li8bd66ee2024-01-26 10:00:47 -08002534 /** Convert a {@link View} to {@link Bitmap}. */
2535 private static Bitmap getBitmapFromView(@Nullable View view) {
2536 if (view == null) {
2537 return null;
2538 }
2539 Bitmap returnedBitmap =
2540 Bitmap.createBitmap(view.getWidth(), view.getHeight(), Bitmap.Config.ARGB_8888);
2541 Canvas canvas = new Canvas(returnedBitmap);
2542 view.draw(canvas);
2543 return returnedBitmap;
2544 }
2545
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002546 /**
2547 * Returns the first view matching the operator in the given ViewGroups, or null if none.
2548 * Forward iteration matters.
2549 */
Jon Mirandaf26bdcb2022-06-09 16:09:30 -07002550 @Nullable
Sunny Goyal32084d42022-05-02 10:00:07 -07002551 private static View mapOverViewGroup(ViewGroup container, Predicate<ItemInfo> op) {
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002552 final int itemCount = container.getChildCount();
2553 for (int itemIdx = 0; itemIdx < itemCount; itemIdx++) {
2554 View item = container.getChildAt(itemIdx);
Sunny Goyalf1582862024-09-05 16:49:10 -07002555 if (item.getVisibility() != View.VISIBLE) {
2556 continue;
2557 }
Brandon Dayauon120838b2024-04-08 13:04:54 -07002558 if (item instanceof ViewGroup viewGroup) {
2559 View view = mapOverViewGroup(viewGroup, op);
2560 if (view != null) {
2561 return view;
2562 }
2563 }
2564 if (item.getTag() instanceof ItemInfo itemInfo && op.test(itemInfo)) {
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002565 return item;
2566 }
2567 }
2568 return null;
2569 }
2570
Winson Chungc9168342013-06-26 14:54:55 -07002571 private ValueAnimator createNewAppBounceAnimation(View v, int i) {
Sunny Goyalf0b6db72018-08-13 16:10:14 -07002572 ValueAnimator bounceAnim = new PropertyListBuilder().alpha(1).scale(1).build(v)
Sunny Goyal60e68c92020-08-12 13:59:27 -07002573 .setDuration(ItemInstallQueue.NEW_SHORTCUT_BOUNCE_DURATION);
2574 bounceAnim.setStartDelay(i * ItemInstallQueue.NEW_SHORTCUT_STAGGER_DELAY);
Sunny Goyal5a1f53b2015-05-27 10:24:24 -07002575 bounceAnim.setInterpolator(new OvershootInterpolator(BOUNCE_ANIMATION_TENSION));
Winson Chungc9168342013-06-26 14:54:55 -07002576 return bounceAnim;
2577 }
2578
Pinyao Tingc9074272019-11-11 11:51:44 -08002579 private void announceForAccessibility(@StringRes int stringResId) {
2580 getDragLayer().announceForAccessibility(getString(stringResId));
2581 }
2582
Amith Yamasani6d7fe502010-11-16 09:05:07 -08002583 /**
Josh Tsuji231c9222022-01-11 20:43:59 -05002584 * Informs us that the overlay (-1 screen, typically), has either become visible or invisible.
2585 */
Sunny Goyal82379182022-11-02 18:58:49 -07002586 public void onOverlayVisibilityChanged(boolean visible) {
2587 getStatsLogManager().logger()
2588 .withSrcState(LAUNCHER_STATE_HOME)
2589 .withDstState(LAUNCHER_STATE_HOME)
2590 .withContainerInfo(LauncherAtom.ContainerInfo.newBuilder()
2591 .setWorkspace(WorkspaceContainer.newBuilder()
2592 .setPageIndex(visible ? 0 : -1))
2593 .build())
2594 .log(visible ? LAUNCHER_SWIPELEFT : LAUNCHER_SWIPERIGHT);
2595 }
Josh Tsuji231c9222022-01-11 20:43:59 -05002596
2597 /**
2598 * Informs us that the page transition has ended, so that we can react to the newly selected
2599 * page if we want to.
2600 */
2601 public void onPageEndTransition() {}
2602
2603 /**
Sebastian Francobd7919c2023-09-19 10:55:37 -07002604 * See {@code LauncherBindingDelegate}
Joe Onorato9c1289c2009-08-17 11:03:03 -04002605 */
Sunny Goyal28daf4a2020-06-08 17:06:09 -07002606 @Override
Schneider Victor-tulias927d6dc2021-08-26 11:56:47 -07002607 @TargetApi(Build.VERSION_CODES.S)
Anushree Ganjam97434ee2023-05-18 22:03:16 +00002608 @UiThread
2609 public void bindAllApplications(AppInfo[] apps, int flags,
2610 Map<PackageUserKey, Integer> packageUserKeytoUidMap) {
Sebastian Francobd7919c2023-09-19 10:55:37 -07002611 mModelCallbacks.bindAllApplications(apps, flags, packageUserKeytoUidMap);
Sunny Goyal621918f2024-09-18 11:31:58 -07002612 Trace.endAsyncSection(DISPLAY_ALL_APPS_TRACE_METHOD_NAME,
2613 DISPLAY_ALL_APPS_TRACE_COOKIE);
Joe Onorato9c1289c2009-08-17 11:03:03 -04002614 }
2615
2616 /**
Sebastian Francobd7919c2023-09-19 10:55:37 -07002617 * See {@code LauncherBindingDelegate}
Tony Wickhambfbf7f92016-05-19 11:19:39 -07002618 */
2619 @Override
Zak Cohen658c67a2018-10-19 14:21:05 -07002620 public void bindDeepShortcutMap(HashMap<ComponentKey, Integer> deepShortcutMapCopy) {
Sebastian Francobd7919c2023-09-19 10:55:37 -07002621 mModelCallbacks.bindDeepShortcutMap(deepShortcutMapCopy);
Tony Wickham1bce7fd2016-04-28 17:39:03 -07002622 }
2623
Sunny Goyal4390ace2014-10-13 11:33:11 -07002624 @Override
Schneider Victor-tulias6a5f4312021-01-12 19:30:02 +00002625 public void bindIncrementalDownloadProgressUpdated(AppInfo app) {
Sebastian Francobd7919c2023-09-19 10:55:37 -07002626 mModelCallbacks.bindIncrementalDownloadProgressUpdated(app);
Mario Bertschler08ffaae2017-03-20 11:30:27 -07002627 }
2628
2629 @Override
Sunny Goyal29947f02017-12-18 13:49:44 -08002630 public void bindWidgetsRestored(ArrayList<LauncherAppWidgetInfo> widgets) {
Sebastian Francobd7919c2023-09-19 10:55:37 -07002631 mModelCallbacks.bindWidgetsRestored(widgets);
Sunny Goyal4390ace2014-10-13 11:33:11 -07002632 }
2633
Joe Onorato9c1289c2009-08-17 11:03:03 -04002634 /**
Sebastian Francobd7919c2023-09-19 10:55:37 -07002635 * See {@code LauncherBindingDelegate}
Sunny Goyalb50cc8c2014-10-06 16:23:56 -07002636 */
Sunny Goyal4390ace2014-10-13 11:33:11 -07002637 @Override
Sunny Goyal28f50752020-07-21 14:15:13 -07002638 public void bindWorkspaceItemsChanged(List<WorkspaceItemInfo> updated) {
Sebastian Francobd7919c2023-09-19 10:55:37 -07002639 mModelCallbacks.bindWorkspaceItemsChanged(updated);
Sunny Goyalb50cc8c2014-10-06 16:23:56 -07002640 }
2641
2642 /**
Sebastian Francobd7919c2023-09-19 10:55:37 -07002643 * See {@code LauncherBindingDelegate}
Chris Wrenaeff7ea2014-02-14 16:59:24 -05002644 */
Sunny Goyale755d462014-07-22 13:48:29 -07002645 @Override
Sunny Goyal29947f02017-12-18 13:49:44 -08002646 public void bindRestoreItemsChange(HashSet<ItemInfo> updates) {
Sebastian Francobd7919c2023-09-19 10:55:37 -07002647 mModelCallbacks.bindRestoreItemsChange(updates);
Sunny Goyala22666f2014-09-18 13:25:15 -07002648 }
2649
2650 /**
Sebastian Francobd7919c2023-09-19 10:55:37 -07002651 * See {@code LauncherBindingDelegate}
Joe Onorato9c1289c2009-08-17 11:03:03 -04002652 */
Sunny Goyal1a745e82014-10-02 15:58:31 -07002653 @Override
Sunny Goyal32084d42022-05-02 10:00:07 -07002654 public void bindWorkspaceComponentsRemoved(Predicate<ItemInfo> matcher) {
Sebastian Francobd7919c2023-09-19 10:55:37 -07002655 mModelCallbacks.bindWorkspaceComponentsRemoved(matcher);
Sunny Goyal3bbbabc2016-03-15 09:16:30 -07002656 }
Sunny Goyal4390ace2014-10-13 11:33:11 -07002657
Sebastian Francobd7919c2023-09-19 10:55:37 -07002658 /**
2659 * See {@code LauncherBindingDelegate}
2660 */
Sunny Goyal3bbbabc2016-03-15 09:16:30 -07002661 @Override
Shamali Pea078cb2024-11-04 21:35:38 +00002662 public void bindAllWidgets(@NonNull final List<WidgetsListBaseEntry> allWidgets,
2663 @NonNull final List<WidgetsListBaseEntry> defaultWidgets) {
2664 mModelCallbacks.bindAllWidgets(allWidgets, defaultWidgets);
Tony Wickham26b17462017-03-20 17:12:24 -07002665 }
2666
kholoud mohamedc76b2032021-12-20 16:47:38 +00002667 @Override
fbarone58aaf12023-09-25 11:34:56 -07002668 public void bindSmartspaceWidget() {
Sebastian Franco50b74c32023-11-16 11:36:49 -06002669 mModelCallbacks.bindSmartspaceWidget();
fbarone58aaf12023-09-25 11:34:56 -07002670 }
2671
2672 @Override
kholoud mohamedc76b2032021-12-20 16:47:38 +00002673 public void bindStringCache(StringCache cache) {
Sebastian Franco6dda7c72023-11-17 18:03:00 -06002674 mModelCallbacks.bindStringCache(cache);
kholoud mohamedc76b2032021-12-20 16:47:38 +00002675 }
2676
Tony Wickham86222d22017-03-29 15:30:43 -07002677 /**
2678 * @param packageUser if null, refreshes all widgets and shortcuts, otherwise only
2679 * refreshes the widgets and shortcuts associated with the given package/user
2680 */
2681 public void refreshAndBindWidgetsForPackageUser(@Nullable PackageUserKey packageUser) {
Sunny Goyalc6e97692017-06-02 13:46:55 -07002682 mModel.refreshAndBindWidgetsAndShortcuts(packageUser);
Sunny Goyal2e1efb42016-03-03 16:58:55 -08002683 }
2684
Winson Chung80baf5a2010-08-09 16:03:15 -07002685 /**
Hyunyoung Song3c7d9cb2017-01-30 15:11:27 -08002686 * $ adb shell dumpsys activity com.android.launcher3.Launcher [--all]
Joe Onoratobe386092009-11-17 17:32:16 -08002687 */
Adam Cohen16d7ffc2011-10-05 17:49:14 -07002688 @Override
2689 public void dump(String prefix, FileDescriptor fd, PrintWriter writer, String[] args) {
2690 super.dump(prefix, fd, writer, args);
Sunny Goyala1365452015-10-01 15:46:24 -07002691
Hyunyoung Song3c7d9cb2017-01-30 15:11:27 -08002692 if (args.length > 0 && TextUtils.equals(args[0], "--all")) {
2693 writer.println(prefix + "Workspace Items");
Sunny Goyal7ce471b2017-08-02 03:37:39 -07002694 for (int i = 0; i < mWorkspace.getPageCount(); i++) {
Hyunyoung Song3c7d9cb2017-01-30 15:11:27 -08002695 writer.println(prefix + " Homescreen " + i);
2696
2697 ViewGroup layout = ((CellLayout) mWorkspace.getPageAt(i)).getShortcutsAndWidgets();
2698 for (int j = 0; j < layout.getChildCount(); j++) {
2699 Object tag = layout.getChildAt(j).getTag();
2700 if (tag != null) {
Sunny Goyal576f7a52023-10-06 11:28:25 -07002701 writer.println(prefix + " " + tag);
Hyunyoung Song3c7d9cb2017-01-30 15:11:27 -08002702 }
2703 }
2704 }
2705
2706 writer.println(prefix + " Hotseat");
Liran Binyamin69f49742024-03-04 09:39:53 -05002707 mHotseat.dump(prefix, writer);
Sunny Goyal876e4622018-11-02 13:50:40 -07002708 ViewGroup layout = mHotseat.getShortcutsAndWidgets();
Sunny Goyala1365452015-10-01 15:46:24 -07002709 for (int j = 0; j < layout.getChildCount(); j++) {
2710 Object tag = layout.getChildAt(j).getTag();
2711 if (tag != null) {
Sunny Goyal576f7a52023-10-06 11:28:25 -07002712 writer.println(prefix + " " + tag);
Sunny Goyala1365452015-10-01 15:46:24 -07002713 }
Adam Cohen4caf2982013-08-20 18:54:31 -07002714 }
Sunny Goyala1365452015-10-01 15:46:24 -07002715 }
2716
Hyunyoung Song3c7d9cb2017-01-30 15:11:27 -08002717 writer.println(prefix + "Misc:");
Winson Chungef528762019-09-06 12:05:52 -07002718 dumpMisc(prefix + "\t", writer);
Sebastian Francoe4965122023-12-01 13:27:42 -06002719 writer.println(prefix + "\tmWorkspaceLoading=" + mModelCallbacks.getWorkspaceLoading());
Winson Chungef528762019-09-06 12:05:52 -07002720 writer.println(prefix + "\tmPendingRequestArgs=" + mPendingRequestArgs
2721 + " mPendingActivityResult=" + mPendingActivityResult);
2722 writer.println(prefix + "\tmRotationHelper: " + mRotationHelper);
Sihua Ma0593a0d2022-10-03 16:01:48 -07002723 writer.println(prefix + "\tmAppWidgetHolder.isListening: "
2724 + mAppWidgetHolder.isListening());
Winson Chungef528762019-09-06 12:05:52 -07002725
Stefan Andonianfb348912024-08-14 22:51:32 +00002726 // b/349929393
2727 // The only way to reproduce this bug is to ensure that onLayout never gets called. This
2728 // theoretically is impossible, so these logs are being added to test if that actually is
2729 // what is happening.
2730 writer.println(prefix + "\tmWorkspace.mHasOnLayoutBeenCalled="
2731 + mWorkspace.mHasOnLayoutBeenCalled);
2732 for (int i = 0; i < mWorkspace.getPageCount(); i++) {
2733 CellLayout cellLayout = (CellLayout) mWorkspace.getPageAt(i);
2734 writer.println(prefix + "\tcellLayout." + i + ".mHasOnLayoutBeenCalled="
2735 + cellLayout.mHasOnLayoutBeenCalled);
2736 writer.println(prefix + "\tshortcutAndWidgetContainer." + i + ".mHasOnLayoutBeenCalled="
2737 + cellLayout.getShortcutsAndWidgets().mHasOnLayoutBeenCalled);
2738 }
2739
Tony Wickham646e4482020-04-06 17:25:53 -07002740 // Extra logging for general debugging
Hyunyoung Songa310a802019-04-25 13:57:16 -07002741 mDragLayer.dump(prefix, writer);
2742 mStateManager.dump(prefix, writer);
Tony Wickham646e4482020-04-06 17:25:53 -07002743 mPopupDataProvider.dump(prefix, writer);
Shamali P74d9fbd2024-07-19 21:07:05 +00002744 mWidgetPickerDataProvider.dump(prefix, writer);
Pat Manning5f74bfd2022-07-20 12:08:54 +01002745 mDeviceProfile.dump(this, prefix, writer);
Kevin Lim07546b82023-09-25 21:02:56 +00002746 mAppsView.getAppsStore().dump(prefix, writer);
Brandon Dayauon71fff872024-08-08 11:12:13 -07002747 mAppsView.getPersonalAppList().dump(prefix, writer);
2748 if (mAppsView.shouldShowTabs()) {
2749 mAppsView.getWorkAppList().dump(prefix, writer);
2750 }
Sunny Goyal2bba1902018-02-27 12:20:50 -08002751
2752 try {
2753 FileLog.flushAll(writer);
2754 } catch (Exception e) {
2755 // Ignore
2756 }
Hyunyoung Song3c7d9cb2017-01-30 15:11:27 -08002757
2758 mModel.dumpState(prefix, fd, writer, args);
Sunny Goyalb1d7de22019-09-06 10:36:54 -07002759 mOverlayManager.dump(prefix, writer);
Schneider Victor-tulias18821d12024-03-22 14:44:00 -04002760 ACTIVITY_TRACKER.dump(prefix, writer);
Juan Sebastian Martinez4c35e502024-11-13 12:07:32 -08002761 MSDLPlayerWrapper.INSTANCE.get(getApplicationContext()).dump(prefix, writer);
Adam Cohen16d7ffc2011-10-05 17:49:14 -07002762 }
Adam Cohen487f7dd2012-06-28 18:12:10 -07002763
Sebastian Franco4080fdd2023-09-19 14:17:23 -07002764 /**
2765 * Populates the list of shortcuts. Logic delegated to {@Link KeyboardShortcutsDelegate}.
2766 *
2767 * @param data The data list to populate with shortcuts.
2768 * @param menu The current menu, which may be null.
2769 * @param deviceId The id for the connected device the shortcuts should be provided for.
2770 */
Sunny Goyal66b24572016-09-21 15:57:55 -07002771 @Override
Sunny Goyal66b24572016-09-21 15:57:55 -07002772 public void onProvideKeyboardShortcuts(
2773 List<KeyboardShortcutGroup> data, Menu menu, int deviceId) {
Sebastian Franco4080fdd2023-09-19 14:17:23 -07002774 mKeyboardShortcutsDelegate.onProvideKeyboardShortcuts(data, menu, deviceId);
Sunny Goyal66b24572016-09-21 15:57:55 -07002775 super.onProvideKeyboardShortcuts(data, menu, deviceId);
2776 }
2777
Sebastian Franco4080fdd2023-09-19 14:17:23 -07002778 /**
2779 * Logic delegated to {@Link KeyboardShortcutsDelegate}.
2780 * @param keyCode The value in event.getKeyCode().
2781 * @param event Description of the key event.
2782 */
Sunny Goyal66b24572016-09-21 15:57:55 -07002783 @Override
2784 public boolean onKeyShortcut(int keyCode, KeyEvent event) {
Sebastian Franco4080fdd2023-09-19 14:17:23 -07002785 Boolean result = mKeyboardShortcutsDelegate.onKeyShortcut(keyCode, event);
2786 return result != null ? result : super.onKeyShortcut(keyCode, event);
Sunny Goyal66b24572016-09-21 15:57:55 -07002787 }
2788
Sebastian Franco4080fdd2023-09-19 14:17:23 -07002789 /**
2790 * Logic delegated to {@Link KeyboardShortcutsDelegate}.
2791 * @param keyCode The value in event.getKeyCode().
2792 * @param event Description of the key event.
2793 */
Vadim Tryshev646a0dd2018-02-05 16:27:50 -08002794 @Override
Josep del Rio1d976c62023-05-04 16:07:50 +00002795 public boolean onKeyDown(int keyCode, KeyEvent event) {
Sebastian Franco4080fdd2023-09-19 14:17:23 -07002796 Boolean result = mKeyboardShortcutsDelegate.onKeyDown(keyCode, event);
2797 return result != null ? result : super.onKeyDown(keyCode, event);
Josep del Rio1d976c62023-05-04 16:07:50 +00002798 }
2799
Sebastian Franco4080fdd2023-09-19 14:17:23 -07002800 /**
2801 * Logic delegated to {@Link KeyboardShortcutsDelegate}.
2802 * @param keyCode The value in event.getKeyCode().
2803 * @param event Description of the key event.
2804 */
Josep del Rio1d976c62023-05-04 16:07:50 +00002805 @Override
Vadim Tryshev646a0dd2018-02-05 16:27:50 -08002806 public boolean onKeyUp(int keyCode, KeyEvent event) {
Sebastian Franco4080fdd2023-09-19 14:17:23 -07002807 Boolean result = mKeyboardShortcutsDelegate.onKeyUp(keyCode, event);
2808 return result != null ? result : super.onKeyUp(keyCode, event);
Vadim Tryshev646a0dd2018-02-05 16:27:50 -08002809 }
2810
Sunny Goyal831212e2021-05-14 14:24:09 -07002811 /**
2812 * Shows the default options popup
2813 */
2814 public void showDefaultOptions(float x, float y) {
Brian Isganitisa85ae692021-09-23 19:56:24 -04002815 OptionsPopupView.show(this, getPopupTarget(x, y), OptionsPopupView.getOptions(this),
2816 false);
2817 }
2818
Brian Isganitisa85ae692021-09-23 19:56:24 -04002819 @Override
Charlie Anderson8ad91442023-01-09 13:55:59 -05002820 public boolean canUseMultipleShadesForPopup() {
Brian Isganitisa85ae692021-09-23 19:56:24 -04002821 return getTopOpenViewWithType(this, TYPE_FOLDER) == null
2822 && getStateManager().getState() != LauncherState.ALL_APPS;
Sunny Goyal831212e2021-05-14 14:24:09 -07002823 }
2824
Sunny Goyalb5181c82021-03-10 07:39:12 +00002825 @Override
randypfohl176ce852024-05-08 14:50:50 -07002826 public void collectStateHandlers(List<StateHandler<LauncherState>> out) {
Sunny Goyalb5181c82021-03-10 07:39:12 +00002827 out.add(getAllAppsController());
2828 out.add(getWorkspace());
Andrew Sappersteinabef55a2016-06-19 12:49:00 -07002829 }
2830
Sunny Goyal210e1742019-10-17 12:05:38 -07002831 public TouchController[] createTouchControllers() {
2832 return new TouchController[] {getDragController(), new AllAppsSwipeController(this)};
2833 }
2834
Sunny Goyal1eb11242022-09-09 17:14:45 -07002835 public void onDragLayerHierarchyChanged() {
2836 updateDisallowBack();
2837 }
2838
Vinit Nayak65460402023-08-11 15:40:07 -07002839 protected void addBackAnimationCallback(BackPressHandler callback) {
2840 mBackPressedHandlers.add(callback);
2841 }
2842
2843 protected void removeBackAnimationCallback(BackPressHandler callback) {
2844 mBackPressedHandlers.remove(callback);
2845 }
2846
Sunny Goyal1eb11242022-09-09 17:14:45 -07002847 private void updateDisallowBack() {
Ivan Tkachenkof58d2272024-06-19 11:44:52 +00002848 if (BuildCompat.isAtLeastV()
2849 && Flags.enableDesktopWindowingMode()
2850 && !Flags.enableDesktopWindowingWallpaperActivity()
2851 && mDeviceProfile.isTablet) {
2852 // TODO(b/333533253): Clean up after desktop wallpaper activity flag is rolled out
Ats Jenk8121e0d2022-12-01 11:34:43 -08002853 return;
2854 }
Sunny Goyal1eb11242022-09-09 17:14:45 -07002855 LauncherRootView rv = getRootView();
2856 if (rv != null) {
Vinit Nayak7c7ece32024-01-23 15:41:14 -08002857 boolean isSplitSelectionEnabled = isSplitSelectionActive();
Sunny Goyal1eb11242022-09-09 17:14:45 -07002858 boolean disableBack = getStateManager().getState() == NORMAL
Vinit Nayak65460402023-08-11 15:40:07 -07002859 && AbstractFloatingView.getTopOpenView(this) == null
2860 && !isSplitSelectionEnabled;
Sunny Goyal1eb11242022-09-09 17:14:45 -07002861 rv.setDisallowBackGesture(disableBack);
2862 }
2863 }
Sunny Goyal210e1742019-10-17 12:05:38 -07002864
Vinit Nayak65460402023-08-11 15:40:07 -07002865 /** To be overridden by subclasses */
Vinit Nayak7c7ece32024-01-23 15:41:14 -08002866 public boolean isSplitSelectionActive() {
Vinit Nayak65460402023-08-11 15:40:07 -07002867 // Overridden
2868 return false;
2869 }
2870
Vinit Nayakd0fc7182023-10-06 16:05:54 -07002871 /** Call to dismiss the intermediary split selection state. */
Vinit Nayak5a9d4af2024-01-31 12:49:05 -08002872 public void dismissSplitSelection(StatsLogManager.LauncherEvent splitDismissEvent) {
Vinit Nayakd0fc7182023-10-06 16:05:54 -07002873 // Overridden; move this into ActivityContext if necessary for Taskbar
2874 }
2875
Jon Miranda20fdc7b2023-12-12 16:48:01 -08002876 /**
2877 * Callback for when launcher state transition completes after user swipes to home.
2878 * @param finalState The final state of the transition.
2879 */
2880 public void onStateTransitionCompletedAfterSwipeToHome(LauncherState finalState) {
2881 // Overridden
2882 }
2883
Vinit Nayakf9b585b2019-07-10 14:25:32 -07002884 @Override
2885 public void returnToHomescreen() {
2886 super.returnToHomescreen();
2887 getStateManager().goToState(LauncherState.NORMAL);
2888 }
2889
Sebastian Franco4080fdd2023-09-19 14:17:23 -07002890 public void closeOpenViews() {
Andy Wickham65ced1b2020-03-07 02:14:19 +00002891 closeOpenViews(true);
2892 }
2893
2894 protected void closeOpenViews(boolean animate) {
2895 AbstractFloatingView.closeAllOpenViews(this, animate);
2896 }
2897
Sunny Goyal384b5782021-02-09 22:50:02 -08002898 protected LauncherAccessibilityDelegate createAccessibilityDelegate() {
2899 return new LauncherAccessibilityDelegate(this);
2900 }
Sunny Goyalf2393f12020-04-01 20:13:12 -07002901
Schneider Victor-tulias7cd0ae32023-03-21 11:46:18 -07002902 /** Enables/disabled the hotseat prediction icon long press edu for testing. */
2903 @VisibleForTesting
2904 public void enableHotseatEdu(boolean enable) {}
2905
Sunny Goyal210e1742019-10-17 12:05:38 -07002906
Sunny Goyal3dce5f32017-10-05 11:40:05 -07002907 /**
Sunny Goyalab770a12018-11-14 15:17:26 -08002908 * Just a wrapper around the type cast to allow easier tracking of calls.
2909 */
2910 public static <T extends Launcher> T cast(ActivityContext activityContext) {
2911 return (T) activityContext;
2912 }
2913
Sunny Goyalb65d7662021-03-07 15:09:11 -08002914 public boolean supportsAdaptiveIconAnimation(View clickedView) {
2915 return false;
2916 }
2917
Schneider Victor-tulias9b6babf2022-03-24 14:47:32 -07002918 /**
2919 * Animates Launcher elements during a transition to the All Apps page.
2920 *
2921 * @param progress Transition progress from 0 to 1; where 0 => home and 1 => all apps.
2922 */
2923 public void onAllAppsTransition(float progress) {
2924 // No-Op
2925 }
2926
2927 /**
2928 * Animates Launcher elements during a transition to the Widgets pages.
2929 *
2930 * @param progress Transition progress from 0 to 1; where 0 => home and 1 => widgets.
2931 */
2932 public void onWidgetsTransition(float progress) {
Alex Chau3d2c0622022-09-01 21:28:14 +01002933 float scale = Utilities.mapToRange(progress, 0f, 1f, 1f,
2934 mDeviceProfile.bottomSheetWorkspaceScale, EMPHASIZED);
2935 WORKSPACE_WIDGET_SCALE.set(getWorkspace(), scale);
2936 HOTSEAT_WIDGET_SCALE.set(getHotseat(), scale);
Schneider Victor-tulias9b6babf2022-03-24 14:47:32 -07002937 }
2938
Sunny Goyal6c0c61a2020-12-08 19:19:56 -08002939 private static class NonConfigInstance {
2940 public Configuration config;
Sunny Goyal6c0c61a2020-12-08 19:19:56 -08002941 }
thiruramc96873c2021-02-11 15:13:47 -08002942
Schneider Victor-tulias789a6a92022-03-04 12:06:09 -08002943 /** Pauses view updates that should not be run during the app launch animation. */
2944 public void pauseExpensiveViewUpdates() {
2945 // Pause page indicator animations as they lead to layer trashing.
Shikha Malhotrae957b602022-04-11 07:57:18 +00002946 getWorkspace().getPageIndicator().pauseAnimations();
Jon Miranda46ecc0c2022-06-02 11:34:15 -07002947
2948 getWorkspace().mapOverItems((info, view) -> {
2949 if (view instanceof LauncherAppWidgetHostView) {
2950 ((LauncherAppWidgetHostView) view).beginDeferringUpdates();
2951 }
2952 return false; // Return false to continue iterating through all the items.
2953 });
Schneider Victor-tulias789a6a92022-03-04 12:06:09 -08002954 }
2955
2956 /** Resumes view updates at the end of the app launch animation. */
2957 public void resumeExpensiveViewUpdates() {
Shikha Malhotrae957b602022-04-11 07:57:18 +00002958 getWorkspace().getPageIndicator().skipAnimationsToEnd();
Shikha Malhotra0f2e1b62022-03-27 21:02:21 +00002959
Jon Miranda46ecc0c2022-06-02 11:34:15 -07002960 getWorkspace().mapOverItems((info, view) -> {
2961 if (view instanceof LauncherAppWidgetHostView) {
2962 ((LauncherAppWidgetHostView) view).endDeferringUpdates();
2963 }
2964 return false; // Return false to continue iterating through all the items.
2965 });
2966 }
Ats Jenkca009e42023-01-06 09:52:40 -08002967
2968 /**
2969 * Returns {@code true} if there are visible tasks with windowing mode set to
2970 * {@link android.app.WindowConfiguration#WINDOWING_MODE_FREEFORM}
2971 */
Alina Zaidi05803792024-04-09 17:16:16 +00002972 public boolean areDesktopTasksVisible() {
2973 return false; // Base launcher does not track desktop tasks
Ats Jenkca009e42023-01-06 09:52:40 -08002974 }
Brian Isganitisf54c6fa2023-07-11 12:47:08 -04002975
Sebastian Franco8a3de212023-09-05 18:54:01 -07002976 // Getters and Setters
2977
Sebastian Franco8a3de212023-09-05 18:54:01 -07002978 public boolean isWorkspaceLocked() {
Sebastian Francoe4965122023-12-01 13:27:42 -06002979 return isWorkspaceLoading() || mPendingRequestArgs != null;
Sebastian Franco8a3de212023-09-05 18:54:01 -07002980 }
2981
2982 public boolean isWorkspaceLoading() {
Sebastian Francoe4965122023-12-01 13:27:42 -06002983 return mModelCallbacks.getWorkspaceLoading();
Sebastian Franco8a3de212023-09-05 18:54:01 -07002984 }
2985
Brian Isganitisf54c6fa2023-07-11 12:47:08 -04002986 @Override
Sebastian Franco8a3de212023-09-05 18:54:01 -07002987 public boolean isBindingItems() {
Sebastian Francoe4965122023-12-01 13:27:42 -06002988 return isWorkspaceLoading();
Sebastian Franco8a3de212023-09-05 18:54:01 -07002989 }
2990
2991 /**
2992 * Returns true if a touch interaction is in progress
2993 */
2994 public boolean isTouchInProgress() {
2995 return mTouchInProgress;
2996 }
2997
2998 public boolean isDraggingEnabled() {
2999 // We prevent dragging when we are loading the workspace as it is possible to pick up a view
3000 // that is subsequently removed from the workspace in startBinding().
3001 return !isWorkspaceLoading();
3002 }
3003
Tracy Zhoude8e25c2023-10-07 00:00:57 -07003004 public boolean isNaturalScrollingEnabled() {
3005 return mIsNaturalScrollingEnabled;
3006 }
3007
Sebastian Franco8a3de212023-09-05 18:54:01 -07003008 public void setWaitingForResult(PendingRequestArgs args) {
3009 mPendingRequestArgs = args;
3010 }
3011
3012 /**
3013 * Call this after onCreate to set or clear overlay.
3014 */
Sunny Goyaldc7cdd82024-02-13 14:56:36 -08003015 public void setLauncherOverlay(LauncherOverlayTouchProxy overlay) {
Sebastian Franco8a3de212023-09-05 18:54:01 -07003016 mWorkspace.setLauncherOverlay(overlay);
3017 }
3018
Sebastian Franco8a3de212023-09-05 18:54:01 -07003019 /**
3020 * Persistent callback which notifies when an activity launch is deferred because the activity
3021 * was not yet resumed.
3022 */
3023 public void setOnDeferredActivityLaunchCallback(Runnable callback) {
3024 mOnDeferredActivityLaunchCallback = callback;
3025 }
3026
3027 /**
3028 * Sets the next pages to bind synchronously on next bind.
3029 * @param pages should not be null.
3030 */
3031 public void setPagesToBindSynchronously(@NonNull IntSet pages) {
Sebastian Franco69fd7422023-10-06 16:48:58 -07003032 mModelCallbacks.setPagesToBindSynchronously(pages);
Sebastian Franco8a3de212023-09-05 18:54:01 -07003033 }
3034
Sebastian Franco8a3de212023-09-05 18:54:01 -07003035 @Override
3036 public CellPosMapper getCellPosMapper() {
3037 return mCellPosMapper;
3038 }
3039
3040 public RotationHelper getRotationHelper() {
3041 return mRotationHelper;
3042 }
3043
3044 public ViewGroupFocusHelper getFocusHandler() {
3045 return mFocusHandler;
3046 }
3047
3048 @Override
randypfohl176ce852024-05-08 14:50:50 -07003049 public StateManager<LauncherState, Launcher> getStateManager() {
Sebastian Franco8a3de212023-09-05 18:54:01 -07003050 return mStateManager;
3051 }
3052
3053 @NonNull
3054 @Override
3055 public PopupDataProvider getPopupDataProvider() {
3056 return mPopupDataProvider;
3057 }
3058
Shamali P74d9fbd2024-07-19 21:07:05 +00003059 @NonNull
3060 @Override
3061 public WidgetPickerDataProvider getWidgetPickerDataProvider() {
3062 return mWidgetPickerDataProvider;
3063 }
3064
Sebastian Franco8a3de212023-09-05 18:54:01 -07003065 @Override
3066 public DotInfo getDotInfoForItem(ItemInfo info) {
3067 return mPopupDataProvider.getDotInfoForItem(info);
3068 }
3069
Fengjiang Lia7e357e2024-09-04 14:46:37 -07003070 @NonNull
Sebastian Franco8a3de212023-09-05 18:54:01 -07003071 public LauncherOverlayManager getOverlayManager() {
3072 return mOverlayManager;
3073 }
3074
3075 public AllAppsTransitionController getAllAppsController() {
3076 return mAllAppsController;
3077 }
3078
3079 @Override
3080 public DragLayer getDragLayer() {
3081 return mDragLayer;
3082 }
3083
3084 @Override
3085 public ActivityAllAppsContainerView<Launcher> getAppsView() {
3086 return mAppsView;
3087 }
3088
3089 public Workspace<?> getWorkspace() {
3090 return mWorkspace;
3091 }
3092
3093 public Hotseat getHotseat() {
3094 return mHotseat;
3095 }
3096
3097 public <T extends View> T getOverviewPanel() {
3098 return (T) mOverviewPanel;
3099 }
3100
3101 public DropTargetBar getDropTargetBar() {
3102 return mDropTargetBar;
3103 }
3104
3105 @Override
3106 public ScrimView getScrimView() {
3107 return mScrimView;
3108 }
3109
3110 public LauncherWidgetHolder getAppWidgetHolder() {
3111 return mAppWidgetHolder;
3112 }
3113
3114 public LauncherModel getModel() {
3115 return mModel;
3116 }
3117
3118 /**
3119 * Returns the ModelWriter writer, make sure to call the function every time you want to use it.
3120 */
3121 public ModelWriter getModelWriter() {
3122 return mModelWriter;
3123 }
3124
Sebastian Franco8a3de212023-09-05 18:54:01 -07003125 public SharedPreferences getSharedPrefs() {
3126 return mSharedPrefs;
3127 }
3128
Sebastian Franco8a3de212023-09-05 18:54:01 -07003129 public int getOrientation() {
3130 return mOldConfig.orientation;
3131 }
3132
Sebastian Franco8a3de212023-09-05 18:54:01 -07003133 /**
3134 * Returns the CellLayout of the specified container at the specified screen.
3135 *
3136 * @param screenId must be presenterPos and not modelPos.
3137 */
3138 public CellLayout getCellLayout(int container, int screenId) {
3139 return (container == LauncherSettings.Favorites.CONTAINER_HOTSEAT)
3140 ? mHotseat : mWorkspace.getScreenWithId(screenId);
3141 }
3142
3143 @Override
3144 public StringCache getStringCache() {
Sebastian Franco6dda7c72023-11-17 18:03:00 -06003145 return mModelCallbacks.getStringCache();
Sebastian Franco8a3de212023-09-05 18:54:01 -07003146 }
3147
3148 /**
3149 * Returns target rectangle for anchoring a popup menu.
3150 */
3151 protected RectF getPopupTarget(float x, float y) {
3152 float halfSize = getResources().getDimension(R.dimen.options_menu_thumb_size) / 2;
3153 if (x < 0 || y < 0) {
3154 x = mDragLayer.getWidth() / 2;
3155 y = mDragLayer.getHeight() / 2;
3156 }
3157 return new RectF(x - halfSize, y - halfSize, x + halfSize, y + halfSize);
3158 }
3159
3160 public Stream<SystemShortcut.Factory> getSupportedShortcuts() {
3161 return Stream.of(APP_INFO, WIDGETS, INSTALL);
3162 }
3163
3164 /**
3165 * @see LauncherState#getOverviewScaleAndOffset(Launcher)
3166 */
3167 public float[] getNormalOverviewScaleAndOffset() {
3168 return new float[] {NO_SCALE, NO_OFFSET};
Brian Isganitisf54c6fa2023-07-11 12:47:08 -04003169 }
Jeremy Sim94fd07e2023-04-19 20:56:49 -07003170
3171 /**
3172 * Handles an app pair launch; overridden in
3173 * {@link com.android.launcher3.uioverrides.QuickstepLauncher}
3174 */
Jeremy Sim23fcbf22023-11-29 17:41:17 -08003175 public void launchAppPair(AppPairIcon appPairIcon) {
Jeremy Sim94fd07e2023-04-19 20:56:49 -07003176 // Overridden
3177 }
Sunny Goyal0ee66472023-08-17 16:19:22 -07003178
fbaronc0e687b2023-10-04 12:11:20 -07003179 public boolean getIsFirstPagePinnedItemEnabled() {
Sebastian Franco6dda7c72023-11-17 18:03:00 -06003180 return mModelCallbacks.getIsFirstPagePinnedItemEnabled();
fbaronc0e687b2023-10-04 12:11:20 -07003181 }
3182
Sunny Goyal0ee66472023-08-17 16:19:22 -07003183 /**
3184 * Returns the animation coordinator for playing one-off animations
3185 */
3186 public CannedAnimationCoordinator getAnimationCoordinator() {
3187 return mAnimationCoordinator;
3188 }
Sebastian Franco8a3de212023-09-05 18:54:01 -07003189
Brandon Dayauon05105162024-10-11 15:13:17 -07003190 /**
3191 * Set to force config update when set to true next time onHandleConfigurationChanged is called.
3192 */
3193 public void setForceConfigUpdate(boolean forceConfigUpdate) {
3194 mForceConfigUpdate = forceConfigUpdate;
3195 }
3196
Sebastian Franco8a3de212023-09-05 18:54:01 -07003197 @Override
3198 public View.OnLongClickListener getAllAppsItemLongClickListener() {
3199 return ItemLongClickListener.INSTANCE_ALL_APPS;
3200 }
3201
3202 @Override
3203 public StatsLogManager getStatsLogManager() {
3204 return super.getStatsLogManager().withDefaultInstanceId(mAllAppsSessionLogId);
3205 }
3206
Sunny Goyal72a74662024-02-14 12:32:59 -08003207 @Override
Sunny Goyal4e014232024-01-18 13:53:45 -08003208 public ItemInflater<Launcher> getItemInflater() {
3209 return mItemInflater;
3210 }
3211
Sebastian Franco8a3de212023-09-05 18:54:01 -07003212 /**
3213 * Returns the current popup for testing, if any.
3214 */
3215 @VisibleForTesting
3216 @Nullable
3217 public ArrowPopup<?> getOptionsPopup() {
3218 return findViewById(R.id.popup_container);
3219 }
3220
3221 // End of Getters and Setters
Anton Vayvodee382242024-05-28 21:26:25 -04003222}