blob: 9ac991f23f53a3e007452c9ae05d284d4d43ee0f [file] [log] [blame]
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001/*
2 * Copyright (C) 2008 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 * http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
Daniel Sandler325dc232013-06-05 22:57:57 -040017package com.android.launcher3;
The Android Open Source Project31dd5032009-03-03 19:32:27 -080018
Sunny Goyalcd2ac0f2022-04-14 21:21:47 -070019import static android.app.PendingIntent.FLAG_IMMUTABLE;
20import static android.app.PendingIntent.FLAG_UPDATE_CURRENT;
Sunny Goyal6c0c61a2020-12-08 19:19:56 -080021import static android.content.pm.ActivityInfo.CONFIG_UI_MODE;
Sunny Goyal8f965462020-04-23 19:00:36 -070022import static android.view.accessibility.AccessibilityEvent.TYPE_WINDOW_STATE_CHANGED;
Vinit Nayak48b28022020-04-27 20:48:49 +000023
Kateryna Ivanova71203732023-05-24 15:09:00 +000024import static com.android.app.animation.Interpolators.EMPHASIZED;
Brian Isganitisa85ae692021-09-23 19:56:24 -040025import static com.android.launcher3.AbstractFloatingView.TYPE_FOLDER;
Sunny Goyal30ac97d2020-06-24 23:47:46 -070026import static com.android.launcher3.AbstractFloatingView.TYPE_ICON_SURFACE;
Pinyao Tinga74b63a2019-07-17 23:26:06 -070027import static com.android.launcher3.AbstractFloatingView.TYPE_REBIND_SAFE;
Brian Isganitisa85ae692021-09-23 19:56:24 -040028import static com.android.launcher3.AbstractFloatingView.getTopOpenViewWithType;
Alex Chau0c4e11b2022-07-08 18:41:36 +010029import static com.android.launcher3.LauncherAnimUtils.HOTSEAT_SCALE_PROPERTY_FACTORY;
30import static com.android.launcher3.LauncherAnimUtils.SCALE_INDEX_WIDGET_TRANSITION;
Sunny Goyal4c7f2152017-10-17 17:17:16 -070031import static com.android.launcher3.LauncherAnimUtils.SPRING_LOADED_EXIT_DELAY;
Alex Chau0c4e11b2022-07-08 18:41:36 +010032import static com.android.launcher3.LauncherAnimUtils.WORKSPACE_SCALE_PROPERTY_FACTORY;
Sebastian Franco974cc942023-10-19 14:22:06 -070033import static com.android.launcher3.LauncherConstants.ActivityCodes.REQUEST_BIND_APPWIDGET;
34import static com.android.launcher3.LauncherConstants.ActivityCodes.REQUEST_BIND_PENDING_APPWIDGET;
35import static com.android.launcher3.LauncherConstants.ActivityCodes.REQUEST_CREATE_APPWIDGET;
36import static com.android.launcher3.LauncherConstants.ActivityCodes.REQUEST_CREATE_SHORTCUT;
37import static com.android.launcher3.LauncherConstants.ActivityCodes.REQUEST_PICK_APPWIDGET;
38import static com.android.launcher3.LauncherConstants.ActivityCodes.REQUEST_RECONFIGURE_APPWIDGET;
39import static com.android.launcher3.LauncherConstants.SavedInstanceKeys.RUNTIME_STATE;
40import static com.android.launcher3.LauncherConstants.SavedInstanceKeys.RUNTIME_STATE_CURRENT_SCREEN_IDS;
41import static com.android.launcher3.LauncherConstants.SavedInstanceKeys.RUNTIME_STATE_PENDING_ACTIVITY_RESULT;
42import static com.android.launcher3.LauncherConstants.SavedInstanceKeys.RUNTIME_STATE_PENDING_REQUEST_ARGS;
43import static com.android.launcher3.LauncherConstants.SavedInstanceKeys.RUNTIME_STATE_PENDING_REQUEST_CODE;
44import static com.android.launcher3.LauncherConstants.SavedInstanceKeys.RUNTIME_STATE_WIDGET_PANEL;
45import static com.android.launcher3.LauncherConstants.TraceEvents.COLD_STARTUP_TRACE_COOKIE;
46import static com.android.launcher3.LauncherConstants.TraceEvents.COLD_STARTUP_TRACE_METHOD_NAME;
47import static com.android.launcher3.LauncherConstants.TraceEvents.DISPLAY_ALL_APPS_TRACE_COOKIE;
48import static com.android.launcher3.LauncherConstants.TraceEvents.DISPLAY_ALL_APPS_TRACE_METHOD_NAME;
Sebastian Franco974cc942023-10-19 14:22:06 -070049import static com.android.launcher3.LauncherConstants.TraceEvents.DISPLAY_WORKSPACE_TRACE_COOKIE;
Sebastian Franco50b74c32023-11-16 11:36:49 -060050import static com.android.launcher3.LauncherConstants.TraceEvents.DISPLAY_WORKSPACE_TRACE_METHOD_NAME;
Sebastian Franco974cc942023-10-19 14:22:06 -070051import static com.android.launcher3.LauncherConstants.TraceEvents.ON_CREATE_EVT;
52import static com.android.launcher3.LauncherConstants.TraceEvents.ON_NEW_INTENT_EVT;
53import static com.android.launcher3.LauncherConstants.TraceEvents.ON_RESUME_EVT;
54import static com.android.launcher3.LauncherConstants.TraceEvents.ON_START_EVT;
Charlie Anderson511421c2023-10-26 11:22:26 -040055import static com.android.launcher3.LauncherPrefs.IS_FIRST_LOAD_AFTER_RESTORE;
Sunny Goyal669b71f2023-01-27 14:37:07 -080056import static com.android.launcher3.LauncherSettings.Favorites.CONTAINER_DESKTOP;
Jon Mirandac4a99bf2021-11-04 16:53:45 -070057import static com.android.launcher3.LauncherSettings.Favorites.ITEM_TYPE_APPLICATION;
Charlie Anderson511421c2023-10-26 11:22:26 -040058import static com.android.launcher3.LauncherSettings.Favorites.ITEM_TYPE_APPWIDGET;
Sunny Goyal3e3f44c2017-10-23 17:14:52 -070059import static com.android.launcher3.LauncherState.ALL_APPS;
Charlie Anderson438d4052023-04-25 14:38:57 -040060import static com.android.launcher3.LauncherState.EDIT_MODE;
Sunny Goyal8f965462020-04-23 19:00:36 -070061import static com.android.launcher3.LauncherState.FLAG_MULTI_PAGE;
62import static com.android.launcher3.LauncherState.FLAG_NON_INTERACTIVE;
Sunny Goyal3e3f44c2017-10-23 17:14:52 -070063import static com.android.launcher3.LauncherState.NORMAL;
Sunny Goyalf2393f12020-04-01 20:13:12 -070064import static com.android.launcher3.LauncherState.NO_OFFSET;
65import static com.android.launcher3.LauncherState.NO_SCALE;
Sunny Goyal8f965462020-04-23 19:00:36 -070066import static com.android.launcher3.LauncherState.SPRING_LOADED;
Sunny Goyalb1d7de22019-09-06 10:36:54 -070067import static com.android.launcher3.Utilities.postAsyncCallback;
Charlie Anderson511421c2023-10-26 11:22:26 -040068import static com.android.launcher3.backuprestore.LauncherRestoreEventLogger.RESTORE_ERROR_BIND_FAILURE;
69import static com.android.launcher3.backuprestore.LauncherRestoreEventLogger.RESTORE_ERROR_INVALID_LOCATION;
fbaronc0e687b2023-10-04 12:11:20 -070070import static com.android.launcher3.config.FeatureFlags.ENABLE_SMARTSPACE_REMOVAL;
Sebastián Franco1f4d56c2023-08-08 03:29:10 +000071import static com.android.launcher3.config.FeatureFlags.FOLDABLE_SINGLE_PAGE;
Charlie Anderson438d4052023-04-25 14:38:57 -040072import static com.android.launcher3.config.FeatureFlags.MULTI_SELECT_EDIT_MODE;
Thiru Ramasamy5fbac632022-01-28 15:05:36 -080073import static com.android.launcher3.logging.StatsLogManager.EventEnum;
Hyunyoung Song801f81f2020-06-19 02:58:53 -070074import static com.android.launcher3.logging.StatsLogManager.LAUNCHER_STATE_BACKGROUND;
Hyunyoung Song95786e02020-09-15 00:34:10 -070075import static com.android.launcher3.logging.StatsLogManager.LAUNCHER_STATE_HOME;
thiruramc96873c2021-02-11 15:13:47 -080076import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_ALLAPPS_ENTRY;
thiruram9f53d612021-02-24 10:54:01 -080077import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_ALLAPPS_ENTRY_WITH_DEVICE_SEARCH;
thiruramc96873c2021-02-11 15:13:47 -080078import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_ALLAPPS_EXIT;
Hyunyoung Song801f81f2020-06-19 02:58:53 -070079import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_ONRESUME;
80import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_ONSTOP;
Sunny Goyal82379182022-11-02 18:58:49 -070081import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_SWIPELEFT;
82import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_SWIPERIGHT;
Yogisha Dixit4ff5ee32021-05-04 14:58:34 +010083import static com.android.launcher3.logging.StatsLogManager.LauncherEvent.LAUNCHER_WIDGET_RECONFIGURED;
Fengjiang Li5a36c172023-04-13 18:18:27 +000084import static com.android.launcher3.logging.StatsLogManager.LauncherLatencyEvent.LAUNCHER_LATENCY_STARTUP_ACTIVITY_ON_CREATE;
85import static com.android.launcher3.logging.StatsLogManager.LauncherLatencyEvent.LAUNCHER_LATENCY_STARTUP_TOTAL_DURATION;
86import static com.android.launcher3.logging.StatsLogManager.LauncherLatencyEvent.LAUNCHER_LATENCY_STARTUP_VIEW_INFLATION;
Fengjiang Li5a36c172023-04-13 18:18:27 +000087import static com.android.launcher3.logging.StatsLogManager.StatsLatencyLogger.LatencyType.COLD;
88import static com.android.launcher3.logging.StatsLogManager.StatsLatencyLogger.LatencyType.COLD_DEVICE_REBOOTING;
89import static com.android.launcher3.logging.StatsLogManager.StatsLatencyLogger.LatencyType.WARM;
Sunny Goyal60e68c92020-08-12 13:59:27 -070090import static com.android.launcher3.model.ItemInstallQueue.FLAG_ACTIVITY_PAUSED;
91import static com.android.launcher3.model.ItemInstallQueue.FLAG_DRAG_AND_DROP;
fbaron30d9e3f2023-08-03 17:03:59 -070092import static com.android.launcher3.model.data.LauncherAppWidgetInfo.CUSTOM_WIDGET_ID;
Sunny Goyal3a1eadd2019-10-23 17:44:27 -070093import static com.android.launcher3.popup.SystemShortcut.APP_INFO;
Sunny Goyal3a1eadd2019-10-23 17:44:27 -070094import static com.android.launcher3.popup.SystemShortcut.INSTALL;
95import static com.android.launcher3.popup.SystemShortcut.WIDGETS;
Sunny Goyal8f965462020-04-23 19:00:36 -070096import static com.android.launcher3.states.RotationHelper.REQUEST_LOCK;
Sunny Goyalbe8c3402019-05-22 15:17:52 -070097import static com.android.launcher3.states.RotationHelper.REQUEST_NONE;
Vadim Tryshev1b058fd2023-11-28 18:26:43 -080098import static com.android.launcher3.testing.shared.TestProtocol.LAUNCHER_ACTIVITY_STOPPED_MESSAGE;
Jeremy Sim7cf0dd92023-03-24 22:39:45 -070099import static com.android.launcher3.util.Executors.MAIN_EXECUTOR;
Jon Mirandac4a99bf2021-11-04 16:53:45 -0700100import static com.android.launcher3.util.ItemInfoMatcher.forFolderMatch;
Tracy Zhoude8e25c2023-10-07 00:00:57 -0700101import static com.android.launcher3.util.SettingsCache.TOUCHPAD_NATURAL_SCROLLING;
Sunny Goyal326403e2017-10-02 12:45:10 -0700102
Gilles Debunnedd6c9922010-10-25 11:23:41 -0700103import android.animation.Animator;
Sunny Goyal6001ea22018-05-10 16:31:00 -0700104import android.animation.AnimatorListenerAdapter;
Gilles Debunnedd6c9922010-10-25 11:23:41 -0700105import android.animation.AnimatorSet;
Gilles Debunnedd6c9922010-10-25 11:23:41 -0700106import android.animation.ValueAnimator;
Adam Cohen0b395352014-06-09 22:54:36 +0000107import android.annotation.TargetApi;
Tony Wickhame78a70b2021-03-29 16:45:59 -0700108import android.app.Notification;
109import android.app.NotificationChannel;
110import android.app.NotificationManager;
111import android.app.PendingIntent;
Adam Cohen0cf2a7c2011-11-08 15:07:01 -0800112import android.appwidget.AppWidgetHostView;
Michael Jurkaaf442092010-06-10 17:01:57 -0700113import android.appwidget.AppWidgetManager;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800114import android.content.ActivityNotFoundException;
Michael Jurkae326f182011-11-21 14:05:46 -0800115import android.content.ComponentCallbacks2;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800116import android.content.Context;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800117import android.content.Intent;
Adam Cohen173f7112015-03-27 15:14:00 -0700118import android.content.IntentSender;
Winson Chung82f55532011-08-09 14:14:23 -0700119import android.content.SharedPreferences;
Sunny Goyalf8d56fc2018-01-31 15:18:11 -0800120import android.content.res.Configuration;
Adam Cohen3f9c9712014-10-31 11:48:25 -0700121import android.database.sqlite.SQLiteDatabase;
Sunny Goyal5cd1b192023-04-06 22:33:11 +0000122import android.graphics.Color;
Tony Wickham1906cc32021-02-11 11:55:24 -0800123import android.graphics.Rect;
Sunny Goyal831212e2021-05-14 14:24:09 -0700124import android.graphics.RectF;
Adam Cohen0f668f32014-09-08 19:54:17 +0200125import android.os.Build;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800126import android.os.Bundle;
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -0700127import android.os.Parcelable;
Winson Chunga2413752012-04-03 14:22:34 -0700128import android.os.StrictMode;
Riddle Hsu979da642020-09-22 21:52:40 +0800129import android.os.SystemClock;
Schneider Victor-tulias927d6dc2021-08-26 11:56:47 -0700130import android.os.Trace;
Jon Mirandac4a99bf2021-11-04 16:53:45 -0700131import android.os.UserHandle;
Michael Jurkaa33411c2012-06-14 16:18:21 -0700132import android.text.TextUtils;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800133import android.text.method.TextKeyListener;
Federico Baron7539d762022-09-29 09:47:04 -0700134import android.util.AttributeSet;
Alex Chau0c4e11b2022-07-08 18:41:36 +0100135import android.util.FloatProperty;
Joe Onorato7c312c12009-08-13 21:36:53 -0700136import android.util.Log;
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -0700137import android.util.SparseArray;
Adam Cohen96d30a12013-07-16 18:13:21 -0700138import android.view.KeyEvent;
Sunny Goyal66b24572016-09-21 15:57:55 -0700139import android.view.KeyboardShortcutGroup;
Sunny Goyal9b29ca52017-02-17 10:39:44 -0800140import android.view.LayoutInflater;
Adam Cohen96d30a12013-07-16 18:13:21 -0700141import android.view.Menu;
vadimt9af34a72020-01-21 11:19:13 -0800142import android.view.MotionEvent;
Adam Cohen96d30a12013-07-16 18:13:21 -0700143import android.view.View;
Adam Cohen96d30a12013-07-16 18:13:21 -0700144import android.view.ViewGroup;
Sunny Goyal7b8d63f2022-04-14 16:37:32 -0700145import android.view.ViewTreeObserver.OnPreDrawListener;
Schneider Victor-tulias25ecae12020-09-14 14:07:38 -0700146import android.view.WindowManager.LayoutParams;
Svetoslav Ganov815ba2d2011-01-07 14:55:17 -0800147import android.view.accessibility.AccessibilityEvent;
Sunny Goyal5a1f53b2015-05-27 10:24:24 -0700148import android.view.animation.OvershootInterpolator;
Fengjiang Lib7860bd2023-03-15 10:50:50 -0700149import android.window.BackEvent;
150import android.window.OnBackAnimationCallback;
Sunny Goyala1d1bf32015-06-26 13:24:53 -0700151
Sunny Goyal35e7d382020-05-08 13:37:58 -0700152import androidx.annotation.CallSuper;
Andras Kloczl55edfe52021-05-14 12:21:30 +0200153import androidx.annotation.NonNull;
Sunny Goyal11a50742019-08-07 09:24:26 -0700154import androidx.annotation.Nullable;
Fengjiang Lid0c23592023-04-20 16:42:25 -0700155import androidx.annotation.RequiresApi;
Pinyao Tingc9074272019-11-11 11:51:44 -0800156import androidx.annotation.StringRes;
Anushree Ganjam97434ee2023-05-18 22:03:16 +0000157import androidx.annotation.UiThread;
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700158import androidx.annotation.VisibleForTesting;
Sunny Goyal11a50742019-08-07 09:24:26 -0700159
Sunny Goyal651077b2014-06-30 14:15:31 -0700160import com.android.launcher3.DropTarget.DragObject;
Sunny Goyalae502842016-06-17 08:43:56 -0700161import com.android.launcher3.accessibility.LauncherAccessibilityDelegate;
Brian Isganitis1664c9f2022-01-14 23:15:47 -0500162import com.android.launcher3.allapps.ActivityAllAppsContainerView;
Jon Mirandaf58db152022-06-02 16:06:37 -0700163import com.android.launcher3.allapps.AllAppsRecyclerView;
Hyunyoung Song645764e2016-06-06 14:19:02 -0700164import com.android.launcher3.allapps.AllAppsTransitionController;
Sunny Goyal7ede6112017-12-05 15:11:21 -0800165import com.android.launcher3.allapps.DiscoveryBounce;
Holly Sund9d70ea2023-09-05 13:14:22 -0700166import com.android.launcher3.anim.AnimationSuccessListener;
Sunny Goyalf0b6db72018-08-13 16:10:14 -0700167import com.android.launcher3.anim.PropertyListBuilder;
Jeremy Sim94fd07e2023-04-19 20:56:49 -0700168import com.android.launcher3.apppairs.AppPairIcon;
Charlie Anderson511421c2023-10-26 11:22:26 -0400169import com.android.launcher3.backuprestore.LauncherRestoreEventLogger;
Sunny Goyal669b71f2023-01-27 14:37:07 -0800170import com.android.launcher3.celllayout.CellPosMapper;
171import com.android.launcher3.celllayout.CellPosMapper.CellPos;
Sebastian Franco09589322022-11-02 15:25:58 -0700172import com.android.launcher3.celllayout.CellPosMapper.TwoPanelCellPosMapper;
Sunny Goyal8f965462020-04-23 19:00:36 -0700173import com.android.launcher3.compat.AccessibilityManagerCompat;
Tony Wickhame0c33232016-02-08 11:37:04 -0800174import com.android.launcher3.config.FeatureFlags;
vadimt00d42552018-12-11 17:59:36 -0800175import com.android.launcher3.dot.DotInfo;
Vadim Tryshevfedca432015-08-19 17:55:02 -0700176import com.android.launcher3.dragndrop.DragController;
177import com.android.launcher3.dragndrop.DragLayer;
178import com.android.launcher3.dragndrop.DragView;
Sunny Goyal59969372021-05-06 12:11:44 -0700179import com.android.launcher3.dragndrop.LauncherDragController;
Federico Baron8bf1bca2022-09-27 16:19:11 -0700180import com.android.launcher3.folder.Folder;
Sunny Goyal11a50742019-08-07 09:24:26 -0700181import com.android.launcher3.folder.FolderGridOrganizer;
Sunny Goyal26119432016-02-18 22:09:23 +0000182import com.android.launcher3.folder.FolderIcon;
Sunny Goyalf840f102018-09-21 14:41:05 -0700183import com.android.launcher3.icons.IconCache;
Sunny Goyal3333b0c2016-05-09 20:43:21 -0700184import com.android.launcher3.keyboard.ViewGroupFocusHelper;
Hyunyoung Song801f81f2020-06-19 02:58:53 -0700185import com.android.launcher3.logger.LauncherAtom;
Thiru Ramasamy5fbac632022-01-28 15:05:36 -0800186import com.android.launcher3.logger.LauncherAtom.ContainerInfo;
187import com.android.launcher3.logger.LauncherAtom.WorkspaceContainer;
Fengjiang Lie5f91a42023-11-16 16:12:04 -0800188import com.android.launcher3.logging.ColdRebootStartupLatencyLogger;
Sunny Goyala7ce1662016-05-31 15:01:35 -0700189import com.android.launcher3.logging.FileLog;
thiruramc96873c2021-02-11 15:13:47 -0800190import com.android.launcher3.logging.InstanceId;
191import com.android.launcher3.logging.InstanceIdSequence;
Fengjiang Li5a36c172023-04-13 18:18:27 +0000192import com.android.launcher3.logging.StartupLatencyLogger;
Hyunyoung Song801f81f2020-06-19 02:58:53 -0700193import com.android.launcher3.logging.StatsLogManager;
Sebastian Franco0b461ef2023-12-08 12:20:07 -0600194import com.android.launcher3.logging.StatsLogManager.LauncherLatencyEvent;
Sunny Goyal87dcde62019-07-17 20:35:56 -0700195import com.android.launcher3.model.BgDataModel.Callbacks;
Sunny Goyal60e68c92020-08-12 13:59:27 -0700196import com.android.launcher3.model.ItemInstallQueue;
Sunny Goyala535ae42017-02-27 10:07:13 -0800197import com.android.launcher3.model.ModelWriter;
kholoud mohamedc76b2032021-12-20 16:47:38 +0000198import com.android.launcher3.model.StringCache;
Pinyao Tingbbb9a9c2021-05-11 15:42:54 -0700199import com.android.launcher3.model.WidgetsModel;
Sunny Goyale396abf2020-04-06 15:11:17 -0700200import com.android.launcher3.model.data.AppInfo;
201import com.android.launcher3.model.data.FolderInfo;
202import com.android.launcher3.model.data.ItemInfo;
203import com.android.launcher3.model.data.LauncherAppWidgetInfo;
Sunny Goyale396abf2020-04-06 15:11:17 -0700204import com.android.launcher3.model.data.WorkspaceItemInfo;
Sunny Goyala535ae42017-02-27 10:07:13 -0800205import com.android.launcher3.notification.NotificationListener;
Federico Baron7539d762022-09-29 09:47:04 -0700206import com.android.launcher3.pageindicators.WorkspacePageIndicator;
Sunny Goyale7b00122019-10-02 16:13:34 -0700207import com.android.launcher3.pm.PinRequestHelper;
Brian Isganitis149dbcb2021-11-08 18:12:38 -0500208import com.android.launcher3.popup.ArrowPopup;
Sunny Goyala535ae42017-02-27 10:07:13 -0800209import com.android.launcher3.popup.PopupDataProvider;
Sunny Goyal3a1eadd2019-10-23 17:44:27 -0700210import com.android.launcher3.popup.SystemShortcut;
Samuel Fufaca37b8a2019-08-19 17:04:36 -0700211import com.android.launcher3.qsb.QsbContainerView;
Sunny Goyal35e7d382020-05-08 13:37:58 -0700212import com.android.launcher3.statemanager.StateManager;
213import com.android.launcher3.statemanager.StateManager.StateHandler;
Sunny Goyal35e7d382020-05-08 13:37:58 -0700214import com.android.launcher3.statemanager.StatefulActivity;
Sunny Goyal623eddd2018-03-02 12:24:41 -0800215import com.android.launcher3.states.RotationHelper;
vadimt9af34a72020-01-21 11:19:13 -0800216import com.android.launcher3.testing.TestLogging;
vadimtf6ef8792022-07-26 13:54:31 -0700217import com.android.launcher3.testing.shared.TestProtocol;
Sunny Goyal210e1742019-10-17 12:05:38 -0700218import com.android.launcher3.touch.AllAppsSwipeController;
Brian Isganitisf54c6fa2023-07-11 12:47:08 -0400219import com.android.launcher3.touch.ItemLongClickListener;
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700220import com.android.launcher3.uioverrides.plugins.PluginManagerWrapper;
Sunny Goyal2100c782016-08-22 16:00:03 -0700221import com.android.launcher3.util.ActivityResultInfo;
Sunny Goyale84c5b82019-09-26 17:05:31 -0700222import com.android.launcher3.util.ActivityTracker;
Vinit Nayak65460402023-08-11 15:40:07 -0700223import com.android.launcher3.util.BackPressHandler;
Sukesh Ram3f2338a2023-08-28 18:31:54 +0000224import com.android.launcher3.util.CannedAnimationCoordinator;
Winson Chung6b1c73f2015-06-18 11:38:42 -0700225import com.android.launcher3.util.ComponentKey;
Sunny Goyalefb7e842018-10-04 15:11:00 -0700226import com.android.launcher3.util.IntArray;
Andras Kloczl55edfe52021-05-14 12:21:30 +0200227import com.android.launcher3.util.IntSet;
Sebastian Franco4080fdd2023-09-19 14:17:23 -0700228import com.android.launcher3.util.KeyboardShortcutsDelegate;
Fengjiang Li5a36c172023-04-13 18:18:27 +0000229import com.android.launcher3.util.LockedUserState;
Tony Wickham010d2552017-01-20 08:15:28 -0800230import com.android.launcher3.util.PackageUserKey;
Sunny Goyal2100c782016-08-22 16:00:03 -0700231import com.android.launcher3.util.PendingRequestArgs;
Sunny Goyal4a48a982021-06-17 15:15:46 -0700232import com.android.launcher3.util.RunnableList;
Sunny Goyala992ac92023-01-10 17:50:32 -0800233import com.android.launcher3.util.ScreenOnTracker;
234import com.android.launcher3.util.ScreenOnTracker.ScreenOnListener;
Tracy Zhoude8e25c2023-10-07 00:00:57 -0700235import com.android.launcher3.util.SettingsCache;
Sunny Goyal8392c822017-06-20 10:03:56 -0700236import com.android.launcher3.util.SystemUiController;
Mario Bertschlera6936942017-05-31 14:48:19 -0700237import com.android.launcher3.util.Themes;
Adam Cohen091440a2015-03-18 14:16:05 -0700238import com.android.launcher3.util.Thunk;
Sunny Goyal210e1742019-10-17 12:05:38 -0700239import com.android.launcher3.util.TouchController;
Sunny Goyalfca6bc92017-09-28 16:28:34 -0700240import com.android.launcher3.util.TraceHelper;
Sunny Goyal527c7d32015-08-28 15:19:36 -0700241import com.android.launcher3.util.ViewOnDrawExecutor;
Sunny Goyalab770a12018-11-14 15:17:26 -0800242import com.android.launcher3.views.ActivityContext;
Xiaowen Lei3c0f30a2023-04-12 16:59:45 -0700243import com.android.launcher3.views.ComposeInitializer;
Jon Mirandaf58db152022-06-02 16:06:37 -0700244import com.android.launcher3.views.FloatingIconView;
Sunny Goyal30ac97d2020-06-24 23:47:46 -0700245import com.android.launcher3.views.FloatingSurfaceView;
Sunny Goyal7c7be8c2018-03-07 19:58:07 -0800246import com.android.launcher3.views.OptionsPopupView;
Govinda Wassermanc06e1512019-04-09 09:56:53 -0400247import com.android.launcher3.views.ScrimView;
Sunny Goyal29947f02017-12-18 13:49:44 -0800248import com.android.launcher3.widget.LauncherAppWidgetHostView;
Yogisha Dixit741fae92021-02-22 14:03:44 +0000249import com.android.launcher3.widget.LauncherAppWidgetProviderInfo;
Sihua Ma8bbfcb62022-11-08 16:46:07 -0800250import com.android.launcher3.widget.LauncherWidgetHolder;
Sunny Goyal782f0c92017-01-19 10:27:54 -0800251import com.android.launcher3.widget.PendingAddShortcutInfo;
Hyunyoung Song3f471442015-04-08 19:01:34 -0700252import com.android.launcher3.widget.PendingAddWidgetInfo;
Sunny Goyal29947f02017-12-18 13:49:44 -0800253import com.android.launcher3.widget.PendingAppWidgetHostView;
Sunny Goyal04a324a2017-01-20 21:08:59 -0800254import com.android.launcher3.widget.WidgetAddFlowHandler;
Sunny Goyal337c81f2019-12-10 12:19:13 -0800255import com.android.launcher3.widget.WidgetManagerHelper;
Pinyao Tingc7a6c292019-08-26 14:36:02 -0700256import com.android.launcher3.widget.custom.CustomWidgetManager;
Steven Ng2f5648a2021-02-08 17:18:25 +0000257import com.android.launcher3.widget.model.WidgetsListBaseEntry;
258import com.android.launcher3.widget.picker.WidgetsFullSheet;
Sunny Goyal80a071b2021-12-27 13:30:08 +0530259import com.android.systemui.plugins.LauncherOverlayPlugin;
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700260import com.android.systemui.plugins.PluginListener;
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700261import com.android.systemui.plugins.shared.LauncherOverlayManager;
262import com.android.systemui.plugins.shared.LauncherOverlayManager.LauncherOverlay;
Ats Jenk5c25c3a2023-10-12 09:24:56 -0700263import com.android.wm.shell.Flags;
Adam Cohen6c5891a2014-07-09 23:53:15 -0700264
Adam Cohen16d7ffc2011-10-05 17:49:14 -0700265import java.io.FileDescriptor;
Adam Cohen16d7ffc2011-10-05 17:49:14 -0700266import java.io.PrintWriter;
Adam Cohenc0dcf592011-06-01 15:30:43 -0700267import java.util.ArrayList;
Winson Chungf0c6ae02012-03-21 16:10:31 -0700268import java.util.Collection;
Jon Mirandac4a99bf2021-11-04 16:53:45 -0700269import java.util.Collections;
Zak Cohen658c67a2018-10-19 14:21:05 -0700270import java.util.HashMap;
Sunny Goyal4390ace2014-10-13 11:33:11 -0700271import java.util.HashSet;
Michael Jurkad7c28052012-04-27 15:43:36 -0700272import java.util.List;
Anushree Ganjam97434ee2023-05-18 22:03:16 +0000273import java.util.Map;
Thiru Ramasamy694407c2022-03-08 12:11:24 -0800274import java.util.Optional;
Sunny Goyalaae6fbb2019-01-31 16:05:58 -0800275import java.util.function.Predicate;
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700276import java.util.function.Supplier;
Sunny Goyal3a1eadd2019-10-23 17:44:27 -0700277import java.util.stream.Stream;
Jon Mirandaf5197fc2019-09-04 16:55:41 -0700278
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800279/**
280 * Default launcher application.
281 */
Shikha Malhotra0f2e1b62022-03-27 21:02:21 +0000282public class Launcher extends StatefulActivity<LauncherState>
Sunny Goyal576f7a52023-10-06 11:28:25 -0700283 implements Callbacks, InvariantDeviceProfile.OnIDPChangeListener,
Sunny Goyal82379182022-11-02 18:58:49 -0700284 PluginListener<LauncherOverlayPlugin> {
Vadim Tryshevfedca432015-08-19 17:55:02 -0700285 public static final String TAG = "Launcher";
Sunny Goyale84c5b82019-09-26 17:05:31 -0700286
287 public static final ActivityTracker<Launcher> ACTIVITY_TRACKER = new ActivityTracker<>();
288
Sunny Goyal2bba4c32015-05-18 15:42:48 -0700289 static final boolean LOGD = false;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800290
Winson Chunga2413752012-04-03 14:22:34 -0700291 static final boolean DEBUG_STRICT_MODE = false;
Romain Guy6fefcf12009-06-11 13:07:43 -0700292
Sunny Goyal5a1f53b2015-05-27 10:24:24 -0700293 private static final float BOUNCE_ANIMATION_TENSION = 1.3f;
294
Mathew Inwood876a8462013-06-14 14:12:41 +0100295 /**
296 * IntentStarter uses request codes starting with this. This must be greater than all activity
297 * request codes used internally.
298 */
299 protected static final int REQUEST_LAST = 100;
300
Tracy Zhoucb93ec52023-03-31 22:51:17 -0700301 public static final String INTENT_ACTION_ALL_APPS_TOGGLE =
302 "launcher.intent_action_all_apps_toggle";
303
Fengjiang Li5a36c172023-04-13 18:18:27 +0000304 private static boolean sIsNewProcess = true;
305
Sunny Goyal35e7d382020-05-08 13:37:58 -0700306 private StateManager<LauncherState> mStateManager;
Patrick Dubroy6b509c12010-08-23 15:08:16 -0700307
Adam Cohenad4e15c2013-10-17 16:21:35 -0700308 private static final int ON_ACTIVITY_RESULT_ANIMATION_DELAY = 500;
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800309
Winson Chunga2413752012-04-03 14:22:34 -0700310 // How long to wait before the new-shortcut animation automatically pans the workspace
Jon Mirandaf5197fc2019-09-04 16:55:41 -0700311 @VisibleForTesting public static final int NEW_APPS_PAGE_MOVE_DELAY = 500;
Rajeev Kumar43c0f582017-06-23 15:34:55 -0700312 private static final int NEW_APPS_ANIMATION_INACTIVE_TIMEOUT_SECONDS = 5;
Jon Mirandaf5197fc2019-09-04 16:55:41 -0700313 @Thunk @VisibleForTesting public static final int NEW_APPS_ANIMATION_DELAY = 500;
Winson Chunga2413752012-04-03 14:22:34 -0700314
Alex Chau0c4e11b2022-07-08 18:41:36 +0100315 private static final FloatProperty<Workspace<?>> WORKSPACE_WIDGET_SCALE =
316 WORKSPACE_SCALE_PROPERTY_FACTORY.get(SCALE_INDEX_WIDGET_TRANSITION);
317 private static final FloatProperty<Hotseat> HOTSEAT_WIDGET_SCALE =
318 HOTSEAT_SCALE_PROPERTY_FACTORY.get(SCALE_INDEX_WIDGET_TRANSITION);
319
Ats Jenk5c25c3a2023-10-12 09:24:56 -0700320 private static final boolean ENABLE_DESKTOP_WINDOWING = Flags.enableDesktopWindowing();
Sukesh Ram3f2338a2023-08-28 18:31:54 +0000321 private static final boolean DESKTOP_MODE_SUPPORTED =
Ats Jenk8121e0d2022-12-01 11:34:43 -0800322 "1".equals(Utilities.getSystemProperty("persist.wm.debug.desktop_mode_2", "0"));
323
Sebastian Francobd7919c2023-09-19 10:55:37 -0700324 private final ModelCallbacks mModelCallbacks = createModelCallbacks();
325
326 private final KeyboardShortcutsDelegate mKeyboardShortcutsDelegate =
327 new KeyboardShortcutsDelegate(this);
328
Samuel Fufaca37b8a2019-08-19 17:04:36 -0700329 @Thunk
Shikha Malhotra0f2e1b62022-03-27 21:02:21 +0000330 Workspace<?> mWorkspace;
Samuel Fufaca37b8a2019-08-19 17:04:36 -0700331 @Thunk
332 DragLayer mDragLayer;
Sunny Goyal322d5562015-06-25 19:35:49 -0700333
Sunny Goyal337c81f2019-12-10 12:19:13 -0800334 private WidgetManagerHelper mAppWidgetManager;
Sihua Ma0593a0d2022-10-03 16:01:48 -0700335 private LauncherWidgetHolder mAppWidgetHolder;
Romain Guycbb89e42009-06-08 15:52:54 -0700336
Rajeev Kumar43c0f582017-06-23 15:34:55 -0700337 private final int[] mTmpAddItemCellCoordinates = new int[2];
Michael Jurka0280c3b2010-09-17 15:00:07 -0700338
Samuel Fufaca37b8a2019-08-19 17:04:36 -0700339 @Thunk
340 Hotseat mHotseat;
Adam Cohenf358a4b2013-07-23 16:47:31 -0700341
Sunny Goyal47328fd2016-05-25 18:56:41 -0700342 private DropTargetBar mDropTargetBar;
Hyunyoung Song3f471442015-04-08 19:01:34 -0700343
344 // Main container view for the all apps screen.
Samuel Fufaca37b8a2019-08-19 17:04:36 -0700345 @Thunk
Brian Isganitis1664c9f2022-01-14 23:15:47 -0500346 ActivityAllAppsContainerView<Launcher> mAppsView;
Hyunyoung Song645764e2016-06-06 14:19:02 -0700347 AllAppsTransitionController mAllAppsController;
Hyunyoung Song3f471442015-04-08 19:01:34 -0700348
Govinda Wassermanc06e1512019-04-09 09:56:53 -0400349 // Scrim view for the all apps and overview state.
Samuel Fufaca37b8a2019-08-19 17:04:36 -0700350 @Thunk
351 ScrimView mScrimView;
Govinda Wassermanc06e1512019-04-09 09:56:53 -0400352
Winson Chung8ae41982017-11-10 11:42:13 -0800353 // UI and state for the overview panel
Sunny Goyal7c7be8c2018-03-07 19:58:07 -0800354 private View mOverviewPanel;
Winson Chung8ae41982017-11-10 11:42:13 -0800355
Winson Chungc9bf6d42019-10-04 15:33:18 -0700356 // Used to notify when an activity launch has been deferred because launcher is not yet resumed
357 // TODO: See if we can remove this later
358 private Runnable mOnDeferredActivityLaunchCallback;
Sunny Goyal7b8d63f2022-04-14 16:37:32 -0700359 private OnPreDrawListener mOnInitialBindListener;
Michael Jurka7607c2f2013-04-03 14:33:19 -0700360
Joe Onorato9c1289c2009-08-17 11:03:03 -0400361 private LauncherModel mModel;
Sunny Goyal43bf11d2017-02-02 13:52:53 -0800362 private ModelWriter mModelWriter;
Joe Onorato0589f0f2010-02-08 13:44:00 -0800363 private IconCache mIconCache;
Sunny Goyalae502842016-06-17 08:43:56 -0700364 private LauncherAccessibilityDelegate mAccessibilityDelegate;
Joe Onorato9c1289c2009-08-17 11:03:03 -0400365
Tony Wickham010d2552017-01-20 08:15:28 -0800366 private PopupDataProvider mPopupDataProvider;
Tony Wickhambfbf7f92016-05-19 11:19:39 -0700367
Winson Chung46353de2012-02-16 14:05:10 -0800368 // We only want to get the SharedPreferences once since it does an FS stat each time we get
369 // it from the context.
370 private SharedPreferences mSharedPrefs;
371
Sunny Goyal2100c782016-08-22 16:00:03 -0700372 // Activity result which needs to be processed after workspace has loaded.
373 private ActivityResultInfo mPendingActivityResult;
374 /**
375 * Holds extra information required to handle a result from an external call, like
376 * {@link #startActivityForResult(Intent, int)} or {@link #requestPermissions(String[], int)}
377 */
378 private PendingRequestArgs mPendingRequestArgs;
Sunny Goyaldedda052019-05-14 15:23:48 -0700379 // Request id for any pending activity result
Sunny Goyal210e1742019-10-17 12:05:38 -0700380 protected int mPendingActivityRequestCode = -1;
Patrick Dubroy002cbf42011-03-03 16:36:21 -0800381
Tracy Zhou4d7b2442019-12-09 13:42:57 -0800382 private ViewGroupFocusHelper mFocusHandler;
Hyunyoung Song7fb3ccc2017-10-17 15:39:46 -0700383
Sunny Goyal623eddd2018-03-02 12:24:41 -0800384 private RotationHelper mRotationHelper;
Sunny Goyal7779d622015-06-11 16:18:39 -0700385
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700386 protected LauncherOverlayManager mOverlayManager;
Abhilasha Chahalcb329352022-05-31 15:50:53 +0000387 protected DragController mDragController;
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700388 // If true, overlay callbacks are deferred
389 private boolean mDeferOverlayCallbacks;
390 private final Runnable mDeferredOverlayCallbacks = this::checkIfOverlayStillDeferred;
391
Riddle Hsu979da642020-09-22 21:52:40 +0800392 protected long mLastTouchUpTime = -1;
Sunny Goyala306e592020-03-24 01:51:41 -0700393 private boolean mTouchInProgress;
Sunny Goyal9b180102020-03-11 10:02:29 -0700394
thiruramc96873c2021-02-11 15:13:47 -0800395 // New InstanceId is assigned to mAllAppsSessionLogId for each AllApps sessions.
396 // When Launcher is not in AllApps state mAllAppsSessionLogId will be null.
397 // User actions within AllApps state are logged with this InstanceId, to recreate AllApps
398 // session on the server side.
399 protected InstanceId mAllAppsSessionLogId;
400 private LauncherState mPrevLauncherState;
Fengjiang Li5a36c172023-04-13 18:18:27 +0000401 private StartupLatencyLogger mStartupLatencyLogger;
Sunny Goyal669b71f2023-01-27 14:37:07 -0800402 private CellPosMapper mCellPosMapper = CellPosMapper.DEFAULT;
403
Sunny Goyal0ee66472023-08-17 16:19:22 -0700404 private final CannedAnimationCoordinator mAnimationCoordinator =
405 new CannedAnimationCoordinator(this);
406
Vinit Nayak65460402023-08-11 15:40:07 -0700407 private final List<BackPressHandler> mBackPressedHandlers = new ArrayList<>();
Mark Fashehf547a7f62023-09-11 23:57:41 +0000408 private boolean mIsColdStartupAfterReboot;
Vinit Nayak65460402023-08-11 15:40:07 -0700409
Tracy Zhoude8e25c2023-10-07 00:00:57 -0700410 private boolean mIsNaturalScrollingEnabled;
411
412 private final SettingsCache.OnChangeListener mNaturalScrollingChangedListener =
413 enabled -> mIsNaturalScrollingEnabled = enabled;
414
Sebastian Franco8a3de212023-09-05 18:54:01 -0700415 public static Launcher getLauncher(Context context) {
416 return fromContext(context);
417 }
418
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800419 @Override
Schneider Victor-tulias927d6dc2021-08-26 11:56:47 -0700420 @TargetApi(Build.VERSION_CODES.S)
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800421 protected void onCreate(Bundle savedInstanceState) {
Fengjiang Li5a36c172023-04-13 18:18:27 +0000422 mStartupLatencyLogger = createStartupLatencyLogger(
423 sIsNewProcess
424 ? LockedUserState.get(this).isUserUnlockedAtLauncherStartup()
425 ? COLD
426 : COLD_DEVICE_REBOOTING
427 : WARM);
Mark Fashehf547a7f62023-09-11 23:57:41 +0000428
429 mIsColdStartupAfterReboot = sIsNewProcess
430 && !LockedUserState.get(this).isUserUnlockedAtLauncherStartup();
431 if (mIsColdStartupAfterReboot) {
432 Trace.beginAsyncSection(
433 COLD_STARTUP_TRACE_METHOD_NAME, COLD_STARTUP_TRACE_COOKIE);
434 }
435
Fengjiang Li5a36c172023-04-13 18:18:27 +0000436 sIsNewProcess = false;
437 mStartupLatencyLogger
438 .logStart(LAUNCHER_LATENCY_STARTUP_TOTAL_DURATION)
439 .logStart(LAUNCHER_LATENCY_STARTUP_ACTIVITY_ON_CREATE);
Schneider Victor-tulias927d6dc2021-08-26 11:56:47 -0700440 // Only use a hard-coded cookie since we only want to trace this once.
441 if (Utilities.ATLEAST_S) {
442 Trace.beginAsyncSection(
443 DISPLAY_WORKSPACE_TRACE_METHOD_NAME, DISPLAY_WORKSPACE_TRACE_COOKIE);
444 Trace.beginAsyncSection(DISPLAY_ALL_APPS_TRACE_METHOD_NAME,
445 DISPLAY_ALL_APPS_TRACE_COOKIE);
446 }
Sunny Goyal67736672023-06-02 13:35:19 +0000447 TraceHelper.INSTANCE.beginSection(ON_CREATE_EVT);
Winson Chunga2413752012-04-03 14:22:34 -0700448 if (DEBUG_STRICT_MODE) {
449 StrictMode.setThreadPolicy(new StrictMode.ThreadPolicy.Builder()
450 .detectDiskReads()
451 .detectDiskWrites()
452 .detectNetwork() // or .detectAll() for all detectable problems
453 .penaltyLog()
454 .build());
455 StrictMode.setVmPolicy(new StrictMode.VmPolicy.Builder()
456 .detectLeakedSqlLiteObjects()
457 .detectLeakedClosableObjects()
458 .penaltyLog()
459 .penaltyDeath()
460 .build());
461 }
462
Tony Wickhame78a70b2021-03-29 16:45:59 -0700463 if (Utilities.IS_DEBUG_DEVICE && FeatureFlags.NOTIFY_CRASHES.get()) {
464 final String notificationChannelId = "com.android.launcher3.Debug";
465 final String notificationChannelName = "Debug";
466 final String notificationTag = "Debug";
467 final int notificationId = 0;
468
469 NotificationManager notificationManager = getSystemService(NotificationManager.class);
470 notificationManager.createNotificationChannel(new NotificationChannel(
471 notificationChannelId, notificationChannelName,
472 NotificationManager.IMPORTANCE_HIGH));
473
474 Thread.currentThread().setUncaughtExceptionHandler((thread, throwable) -> {
475 String stackTrace = Log.getStackTraceString(throwable);
476
477 Intent shareIntent = new Intent(Intent.ACTION_SEND);
478 shareIntent.setType("text/plain");
479 shareIntent.putExtra(Intent.EXTRA_TEXT, stackTrace);
480 shareIntent = Intent.createChooser(shareIntent, null);
481 PendingIntent sharePendingIntent = PendingIntent.getActivity(
Sunny Goyalcd2ac0f2022-04-14 21:21:47 -0700482 this, 0, shareIntent, FLAG_UPDATE_CURRENT | FLAG_IMMUTABLE);
Tony Wickhame78a70b2021-03-29 16:45:59 -0700483
484 Notification notification = new Notification.Builder(this, notificationChannelId)
485 .setSmallIcon(android.R.drawable.ic_menu_close_clear_cancel)
486 .setContentTitle("Launcher crash detected!")
487 .setStyle(new Notification.BigTextStyle().bigText(stackTrace))
488 .addAction(android.R.drawable.ic_menu_share, "Share", sharePendingIntent)
489 .build();
490 notificationManager.notify(notificationTag, notificationId, notification);
491
492 Thread.UncaughtExceptionHandler defaultUncaughtExceptionHandler =
493 Thread.getDefaultUncaughtExceptionHandler();
494 if (defaultUncaughtExceptionHandler != null) {
495 defaultUncaughtExceptionHandler.uncaughtException(thread, throwable);
496 }
497 });
498 }
499
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800500 super.onCreate(savedInstanceState);
Daniel Sandlere060b0b2013-06-27 21:47:55 -0400501
Sunny Goyal87f784c2017-01-11 10:48:34 -0800502 LauncherAppState app = LauncherAppState.getInstance(this);
Sunny Goyala7a5bf32020-01-05 15:35:29 +0530503 mModel = app.getModel();
Sunny Goyal9d89f752020-06-19 11:09:24 -0700504
Sunny Goyal41d51a02019-05-14 09:44:34 -0700505 mRotationHelper = new RotationHelper(this);
Hyunyoung Song31971a32019-01-27 12:31:12 -0800506 InvariantDeviceProfile idp = app.getInvariantDeviceProfile();
507 initDeviceProfile(idp);
508 idp.addOnChangeListener(this);
Stefan Andonian146701c2022-11-10 23:07:40 +0000509 mSharedPrefs = LauncherPrefs.getPrefs(this);
Joe Onorato0589f0f2010-02-08 13:44:00 -0800510 mIconCache = app.getIconCache();
Sunny Goyal384b5782021-02-09 22:50:02 -0800511 mAccessibilityDelegate = createAccessibilityDelegate();
Adam Cohen2e6da152015-05-06 11:42:25 -0700512
Abhilasha Chahalcb329352022-05-31 15:50:53 +0000513 initDragController();
Hyunyoung Song645764e2016-06-06 14:19:02 -0700514 mAllAppsController = new AllAppsTransitionController(this);
Sunny Goyal35e7d382020-05-08 13:37:58 -0700515 mStateManager = new StateManager<>(this, NORMAL);
Romain Guycbb89e42009-06-08 15:52:54 -0700516
Schneider Victor-tuliasfb2affa2023-05-26 15:09:41 -0700517 setupViews();
Johannes Gallmann9e913352024-01-11 13:20:01 +0100518 updateDisallowBack();
Schneider Victor-tuliasfb2affa2023-05-26 15:09:41 -0700519
Sunny Goyal337c81f2019-12-10 12:19:13 -0800520 mAppWidgetManager = new WidgetManagerHelper(this);
Sihua Ma0593a0d2022-10-03 16:01:48 -0700521 mAppWidgetHolder = createAppWidgetHolder();
522 mAppWidgetHolder.startListening();
Sunny Goyaleb293132023-11-17 12:23:40 -0800523 mAppWidgetHolder.addProviderChangeListener(() -> refreshAndBindWidgetsForPackageUser(null));
Romain Guycbb89e42009-06-08 15:52:54 -0700524
Sunny Goyal9c2b9602020-01-07 13:07:55 -0800525 mPopupDataProvider = new PopupDataProvider(this::updateNotificationDots);
Tony Wickham010d2552017-01-20 08:15:28 -0800526
Sunny Goyale84c5b82019-09-26 17:05:31 -0700527 boolean internalStateHandled = ACTIVITY_TRACKER.handleCreate(this);
Sunny Goyald3864fa2017-11-14 15:06:36 -0800528 if (internalStateHandled) {
Sunny Goyald3864fa2017-11-14 15:06:36 -0800529 if (savedInstanceState != null) {
530 // InternalStateHandler has already set the appropriate state.
531 // We dont need to do anything.
532 savedInstanceState.remove(RUNTIME_STATE);
533 }
534 }
535 restoreState(savedInstanceState);
Sunny Goyalbbece862019-03-01 13:13:52 -0800536 mStateManager.reapplyState();
Winson Chungb63b44c2017-11-10 17:54:44 -0800537
Sunny Goyalfe770c92016-09-27 14:38:58 -0700538 if (savedInstanceState != null) {
Sunny Goyal12e3f1f2021-07-15 14:31:58 -0700539 int[] pageIds = savedInstanceState.getIntArray(RUNTIME_STATE_CURRENT_SCREEN_IDS);
540 if (pageIds != null) {
Sebastian Franco69fd7422023-10-06 16:48:58 -0700541 mModelCallbacks.setPagesToBindSynchronously(IntSet.wrap(pageIds));
Sunny Goyal12e3f1f2021-07-15 14:31:58 -0700542 }
Sunny Goyalfe770c92016-09-27 14:38:58 -0700543 }
Sunny Goyald3864fa2017-11-14 15:06:36 -0800544
Fengjiang Li5a36c172023-04-13 18:18:27 +0000545 mStartupLatencyLogger.logWorkspaceLoadStartTime();
Sunny Goyala7a5bf32020-01-05 15:35:29 +0530546 if (!mModel.addCallbacksAndLoad(this)) {
Sunny Goyald3864fa2017-11-14 15:06:36 -0800547 if (!internalStateHandled) {
Sunny Goyal7b8d63f2022-04-14 16:37:32 -0700548 // If we are not binding synchronously, pause drawing until initial bind complete,
549 // so that the system could continue to show the device loading prompt
550 mOnInitialBindListener = Boolean.FALSE::booleanValue;
Sunny Goyald3864fa2017-11-14 15:06:36 -0800551 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800552 }
553
554 // For handling default keys
Sunny Goyalf4aceab2017-12-06 16:16:31 -0800555 setDefaultKeyMode(DEFAULT_KEYS_SEARCH_LOCAL);
Joe Onorato34a0e1b2009-12-14 17:44:51 -0800556
Sunny Goyal9d89f752020-06-19 11:09:24 -0700557 setContentView(getRootView());
Xiaowen Lei3c0f30a2023-04-12 16:59:45 -0700558 ComposeInitializer.initCompose(this);
559
Sunny Goyal7b8d63f2022-04-14 16:37:32 -0700560 if (mOnInitialBindListener != null) {
561 getRootView().getViewTreeObserver().addOnPreDrawListener(mOnInitialBindListener);
562 }
Sunny Goyalf8d56fc2018-01-31 15:18:11 -0800563 getRootView().dispatchInsets();
Mario Bertschlera6936942017-05-31 14:48:19 -0700564
Tracy Zhoude8e25c2023-10-07 00:00:57 -0700565 final SettingsCache settingsCache = SettingsCache.INSTANCE.get(this);
566 settingsCache.register(TOUCHPAD_NATURAL_SCROLLING, mNaturalScrollingChangedListener);
567 mIsNaturalScrollingEnabled = settingsCache.getValue(TOUCHPAD_NATURAL_SCROLLING);
568
Sunny Goyala992ac92023-01-10 17:50:32 -0800569 // Listen for screen turning off
570 ScreenOnTracker.INSTANCE.get(this).addListener(mScreenOnListener);
Sunny Goyal8392c822017-06-20 10:03:56 -0700571 getSystemUiController().updateUiState(SystemUiController.UI_STATE_BASE_WINDOW,
572 Themes.getAttrBoolean(this, R.attr.isWorkspaceDarkText));
Sunny Goyal14b32402017-07-31 10:03:28 -0700573
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700574 mOverlayManager = getDefaultOverlay();
575 PluginManagerWrapper.INSTANCE.get(this).addPluginListener(this,
Sunny Goyal80a071b2021-12-27 13:30:08 +0530576 LauncherOverlayPlugin.class, false /* allowedMultiple */);
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700577
Sunny Goyal623eddd2018-03-02 12:24:41 -0800578 mRotationHelper.initialize();
Sunny Goyal67736672023-06-02 13:35:19 +0000579 TraceHelper.INSTANCE.endSection();
Samuel Fufa41d909f2020-03-20 16:27:09 -0700580
Schneider Victor-tulias8a35c762020-09-03 14:30:10 -0700581 if (Utilities.ATLEAST_R) {
Schneider Victor-tulias25ecae12020-09-14 14:07:38 -0700582 getWindow().setSoftInputMode(LayoutParams.SOFT_INPUT_ADJUST_NOTHING);
Schneider Victor-tulias8a35c762020-09-03 14:30:10 -0700583 }
Stefan Andonian45fc3012022-05-05 22:48:09 +0000584 setTitle(R.string.home_screen);
Fengjiang Li5a36c172023-04-13 18:18:27 +0000585 mStartupLatencyLogger.logEnd(LAUNCHER_LATENCY_STARTUP_ACTIVITY_ON_CREATE);
586 }
587
Sebastian Francobd7919c2023-09-19 10:55:37 -0700588 protected ModelCallbacks createModelCallbacks() {
589 return new ModelCallbacks(this);
590 }
591
Fengjiang Li5a36c172023-04-13 18:18:27 +0000592 /**
Fengjiang Lie5f91a42023-11-16 16:12:04 -0800593 * We only log startup latency in {@link COLD_DEVICE_REBOOTING} type. For other latency types,
594 * create a no op implementation.
595 */
596 private StartupLatencyLogger createStartupLatencyLogger(
597 StatsLogManager.StatsLatencyLogger.LatencyType latencyType) {
598 if (latencyType == COLD_DEVICE_REBOOTING) {
599 return createColdRebootStartupLatencyLogger();
600 }
601 return StartupLatencyLogger.Companion.getNO_OP();
602 }
603
604 /**
605 * Create {@link ColdRebootStartupLatencyLogger} that only collects launcher startup latency
606 * metrics without sending them anywhere. Child class can override this method to create logger
Fengjiang Li5a36c172023-04-13 18:18:27 +0000607 * that overrides {@link StartupLatencyLogger#log()} to report those metrics.
608 */
Fengjiang Lie5f91a42023-11-16 16:12:04 -0800609 protected ColdRebootStartupLatencyLogger createColdRebootStartupLatencyLogger() {
610 return new ColdRebootStartupLatencyLogger();
Adam Cohen9211d422014-10-07 18:14:53 -0700611 }
612
Fengjiang Li6bb8d792023-01-12 16:20:58 -0800613 /**
Fengjiang Lib7860bd2023-03-15 10:50:50 -0700614 * Provide {@link OnBackAnimationCallback} in below order:
Fengjiang Li6bb8d792023-01-12 16:20:58 -0800615 * <ol>
616 * <li> auto cancel action mode handler
617 * <li> drag handler
618 * <li> view handler
Vinit Nayak65460402023-08-11 15:40:07 -0700619 * <li> registered {@link BackPressHandler}
Fengjiang Li6bb8d792023-01-12 16:20:58 -0800620 * <li> state handler
621 * </ol>
622 *
623 * A back gesture (a single click on back button, or a swipe back gesture that contains a series
624 * of swipe events) should be handled by the same handler from above list. For a new back
625 * gesture, a new handler should be regenerated.
626 *
627 * Note that state handler will always be handling the back press event if the previous 3 don't.
628 */
629 @NonNull
Fengjiang Lid0c23592023-04-20 16:42:25 -0700630 @RequiresApi(Build.VERSION_CODES.UPSIDE_DOWN_CAKE)
Fengjiang Lib7860bd2023-03-15 10:50:50 -0700631 protected OnBackAnimationCallback getOnBackAnimationCallback() {
Fengjiang Li6bb8d792023-01-12 16:20:58 -0800632 // #1 auto cancel action mode handler
633 if (isInAutoCancelActionMode()) {
634 return this::finishAutoCancelActionMode;
635 }
636
637 // #2 drag handler
638 if (mDragController.isDragging()) {
639 return mDragController::cancelDrag;
640 }
641
642 // #3 view handler
643 AbstractFloatingView topView =
644 AbstractFloatingView.getTopOpenView(Launcher.this);
645 if (topView != null && topView.canHandleBack()) {
646 return topView;
647 }
648
Vinit Nayak65460402023-08-11 15:40:07 -0700649 // #4 Custom back handlers
650 for (BackPressHandler handler : mBackPressedHandlers) {
651 if (handler.canHandleBack()) {
652 return handler;
653 }
654 }
655
656 // #5 state handler
Fengjiang Lib7860bd2023-03-15 10:50:50 -0700657 return new OnBackAnimationCallback() {
Fengjiang Li6bb8d792023-01-12 16:20:58 -0800658 @Override
659 public void onBackInvoked() {
660 onStateBack();
661 }
662
663 @Override
Fengjiang Lib7860bd2023-03-15 10:50:50 -0700664 public void onBackProgressed(@NonNull BackEvent backEvent) {
Fengjiang Li6bb8d792023-01-12 16:20:58 -0800665 mStateManager.getState().onBackProgressed(
Fengjiang Lib7860bd2023-03-15 10:50:50 -0700666 Launcher.this, backEvent.getProgress());
Fengjiang Li6bb8d792023-01-12 16:20:58 -0800667 }
668
669 @Override
670 public void onBackCancelled() {
671 mStateManager.getState().onBackCancelled(Launcher.this);
672 }
673 };
674 }
675
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700676 protected LauncherOverlayManager getDefaultOverlay() {
677 return new LauncherOverlayManager() { };
678 }
679
680 @Override
Sunny Goyal80a071b2021-12-27 13:30:08 +0530681 public void onPluginConnected(LauncherOverlayPlugin overlayManager, Context context) {
Sunny Goyal576f7a52023-10-06 11:28:25 -0700682 switchOverlay(() -> overlayManager.createOverlayManager(this));
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700683 }
684
685 @Override
Sunny Goyal80a071b2021-12-27 13:30:08 +0530686 public void onPluginDisconnected(LauncherOverlayPlugin plugin) {
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700687 switchOverlay(this::getDefaultOverlay);
688 }
689
690 private void switchOverlay(Supplier<LauncherOverlayManager> overlaySupplier) {
691 if (mOverlayManager != null) {
Sunny Goyale82a20a2023-10-19 13:52:49 -0700692 mOverlayManager.onActivityDestroyed();
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700693 }
694 mOverlayManager = overlaySupplier.get();
695 if (getRootView().isAttachedToWindow()) {
696 mOverlayManager.onAttachedToWindow();
697 }
698 mDeferOverlayCallbacks = true;
699 checkIfOverlayStillDeferred();
700 }
701
702 @Override
Brian Isganitis099945b2022-01-31 18:15:00 -0500703 public void dispatchDeviceProfileChanged() {
Sunny Goyalb1d7de22019-09-06 10:36:54 -0700704 super.dispatchDeviceProfileChanged();
705 mOverlayManager.onDeviceProvideChanged();
706 }
707
Sunny Goyal7779d622015-06-11 16:18:39 -0700708 @Override
Winson Chung8eb49e02018-07-16 13:33:31 -0700709 public void onEnterAnimationComplete() {
710 super.onEnterAnimationComplete();
Sunny Goyalbe8c3402019-05-22 15:17:52 -0700711 mRotationHelper.setCurrentTransitionRequest(REQUEST_NONE);
Sunny Goyal5c20fdd2022-04-05 20:58:03 -0700712 // Starting with Android S, onEnterAnimationComplete is sent immediately
713 // causing the surface to get removed before the animation completed (b/175345344).
714 // Instead we rely on next user touch event to remove the view and optionally a callback
715 // from system from Android T onwards.
716 if (!Utilities.ATLEAST_S) {
717 AbstractFloatingView.closeOpenViews(this, false, TYPE_ICON_SURFACE);
718 }
Winson Chung8eb49e02018-07-16 13:33:31 -0700719 }
720
721 @Override
Jerry Chang09b40242021-08-27 13:29:01 +0800722 public void onMultiWindowModeChanged(boolean isInMultiWindowMode, Configuration newConfig) {
723 super.onMultiWindowModeChanged(isInMultiWindowMode, newConfig);
724 // Always update device profile when multi window mode changed.
725 initDeviceProfile(mDeviceProfile.inv);
726 dispatchDeviceProfileChanged();
727 }
728
Abhilasha Chahalcb329352022-05-31 15:50:53 +0000729 /**
730 * Initializes the drag controller.
731 */
732 protected void initDragController() {
733 mDragController = new LauncherDragController(this);
734 }
735
Sunny Goyal605bcf32018-03-02 15:16:12 -0800736 @Override
Sunny Goyal6e6f7992021-08-24 16:23:29 -0700737 public void onIdpChanged(boolean modelPropertiesChanged) {
Alex Chau360ec032022-08-10 16:11:42 +0100738 onHandleConfigurationChanged();
739 }
740
741 @Override
742 protected void onHandleConfigurationChanged() {
Nicolo' Mazzucatoe120fcf2023-08-04 15:33:15 +0000743 Trace.beginSection("Launcher#onHandleconfigurationChanged");
744 try {
745 if (!initDeviceProfile(mDeviceProfile.inv)) {
746 return;
747 }
748
749 dispatchDeviceProfileChanged();
750 reapplyUi();
751 mDragLayer.recreateControllers();
752
753 // Calling onSaveInstanceState ensures that static cache used by listWidgets is
754 // initialized properly.
755 onSaveInstanceState(new Bundle());
756 mModel.rebindCallbacks();
757 } finally {
758 Trace.endSection();
Alex Chau6209af62022-07-27 14:08:23 +0100759 }
Hyunyoung Song31971a32019-01-27 12:31:12 -0800760 }
761
Govinda Wassermanc06e1512019-04-09 09:56:53 -0400762 public void onAssistantVisibilityChanged(float visibility) {
Sunny Goyal0b5b8d42021-03-31 14:56:47 -0700763 mHotseat.getQsb().setAlpha(1f - visibility);
Govinda Wassermanc06e1512019-04-09 09:56:53 -0400764 }
765
Bill Lina1221bc2021-06-03 01:49:27 +0800766 /**
Alex Chau6209af62022-07-27 14:08:23 +0100767 * Returns {@code true} if a new DeviceProfile is initialized, and {@code false} otherwise.
768 */
769 protected boolean initDeviceProfile(InvariantDeviceProfile idp) {
Sunny Goyalf8d56fc2018-01-31 15:18:11 -0800770 // Load configuration-specific DeviceProfile
Alex Chau6209af62022-07-27 14:08:23 +0100771 DeviceProfile deviceProfile = idp.getDeviceProfile(this);
772 if (mDeviceProfile == deviceProfile) {
773 return false;
774 }
775
776 mDeviceProfile = deviceProfile;
Jerry Changbfac46a2021-09-08 08:20:58 +0800777 if (isInMultiWindowMode()) {
778 mDeviceProfile = mDeviceProfile.getMultiWindowProfile(
779 this, getMultiWindowDisplaySize());
780 }
Sunny Goyalae6e3182019-04-30 12:04:37 -0700781
Sunny Goyal59d086c2018-05-07 17:31:40 -0700782 onDeviceProfileInitiated();
Sebastián Franco1f4d56c2023-08-08 03:29:10 +0000783 if (FOLDABLE_SINGLE_PAGE.get() && mDeviceProfile.isTwoPanels) {
Sebastian Franco09589322022-11-02 15:25:58 -0700784 mCellPosMapper = new TwoPanelCellPosMapper(mDeviceProfile.inv.numColumns);
785 } else {
Sebastian Franco2d023e22023-11-15 16:48:34 -0600786 mCellPosMapper = new CellPosMapper(mDeviceProfile.isVerticalBarLayout(),
787 mDeviceProfile.numShownHotseatIcons);
Sebastian Franco09589322022-11-02 15:25:58 -0700788 }
Sebastian Franco2d023e22023-11-15 16:48:34 -0600789 mModelWriter = mModel.getWriter(true, mCellPosMapper, this);
Alex Chau6209af62022-07-27 14:08:23 +0100790 return true;
Sunny Goyalf8d56fc2018-01-31 15:18:11 -0800791 }
792
Sunny Goyal0b0847b2018-03-14 12:30:11 -0700793 @Override
794 public void invalidateParent(ItemInfo info) {
Jon Mirandae6f3fa42019-03-04 09:14:40 -0800795 if (info.container >= 0) {
Sunny Goyal0b0847b2018-03-14 12:30:11 -0700796 View folderIcon = getWorkspace().getHomescreenIconByItemId(info.container);
Jon Mirandae6f3fa42019-03-04 09:14:40 -0800797 if (folderIcon instanceof FolderIcon && folderIcon.getTag() instanceof FolderInfo) {
Thales Lima1faa4ed2023-12-01 16:48:19 +0000798 if (new FolderGridOrganizer(getDeviceProfile())
Sunny Goyal11a50742019-08-07 09:24:26 -0700799 .setFolderInfo((FolderInfo) folderIcon.getTag())
800 .isItemInPreview(info.rank)) {
Jon Mirandae6f3fa42019-03-04 09:14:40 -0800801 folderIcon.invalidate();
802 }
Sunny Goyal0b0847b2018-03-14 12:30:11 -0700803 }
804 }
805 }
806
Adam Cohenc76e1dd2013-11-14 11:09:14 +0000807 /**
Winson Chung557d6ed2011-07-08 15:34:52 -0700808 * Returns whether we should delay spring loaded mode -- for shortcuts and widgets that have
809 * a configuration step, this allows the proper animations to run after other transitions.
810 */
Sunny Goyalefb7e842018-10-04 15:11:00 -0700811 private int completeAdd(
Sunny Goyal2100c782016-08-22 16:00:03 -0700812 int requestCode, Intent intent, int appWidgetId, PendingRequestArgs info) {
Sunny Goyal669b71f2023-01-27 14:37:07 -0800813 CellPos cellPos = getCellPosMapper().mapModelToPresenter(info);
814 int screenId = cellPos.screenId;
815 if (info.container == CONTAINER_DESKTOP) {
Adam Cohen83079e42014-09-19 17:43:08 -0700816 // When the screen id represents an actual screen (as opposed to a rank) we make sure
817 // that the drop page actually exists.
Sunny Goyal669b71f2023-01-27 14:37:07 -0800818 screenId = ensurePendingDropLayoutExists(cellPos.screenId);
Adam Cohen83079e42014-09-19 17:43:08 -0700819 }
Adam Cohendb364c32014-05-20 14:23:40 -0700820
Sunny Goyal2100c782016-08-22 16:00:03 -0700821 switch (requestCode) {
Patrick Dubroy002cbf42011-03-03 16:36:21 -0800822 case REQUEST_CREATE_SHORTCUT:
Sunny Goyal669b71f2023-01-27 14:37:07 -0800823 completeAddShortcut(intent, info.container, screenId,
824 cellPos.cellX, cellPos.cellY, info);
Pinyao Tingc9074272019-11-11 11:51:44 -0800825 announceForAccessibility(R.string.item_added_to_workspace);
Winson Chungb8472bb2011-08-05 13:49:21 -0700826 break;
Patrick Dubroy002cbf42011-03-03 16:36:21 -0800827 case REQUEST_CREATE_APPWIDGET:
Sunny Goyal2100c782016-08-22 16:00:03 -0700828 completeAddAppWidget(appWidgetId, info, null, null);
Winson Chungb8472bb2011-08-05 13:49:21 -0700829 break;
Sunny Goyalff572272014-07-23 13:58:07 -0700830 case REQUEST_RECONFIGURE_APPWIDGET:
Sunny Goyal977838b2022-06-27 13:15:41 -0700831 getStatsLogManager().logger().withItemInfo(info).log(LAUNCHER_WIDGET_RECONFIGURED);
Sunny Goyal2100c782016-08-22 16:00:03 -0700832 completeRestoreAppWidget(appWidgetId, LauncherAppWidgetInfo.RESTORE_COMPLETED);
Sunny Goyalff572272014-07-23 13:58:07 -0700833 break;
Sunny Goyald478c832016-04-01 12:04:16 -0700834 case REQUEST_BIND_PENDING_APPWIDGET: {
Sunny Goyal2100c782016-08-22 16:00:03 -0700835 int widgetId = appWidgetId;
836 LauncherAppWidgetInfo widgetInfo =
Sunny Goyald478c832016-04-01 12:04:16 -0700837 completeRestoreAppWidget(widgetId, LauncherAppWidgetInfo.FLAG_UI_NOT_READY);
Sunny Goyal2100c782016-08-22 16:00:03 -0700838 if (widgetInfo != null) {
Sunny Goyald478c832016-04-01 12:04:16 -0700839 // Since the view was just bound, also launch the configure activity if needed
840 LauncherAppWidgetProviderInfo provider = mAppWidgetManager
fbaron30d9e3f2023-08-03 17:03:59 -0700841 .getLauncherAppWidgetInfo(widgetId, info.getTargetComponent());
Sunny Goyal04a324a2017-01-20 21:08:59 -0800842 if (provider != null) {
843 new WidgetAddFlowHandler(provider)
Samuel Fufaca37b8a2019-08-19 17:04:36 -0700844 .startConfigActivity(this, widgetInfo,
845 REQUEST_RECONFIGURE_APPWIDGET);
Sunny Goyald478c832016-04-01 12:04:16 -0700846 }
847 }
848 break;
849 }
Patrick Dubroy002cbf42011-03-03 16:36:21 -0800850 }
Adam Cohendb364c32014-05-20 14:23:40 -0700851 return screenId;
Patrick Dubroy002cbf42011-03-03 16:36:21 -0800852 }
853
Sebastian Franco6196b902023-12-06 11:39:52 -0600854 /**
855 * Process any pending activity result if it was put on hold for any reason like item binding.
856 */
857 public void processActivityResult() {
858 if (mPendingActivityResult != null) {
859 handleActivityResult(mPendingActivityResult.requestCode,
860 mPendingActivityResult.resultCode, mPendingActivityResult.data);
861 mPendingActivityResult = null;
862 }
863 }
864
Adam Cohenc7cd2cb2014-11-17 17:45:34 -0800865 private void handleActivityResult(
Michael Jurka8b805b12012-04-18 14:23:14 -0700866 final int requestCode, final int resultCode, final Intent data) {
Sunny Goyal2100c782016-08-22 16:00:03 -0700867 if (isWorkspaceLoading()) {
868 // process the result once the workspace has loaded.
869 mPendingActivityResult = new ActivityResultInfo(requestCode, resultCode, data);
870 return;
871 }
872 mPendingActivityResult = null;
873
Winson Chunge341d302013-08-16 14:31:00 -0700874 // Reset the startActivity waiting flag
Sunny Goyal2100c782016-08-22 16:00:03 -0700875 final PendingRequestArgs requestArgs = mPendingRequestArgs;
876 setWaitingForResult(null);
877 if (requestArgs == null) {
878 return;
879 }
880
881 final int pendingAddWidgetId = requestArgs.getWidgetId();
Winson Chunge341d302013-08-16 14:31:00 -0700882
Charlie Anderson438d4052023-04-25 14:38:57 -0400883 Runnable exitSpringLoaded = MULTI_SELECT_EDIT_MODE.get() ? null
884 : () -> mStateManager.goToState(NORMAL, SPRING_LOADED_EXIT_DELAY);
Adam Cohenad4e15c2013-10-17 16:21:35 -0700885
Michael Jurka8b805b12012-04-18 14:23:14 -0700886 if (requestCode == REQUEST_BIND_APPWIDGET) {
Winsona1f79d32015-08-05 14:00:45 -0700887 // This is called only if the user did not previously have permissions to bind widgets
Adam Cohenad4e15c2013-10-17 16:21:35 -0700888 final int appWidgetId = data != null ?
Michael Jurka8b805b12012-04-18 14:23:14 -0700889 data.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, -1) : -1;
890 if (resultCode == RESULT_CANCELED) {
Sunny Goyal2100c782016-08-22 16:00:03 -0700891 completeTwoStageWidgetDrop(RESULT_CANCELED, appWidgetId, requestArgs);
Sunny Goyal6e379fc2020-03-19 16:08:14 -0700892 mWorkspace.removeExtraEmptyScreenDelayed(
893 ON_ACTIVITY_RESULT_ANIMATION_DELAY, false, exitSpringLoaded);
Michael Jurka8b805b12012-04-18 14:23:14 -0700894 } else if (resultCode == RESULT_OK) {
Sunny Goyal2100c782016-08-22 16:00:03 -0700895 addAppWidgetImpl(
896 appWidgetId, requestArgs, null,
Sunny Goyal04a324a2017-01-20 21:08:59 -0800897 requestArgs.getWidgetHandler(),
Sunny Goyal2100c782016-08-22 16:00:03 -0700898 ON_ACTIVITY_RESULT_ANIMATION_DELAY);
Michael Jurka8b805b12012-04-18 14:23:14 -0700899 }
900 return;
901 }
Michael Jurka336fd4f2013-09-12 00:05:02 +0200902
Adam Cohened66b2b2012-01-23 17:28:51 -0800903 boolean isWidgetDrop = (requestCode == REQUEST_PICK_APPWIDGET ||
Sunny Goyal5c97f512015-05-19 16:03:28 -0700904 requestCode == REQUEST_CREATE_APPWIDGET);
Romain Guyaad5ef42009-06-10 02:48:37 -0700905
Adam Cohened66b2b2012-01-23 17:28:51 -0800906 // We have special handling for widgets
907 if (isWidgetDrop) {
Adam Cohen4637b5a2013-11-04 18:21:24 -0800908 final int appWidgetId;
909 int widgetId = data != null ? data.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, -1)
910 : -1;
911 if (widgetId < 0) {
912 appWidgetId = pendingAddWidgetId;
913 } else {
914 appWidgetId = widgetId;
915 }
916
Adam Cohenad4e15c2013-10-17 16:21:35 -0700917 final int result;
Adam Cohenf0129b12013-11-04 17:57:36 -0800918 if (appWidgetId < 0 || resultCode == RESULT_CANCELED) {
Adam Cohendb364c32014-05-20 14:23:40 -0700919 Log.e(TAG, "Error: appWidgetId (EXTRA_APPWIDGET_ID) was not " +
920 "returned from the widget configuration activity.");
Adam Cohenad4e15c2013-10-17 16:21:35 -0700921 result = RESULT_CANCELED;
Sunny Goyal2100c782016-08-22 16:00:03 -0700922 completeTwoStageWidgetDrop(result, appWidgetId, requestArgs);
Sunny Goyal6e379fc2020-03-19 16:08:14 -0700923 mWorkspace.removeExtraEmptyScreenDelayed(
924 ON_ACTIVITY_RESULT_ANIMATION_DELAY, false,
925 () -> getStateManager().goToState(NORMAL));
Sunny Goyal2100c782016-08-22 16:00:03 -0700926 } else {
Sunny Goyal669b71f2023-01-27 14:37:07 -0800927 CellPos presenterPos = getCellPosMapper().mapModelToPresenter(requestArgs);
928 if (requestArgs.container == CONTAINER_DESKTOP) {
Sunny Goyal2100c782016-08-22 16:00:03 -0700929 // When the screen id represents an actual screen (as opposed to a rank)
930 // we make sure that the drop page actually exists.
Sunny Goyal669b71f2023-01-27 14:37:07 -0800931 int newScreenId = ensurePendingDropLayoutExists(presenterPos.screenId);
932 requestArgs.screenId = getCellPosMapper().mapPresenterToModel(
933 presenterPos.cellX, presenterPos.cellY, newScreenId, CONTAINER_DESKTOP)
934 .screenId;
Adam Cohendb364c32014-05-20 14:23:40 -0700935 }
Sunny Goyal2100c782016-08-22 16:00:03 -0700936 final CellLayout dropLayout =
Sunny Goyal669b71f2023-01-27 14:37:07 -0800937 mWorkspace.getScreenWithId(presenterPos.screenId);
Sunny Goyal2100c782016-08-22 16:00:03 -0700938
939 dropLayout.setDropPending(true);
940 final Runnable onComplete = new Runnable() {
941 @Override
942 public void run() {
943 completeTwoStageWidgetDrop(resultCode, appWidgetId, requestArgs);
944 dropLayout.setDropPending(false);
945 }
946 };
Sunny Goyal6e379fc2020-03-19 16:08:14 -0700947 mWorkspace.removeExtraEmptyScreenDelayed(
948 ON_ACTIVITY_RESULT_ANIMATION_DELAY, false, onComplete);
Winson Chung5aaab772012-04-27 15:24:02 -0700949 }
Adam Cohened66b2b2012-01-23 17:28:51 -0800950 return;
951 }
952
Sunny Goyald478c832016-04-01 12:04:16 -0700953 if (requestCode == REQUEST_RECONFIGURE_APPWIDGET
954 || requestCode == REQUEST_BIND_PENDING_APPWIDGET) {
Sunny Goyalff572272014-07-23 13:58:07 -0700955 if (resultCode == RESULT_OK) {
956 // Update the widget view.
Sunny Goyal2100c782016-08-22 16:00:03 -0700957 completeAdd(requestCode, data, pendingAddWidgetId, requestArgs);
Sunny Goyalff572272014-07-23 13:58:07 -0700958 }
959 // Leave the widget in the pending state if the user canceled the configure.
960 return;
961 }
962
Sunny Goyalaad90582015-07-09 14:22:50 -0700963 if (requestCode == REQUEST_CREATE_SHORTCUT) {
964 // Handle custom shortcuts created using ACTION_CREATE_SHORTCUT.
Sunny Goyal2100c782016-08-22 16:00:03 -0700965 if (resultCode == RESULT_OK && requestArgs.container != ItemInfo.NO_ID) {
966 completeAdd(requestCode, data, -1, requestArgs);
Sunny Goyal6e379fc2020-03-19 16:08:14 -0700967 mWorkspace.removeExtraEmptyScreenDelayed(
968 ON_ACTIVITY_RESULT_ANIMATION_DELAY, false, exitSpringLoaded);
Sunny Goyal2100c782016-08-22 16:00:03 -0700969
Sunny Goyalaad90582015-07-09 14:22:50 -0700970 } else if (resultCode == RESULT_CANCELED) {
Sunny Goyal6e379fc2020-03-19 16:08:14 -0700971 mWorkspace.removeExtraEmptyScreenDelayed(
972 ON_ACTIVITY_RESULT_ANIMATION_DELAY, false, exitSpringLoaded);
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800973 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -0800974 }
Hongming Jind91cb6e2020-01-27 16:23:03 -0800975
Adam Cohened66b2b2012-01-23 17:28:51 -0800976 mDragLayer.clearAnimatedView();
Adam Cohenc7cd2cb2014-11-17 17:45:34 -0800977 }
978
979 @Override
Sunny Goyal64a75aa2017-07-03 13:50:52 -0700980 public void onActivityResult(
Adam Cohenc7cd2cb2014-11-17 17:45:34 -0800981 final int requestCode, final int resultCode, final Intent data) {
Sunny Goyaldedda052019-05-14 15:23:48 -0700982 mPendingActivityRequestCode = -1;
Adam Cohenc7cd2cb2014-11-17 17:45:34 -0800983 handleActivityResult(requestCode, resultCode, data);
Adam Cohened66b2b2012-01-23 17:28:51 -0800984 }
985
Adam Cohendb364c32014-05-20 14:23:40 -0700986 /**
987 * Check to see if a given screen id exists. If not, create it at the end, return the new id.
988 *
989 * @param screenId the screen id to check
990 * @return the new screen, or screenId if it exists
991 */
Sunny Goyalefb7e842018-10-04 15:11:00 -0700992 private int ensurePendingDropLayoutExists(int screenId) {
Sunny Goyal32554d12015-12-03 15:31:25 -0800993 CellLayout dropLayout = mWorkspace.getScreenWithId(screenId);
Adam Cohendb364c32014-05-20 14:23:40 -0700994 if (dropLayout == null) {
995 // it's possible that the add screen was removed because it was
996 // empty and a re-bind occurred
Andras Kloczl408a54f2021-08-28 00:59:08 +0100997 mWorkspace.addExtraEmptyScreens();
998 IntSet emptyPagesAdded = mWorkspace.commitExtraEmptyScreens();
999 return emptyPagesAdded.isEmpty() ? -1 : emptyPagesAdded.getArray().get(0);
Adam Cohendb364c32014-05-20 14:23:40 -07001000 }
Andras Kloczl408a54f2021-08-28 00:59:08 +01001001 return screenId;
Adam Cohendb364c32014-05-20 14:23:40 -07001002 }
1003
Samuel Fufaca37b8a2019-08-19 17:04:36 -07001004 @Thunk
1005 void completeTwoStageWidgetDrop(
Sunny Goyal2100c782016-08-22 16:00:03 -07001006 final int resultCode, final int appWidgetId, final PendingRequestArgs requestArgs) {
Sunny Goyal669b71f2023-01-27 14:37:07 -08001007 CellLayout cellLayout = mWorkspace.getScreenWithId(
1008 getCellPosMapper().mapModelToPresenter(requestArgs).screenId);
Adam Cohened66b2b2012-01-23 17:28:51 -08001009 Runnable onCompleteRunnable = null;
1010 int animationType = 0;
1011
Adam Cohen9d5b7d82012-05-09 18:00:44 -07001012 AppWidgetHostView boundWidget = null;
Adam Cohened66b2b2012-01-23 17:28:51 -08001013 if (resultCode == RESULT_OK) {
1014 animationType = Workspace.COMPLETE_TWO_STAGE_WIDGET_DROP_ANIMATION;
Sihua Ma0593a0d2022-10-03 16:01:48 -07001015 final AppWidgetHostView layout = mAppWidgetHolder.createView(this, appWidgetId,
Sunny Goyal04a324a2017-01-20 21:08:59 -08001016 requestArgs.getWidgetHandler().getProviderInfo(this));
Adam Cohen9d5b7d82012-05-09 18:00:44 -07001017 boundWidget = layout;
Charlie Anderson438d4052023-04-25 14:38:57 -04001018 onCompleteRunnable = () -> {
1019 completeAddAppWidget(appWidgetId, requestArgs, layout, null);
1020 if (!isInState(EDIT_MODE)) {
Sunny Goyal3e3f44c2017-10-23 17:14:52 -07001021 mStateManager.goToState(NORMAL, SPRING_LOADED_EXIT_DELAY);
Adam Cohened66b2b2012-01-23 17:28:51 -08001022 }
1023 };
1024 } else if (resultCode == RESULT_CANCELED) {
Sihua Ma0593a0d2022-10-03 16:01:48 -07001025 mAppWidgetHolder.deleteAppWidgetId(appWidgetId);
Adam Cohened66b2b2012-01-23 17:28:51 -08001026 animationType = Workspace.CANCEL_TWO_STAGE_WIDGET_DROP_ANIMATION;
Adam Cohened66b2b2012-01-23 17:28:51 -08001027 }
Adam Cohen9d5b7d82012-05-09 18:00:44 -07001028 if (mDragLayer.getAnimatedView() != null) {
Sunny Goyal2100c782016-08-22 16:00:03 -07001029 mWorkspace.animateWidgetDrop(requestArgs, cellLayout,
Adam Cohen9d5b7d82012-05-09 18:00:44 -07001030 (DragView) mDragLayer.getAnimatedView(), onCompleteRunnable,
1031 animationType, boundWidget, true);
Adam Cohenad4e15c2013-10-17 16:21:35 -07001032 } else if (onCompleteRunnable != null) {
Adam Cohen9d5b7d82012-05-09 18:00:44 -07001033 // The animated view may be null in the case of a rotation during widget configuration
1034 onCompleteRunnable.run();
1035 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001036 }
1037
1038 @Override
Michael Jurkacd496d72013-04-11 11:32:45 -07001039 protected void onStop() {
1040 super.onStop();
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001041 if (mDeferOverlayCallbacks) {
1042 checkIfOverlayStillDeferred();
1043 } else {
Sunny Goyale82a20a2023-10-19 13:52:49 -07001044 mOverlayManager.onActivityStopped();
Adam Cohen9211d422014-10-07 18:14:53 -07001045 }
Hyunyoung Song5ee7c132021-05-11 13:52:36 -07001046 hideKeyboard();
Hyunyoung Song95786e02020-09-15 00:34:10 -07001047 logStopAndResume(false /* isResume */);
Sihua Ma0593a0d2022-10-03 16:01:48 -07001048 mAppWidgetHolder.setActivityStarted(false);
Schneider Victor-tulias5173fd82021-10-19 14:47:23 -07001049 NotificationListener.removeNotificationsChangedListener(getPopupDataProvider());
Winson Chung7c500162023-06-14 18:58:27 +00001050 FloatingIconView.resetIconLoadResult();
Vadim Tryshev1b058fd2023-11-28 18:26:43 -08001051 AccessibilityManagerCompat.sendTestProtocolEventToTest(
1052 this, LAUNCHER_ACTIVITY_STOPPED_MESSAGE);
Michael Jurkacd496d72013-04-11 11:32:45 -07001053 }
1054
1055 @Override
1056 protected void onStart() {
Sunny Goyal67736672023-06-02 13:35:19 +00001057 TraceHelper.INSTANCE.beginSection(ON_START_EVT);
Michael Jurkacd496d72013-04-11 11:32:45 -07001058 super.onStart();
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001059 if (!mDeferOverlayCallbacks) {
Sunny Goyale82a20a2023-10-19 13:52:49 -07001060 mOverlayManager.onActivityStarted();
Adam Cohen9211d422014-10-07 18:14:53 -07001061 }
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001062
Sihua Ma0593a0d2022-10-03 16:01:48 -07001063 mAppWidgetHolder.setActivityStarted(true);
Sunny Goyal67736672023-06-02 13:35:19 +00001064 TraceHelper.INSTANCE.endSection();
Michael Jurkacd496d72013-04-11 11:32:45 -07001065 }
1066
Sunny Goyal35e7d382020-05-08 13:37:58 -07001067 @Override
1068 @CallSuper
1069 protected void onDeferredResumed() {
Hyunyoung Song95786e02020-09-15 00:34:10 -07001070 logStopAndResume(true /* isResume */);
Sunny Goyala002c6c2019-02-12 16:20:10 -08001071
Sunny Goyal35e7d382020-05-08 13:37:58 -07001072 // Process any items that were added while Launcher was away.
Sunny Goyal60e68c92020-08-12 13:59:27 -07001073 ItemInstallQueue.INSTANCE.get(this)
1074 .resumeModelPush(FLAG_ACTIVITY_PAUSED);
Sunny Goyale9c6f4c2019-05-30 11:35:25 -07001075
Sunny Goyal35e7d382020-05-08 13:37:58 -07001076 // Refresh shortcuts if the permission changed.
Sunny Goyal8b74cc72020-07-27 17:50:33 -07001077 mModel.validateModelDataOnResume();
Sunny Goyale9c6f4c2019-05-30 11:35:25 -07001078
Sunny Goyal35e7d382020-05-08 13:37:58 -07001079 // Set the notification listener and fetch updated notifications when we resume
Schneider Victor-tulias5173fd82021-10-19 14:47:23 -07001080 NotificationListener.addNotificationsChangedListener(mPopupDataProvider);
Winson Chung87583112019-06-10 14:20:58 -07001081
Sunny Goyal35e7d382020-05-08 13:37:58 -07001082 DiscoveryBounce.showForHomeIfNeeded(this);
Sihua Ma0593a0d2022-10-03 16:01:48 -07001083 mAppWidgetHolder.setActivityResumed(true);
Sunny Goyaldedda052019-05-14 15:23:48 -07001084 }
1085
Hyunyoung Song95786e02020-09-15 00:34:10 -07001086 private void logStopAndResume(boolean isResume) {
Sebastian Francoe4965122023-12-01 13:27:42 -06001087 if (mModelCallbacks.getPendingExecutor() != null) return;
Hyunyoung Song801f81f2020-06-19 02:58:53 -07001088 int pageIndex = mWorkspace.isOverlayShown() ? -1 : mWorkspace.getCurrentPage();
Hyunyoung Song95786e02020-09-15 00:34:10 -07001089 int statsLogOrdinal = mStateManager.getState().statsLogOrdinal;
Hyunyoung Song801f81f2020-06-19 02:58:53 -07001090
1091 StatsLogManager.EventEnum event;
1092 StatsLogManager.StatsLogger logger = getStatsLogManager().logger();
Hyunyoung Song95786e02020-09-15 00:34:10 -07001093 if (isResume) {
Hyunyoung Song801f81f2020-06-19 02:58:53 -07001094 logger.withSrcState(LAUNCHER_STATE_BACKGROUND)
Hyunyoung Song95786e02020-09-15 00:34:10 -07001095 .withDstState(mStateManager.getState().statsLogOrdinal);
Hyunyoung Song801f81f2020-06-19 02:58:53 -07001096 event = LAUNCHER_ONRESUME;
1097 } else { /* command == Action.Command.STOP */
Hyunyoung Song95786e02020-09-15 00:34:10 -07001098 logger.withSrcState(mStateManager.getState().statsLogOrdinal)
Hyunyoung Song801f81f2020-06-19 02:58:53 -07001099 .withDstState(LAUNCHER_STATE_BACKGROUND);
1100 event = LAUNCHER_ONSTOP;
1101 }
1102
Hyunyoung Song95786e02020-09-15 00:34:10 -07001103 if (statsLogOrdinal == LAUNCHER_STATE_HOME && mWorkspace != null) {
Hyunyoung Song801f81f2020-06-19 02:58:53 -07001104 logger.withContainerInfo(LauncherAtom.ContainerInfo.newBuilder()
1105 .setWorkspace(
1106 LauncherAtom.WorkspaceContainer.newBuilder()
1107 .setPageIndex(pageIndex)).build());
Becky Qiubfc2da12019-08-01 11:09:38 -07001108 }
Hyunyoung Song801f81f2020-06-19 02:58:53 -07001109 logger.log(event);
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001110 }
Becky Qiubfc2da12019-08-01 11:09:38 -07001111
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001112 private void scheduleDeferredCheck() {
1113 mHandler.removeCallbacks(mDeferredOverlayCallbacks);
1114 postAsyncCallback(mHandler, mDeferredOverlayCallbacks);
1115 }
1116
1117 private void checkIfOverlayStillDeferred() {
1118 if (!mDeferOverlayCallbacks) {
1119 return;
1120 }
Sunny Goyal8f965462020-04-23 19:00:36 -07001121 if (isStarted() && (!hasBeenResumed()
1122 || mStateManager.getState().hasFlag(FLAG_NON_INTERACTIVE))) {
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001123 return;
1124 }
1125 mDeferOverlayCallbacks = false;
1126
1127 // Move the client to the correct state. Calling the same method twice is no-op.
1128 if (isStarted()) {
Sunny Goyale82a20a2023-10-19 13:52:49 -07001129 mOverlayManager.onActivityStarted();
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001130 }
1131 if (hasBeenResumed()) {
Sunny Goyale82a20a2023-10-19 13:52:49 -07001132 mOverlayManager.onActivityResumed();
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001133 } else {
Sunny Goyale82a20a2023-10-19 13:52:49 -07001134 mOverlayManager.onActivityPaused();
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001135 }
1136 if (!isStarted()) {
Sunny Goyale82a20a2023-10-19 13:52:49 -07001137 mOverlayManager.onActivityStopped();
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001138 }
1139 }
1140
1141 public void deferOverlayCallbacksUntilNextResumeOrStop() {
1142 mDeferOverlayCallbacks = true;
1143 }
1144
Sunny Goyal35e7d382020-05-08 13:37:58 -07001145 @Override
Winson Chungef528762019-09-06 12:05:52 -07001146 public void onStateSetStart(LauncherState state) {
Sunny Goyal35e7d382020-05-08 13:37:58 -07001147 super.onStateSetStart(state);
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001148 if (mDeferOverlayCallbacks) {
1149 scheduleDeferredCheck();
Sunny Goyale9c6f4c2019-05-30 11:35:25 -07001150 }
Sunny Goyal210e1742019-10-17 12:05:38 -07001151 addActivityFlags(ACTIVITY_STATE_TRANSITION_ACTIVE);
Sunny Goyal8f965462020-04-23 19:00:36 -07001152
Charlie Anderson438d4052023-04-25 14:38:57 -04001153 if (state == SPRING_LOADED || state == EDIT_MODE) {
Sunny Goyal8f965462020-04-23 19:00:36 -07001154 // Prevent any Un/InstallShortcutReceivers from updating the db while we are
1155 // not on homescreen
Sunny Goyal60e68c92020-08-12 13:59:27 -07001156 ItemInstallQueue.INSTANCE.get(this).pauseModelPush(FLAG_DRAG_AND_DROP);
Sunny Goyal8f965462020-04-23 19:00:36 -07001157 getRotationHelper().setCurrentStateRequest(REQUEST_LOCK);
1158
1159 mWorkspace.showPageIndicatorAtCurrentScroll();
1160 mWorkspace.setClipChildren(false);
1161 }
1162 // When multiple pages are visible, show persistent page indicator
1163 mWorkspace.getPageIndicator().setShouldAutoHide(!state.hasFlag(FLAG_MULTI_PAGE));
thiruram0eabc782021-04-02 14:30:10 -07001164
thiruramc96873c2021-02-11 15:13:47 -08001165 mPrevLauncherState = mStateManager.getCurrentStableState();
thiruram0eabc782021-04-02 14:30:10 -07001166 if (mPrevLauncherState != state && ALL_APPS.equals(state)
1167 // Making sure mAllAppsSessionLogId is null to avoid double logging.
1168 && mAllAppsSessionLogId == null) {
1169 // creates new instance ID since new all apps session is started.
1170 mAllAppsSessionLogId = new InstanceIdSequence().newInstanceId();
Thiru Ramasamy694407c2022-03-08 12:11:24 -08001171 if (getAllAppsEntryEvent().isPresent()) {
1172 getStatsLogManager().logger()
1173 .withContainerInfo(ContainerInfo.newBuilder()
1174 .setWorkspace(WorkspaceContainer.newBuilder()
1175 .setPageIndex(getWorkspace().getCurrentPage())).build())
1176 .log(getAllAppsEntryEvent().get());
1177 }
thiruram0eabc782021-04-02 14:30:10 -07001178 }
Sunny Goyal1eb11242022-09-09 17:14:45 -07001179 updateDisallowBack();
Sunny Goyaldedda052019-05-14 15:23:48 -07001180 }
1181
Thiru Ramasamy5fbac632022-01-28 15:05:36 -08001182 /**
1183 * Returns {@link EventEnum} that should be logged when Launcher enters into AllApps state.
1184 */
Thiru Ramasamy694407c2022-03-08 12:11:24 -08001185 protected Optional<EventEnum> getAllAppsEntryEvent() {
1186 return Optional.of(FeatureFlags.ENABLE_DEVICE_SEARCH.get()
Thiru Ramasamy5fbac632022-01-28 15:05:36 -08001187 ? LAUNCHER_ALLAPPS_ENTRY_WITH_DEVICE_SEARCH
Thiru Ramasamy694407c2022-03-08 12:11:24 -08001188 : LAUNCHER_ALLAPPS_ENTRY);
Thiru Ramasamy5fbac632022-01-28 15:05:36 -08001189 }
1190
Sunny Goyal35e7d382020-05-08 13:37:58 -07001191 @Override
Winson Chungef528762019-09-06 12:05:52 -07001192 public void onStateSetEnd(LauncherState state) {
Sunny Goyalfee1b252020-12-14 12:30:38 -08001193 super.onStateSetEnd(state);
Sihua Ma0593a0d2022-10-03 16:01:48 -07001194 getAppWidgetHolder().setStateIsNormal(state == LauncherState.NORMAL);
Sunny Goyal8f965462020-04-23 19:00:36 -07001195 getWorkspace().setClipChildren(!state.hasFlag(FLAG_MULTI_PAGE));
1196
Winson Chungef528762019-09-06 12:05:52 -07001197 finishAutoCancelActionMode();
Sunny Goyal210e1742019-10-17 12:05:38 -07001198 removeActivityFlags(ACTIVITY_STATE_TRANSITION_ACTIVE);
Sunny Goyal8f965462020-04-23 19:00:36 -07001199
1200 // dispatch window state changed
1201 getWindow().getDecorView().sendAccessibilityEvent(TYPE_WINDOW_STATE_CHANGED);
1202 AccessibilityManagerCompat.sendStateEventToTest(this, state.ordinal);
1203
1204 if (state == NORMAL) {
1205 // Re-enable any Un/InstallShortcutReceiver and now process any queued items
Sunny Goyal60e68c92020-08-12 13:59:27 -07001206 ItemInstallQueue.INSTANCE.get(this)
1207 .resumeModelPush(FLAG_DRAG_AND_DROP);
Sunny Goyal8f965462020-04-23 19:00:36 -07001208
1209 // Clear any rotation locks when going to normal state
1210 getRotationHelper().setCurrentStateRequest(REQUEST_NONE);
1211 }
thiruramc96873c2021-02-11 15:13:47 -08001212
thiruramea56f842021-06-02 16:02:37 -07001213 if (ALL_APPS.equals(mPrevLauncherState) && !ALL_APPS.equals(state)
thiruram0eabc782021-04-02 14:30:10 -07001214 // Making sure mAllAppsSessionLogId is not null to avoid double logging.
thiruramc96873c2021-02-11 15:13:47 -08001215 && mAllAppsSessionLogId != null) {
Samuel Fuface820f52021-06-18 17:23:48 -05001216 getAppsView().reset(false);
Thiru Ramasamy694407c2022-03-08 12:11:24 -08001217 getAllAppsExitEvent().ifPresent(getStatsLogManager().logger()::log);
thiruramc96873c2021-02-11 15:13:47 -08001218 mAllAppsSessionLogId = null;
1219 }
Winson Chungef528762019-09-06 12:05:52 -07001220 }
1221
Thiru Ramasamy694407c2022-03-08 12:11:24 -08001222 /**
1223 * Returns {@link EventEnum} that should be logged when Launcher exists from AllApps state.
1224 */
1225 protected Optional<EventEnum> getAllAppsExitEvent() {
1226 return Optional.of(LAUNCHER_ALLAPPS_EXIT);
1227 }
1228
Michael Jurkacd496d72013-04-11 11:32:45 -07001229 @Override
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001230 protected void onResume() {
Sunny Goyal67736672023-06-02 13:35:19 +00001231 TraceHelper.INSTANCE.beginSection(ON_RESUME_EVT);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001232 super.onResume();
Sunny Goyalfca6bc92017-09-28 16:28:34 -07001233
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001234 if (mDeferOverlayCallbacks) {
1235 scheduleDeferredCheck();
1236 } else {
Sunny Goyale82a20a2023-10-19 13:52:49 -07001237 mOverlayManager.onActivityResumed();
Adam Cohen9211d422014-10-07 18:14:53 -07001238 }
Mario Bertschler0fc6f682017-02-17 12:16:13 -08001239
Jon Mirandaa82a7dc2022-05-10 11:48:32 -07001240 DragView.removeAllViews(this);
Sunny Goyal67736672023-06-02 13:35:19 +00001241 TraceHelper.INSTANCE.endSection();
Adam Cohen06dff352012-06-01 17:17:08 -07001242 }
1243
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001244 @Override
The Android Open Source Project7376fae2009-03-11 12:11:58 -07001245 protected void onPause() {
Winson Chung997a9232013-07-24 15:33:46 -07001246 // Ensure that items added to Launcher are queued until Launcher returns
Sunny Goyal60e68c92020-08-12 13:59:27 -07001247 ItemInstallQueue.INSTANCE.get(this).pauseModelPush(FLAG_ACTIVITY_PAUSED);
Winson Chung997a9232013-07-24 15:33:46 -07001248
The Android Open Source Project7376fae2009-03-11 12:11:58 -07001249 super.onPause();
Joe Onorato24b6fd82009-11-12 13:47:09 -08001250 mDragController.cancelDrag();
Sunny Goyal9b180102020-03-11 10:02:29 -07001251 mLastTouchUpTime = -1;
Hyunyoung Song497708c2019-05-01 16:16:53 -07001252 mDropTargetBar.animateToVisibility(false);
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001253
1254 if (!mDeferOverlayCallbacks) {
Sunny Goyale82a20a2023-10-19 13:52:49 -07001255 mOverlayManager.onActivityPaused();
Adam Cohenbffe7452013-07-22 18:21:45 -07001256 }
Sihua Ma0593a0d2022-10-03 16:01:48 -07001257 mAppWidgetHolder.setActivityResumed(false);
Adam Cohenbffe7452013-07-22 18:21:45 -07001258 }
1259
Lucas Dupin87d75202021-07-28 10:24:54 -07001260 /**
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001261 * Restores the previous state, if it exists.
1262 *
1263 * @param savedState The previous state.
1264 */
1265 private void restoreState(Bundle savedState) {
1266 if (savedState == null) {
1267 return;
1268 }
1269
Sunny Goyal3e3f44c2017-10-23 17:14:52 -07001270 int stateOrdinal = savedState.getInt(RUNTIME_STATE, NORMAL.ordinal);
Sunny Goyalf9403d92017-10-18 10:55:56 -07001271 LauncherState[] stateValues = LauncherState.values();
1272 LauncherState state = stateValues[stateOrdinal];
Sunny Goyal6c0c61a2020-12-08 19:19:56 -08001273
1274 NonConfigInstance lastInstance = (NonConfigInstance) getLastNonConfigurationInstance();
1275 boolean forceRestore = lastInstance != null
1276 && (lastInstance.config.diff(mOldConfig) & CONFIG_UI_MODE) != 0;
1277 if (forceRestore || !state.shouldDisableRestore()) {
Sunny Goyal3e3f44c2017-10-23 17:14:52 -07001278 mStateManager.goToState(state, false /* animated */);
Joe Onorato3a8820b2009-11-10 15:06:42 -08001279 }
1280
Samuel Fufaca37b8a2019-08-19 17:04:36 -07001281 PendingRequestArgs requestArgs = savedState.getParcelable(
1282 RUNTIME_STATE_PENDING_REQUEST_ARGS);
Sunny Goyal2100c782016-08-22 16:00:03 -07001283 if (requestArgs != null) {
1284 setWaitingForResult(requestArgs);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001285 }
Sunny Goyaldedda052019-05-14 15:23:48 -07001286 mPendingActivityRequestCode = savedState.getInt(RUNTIME_STATE_PENDING_REQUEST_CODE);
Sunny Goyal2100c782016-08-22 16:00:03 -07001287
1288 mPendingActivityResult = savedState.getParcelable(RUNTIME_STATE_PENDING_ACTIVITY_RESULT);
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -07001289
1290 SparseArray<Parcelable> widgetsState =
1291 savedState.getSparseParcelableArray(RUNTIME_STATE_WIDGET_PANEL);
1292 if (widgetsState != null) {
1293 WidgetsFullSheet.show(this, false).restoreHierarchyState(widgetsState);
1294 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001295 }
1296
1297 /**
1298 * Finds all the views we need and configure them properly.
1299 */
Tony Wickham04fca162020-02-05 15:06:52 -08001300 protected void setupViews() {
Fengjiang Li5a36c172023-04-13 18:18:27 +00001301 mStartupLatencyLogger.logStart(LAUNCHER_LATENCY_STARTUP_VIEW_INFLATION);
Becky Qiu3aec5d52022-09-16 11:17:50 -07001302 inflateRootView(R.layout.launcher);
Fengjiang Li5a36c172023-04-13 18:18:27 +00001303 mStartupLatencyLogger.logEnd(LAUNCHER_LATENCY_STARTUP_VIEW_INFLATION);
1304
Sunny Goyalcc96aa12018-01-11 09:56:07 -08001305 mDragLayer = findViewById(R.id.drag_layer);
Sunny Goyal3333b0c2016-05-09 20:43:21 -07001306 mFocusHandler = mDragLayer.getFocusIndicatorHelper();
Sunny Goyal966d9012017-06-06 16:43:59 -07001307 mWorkspace = mDragLayer.findViewById(R.id.workspace);
Sunny Goyald0a6ae72016-06-16 12:29:03 -07001308 mWorkspace.initParentViews(mDragLayer);
Sreyas321bfae2020-02-21 17:53:02 -08001309 mOverviewPanel = findViewById(R.id.overview_panel);
Sunny Goyal7c7be8c2018-03-07 19:58:07 -08001310 mHotseat = findViewById(R.id.hotseat);
Adam Cohenb66675a2020-05-15 16:16:17 -07001311 mHotseat.setWorkspace(mWorkspace);
Craig Mautner360310b2012-10-26 15:13:08 -07001312
Winson Chung4c98d922011-05-31 16:50:48 -07001313 // Setup the drag layer
Sunny Goyal5d1873a2018-05-08 11:10:44 -07001314 mDragLayer.setup(mDragController, mWorkspace);
Winson Chung4c98d922011-05-31 16:50:48 -07001315
Hyunyoung Song645764e2016-06-06 14:19:02 -07001316 mWorkspace.setup(mDragController);
Winsonc7d2e832016-07-28 12:24:55 -07001317 // Until the workspace is bound, ensure that we keep the wallpaper offset locked to the
1318 // default state, otherwise we will update to the wrong offsets in RTL
1319 mWorkspace.lockWallpaperToDefaultPage();
fbaronc0e687b2023-10-04 12:11:20 -07001320 if (!ENABLE_SMARTSPACE_REMOVAL.get()) {
1321 mWorkspace.bindAndInitFirstWorkspaceScreen();
1322 }
Hyunyoung Song645764e2016-06-06 14:19:02 -07001323 mDragController.addDragListener(mWorkspace);
Winson Chung4c98d922011-05-31 16:50:48 -07001324
Tony Wickham34d2c912015-09-11 09:27:58 -07001325 // Get the search/delete/uninstall bar
Rajeev Kumar43c0f582017-06-23 15:34:55 -07001326 mDropTargetBar = mDragLayer.findViewById(R.id.drop_target_bar);
Patrick Dubroy3ec8bdd2010-08-06 16:01:33 -07001327
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -07001328 // Setup Apps
1329 mAppsView = findViewById(R.id.apps_view);
Fengjiang Lid080b982023-02-01 15:30:30 -08001330 mAppsView.setAllAppsTransitionController(mAllAppsController);
Craig Mautner360310b2012-10-26 15:13:08 -07001331
Govinda Wassermanc06e1512019-04-09 09:56:53 -04001332 // Setup Scrim
1333 mScrimView = findViewById(R.id.scrim_view);
1334
Winson Chung3d503fb2011-07-13 17:25:49 -07001335 // Setup the drag controller (drop targets have to be added in reverse order in priority)
Sunny Goyal47328fd2016-05-25 18:56:41 -07001336 mDropTargetBar.setup(mDragController);
Samuel Fufaacebd1f2021-05-06 10:02:03 -05001337 mAllAppsController.setupViews(mScrimView, mAppsView);
Federico Baron3f255eb2022-12-22 14:40:58 -08001338
fbaron80b0ce82023-09-27 16:23:15 -07001339 mWorkspace.getPageIndicator().setShouldAutoHide(true);
1340 mWorkspace.getPageIndicator().setPaintColor(Themes.getAttrBoolean(
1341 this, R.attr.isWorkspaceDarkText) ? Color.BLACK : Color.WHITE);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001342 }
1343
Federico Baron7539d762022-09-29 09:47:04 -07001344 @Override
1345 public View onCreateView(View parent, String name, Context context, AttributeSet attrs) {
fbaron80b0ce82023-09-27 16:23:15 -07001346 if (WorkspacePageIndicator.class.getName().equals(name)) {
Federico Baron7539d762022-09-29 09:47:04 -07001347 return LayoutInflater.from(context).inflate(R.layout.page_indicator_dots,
1348 (ViewGroup) parent, false);
1349 }
1350 return super.onCreateView(parent, name, context, attrs);
1351 }
1352
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001353 /**
1354 * Creates a view representing a shortcut.
1355 *
1356 * @param info The data structure describing the shortcut.
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001357 */
Sunny Goyal95899162019-03-27 16:03:06 -07001358 View createShortcut(WorkspaceItemInfo info) {
Schneider Victor-tulias9f922d32022-04-27 16:39:29 -07001359 // This can be called before PagedView#pageScrollsInitialized returns true, so use the
1360 // first page, which we always assume to be present.
1361 return createShortcut((ViewGroup) mWorkspace.getChildAt(0), info);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001362 }
1363
1364 /**
1365 * Creates a view representing a shortcut inflated from the specified resource.
1366 *
Schneider Victor-tulias9f922d32022-04-27 16:39:29 -07001367 * @param parent The group the shortcut belongs to. This is not necessarily the group where
1368 * the shortcut should be added.
Samuel Fufaca37b8a2019-08-19 17:04:36 -07001369 * @param info The data structure describing the shortcut.
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001370 * @return A View inflated from layoutResId.
1371 */
Fengjiang Li080f9322023-07-12 13:33:54 -07001372 public View createShortcut(@Nullable ViewGroup parent, WorkspaceItemInfo info) {
1373 BubbleTextView favorite =
1374 (BubbleTextView) LayoutInflater.from(parent != null ? parent.getContext() : this)
1375 .inflate(R.layout.app_icon, parent, false);
Sunny Goyal95899162019-03-27 16:03:06 -07001376 favorite.applyFromWorkspaceItem(info);
Tracy Zhouba0b5952022-10-14 01:28:07 -07001377 favorite.setOnClickListener(getItemOnClickListener());
Sunny Goyaldcbcc862014-08-12 15:58:36 -07001378 favorite.setOnFocusChangeListener(mFocusHandler);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001379 return favorite;
1380 }
1381
1382 /**
Jon Mirandac476d6e2017-05-04 16:30:01 -07001383 * Add a shortcut to the workspace or to a Folder.
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001384 *
1385 * @param data The intent describing the shortcut.
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001386 */
sfufa@google.comd0a33232021-09-19 15:59:36 -07001387 protected void completeAddShortcut(Intent data, int container, int screenId, int cellX,
Sunny Goyalfb5096d2016-09-08 14:32:06 -07001388 int cellY, PendingRequestArgs args) {
Holly Sun35b99602023-06-28 15:14:02 -07001389 if (args.getRequestCode() != REQUEST_CREATE_SHORTCUT) {
Sunny Goyalfb5096d2016-09-08 14:32:06 -07001390 return;
1391 }
Adam Cohen558baaf2011-08-15 15:22:57 -07001392
Jon Mirandac476d6e2017-05-04 16:30:01 -07001393 int[] cellXY = mTmpAddItemCellCoordinates;
1394 CellLayout layout = getCellLayout(container, screenId);
1395
Sunny Goyaleaf7a952020-07-29 16:54:20 -07001396 WorkspaceItemInfo info = PinRequestHelper.createWorkspaceItemFromPinItemRequest(
Sunny Goyale7b00122019-10-02 16:13:34 -07001397 this, PinRequestHelper.getPinItemRequest(data), 0);
Sunny Goyal782f0c92017-01-19 10:27:54 -08001398 if (info == null) {
Sunny Goyal84b48d82023-03-29 16:52:27 -07001399 Log.e(TAG, "Unable to parse a valid shortcut result");
1400 return;
Sunny Goyal782f0c92017-01-19 10:27:54 -08001401 }
1402
Jon Mirandac476d6e2017-05-04 16:30:01 -07001403 if (container < 0) {
1404 // Adding a shortcut to the Workspace.
1405 final View view = createShortcut(info);
1406 boolean foundCellSpan = false;
1407 // First we check if we already know the exact location where we want to add this item.
1408 if (cellX >= 0 && cellY >= 0) {
1409 cellXY[0] = cellX;
1410 cellXY[1] = cellY;
1411 foundCellSpan = true;
Adam Cohen558baaf2011-08-15 15:22:57 -07001412
Hyunyoung Song1ae42422020-01-26 23:25:14 -08001413 DragObject dragObject = new DragObject(getApplicationContext());
1414 dragObject.dragInfo = info;
Jon Mirandac476d6e2017-05-04 16:30:01 -07001415 // If appropriate, either create a folder or add to an existing folder
1416 if (mWorkspace.createUserFolderIfNecessary(view, container, layout, cellXY, 0,
Hyunyoung Song1ae42422020-01-26 23:25:14 -08001417 true, dragObject)) {
Jon Mirandac476d6e2017-05-04 16:30:01 -07001418 return;
1419 }
Jon Mirandac476d6e2017-05-04 16:30:01 -07001420 if (mWorkspace.addToExistingFolderIfNecessary(view, layout, cellXY, 0, dragObject,
1421 true)) {
1422 return;
1423 }
1424 } else {
1425 foundCellSpan = layout.findCellForSpan(cellXY, 1, 1);
1426 }
1427
1428 if (!foundCellSpan) {
Yogisha Dixit104d09f2021-07-19 14:05:17 +01001429 mWorkspace.onNoCellFound(layout, info, /* logInstanceId= */ null);
Adam Cohen558baaf2011-08-15 15:22:57 -07001430 return;
1431 }
Jon Mirandac476d6e2017-05-04 16:30:01 -07001432
1433 getModelWriter().addItemToDatabase(info, container, screenId, cellXY[0], cellXY[1]);
1434 mWorkspace.addInScreen(view, info);
Michael Jurkad3ef3062010-11-23 16:23:58 -08001435 } else {
Jon Mirandac476d6e2017-05-04 16:30:01 -07001436 // Adding a shortcut to a Folder.
Sunny Goyale29897f52017-07-20 10:09:42 -07001437 FolderIcon folderIcon = findFolderIcon(container);
Jon Mirandac476d6e2017-05-04 16:30:01 -07001438 if (folderIcon != null) {
1439 FolderInfo folderInfo = (FolderInfo) folderIcon.getTag();
1440 folderInfo.add(info, args.rank, false);
1441 } else {
Sunny Goyale29897f52017-07-20 10:09:42 -07001442 Log.e(TAG, "Could not find folder with id " + container + " to add shortcut.");
Jon Mirandac476d6e2017-05-04 16:30:01 -07001443 }
Michael Jurka0280c3b2010-09-17 15:00:07 -07001444 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001445 }
1446
Tony Wickhamc7cbf252021-05-24 15:46:48 -07001447 @Override
1448 public @Nullable FolderIcon findFolderIcon(final int folderIconId) {
Sunny Goyal83fd25e2018-07-09 16:47:01 -07001449 return (FolderIcon) mWorkspace.getHomescreenIconByItemId(folderIconId);
Sunny Goyale29897f52017-07-20 10:09:42 -07001450 }
1451
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001452 /**
The Android Open Source Project7376fae2009-03-11 12:11:58 -07001453 * Add a widget to the workspace.
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001454 *
Romain Guy5bbc91b2010-08-18 11:38:46 -07001455 * @param appWidgetId The app widget id
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001456 */
Samuel Fufaca37b8a2019-08-19 17:04:36 -07001457 @Thunk
1458 void completeAddAppWidget(int appWidgetId, ItemInfo itemInfo,
Adam Cohen59400422014-03-05 18:07:04 -08001459 AppWidgetHostView hostView, LauncherAppWidgetProviderInfo appWidgetInfo) {
1460
Adam Cohened66b2b2012-01-23 17:28:51 -08001461 if (appWidgetInfo == null) {
fbaron30d9e3f2023-08-03 17:03:59 -07001462 appWidgetInfo = mAppWidgetManager.getLauncherAppWidgetInfo(appWidgetId,
1463 itemInfo.getTargetComponent());
Adam Cohened66b2b2012-01-23 17:28:51 -08001464 }
Romain Guycbb89e42009-06-08 15:52:54 -07001465
Yogisha Dixit0b15c7e2021-05-10 12:01:58 +01001466 if (hostView == null) {
1467 // Perform actual inflation because we're live
Sihua Ma0593a0d2022-10-03 16:01:48 -07001468 hostView = mAppWidgetHolder.createView(this, appWidgetId, appWidgetInfo);
Yogisha Dixit0b15c7e2021-05-10 12:01:58 +01001469 }
1470
Adam Cohen59400422014-03-05 18:07:04 -08001471 LauncherAppWidgetInfo launcherInfo;
Yogisha Dixit0b15c7e2021-05-10 12:01:58 +01001472 launcherInfo =
1473 new LauncherAppWidgetInfo(
1474 appWidgetId, appWidgetInfo.provider, appWidgetInfo, hostView);
Sunny Goyal2100c782016-08-22 16:00:03 -07001475 launcherInfo.spanX = itemInfo.spanX;
1476 launcherInfo.spanY = itemInfo.spanY;
1477 launcherInfo.minSpanX = itemInfo.minSpanX;
1478 launcherInfo.minSpanY = itemInfo.minSpanY;
Sunny Goyal952e63d2017-08-16 04:59:08 -07001479 launcherInfo.user = appWidgetInfo.getProfile();
Yogisha Dixit658c5da2021-05-24 23:23:15 +01001480 if (itemInfo instanceof PendingAddWidgetInfo) {
1481 launcherInfo.sourceContainer = ((PendingAddWidgetInfo) itemInfo).sourceContainer;
1482 } else if (itemInfo instanceof PendingRequestArgs) {
1483 launcherInfo.sourceContainer =
1484 ((PendingRequestArgs) itemInfo).getWidgetSourceContainer();
1485 }
Sunny Goyal669b71f2023-01-27 14:37:07 -08001486 CellPos presenterPos = getCellPosMapper().mapModelToPresenter(itemInfo);
Sunny Goyal43bf11d2017-02-02 13:52:53 -08001487 getModelWriter().addItemToDatabase(launcherInfo,
Sunny Goyal669b71f2023-01-27 14:37:07 -08001488 itemInfo.container, presenterPos.screenId, presenterPos.cellX, presenterPos.cellY);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001489
Sunny Goyal2100c782016-08-22 16:00:03 -07001490 hostView.setVisibility(View.VISIBLE);
Sunny Goyald5462aa2016-11-22 16:52:39 +05301491 prepareAppWidget(hostView, launcherInfo);
1492 mWorkspace.addInScreen(hostView, launcherInfo);
Pinyao Tingc9074272019-11-11 11:51:44 -08001493 announceForAccessibility(R.string.item_added_to_workspace);
Yogisha Dixit037a5362021-03-22 14:13:03 +00001494
1495 // Show the widget resize frame.
1496 if (hostView instanceof LauncherAppWidgetHostView) {
1497 final LauncherAppWidgetHostView launcherHostView = (LauncherAppWidgetHostView) hostView;
Sunny Goyal669b71f2023-01-27 14:37:07 -08001498 CellLayout cellLayout = getCellLayout(launcherInfo.container, presenterPos.screenId);
Yogisha Dixit037a5362021-03-22 14:13:03 +00001499 if (mStateManager.getState() == NORMAL) {
Yogisha Dixit7b1d25b2021-10-14 13:06:40 +01001500 AppWidgetResizeFrame.showForWidget(launcherHostView, cellLayout);
Yogisha Dixit037a5362021-03-22 14:13:03 +00001501 } else {
1502 mStateManager.addStateListener(new StateManager.StateListener<LauncherState>() {
1503 @Override
1504 public void onStateTransitionComplete(LauncherState finalState) {
Charlie Anderson438d4052023-04-25 14:38:57 -04001505 if ((mPrevLauncherState == SPRING_LOADED || mPrevLauncherState == EDIT_MODE)
1506 && finalState == NORMAL) {
Yogisha Dixit037a5362021-03-22 14:13:03 +00001507 AppWidgetResizeFrame.showForWidget(launcherHostView, cellLayout);
1508 mStateManager.removeStateListener(this);
1509 }
1510 }
1511 });
1512 }
1513 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001514 }
Romain Guycbb89e42009-06-08 15:52:54 -07001515
Sunny Goyald5462aa2016-11-22 16:52:39 +05301516 private void prepareAppWidget(AppWidgetHostView hostView, LauncherAppWidgetInfo item) {
Sunny Goyal87af0fd2016-05-16 14:56:02 -07001517 hostView.setTag(item);
1518 item.onBindAppWidget(this, hostView);
Sunny Goyal87af0fd2016-05-16 14:56:02 -07001519 hostView.setFocusable(true);
1520 hostView.setOnFocusChangeListener(mFocusHandler);
Sunny Goyal25c2e3e2015-10-28 23:28:21 -07001521 }
1522
Sunny Goyala992ac92023-01-10 17:50:32 -08001523 private final ScreenOnListener mScreenOnListener = this::onScreenOnChanged;
Adam Cohended9f8d2010-11-03 13:25:16 -07001524
Sunny Goyal9c2b9602020-01-07 13:07:55 -08001525 private void updateNotificationDots(Predicate<PackageUserKey> updatedDots) {
Tony Wickhamf34bee82018-12-03 18:11:39 -08001526 mWorkspace.updateNotificationDots(updatedDots);
1527 mAppsView.getAppsStore().updateNotificationDots(updatedDots);
Tony Wickham010d2552017-01-20 08:15:28 -08001528 }
1529
Adam Cohended9f8d2010-11-03 13:25:16 -07001530 @Override
1531 public void onAttachedToWindow() {
1532 super.onAttachedToWindow();
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001533 mOverlayManager.onAttachedToWindow();
Adam Cohended9f8d2010-11-03 13:25:16 -07001534 }
1535
1536 @Override
1537 public void onDetachedFromWindow() {
1538 super.onDetachedFromWindow();
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001539 mOverlayManager.onDetachedFromWindow();
1540 closeContextMenu();
Adam Cohended9f8d2010-11-03 13:25:16 -07001541 }
1542
Schneider Victor-tulias25ecae12020-09-14 14:07:38 -07001543 @Override
1544 public Object onRetainNonConfigurationInstance() {
Sunny Goyal6c0c61a2020-12-08 19:19:56 -08001545 NonConfigInstance instance = new NonConfigInstance();
1546 instance.config = new Configuration(mOldConfig);
Sunny Goyal6c0c61a2020-12-08 19:19:56 -08001547 return instance;
Schneider Victor-tulias25ecae12020-09-14 14:07:38 -07001548 }
1549
Sihua Ma0593a0d2022-10-03 16:01:48 -07001550 protected LauncherWidgetHolder createAppWidgetHolder() {
Sihua Ma1db8bc22022-11-08 17:13:13 -08001551 return LauncherWidgetHolder.HolderFactory.newFactory(this).newInstance(
1552 this, appWidgetId -> getWorkspace().removeWidget(appWidgetId));
Cyrus Boadway0d309db2021-04-14 12:29:14 +00001553 }
1554
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001555 @Override
1556 protected void onNewIntent(Intent intent) {
Brian Isganitisfdd044e2023-03-02 19:45:23 +00001557 if (Utilities.isRunningInTestHarness()) {
vadimtbaf5fbb2019-12-16 18:56:09 -08001558 Log.d(TestProtocol.PERMANENT_DIAG_TAG, "Launcher.onNewIntent: " + intent);
1559 }
Sunny Goyal67736672023-06-02 13:35:19 +00001560 TraceHelper.INSTANCE.beginSection(ON_NEW_INTENT_EVT);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001561 super.onNewIntent(intent);
1562
Sunny Goyalf4aceab2017-12-06 16:16:31 -08001563 boolean alreadyOnHome = hasWindowFocus() && ((intent.getFlags() &
Winson15f8b172015-08-19 11:02:39 -07001564 Intent.FLAG_ACTIVITY_BROUGHT_TO_FRONT)
1565 != Intent.FLAG_ACTIVITY_BROUGHT_TO_FRONT);
Sunny Goyal85313732016-09-28 12:00:07 -07001566
1567 // Check this condition before handling isActionMain, as this will get reset.
Sunny Goyal3e3f44c2017-10-23 17:14:52 -07001568 boolean shouldMoveToDefaultScreen = alreadyOnHome && isInState(NORMAL)
Sunny Goyalf9403d92017-10-18 10:55:56 -07001569 && AbstractFloatingView.getTopOpenView(this) == null;
Winson15f8b172015-08-19 11:02:39 -07001570 boolean isActionMain = Intent.ACTION_MAIN.equals(intent.getAction());
Winson Chung1c2d5222021-06-08 11:50:13 -07001571 boolean internalStateHandled = ACTIVITY_TRACKER.handleNewIntent(this);
kholoud mohamedceec31b2022-02-03 15:44:25 +00001572
Winson15f8b172015-08-19 11:02:39 -07001573 if (isActionMain) {
Sunny Goyald3864fa2017-11-14 15:06:36 -08001574 if (!internalStateHandled) {
Sunny Goyald3864fa2017-11-14 15:06:36 -08001575 // In all these cases, only animate if we're already on home
Schneider Victor-tulias3913e292023-07-21 15:24:57 -07001576 AbstractFloatingView.closeAllOpenViewsExcept(
1577 this, isStarted(), AbstractFloatingView.TYPE_LISTENER);
Jon Mirandafeba90f2016-10-06 10:53:29 -07001578
Sunny Goyala2467272018-03-16 14:53:05 -07001579 if (!isInState(NORMAL)) {
1580 // Only change state, if not already the same. This prevents cancelling any
1581 // animations running as part of resume
Sunny Goyalfee1b252020-12-14 12:30:38 -08001582 mStateManager.goToState(NORMAL, mStateManager.shouldAnimateStateChange());
Sunny Goyala2467272018-03-16 14:53:05 -07001583 }
Sunny Goyald3864fa2017-11-14 15:06:36 -08001584
1585 // Reset the apps view
Sunny Goyal5d1873a2018-05-08 11:10:44 -07001586 if (!alreadyOnHome) {
Sunny Goyal7185dd62018-03-14 17:51:49 -07001587 mAppsView.reset(isStarted() /* animate */);
Sunny Goyald3864fa2017-11-14 15:06:36 -08001588 }
1589
Sunny Goyalaad33592018-08-07 17:20:35 -07001590 if (shouldMoveToDefaultScreen && !mWorkspace.isHandlingTouch()) {
Sunny Goyald3864fa2017-11-14 15:06:36 -08001591 mWorkspace.post(mWorkspace::moveToDefaultScreen);
1592 }
1593 }
Adam Cohen6fecd412013-10-02 17:41:50 -07001594
Vinit Nayaka1be4c12023-10-24 16:57:39 -07001595 if (FeatureFlags.enableSplitContextually()) {
Vinit Nayakf6c2e872023-07-07 13:37:24 -07001596 handleSplitAnimationGoingToHome();
1597 }
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001598 mOverlayManager.hideOverlay(isStarted() && !isForceInvisible());
Sunny Goyal30ac97d2020-06-24 23:47:46 -07001599 handleGestureContract(intent);
Sunny Goyal512a2c12020-04-08 12:52:45 -07001600 } else if (Intent.ACTION_ALL_APPS.equals(intent.getAction())) {
Winson Chungdd15ace2020-08-04 15:52:01 -07001601 showAllAppsFromIntent(alreadyOnHome);
Tracy Zhoucb93ec52023-03-31 22:51:17 -07001602 } else if (INTENT_ACTION_ALL_APPS_TOGGLE.equals(intent.getAction())) {
1603 toggleAllAppsFromIntent(alreadyOnHome);
kholoud mohamedceec31b2022-02-03 15:44:25 +00001604 } else if (Intent.ACTION_SHOW_WORK_APPS.equals(intent.getAction())) {
1605 showAllAppsWorkTabFromIntent(alreadyOnHome);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001606 }
Winson15f8b172015-08-19 11:02:39 -07001607
Sunny Goyal67736672023-06-02 13:35:19 +00001608 TraceHelper.INSTANCE.endSection();
Adam Coppa120b8e2013-11-12 16:26:04 +00001609 }
1610
Vinit Nayakf6c2e872023-07-07 13:37:24 -07001611 /** Handle animating away split placeholder view when user taps on home button */
1612 protected void handleSplitAnimationGoingToHome() {
1613 // Overridden
1614 }
1615
Tracy Zhoucb93ec52023-03-31 22:51:17 -07001616 protected void toggleAllAppsFromIntent(boolean alreadyOnHome) {
1617 if (getStateManager().isInStableState(ALL_APPS)) {
1618 getStateManager().goToState(NORMAL, alreadyOnHome);
1619 } else {
Anushree Ganjamb7369822023-11-06 18:00:12 -08001620 if (mWorkspace.isOverlayShown()) {
1621 mOverlayManager.hideOverlay(/* animate */true);
1622 }
Holly Sund9d70ea2023-09-05 13:14:22 -07001623 AbstractFloatingView.closeAllOpenViews(this);
1624 getStateManager().goToState(ALL_APPS, true /* animated */,
1625 new AnimationSuccessListener() {
1626 @Override
1627 public void onAnimationSuccess(Animator animator) {
1628 if (mAppsView.getSearchUiManager().getEditText() != null) {
1629 mAppsView.getSearchUiManager().getEditText().requestFocus();
1630 }
1631 }
1632 });
Tracy Zhoucb93ec52023-03-31 22:51:17 -07001633 }
1634 }
1635
Winson Chungdd15ace2020-08-04 15:52:01 -07001636 protected void showAllAppsFromIntent(boolean alreadyOnHome) {
1637 AbstractFloatingView.closeAllOpenViews(this);
1638 getStateManager().goToState(ALL_APPS, alreadyOnHome);
1639 }
1640
kholoud mohamedceec31b2022-02-03 15:44:25 +00001641 private void showAllAppsWorkTabFromIntent(boolean alreadyOnHome) {
1642 showAllAppsFromIntent(alreadyOnHome);
Sunny Goyal34c499d2023-01-24 12:43:18 -08001643 mAppsView.switchToTab(ActivityAllAppsContainerView.AdapterHolder.WORK);
kholoud mohamedceec31b2022-02-03 15:44:25 +00001644 }
1645
Sunny Goyaldeb91c42020-03-24 02:17:59 -07001646 /**
Sunny Goyal30ac97d2020-06-24 23:47:46 -07001647 * Handles gesture nav contract
1648 */
1649 protected void handleGestureContract(Intent intent) {
1650 GestureNavContract gnc = GestureNavContract.fromIntent(intent);
1651 if (gnc != null) {
1652 AbstractFloatingView.closeOpenViews(this, false, TYPE_ICON_SURFACE);
1653 FloatingSurfaceView.show(this, gnc);
1654 }
1655 }
1656
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001657 @Override
Adam Cohen1462de32012-07-24 22:34:36 -07001658 public void onRestoreInstanceState(Bundle state) {
1659 super.onRestoreInstanceState(state);
Sebastian Franco69fd7422023-10-06 16:48:58 -07001660 IntSet synchronouslyBoundPages = mModelCallbacks.getSynchronouslyBoundPages();
1661 if (synchronouslyBoundPages != null) {
1662 synchronouslyBoundPages.forEach(screenId -> {
Sunny Goyal12e3f1f2021-07-15 14:31:58 -07001663 int pageIndex = mWorkspace.getPageIndexForScreenId(screenId);
1664 if (pageIndex != PagedView.INVALID_PAGE) {
1665 mWorkspace.restoreInstanceStateForChild(pageIndex);
1666 }
1667 });
Andras Kloczl55edfe52021-05-14 12:21:30 +02001668 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001669 }
1670
1671 @Override
1672 protected void onSaveInstanceState(Bundle outState) {
Sunny Goyal12e3f1f2021-07-15 14:31:58 -07001673 outState.putIntArray(RUNTIME_STATE_CURRENT_SCREEN_IDS,
1674 mWorkspace.getCurrentPageScreenIds().getArray().toArray());
Sunny Goyalea609262017-10-25 15:47:38 -07001675 outState.putInt(RUNTIME_STATE, mStateManager.getState().ordinal);
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -07001676
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -07001677 AbstractFloatingView widgets = AbstractFloatingView
1678 .getOpenView(this, AbstractFloatingView.TYPE_WIDGETS_FULL_SHEET);
1679 if (widgets != null) {
1680 SparseArray<Parcelable> widgetsState = new SparseArray<>();
1681 widgets.saveHierarchyState(widgetsState);
1682 outState.putSparseParcelableArray(RUNTIME_STATE_WIDGET_PANEL, widgetsState);
1683 } else {
1684 outState.remove(RUNTIME_STATE_WIDGET_PANEL);
1685 }
1686
Federico Baron8bf1bca2022-09-27 16:19:11 -07001687 // We close any open folders and shortcut containers that are not safe for rebind,
1688 // and we need to make sure this state is reflected.
1689 AbstractFloatingView.closeAllOpenViewsExcept(
1690 this, isStarted() && !isForceInvisible(), TYPE_REBIND_SAFE);
Pinyao Tinga74b63a2019-07-17 23:26:06 -07001691 finishAutoCancelActionMode();
Tony Wickham49c8d292016-07-01 11:44:34 -07001692
Sunny Goyal2100c782016-08-22 16:00:03 -07001693 if (mPendingRequestArgs != null) {
1694 outState.putParcelable(RUNTIME_STATE_PENDING_REQUEST_ARGS, mPendingRequestArgs);
1695 }
Sunny Goyaldedda052019-05-14 15:23:48 -07001696 outState.putInt(RUNTIME_STATE_PENDING_REQUEST_CODE, mPendingActivityRequestCode);
1697
Sunny Goyal2100c782016-08-22 16:00:03 -07001698 if (mPendingActivityResult != null) {
1699 outState.putParcelable(RUNTIME_STATE_PENDING_ACTIVITY_RESULT, mPendingActivityResult);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001700 }
1701
Sunny Goyalf1fbc3f2017-10-10 15:21:15 -07001702 super.onSaveInstanceState(outState);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001703 }
1704
1705 @Override
1706 public void onDestroy() {
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001707 super.onDestroy();
Sunny Goyale84c5b82019-09-26 17:05:31 -07001708 ACTIVITY_TRACKER.onActivityDestroyed(this);
Romain Guycbb89e42009-06-08 15:52:54 -07001709
Tracy Zhoude8e25c2023-10-07 00:00:57 -07001710 SettingsCache.INSTANCE.get(this).unregister(TOUCHPAD_NATURAL_SCROLLING,
1711 mNaturalScrollingChangedListener);
Sunny Goyala992ac92023-01-10 17:50:32 -08001712 ScreenOnTracker.INSTANCE.get(this).removeListener(mScreenOnListener);
Sunny Goyalaaf7d1d2016-05-17 13:38:54 -07001713 mWorkspace.removeFolderListeners();
Sunny Goyalb1d7de22019-09-06 10:36:54 -07001714 PluginManagerWrapper.INSTANCE.get(this).removePluginListener(this);
Winson Chunge7a03942011-08-05 15:05:12 -07001715
Sunny Goyala7a5bf32020-01-05 15:35:29 +05301716 mModel.removeCallbacks(this);
Sunny Goyal623eddd2018-03-02 12:24:41 -08001717 mRotationHelper.destroy();
Sunny Goyal745bad92016-05-02 10:54:12 -07001718
Sunny Goyal4df719a2024-01-03 19:31:32 -08001719 mAppWidgetHolder.stopListening();
Sihua Maaa2b8722022-10-25 15:17:58 -07001720 mAppWidgetHolder.destroy();
Patrick Dubroy2313eff2011-01-11 20:01:31 -08001721
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001722 TextKeyListener.getInstance().release();
Sebastian Francoe4965122023-12-01 13:27:42 -06001723 mModelCallbacks.clearPendingBinds();
Hyunyoung Song31971a32019-01-27 12:31:12 -08001724 LauncherAppState.getIDP(this).removeOnChangeListener(this);
Fengjiang Li17720f12023-12-07 11:03:11 -08001725 // if Launcher activity is recreated, {@link Window} including {@link ViewTreeObserver}
1726 // could be preserved in {@link ActivityThread#scheduleRelaunchActivity(IBinder)} if the
1727 // previous activity has not stopped, which could happen when wallpaper detects a color
1728 // changes while launcher is still loading.
1729 getRootView().getViewTreeObserver().removeOnPreDrawListener(mOnInitialBindListener);
Sunny Goyale82a20a2023-10-19 13:52:49 -07001730 mOverlayManager.onActivityDestroyed();
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001731 }
1732
Sunny Goyalae502842016-06-17 08:43:56 -07001733 public LauncherAccessibilityDelegate getAccessibilityDelegate() {
1734 return mAccessibilityDelegate;
1735 }
1736
Adam Cohena9cf38f2011-05-02 15:36:58 -07001737 public DragController getDragController() {
1738 return mDragController;
1739 }
1740
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001741 @Override
Andrew Cole44898c32023-04-05 13:49:32 -07001742 public DropTargetHandler getDropTargetHandler() {
1743 return new DropTargetHandler(this);
1744 }
1745
1746 @Override
Sunny Goyal0eca4e22016-07-20 11:43:06 -07001747 public void startActivityForResult(Intent intent, int requestCode, Bundle options) {
Sunny Goyaldedda052019-05-14 15:23:48 -07001748 if (requestCode != -1) {
1749 mPendingActivityRequestCode = requestCode;
1750 }
Sunny Goyal210e1742019-10-17 12:05:38 -07001751 super.startActivityForResult(intent, requestCode, options);
Adam Cohen173f7112015-03-27 15:14:00 -07001752 }
1753
1754 @Override
Sunny Goyaldedda052019-05-14 15:23:48 -07001755 public void startIntentSenderForResult(IntentSender intent, int requestCode,
Adam Cohen173f7112015-03-27 15:14:00 -07001756 Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags, Bundle options) {
Sunny Goyaldedda052019-05-14 15:23:48 -07001757 if (requestCode != -1) {
1758 mPendingActivityRequestCode = requestCode;
1759 }
Sunny Goyal210e1742019-10-17 12:05:38 -07001760 try {
1761 super.startIntentSenderForResult(intent, requestCode,
1762 fillInIntent, flagsMask, flagsValues, extraFlags, options);
Sunny Goyale82a20a2023-10-19 13:52:49 -07001763 } catch (Exception e) {
Sunny Goyal210e1742019-10-17 12:05:38 -07001764 throw new ActivityNotFoundException();
Adam Cohen173f7112015-03-27 15:14:00 -07001765 }
1766 }
1767
Sunny Goyal2100c782016-08-22 16:00:03 -07001768 void addAppWidgetFromDropImpl(int appWidgetId, ItemInfo info, AppWidgetHostView boundWidget,
Sunny Goyal04a324a2017-01-20 21:08:59 -08001769 WidgetAddFlowHandler addFlowHandler) {
Tony Wickhama0628cc2015-10-14 15:23:04 -07001770 if (LOGD) {
1771 Log.d(TAG, "Adding widget from drop");
1772 }
Sunny Goyal04a324a2017-01-20 21:08:59 -08001773 addAppWidgetImpl(appWidgetId, info, boundWidget, addFlowHandler, 0);
Adam Cohenad4e15c2013-10-17 16:21:35 -07001774 }
1775
Sunny Goyal2100c782016-08-22 16:00:03 -07001776 void addAppWidgetImpl(int appWidgetId, ItemInfo info,
Sunny Goyal04a324a2017-01-20 21:08:59 -08001777 AppWidgetHostView boundWidget, WidgetAddFlowHandler addFlowHandler, int delay) {
Samuel Fufaca37b8a2019-08-19 17:04:36 -07001778 if (!addFlowHandler.startConfigActivity(this, appWidgetId, info,
1779 REQUEST_CREATE_APPWIDGET)) {
Sunny Goyal04a324a2017-01-20 21:08:59 -08001780 // If the configuration flow was not started, add the widget
Michael Jurkaaf442092010-06-10 17:01:57 -07001781
Charlie Anderson438d4052023-04-25 14:38:57 -04001782 // Exit spring loaded mode if necessary after adding the widget
1783 Runnable onComplete = MULTI_SELECT_EDIT_MODE.get() ? null
1784 : () -> mStateManager.goToState(NORMAL, SPRING_LOADED_EXIT_DELAY);
Samuel Fufaca37b8a2019-08-19 17:04:36 -07001785 completeAddAppWidget(appWidgetId, info, boundWidget,
1786 addFlowHandler.getProviderInfo(this));
Sunny Goyal6e379fc2020-03-19 16:08:14 -07001787 mWorkspace.removeExtraEmptyScreenDelayed(delay, false, onComplete);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001788 }
1789 }
Romain Guycbb89e42009-06-08 15:52:54 -07001790
Sunny Goyalefb7e842018-10-04 15:11:00 -07001791 public void addPendingItem(PendingAddItemInfo info, int container, int screenId,
Sunny Goyal71b5c0b2015-01-08 16:59:04 -08001792 int[] cell, int spanX, int spanY) {
Sunny Goyal669b71f2023-01-27 14:37:07 -08001793 if (cell == null) {
1794 CellPos modelPos = getCellPosMapper().mapPresenterToModel(0, 0, screenId, container);
1795 info.screenId = modelPos.screenId;
1796 } else {
1797 CellPos modelPos = getCellPosMapper().mapPresenterToModel(
1798 cell[0], cell[1], screenId, container);
1799 info.screenId = modelPos.screenId;
1800 info.cellX = modelPos.cellX;
1801 info.cellY = modelPos.cellY;
Sunny Goyal2100c782016-08-22 16:00:03 -07001802 }
Sunny Goyal669b71f2023-01-27 14:37:07 -08001803 info.container = container;
Sunny Goyal2100c782016-08-22 16:00:03 -07001804 info.spanX = spanX;
1805 info.spanY = spanY;
1806
Holly Sun35b99602023-06-28 15:14:02 -07001807 if (info instanceof PendingAddWidgetInfo) {
1808 addAppWidgetFromDrop((PendingAddWidgetInfo) info);
1809 } else { // info can only be PendingAddShortcutInfo
1810 processShortcutFromDrop((PendingAddShortcutInfo) info);
Samuel Fufaca37b8a2019-08-19 17:04:36 -07001811 }
Sunny Goyal71b5c0b2015-01-08 16:59:04 -08001812 }
1813
Adam Cohenfbba09b2011-07-18 21:43:05 -07001814 /**
1815 * Process a shortcut drop.
Adam Cohenfbba09b2011-07-18 21:43:05 -07001816 */
Sunny Goyal782f0c92017-01-19 10:27:54 -08001817 private void processShortcutFromDrop(PendingAddShortcutInfo info) {
Sunny Goyalfb5096d2016-09-08 14:32:06 -07001818 Intent intent = new Intent(Intent.ACTION_CREATE_SHORTCUT).setComponent(info.componentName);
1819 setWaitingForResult(PendingRequestArgs.forIntent(REQUEST_CREATE_SHORTCUT, intent, info));
vadimtcf275c12020-04-15 12:43:01 -07001820 TestLogging.recordEvent(TestProtocol.SEQUENCE_MAIN, "start: processShortcutFromDrop");
Sunny Goyal239d6e92023-02-07 13:40:11 -08001821 if (!info.getActivityInfo(this).startConfigActivity(this, REQUEST_CREATE_SHORTCUT)) {
Sunny Goyal782f0c92017-01-19 10:27:54 -08001822 handleActivityResult(REQUEST_CREATE_SHORTCUT, RESULT_CANCELED, null);
1823 }
Michael Jurka0280c3b2010-09-17 15:00:07 -07001824 }
1825
Adam Cohenfbba09b2011-07-18 21:43:05 -07001826 /**
1827 * Process a widget drop.
Adam Cohenfbba09b2011-07-18 21:43:05 -07001828 */
Sunny Goyal2100c782016-08-22 16:00:03 -07001829 private void addAppWidgetFromDrop(PendingAddWidgetInfo info) {
Adam Cohened66b2b2012-01-23 17:28:51 -08001830 AppWidgetHostView hostView = info.boundWidget;
Sunny Goyal952e63d2017-08-16 04:59:08 -07001831 final int appWidgetId;
Sunny Goyal8a0dc382017-01-25 11:30:06 -08001832 WidgetAddFlowHandler addFlowHandler = info.getHandler();
Adam Cohened66b2b2012-01-23 17:28:51 -08001833 if (hostView != null) {
Tony Wickhama0628cc2015-10-14 15:23:04 -07001834 // In the case where we've prebound the widget, we remove it from the DragLayer
1835 if (LOGD) {
1836 Log.d(TAG, "Removing widget view from drag layer and setting boundWidget to null");
1837 }
1838 getDragLayer().removeView(hostView);
1839
Adam Cohened66b2b2012-01-23 17:28:51 -08001840 appWidgetId = hostView.getAppWidgetId();
Sunny Goyal04a324a2017-01-20 21:08:59 -08001841 addAppWidgetFromDropImpl(appWidgetId, info, hostView, addFlowHandler);
Sunny Goyal5b9ebca2015-06-01 18:37:32 -07001842
1843 // Clear the boundWidget so that it doesn't get destroyed.
1844 info.boundWidget = null;
Adam Cohened66b2b2012-01-23 17:28:51 -08001845 } else {
Adam Cohen9d5b7d82012-05-09 18:00:44 -07001846 // In this case, we either need to start an activity to get permission to bind
1847 // the widget, or we need to start an activity to configure the widget, or both.
Pinyao Tingc7a6c292019-08-26 14:36:02 -07001848 if (info.itemType == LauncherSettings.Favorites.ITEM_TYPE_CUSTOM_APPWIDGET) {
fbaron30d9e3f2023-08-03 17:03:59 -07001849 appWidgetId = CustomWidgetManager.INSTANCE.get(this)
1850 .allocateCustomAppWidgetId(info.componentName);
Sunny Goyal952e63d2017-08-16 04:59:08 -07001851 } else {
Sihua Ma0593a0d2022-10-03 16:01:48 -07001852 appWidgetId = getAppWidgetHolder().allocateAppWidgetId();
Sunny Goyal952e63d2017-08-16 04:59:08 -07001853 }
Adam Cohendd70d662012-10-04 16:53:44 -07001854 Bundle options = info.bindOptions;
1855
Sunny Goyalffe83f12014-08-14 17:39:34 -07001856 boolean success = mAppWidgetManager.bindAppWidgetIdIfAllowed(
1857 appWidgetId, info.info, options);
Adam Cohendd70d662012-10-04 16:53:44 -07001858 if (success) {
Sunny Goyal04a324a2017-01-20 21:08:59 -08001859 addAppWidgetFromDropImpl(appWidgetId, info, null, addFlowHandler);
Michael Jurka8b805b12012-04-18 14:23:14 -07001860 } else {
Sunny Goyal04a324a2017-01-20 21:08:59 -08001861 addFlowHandler.startBindFlow(this, appWidgetId, info, REQUEST_BIND_APPWIDGET);
Michael Jurka8b805b12012-04-18 14:23:14 -07001862 }
Adam Cohened66b2b2012-01-23 17:28:51 -08001863 }
Adam Cohenfbba09b2011-07-18 21:43:05 -07001864 }
1865
Samuel Fufa746d4202020-02-02 18:55:44 -08001866 /**
1867 * Creates and adds new folder to CellLayout
1868 */
Samuel Fufa28c3e452020-02-08 16:07:16 -08001869 public FolderIcon addFolder(CellLayout layout, int container, final int screenId, int cellX,
1870 int cellY) {
Michael Jurkac9d95c52011-08-29 14:03:34 -07001871 final FolderInfo folderInfo = new FolderInfo();
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001872
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001873 // Update the model
Sunny Goyal43bf11d2017-02-02 13:52:53 -08001874 getModelWriter().addItemToDatabase(folderInfo, container, screenId, cellX, cellY);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001875
1876 // Create the view
Samuel Fufa746d4202020-02-02 18:55:44 -08001877 FolderIcon newFolder = FolderIcon.inflateFolderAndIcon(R.layout.folder_icon, this, layout,
1878 folderInfo);
Sunny Goyald5462aa2016-11-22 16:52:39 +05301879 mWorkspace.addInScreen(newFolder, folderInfo);
Winson Chung5f8afe62013-08-12 16:19:28 -07001880 // Force measure the new folder icon
1881 CellLayout parent = mWorkspace.getParentCellLayoutForView(newFolder);
1882 parent.getShortcutsAndWidgets().measureChild(newFolder);
Adam Cohendf035382011-04-11 17:22:04 -07001883 return newFolder;
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001884 }
Romain Guycbb89e42009-06-08 15:52:54 -07001885
Tony Wickham1906cc32021-02-11 11:55:24 -08001886 @Override
1887 public Rect getFolderBoundingBox() {
1888 // We need to bound the folder to the currently visible workspace area
Andras Kloczl3a4ba0b2021-03-29 18:47:14 +02001889 return getWorkspace().getPageAreaRelativeToDragLayer();
Tony Wickham1906cc32021-02-11 11:55:24 -08001890 }
1891
1892 @Override
1893 public void updateOpenFolderPosition(int[] inOutPosition, Rect bounds, int width, int height) {
1894 int left = inOutPosition[0];
1895 int top = inOutPosition[1];
1896 DeviceProfile grid = getDeviceProfile();
1897 int distFromEdgeOfScreen = getWorkspace().getPaddingLeft();
1898 if (grid.isPhone && (grid.availableWidthPx - width) < 4 * distFromEdgeOfScreen) {
1899 // Center the folder if it is very close to being centered anyway, by virtue of
1900 // filling the majority of the viewport. ie. remove it from the uncanny valley
1901 // of centeredness.
1902 left = (grid.availableWidthPx - width) / 2;
1903 } else if (width >= bounds.width()) {
1904 // If the folder doesn't fit within the bounds, center it about the desired bounds
1905 left = bounds.left + (bounds.width() - width) / 2;
1906 }
1907 if (height >= bounds.height()) {
1908 // Folder height is greater than page height, center on page
1909 top = bounds.top + (bounds.height() - height) / 2;
1910 } else {
1911 // Folder height is less than page height, so bound it to the absolute open folder
1912 // bounds if necessary
1913 Rect folderBounds = grid.getAbsoluteOpenFolderBounds();
1914 left = Math.max(folderBounds.left, Math.min(left, folderBounds.right - width));
1915 top = Math.max(folderBounds.top, Math.min(top, folderBounds.bottom - height));
1916 }
1917 inOutPosition[0] = left;
1918 inOutPosition[1] = top;
1919 }
1920
Winsonc0b52fe2015-09-09 16:38:15 -07001921 /**
Winsonfa56b3f2015-09-14 12:01:13 -07001922 * Unbinds the view for the specified item, and removes the item and all its children.
1923 *
1924 * @param v the view being removed.
Winsonfa56b3f2015-09-14 12:01:13 -07001925 * @param itemInfo the {@link ItemInfo} for this view.
1926 * @param deleteFromDb whether or not to delete this item from the db.
Winsonc0b52fe2015-09-09 16:38:15 -07001927 */
Tony Wickhambfbf7f92016-05-19 11:19:39 -07001928 public boolean removeItem(View v, final ItemInfo itemInfo, boolean deleteFromDb) {
Pinyao Ting6a41d562022-05-10 23:47:36 +00001929 return removeItem(v, itemInfo, deleteFromDb, null);
1930 }
1931
1932 /**
1933 * Unbinds the view for the specified item, and removes the item and all its children.
1934 *
1935 * @param v the view being removed.
1936 * @param itemInfo the {@link ItemInfo} for this view.
1937 * @param deleteFromDb whether or not to delete this item from the db.
1938 * @param reason the resaon for removal.
1939 */
1940 public boolean removeItem(View v, final ItemInfo itemInfo, boolean deleteFromDb,
1941 @Nullable final String reason) {
Sunny Goyal95899162019-03-27 16:03:06 -07001942 if (itemInfo instanceof WorkspaceItemInfo) {
Winsonfa56b3f2015-09-14 12:01:13 -07001943 // Remove the shortcut from the folder before removing it from launcher
Sunny Goyal44c06432016-04-02 10:56:02 -07001944 View folderIcon = mWorkspace.getHomescreenIconByItemId(itemInfo.container);
1945 if (folderIcon instanceof FolderIcon) {
Sunny Goyal95899162019-03-27 16:03:06 -07001946 ((FolderInfo) folderIcon.getTag()).remove((WorkspaceItemInfo) itemInfo, true);
Winsonfa56b3f2015-09-14 12:01:13 -07001947 } else {
1948 mWorkspace.removeWorkspaceItem(v);
1949 }
Winsonc0b52fe2015-09-09 16:38:15 -07001950 if (deleteFromDb) {
Pinyao Ting6a41d562022-05-10 23:47:36 +00001951 getModelWriter().deleteItemFromDatabase(itemInfo, reason);
Winsonc0b52fe2015-09-09 16:38:15 -07001952 }
1953 } else if (itemInfo instanceof FolderInfo) {
1954 final FolderInfo folderInfo = (FolderInfo) itemInfo;
Sunny Goyalaaf7d1d2016-05-17 13:38:54 -07001955 if (v instanceof FolderIcon) {
1956 ((FolderIcon) v).removeListeners();
1957 }
Winsonc0b52fe2015-09-09 16:38:15 -07001958 mWorkspace.removeWorkspaceItem(v);
1959 if (deleteFromDb) {
Sunny Goyal43bf11d2017-02-02 13:52:53 -08001960 getModelWriter().deleteFolderAndContentsFromDatabase(folderInfo);
Winsonc0b52fe2015-09-09 16:38:15 -07001961 }
1962 } else if (itemInfo instanceof LauncherAppWidgetInfo) {
1963 final LauncherAppWidgetInfo widgetInfo = (LauncherAppWidgetInfo) itemInfo;
Winson44818e02015-10-02 11:25:46 -07001964 mWorkspace.removeWorkspaceItem(v);
Winsonc0b52fe2015-09-09 16:38:15 -07001965 if (deleteFromDb) {
Sihua Ma0593a0d2022-10-03 16:01:48 -07001966 getModelWriter().deleteWidgetInfo(widgetInfo, getAppWidgetHolder(), reason);
Winsonc0b52fe2015-09-09 16:38:15 -07001967 }
1968 } else {
1969 return false;
1970 }
1971 return true;
1972 }
1973
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001974 @Override
1975 public boolean dispatchKeyEvent(KeyEvent event) {
vadimt6b534ee2021-08-06 15:49:02 -07001976 TestLogging.recordKeyEvent(TestProtocol.SEQUENCE_MAIN, "Key event", event);
Hyunyoung Song3c7d9cb2017-01-30 15:11:27 -08001977 return (event.getKeyCode() == KeyEvent.KEYCODE_HOME) || super.dispatchKeyEvent(event);
The Android Open Source Project31dd5032009-03-03 19:32:27 -08001978 }
1979
Joe Onorato88ec0992009-11-19 13:16:06 -08001980 @Override
vadimt9af34a72020-01-21 11:19:13 -08001981 public boolean dispatchTouchEvent(MotionEvent ev) {
Sunny Goyala306e592020-03-24 01:51:41 -07001982 switch (ev.getAction()) {
1983 case MotionEvent.ACTION_DOWN:
1984 mTouchInProgress = true;
1985 break;
1986 case MotionEvent.ACTION_UP:
Riddle Hsub30adcb2020-10-07 15:57:44 +08001987 mLastTouchUpTime = SystemClock.uptimeMillis();
Sunny Goyala306e592020-03-24 01:51:41 -07001988 // Follow through
1989 case MotionEvent.ACTION_CANCEL:
1990 mTouchInProgress = false;
1991 break;
Sunny Goyal9b180102020-03-11 10:02:29 -07001992 }
vadimtd633c9c2020-01-22 18:00:37 -08001993 TestLogging.recordMotionEvent(TestProtocol.SEQUENCE_MAIN, "Touch event", ev);
vadimt9af34a72020-01-21 11:19:13 -08001994 return super.dispatchTouchEvent(ev);
1995 }
1996
1997 @Override
Fengjiang Lib7860bd2023-03-15 10:50:50 -07001998 @TargetApi(Build.VERSION_CODES.UPSIDE_DOWN_CAKE)
Joe Onorato88ec0992009-11-19 13:16:06 -08001999 public void onBackPressed() {
Fengjiang Lib7860bd2023-03-15 10:50:50 -07002000 getOnBackAnimationCallback().onBackInvoked();
Joe Onorato88ec0992009-11-19 13:16:06 -08002001 }
2002
Sunny Goyal3f2637f2022-05-05 12:24:08 -07002003 protected void onStateBack() {
2004 mStateManager.getState().onBackPressed(this);
2005 }
2006
Sunny Goyala992ac92023-01-10 17:50:32 -08002007 protected void onScreenOnChanged(boolean isOn) {
Tracy Zhouf20a4bd2021-04-19 21:37:08 -07002008 // Reset AllApps to its initial state only if we are not in the middle of
2009 // processing a multi-step drop
Sunny Goyala992ac92023-01-10 17:50:32 -08002010 if (!isOn && mPendingRequestArgs == null) {
Tracy Zhouf20a4bd2021-04-19 21:37:08 -07002011 if (!isInState(NORMAL)) {
2012 onUiChangedWhileSleeping();
2013 }
2014 mStateManager.goToState(NORMAL);
2015 }
2016 }
2017
Hyunyoung Song46d07f72018-05-22 15:41:25 -07002018 @Override
Sunny Goyal4fdc9182023-05-12 12:08:53 -07002019 public RunnableList startActivitySafely(View v, Intent intent, ItemInfo item) {
Winson Chung0b70cd42019-06-17 22:34:33 -07002020 if (!hasBeenResumed()) {
Sunny Goyal4fdc9182023-05-12 12:08:53 -07002021 RunnableList result = new RunnableList();
Winson Chung0b70cd42019-06-17 22:34:33 -07002022 // Workaround an issue where the WM launch animation is clobbered when finishing the
2023 // recents animation into launcher. Defer launching the activity until Launcher is
2024 // next resumed.
Sunny Goyale82a20a2023-10-19 13:52:49 -07002025 addEventCallback(EVENT_RESUMED, () -> {
Sunny Goyal4fdc9182023-05-12 12:08:53 -07002026 RunnableList actualResult = startActivitySafely(v, intent, item);
2027 if (actualResult != null) {
2028 actualResult.add(result::executeAllAndDestroy);
2029 } else {
2030 result.executeAllAndDestroy();
2031 }
2032 });
Winson Chungc9bf6d42019-10-04 15:33:18 -07002033 if (mOnDeferredActivityLaunchCallback != null) {
2034 mOnDeferredActivityLaunchCallback.run();
2035 mOnDeferredActivityLaunchCallback = null;
2036 }
Sunny Goyal4fdc9182023-05-12 12:08:53 -07002037 return result;
Winson Chung0b70cd42019-06-17 22:34:33 -07002038 }
2039
Sunny Goyal4fdc9182023-05-12 12:08:53 -07002040 RunnableList result = super.startActivitySafely(v, intent, item);
2041 if (result != null && v instanceof BubbleTextView) {
Sunny Goyal0b0847b2018-03-14 12:30:11 -07002042 // This is set to the view that launched the activity that navigated the user away
2043 // from launcher. Since there is no callback for when the activity has finished
2044 // launching, enable the press state and keep this reference to reset the press
2045 // state when we return to launcher.
2046 BubbleTextView btv = (BubbleTextView) v;
2047 btv.setStayPressed(true);
Sunny Goyal4fdc9182023-05-12 12:08:53 -07002048 result.add(() -> btv.setStayPressed(false));
Sunny Goyala7ce1662016-05-31 15:01:35 -07002049 }
Sunny Goyal4fdc9182023-05-12 12:08:53 -07002050 return result;
Michael Jurka86a720e2012-05-09 11:23:23 -07002051 }
2052
Winson Chung3d503fb2011-07-13 17:25:49 -07002053 boolean isHotseatLayout(View layout) {
Sunny Goyalc13403c2016-11-18 23:44:48 -08002054 // TODO: Remove this method
Sunny Goyal876e4622018-11-02 13:50:40 -07002055 return mHotseat != null && (layout == mHotseat);
Winson Chung3d503fb2011-07-13 17:25:49 -07002056 }
Romain Guy1fbc1c82009-11-09 20:43:08 -08002057
Michael Jurkae326f182011-11-21 14:05:46 -08002058 @Override
2059 public void onTrimMemory(int level) {
2060 super.onTrimMemory(level);
Adam Cohen3f9c9712014-10-31 11:48:25 -07002061 if (level >= ComponentCallbacks2.TRIM_MEMORY_UI_HIDDEN) {
2062 // The widget preview db can result in holding onto over
2063 // 3MB of memory for caching which isn't necessary.
2064 SQLiteDatabase.releaseMemory();
2065
Adam Cohenc8f4e1b2014-11-19 16:03:20 -08002066 // This clears all widget bitmaps from the widget tray
Hyunyoung Song3f471442015-04-08 19:01:34 -07002067 // TODO(hyunyoungs)
Michael Jurkae326f182011-11-21 14:05:46 -08002068 }
2069 }
2070
Michael Jurkad7c28052012-04-27 15:43:36 -07002071 @Override
2072 public boolean dispatchPopulateAccessibilityEvent(AccessibilityEvent event) {
alanv1d4fde62012-10-17 13:15:47 -07002073 final boolean result = super.dispatchPopulateAccessibilityEvent(event);
Michael Jurkad7c28052012-04-27 15:43:36 -07002074 final List<CharSequence> text = event.getText();
2075 text.clear();
alanv1d4fde62012-10-17 13:15:47 -07002076 // Populate event with a fake title based on the current state.
Sunny Goyal3e3f44c2017-10-23 17:14:52 -07002077 // TODO: When can workspace be null?
2078 text.add(mWorkspace == null
Sunny Goyal52e25452020-07-20 12:38:01 -07002079 ? getString(R.string.home_screen)
Sunny Goyalea609262017-10-25 15:47:38 -07002080 : mStateManager.getState().getDescription(this));
Michael Jurkad7c28052012-04-27 15:43:36 -07002081 return result;
2082 }
2083
Sunny Goyal93f878c2016-03-30 17:31:24 -07002084 @Override
Sunny Goyal12e3f1f2021-07-15 14:31:58 -07002085 public IntSet getPagesToBindSynchronously(IntArray orderedScreenIds) {
Sebastian Franco69fd7422023-10-06 16:48:58 -07002086 return mModelCallbacks.getPagesToBindSynchronously(orderedScreenIds);
Joe Onorato9c1289c2009-08-17 11:03:03 -04002087 }
The Android Open Source Projectf96811c2009-03-18 17:39:48 -07002088
Liran Binyamina833af32023-08-02 16:30:27 -04002089 @Override
Joe Onorato9c1289c2009-08-17 11:03:03 -04002090 public void startBinding() {
Sebastian Francoe4965122023-12-01 13:27:42 -06002091 mModelCallbacks.startBinding();
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002092 }
2093
Adam Cohendcd297f2013-06-18 13:13:40 -07002094 @Override
fbaronc0e687b2023-10-04 12:11:20 -07002095 public void setIsFirstPagePinnedItemEnabled(boolean isFirstPagePinnedItemEnabled) {
Sebastian Franco6dda7c72023-11-17 18:03:00 -06002096 mModelCallbacks.setIsFirstPagePinnedItemEnabled(isFirstPagePinnedItemEnabled);
fbaronc0e687b2023-10-04 12:11:20 -07002097 }
2098
2099 @Override
Sunny Goyalefb7e842018-10-04 15:11:00 -07002100 public void bindScreens(IntArray orderedScreenIds) {
Sebastian Franco6dda7c72023-11-17 18:03:00 -06002101 mModelCallbacks.bindScreens(orderedScreenIds);
Winson Chung64359a52013-07-08 17:17:08 -07002102 }
2103
Sebastian Francoddd04502023-07-26 15:09:10 -07002104 /**
2105 * Remove odd number because they are already included when isTwoPanels and add the pair screen
2106 * if not present.
2107 */
2108 private IntArray filterTwoPanelScreenIds(IntArray orderedScreenIds) {
2109 IntSet screenIds = IntSet.wrap(orderedScreenIds);
2110 orderedScreenIds.forEach(screenId -> {
2111 if (screenId % 2 == 1) {
2112 screenIds.remove(screenId);
2113 // In case the pair is not added, add it
2114 if (!mWorkspace.containsScreenId(screenId - 1)) {
2115 screenIds.add(screenId - 1);
2116 }
2117 }
2118 });
2119 return screenIds.getArray();
2120 }
2121
Sunny Goyalb23980c2017-08-17 07:45:25 -07002122 @Override
Tony Wickham6a71a5b2018-08-21 11:40:23 -07002123 public void preAddApps() {
Sebastian Francobd7919c2023-09-19 10:55:37 -07002124 mModelCallbacks.preAddApps();
Tony Wickham6a71a5b2018-08-21 11:40:23 -07002125 }
2126
2127 @Override
Sunny Goyalefb7e842018-10-04 15:11:00 -07002128 public void bindAppsAdded(IntArray newScreens, ArrayList<ItemInfo> addNotAnimated,
Sunny Goyal29947f02017-12-18 13:49:44 -08002129 ArrayList<ItemInfo> addAnimated) {
Sebastian Franco6dda7c72023-11-17 18:03:00 -06002130 mModelCallbacks.bindAppsAdded(newScreens, addNotAnimated, addAnimated);
Winson Chungd64d1762013-08-20 14:37:16 -07002131 }
2132
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002133 /**
Joe Onorato9c1289c2009-08-17 11:03:03 -04002134 * Bind the items start-end from the list.
2135 *
2136 * Implementation of the method from LauncherModel.Callbacks.
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002137 */
Tony Wickham0bb211a2015-10-02 16:22:08 -07002138 @Override
Sunny Goyalb23980c2017-08-17 07:45:25 -07002139 public void bindItems(final List<ItemInfo> items, final boolean forceAnimateIcons) {
Schneider Victor-tulias68706eb2021-04-29 15:24:54 -07002140 bindItems(items, forceAnimateIcons, /* focusFirstItemForAccessibility= */ false);
2141 }
2142
2143
2144 /**
2145 * Bind the items start-end from the list.
2146 *
2147 * Implementation of the method from LauncherModel.Callbacks.
2148 *
2149 * @param focusFirstItemForAccessibility true iff the first item to be added to the workspace
2150 * should be focused for accessibility.
2151 */
2152 public void bindItems(
2153 final List<ItemInfo> items,
2154 final boolean forceAnimateIcons,
2155 final boolean focusFirstItemForAccessibility) {
Sunny Goyal3be633b2016-12-08 09:59:25 -08002156 // Get the list of added items and intersect them with the set of items here
Rajeev Kumar43c0f582017-06-23 15:34:55 -07002157 final Collection<Animator> bounceAnims = new ArrayList<>();
Schneider Victor-tulias68fb4162021-09-16 13:24:01 -07002158 boolean canAnimatePageChange = canAnimatePageChange();
Shikha Malhotraf78da1b2022-04-11 10:23:18 +00002159 Workspace<?> workspace = mWorkspace;
Sunny Goyalefb7e842018-10-04 15:11:00 -07002160 int newItemsScreenId = -1;
Sunny Goyalb23980c2017-08-17 07:45:25 -07002161 int end = items.size();
Schneider Victor-tulias68706eb2021-04-29 15:24:54 -07002162 View newView = null;
Charlie Anderson511421c2023-10-26 11:22:26 -04002163 LauncherRestoreEventLogger restoreEventLogger = null;
2164 Boolean isRestoreFromBackup = (Boolean) LauncherPrefs.get(getApplicationContext())
2165 .get(IS_FIRST_LOAD_AFTER_RESTORE);
2166 if (isRestoreFromBackup) {
2167 restoreEventLogger = LauncherRestoreEventLogger.Companion
2168 .newInstance(getApplicationContext());
2169 }
Sunny Goyalb23980c2017-08-17 07:45:25 -07002170 for (int i = 0; i < end; i++) {
Sunny Goyal3be633b2016-12-08 09:59:25 -08002171 final ItemInfo item = items.get(i);
Winson Chung4d279d92011-07-21 11:46:32 -07002172 // Short circuit if we are loading dock items for a configuration which has no dock
2173 if (item.container == LauncherSettings.Favorites.CONTAINER_HOTSEAT &&
2174 mHotseat == null) {
2175 continue;
2176 }
2177
Sunny Goyal639e9062015-08-19 19:17:06 -07002178 final View view;
Joe Onorato9c1289c2009-08-17 11:03:03 -04002179 switch (item.itemType) {
2180 case LauncherSettings.Favorites.ITEM_TYPE_APPLICATION:
Sunny Goyal3be633b2016-12-08 09:59:25 -08002181 case LauncherSettings.Favorites.ITEM_TYPE_DEEP_SHORTCUT: {
Sunny Goyal95899162019-03-27 16:03:06 -07002182 WorkspaceItemInfo info = (WorkspaceItemInfo) item;
Sunny Goyal639e9062015-08-19 19:17:06 -07002183 view = createShortcut(info);
Joe Onorato9c1289c2009-08-17 11:03:03 -04002184 break;
Sunny Goyal3be633b2016-12-08 09:59:25 -08002185 }
2186 case LauncherSettings.Favorites.ITEM_TYPE_FOLDER: {
Tracy Zhou4d7b2442019-12-09 13:42:57 -08002187 view = FolderIcon.inflateFolderAndIcon(R.layout.folder_icon, this,
Michael Jurka0142d492010-08-25 17:46:15 -07002188 (ViewGroup) workspace.getChildAt(workspace.getCurrentPage()),
Sunny Goyal1cd01b02016-11-09 10:43:58 -08002189 (FolderInfo) item);
Joe Onorato9c1289c2009-08-17 11:03:03 -04002190 break;
Sunny Goyal3be633b2016-12-08 09:59:25 -08002191 }
Jeremy Sim7cf0dd92023-03-24 22:39:45 -07002192 case LauncherSettings.Favorites.ITEM_TYPE_APP_PAIR: {
Jeremy Sim94fd07e2023-04-19 20:56:49 -07002193 view = AppPairIcon.inflateIcon(R.layout.app_pair_icon, this,
2194 (ViewGroup) workspace.getChildAt(workspace.getCurrentPage()),
2195 (FolderInfo) item);
Jeremy Sim7cf0dd92023-03-24 22:39:45 -07002196 break;
2197 }
Charlie Anderson511421c2023-10-26 11:22:26 -04002198 case ITEM_TYPE_APPWIDGET:
Sunny Goyal952e63d2017-08-16 04:59:08 -07002199 case LauncherSettings.Favorites.ITEM_TYPE_CUSTOM_APPWIDGET: {
Charlie Anderson511421c2023-10-26 11:22:26 -04002200 view = inflateAppWidget((LauncherAppWidgetInfo) item, restoreEventLogger);
Sunny Goyalb23980c2017-08-17 07:45:25 -07002201 if (view == null) {
2202 continue;
Sunny Goyal3be633b2016-12-08 09:59:25 -08002203 }
Charlie Anderson511421c2023-10-26 11:22:26 -04002204 // Widgets have more checks when inflating, so we have to wait until here
2205 // to mark restored, instead of logging in LoaderTask.
2206 if (restoreEventLogger != null) {
2207 restoreEventLogger.logSingleFavoritesItemRestored(item.itemType);
2208 }
Sunny Goyal3be633b2016-12-08 09:59:25 -08002209 break;
2210 }
Winson Chungc763c4e2013-07-19 13:49:06 -07002211 default:
2212 throw new RuntimeException("Invalid Item Type");
Joe Onorato9c1289c2009-08-17 11:03:03 -04002213 }
Sunny Goyal639e9062015-08-19 19:17:06 -07002214
Samuel Fufaca37b8a2019-08-19 17:04:36 -07002215 /*
Sunny Goyalda4fe1a2016-05-26 16:05:17 -07002216 * Remove colliding items.
2217 */
Sunny Goyal669b71f2023-01-27 14:37:07 -08002218 CellPos presenterPos = getCellPosMapper().mapModelToPresenter(item);
2219 if (item.container == CONTAINER_DESKTOP) {
2220 CellLayout cl = mWorkspace.getScreenWithId(presenterPos.screenId);
2221 if (cl != null && cl.isOccupied(presenterPos.cellX, presenterPos.cellY)) {
2222 View v = cl.getChildAt(presenterPos.cellX, presenterPos.cellY);
Jon Miranda0aff1152021-11-05 16:36:07 -07002223 if (v == null) {
2224 Log.e(TAG, "bindItems failed when removing colliding item=" + item);
2225 }
Sunny Goyalda4fe1a2016-05-26 16:05:17 -07002226 Object tag = v.getTag();
2227 String desc = "Collision while binding workspace item: " + item
2228 + ". Collides with " + tag;
Zak Cohen3eeb41d2020-02-14 14:15:13 -08002229 if (FeatureFlags.IS_STUDIO_BUILD) {
Sunny Goyalda4fe1a2016-05-26 16:05:17 -07002230 throw (new RuntimeException(desc));
2231 } else {
Charlie Anderson511421c2023-10-26 11:22:26 -04002232 if (restoreEventLogger != null) {
2233 restoreEventLogger.logSingleFavoritesItemRestoreFailed(item.itemType,
2234 RESTORE_ERROR_INVALID_LOCATION);
2235 }
Pinyao Ting6a41d562022-05-10 23:47:36 +00002236 getModelWriter().deleteItemFromDatabase(item, desc);
Sunny Goyalda4fe1a2016-05-26 16:05:17 -07002237 continue;
2238 }
2239 }
2240 }
Sunny Goyald5462aa2016-11-22 16:52:39 +05302241 workspace.addInScreenFromBind(view, item);
Schneider Victor-tulias68fb4162021-09-16 13:24:01 -07002242 if (forceAnimateIcons) {
Sunny Goyal639e9062015-08-19 19:17:06 -07002243 // Animate all the applications up now
2244 view.setAlpha(0f);
2245 view.setScaleX(0f);
2246 view.setScaleY(0f);
2247 bounceAnims.add(createNewAppBounceAnimation(view, i));
Sunny Goyal669b71f2023-01-27 14:37:07 -08002248 newItemsScreenId = presenterPos.screenId;
Sunny Goyal639e9062015-08-19 19:17:06 -07002249 }
Schneider Victor-tulias68706eb2021-04-29 15:24:54 -07002250
2251 if (newView == null) {
2252 newView = view;
2253 }
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002254 }
Winson Chungf0c6ae02012-03-21 16:10:31 -07002255
Schneider Victor-tulias68706eb2021-04-29 15:24:54 -07002256 View viewToFocus = newView;
2257 // Animate to the correct pager
Schneider Victor-tulias68fb4162021-09-16 13:24:01 -07002258 if (forceAnimateIcons && newItemsScreenId > -1) {
Sunny Goyalf0b6db72018-08-13 16:10:14 -07002259 AnimatorSet anim = new AnimatorSet();
2260 anim.playTogether(bounceAnims);
Schneider Victor-tulias68706eb2021-04-29 15:24:54 -07002261 if (focusFirstItemForAccessibility && viewToFocus != null) {
2262 anim.addListener(new AnimatorListenerAdapter() {
2263 @Override
2264 public void onAnimationEnd(Animator animation) {
2265 viewToFocus.sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_FOCUSED);
2266 }
2267 });
2268 }
Jon Miranda64eb8ea2018-03-29 11:43:58 -07002269
Sunny Goyalefb7e842018-10-04 15:11:00 -07002270 int currentScreenId = mWorkspace.getScreenIdForPageIndex(mWorkspace.getNextPage());
Sunny Goyalf0b6db72018-08-13 16:10:14 -07002271 final int newScreenIndex = mWorkspace.getPageIndexForScreenId(newItemsScreenId);
2272 final Runnable startBounceAnimRunnable = anim::start;
2273
Schneider Victor-tulias68fb4162021-09-16 13:24:01 -07002274 if (canAnimatePageChange && newItemsScreenId != currentScreenId) {
Sunny Goyalf0b6db72018-08-13 16:10:14 -07002275 // We post the animation slightly delayed to prevent slowdowns
2276 // when we are loading right after we return to launcher.
2277 mWorkspace.postDelayed(new Runnable() {
2278 public void run() {
2279 if (mWorkspace != null) {
Andy Wickham65ced1b2020-03-07 02:14:19 +00002280 closeOpenViews(false);
Sunny Goyalf0b6db72018-08-13 16:10:14 -07002281
2282 mWorkspace.snapToPage(newScreenIndex);
2283 mWorkspace.postDelayed(startBounceAnimRunnable,
2284 NEW_APPS_ANIMATION_DELAY);
Winson Chung94d67682013-09-25 16:29:40 -07002285 }
Sunny Goyalf0b6db72018-08-13 16:10:14 -07002286 }
2287 }, NEW_APPS_PAGE_MOVE_DELAY);
2288 } else {
2289 mWorkspace.postDelayed(startBounceAnimRunnable, NEW_APPS_ANIMATION_DELAY);
Winson Chung997a9232013-07-24 15:33:46 -07002290 }
Schneider Victor-tulias68706eb2021-04-29 15:24:54 -07002291 } else if (focusFirstItemForAccessibility && viewToFocus != null) {
2292 viewToFocus.sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_FOCUSED);
Winson Chung64359a52013-07-08 17:17:08 -07002293 }
Charlie Anderson511421c2023-10-26 11:22:26 -04002294 if (restoreEventLogger != null) {
2295 restoreEventLogger.reportLauncherRestoreResults();
2296 }
Joe Onorato9c1289c2009-08-17 11:03:03 -04002297 workspace.requestLayout();
The Android Open Source Project31dd5032009-03-03 19:32:27 -08002298 }
2299
Joe Onorato9c1289c2009-08-17 11:03:03 -04002300 /**
2301 * Add the views for a widget to the workspace.
Joe Onorato9c1289c2009-08-17 11:03:03 -04002302 */
Sunny Goyala9a1a212017-08-18 01:03:21 -07002303 public void bindAppWidget(LauncherAppWidgetInfo item) {
Charlie Anderson511421c2023-10-26 11:22:26 -04002304 View view = inflateAppWidget(item, null);
Sunny Goyala9a1a212017-08-18 01:03:21 -07002305 if (view != null) {
2306 mWorkspace.addInScreen(view, item);
2307 mWorkspace.requestLayout();
2308 }
2309 }
2310
Charlie Anderson511421c2023-10-26 11:22:26 -04002311 private View inflateAppWidget(LauncherAppWidgetInfo item,
2312 @Nullable LauncherRestoreEventLogger restoreEventLogger) {
Samuel Fufaca37b8a2019-08-19 17:04:36 -07002313 if (item.hasOptionFlag(LauncherAppWidgetInfo.OPTION_SEARCH_WIDGET)) {
2314 item.providerName = QsbContainerView.getSearchComponentName(this);
2315 if (item.providerName == null) {
Pinyao Ting6a41d562022-05-10 23:47:36 +00002316 getModelWriter().deleteItemFromDatabase(item,
2317 "search widget removed because search component cannot be found");
Samuel Fufaca37b8a2019-08-19 17:04:36 -07002318 return null;
2319 }
2320 }
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002321 final AppWidgetHostView view;
Sunny Goyal2e1efb42016-03-03 16:58:55 -08002322 if (mIsSafeModeEnabled) {
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002323 view = new PendingAppWidgetHostView(this, item, mIconCache, true);
Sunny Goyald5462aa2016-11-22 16:52:39 +05302324 prepareAppWidget(view, item);
Sunny Goyalb23980c2017-08-17 07:45:25 -07002325 return view;
Sunny Goyal2e1efb42016-03-03 16:58:55 -08002326 }
2327
Sunny Goyal67736672023-06-02 13:35:19 +00002328 TraceHelper.INSTANCE.beginSection("BIND_WIDGET_id=" + item.appWidgetId);
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002329 try {
2330 final LauncherAppWidgetProviderInfo appWidgetInfo;
Steven Ngacd9d792021-06-25 11:51:44 +01002331 String removalReason = "";
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002332 if (item.hasRestoreFlag(LauncherAppWidgetInfo.FLAG_PROVIDER_NOT_READY)) {
2333 // If the provider is not ready, bind as a pending widget.
2334 appWidgetInfo = null;
Steven Ngacd9d792021-06-25 11:51:44 +01002335 removalReason = "the provider isn't ready.";
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002336 } else if (item.hasRestoreFlag(LauncherAppWidgetInfo.FLAG_ID_NOT_VALID)) {
2337 // The widget id is not valid. Try to find the widget based on the provider info.
2338 appWidgetInfo = mAppWidgetManager.findProvider(item.providerName, item.user);
Pinyao Tingbbb9a9c2021-05-11 15:42:54 -07002339 if (appWidgetInfo == null) {
2340 if (WidgetsModel.GO_DISABLE_WIDGETS) {
Steven Ngacd9d792021-06-25 11:51:44 +01002341 removalReason = "widgets are disabled on go device.";
Pinyao Tingbbb9a9c2021-05-11 15:42:54 -07002342 } else {
Steven Ngacd9d792021-06-25 11:51:44 +01002343 removalReason =
2344 "WidgetManagerHelper cannot find a provider from provider info.";
Pinyao Tingbbb9a9c2021-05-11 15:42:54 -07002345 }
2346 }
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002347 } else {
fbaron30d9e3f2023-08-03 17:03:59 -07002348 appWidgetInfo = mAppWidgetManager.getLauncherAppWidgetInfo(item.appWidgetId,
2349 item.getTargetComponent());
Pinyao Tingbbb9a9c2021-05-11 15:42:54 -07002350 if (appWidgetInfo == null) {
fbaron30d9e3f2023-08-03 17:03:59 -07002351 if (item.appWidgetId <= CUSTOM_WIDGET_ID) {
Steven Ngacd9d792021-06-25 11:51:44 +01002352 removalReason =
2353 "CustomWidgetManager cannot find provider from that widget id.";
Pinyao Tingbbb9a9c2021-05-11 15:42:54 -07002354 } else {
Steven Ngacd9d792021-06-25 11:51:44 +01002355 removalReason = "AppWidgetManager cannot find provider for that widget id."
2356 + " It could be because AppWidgetService is not available, or the"
Pinyao Tingbbb9a9c2021-05-11 15:42:54 -07002357 + " appWidgetId has not been bound to a the provider yet, or you"
2358 + " don't have access to that appWidgetId.";
2359 }
2360 }
Sunny Goyalff572272014-07-23 13:58:07 -07002361 }
Sunny Goyalff572272014-07-23 13:58:07 -07002362
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002363 // If the provider is ready, but the width is not yet restored, try to restore it.
2364 if (!item.hasRestoreFlag(LauncherAppWidgetInfo.FLAG_PROVIDER_NOT_READY)
2365 && (item.restoreStatus != LauncherAppWidgetInfo.RESTORE_COMPLETED)) {
2366 if (appWidgetInfo == null) {
Pinyao Ting6a41d562022-05-10 23:47:36 +00002367 getModelWriter().deleteItemFromDatabase(item,
2368 "Removing restored widget: id=" + item.appWidgetId
Pinyao Tingbbb9a9c2021-05-11 15:42:54 -07002369 + " belongs to component " + item.providerName + " user " + item.user
Steven Ngacd9d792021-06-25 11:51:44 +01002370 + ", as the provider is null and " + removalReason);
Charlie Anderson511421c2023-10-26 11:22:26 -04002371 if (restoreEventLogger != null) {
2372 restoreEventLogger.logSingleFavoritesItemRestoreFailed(
2373 ITEM_TYPE_APPWIDGET, RESTORE_ERROR_BIND_FAILURE);
2374 }
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002375 return null;
2376 }
Sunny Goyalff572272014-07-23 13:58:07 -07002377
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002378 // If we do not have a valid id, try to bind an id.
2379 if (item.hasRestoreFlag(LauncherAppWidgetInfo.FLAG_ID_NOT_VALID)) {
2380 if (!item.hasRestoreFlag(LauncherAppWidgetInfo.FLAG_ID_ALLOCATED)) {
2381 // Id has not been allocated yet. Allocate a new id.
Sihua Ma0593a0d2022-10-03 16:01:48 -07002382 item.appWidgetId = mAppWidgetHolder.allocateAppWidgetId();
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002383 item.restoreStatus |= LauncherAppWidgetInfo.FLAG_ID_ALLOCATED;
Sunny Goyal86df1382016-08-10 15:03:22 -07002384
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002385 // Also try to bind the widget. If the bind fails, the user will be shown
2386 // a click to setup UI, which will ask for the bind permission.
Yogisha Dixit658c5da2021-05-24 23:23:15 +01002387 PendingAddWidgetInfo pendingInfo =
2388 new PendingAddWidgetInfo(appWidgetInfo, item.sourceContainer);
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002389 pendingInfo.spanX = item.spanX;
2390 pendingInfo.spanY = item.spanY;
2391 pendingInfo.minSpanX = item.minSpanX;
2392 pendingInfo.minSpanY = item.minSpanY;
Sunny Goyal19ff7282021-04-22 10:12:54 -07002393 Bundle options = pendingInfo.getDefaultSizeOptions(this);
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002394
2395 boolean isDirectConfig =
2396 item.hasRestoreFlag(LauncherAppWidgetInfo.FLAG_DIRECT_CONFIG);
2397 if (isDirectConfig && item.bindOptions != null) {
2398 Bundle newOptions = item.bindOptions.getExtras();
2399 if (options != null) {
2400 newOptions.putAll(options);
2401 }
2402 options = newOptions;
Sunny Goyal86df1382016-08-10 15:03:22 -07002403 }
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002404 boolean success = mAppWidgetManager.bindAppWidgetIdIfAllowed(
2405 item.appWidgetId, appWidgetInfo, options);
2406
2407 // We tried to bind once. If we were not able to bind, we would need to
2408 // go through the permission dialog, which means we cannot skip the config
2409 // activity.
2410 item.bindOptions = null;
2411 item.restoreStatus &= ~LauncherAppWidgetInfo.FLAG_DIRECT_CONFIG;
2412
2413 // Bind succeeded
2414 if (success) {
2415 // If the widget has a configure activity, it is still needs to set it
2416 // up, otherwise the widget is ready to go.
2417 item.restoreStatus = (appWidgetInfo.configure == null) || isDirectConfig
2418 ? LauncherAppWidgetInfo.RESTORE_COMPLETED
2419 : LauncherAppWidgetInfo.FLAG_UI_NOT_READY;
2420 }
2421
2422 getModelWriter().updateItemInDatabase(item);
Sunny Goyal86df1382016-08-10 15:03:22 -07002423 }
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002424 } else if (item.hasRestoreFlag(LauncherAppWidgetInfo.FLAG_UI_NOT_READY)
2425 && (appWidgetInfo.configure == null)) {
2426 // The widget was marked as UI not ready, but there is no configure activity to
2427 // update the UI.
2428 item.restoreStatus = LauncherAppWidgetInfo.RESTORE_COMPLETED;
Sunny Goyal43bf11d2017-02-02 13:52:53 -08002429 getModelWriter().updateItemInDatabase(item);
Sunny Goyalff572272014-07-23 13:58:07 -07002430 }
Samuel Fufa9151c012020-02-24 17:06:28 -08002431 else if (item.hasRestoreFlag(LauncherAppWidgetInfo.FLAG_UI_NOT_READY)
2432 && appWidgetInfo.configure != null) {
2433 if (mAppWidgetManager.isAppWidgetRestored(item.appWidgetId)) {
2434 item.restoreStatus = LauncherAppWidgetInfo.RESTORE_COMPLETED;
2435 getModelWriter().updateItemInDatabase(item);
2436 }
2437 }
Sunny Goyal56c73602015-09-25 12:55:01 -07002438 }
2439
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002440 if (item.restoreStatus == LauncherAppWidgetInfo.RESTORE_COMPLETED) {
2441 // Verify that we own the widget
2442 if (appWidgetInfo == null) {
Pinyao Ting0d97f8d2020-12-04 15:12:26 -08002443 FileLog.e(TAG, "Removing invalid widget: id=" + item.appWidgetId);
Sihua Ma0593a0d2022-10-03 16:01:48 -07002444 getModelWriter().deleteWidgetInfo(item, getAppWidgetHolder(), removalReason);
Charlie Anderson511421c2023-10-26 11:22:26 -04002445 if (restoreEventLogger != null) {
2446 restoreEventLogger.logSingleFavoritesItemRestoreFailed(
2447 ITEM_TYPE_APPWIDGET, RESTORE_ERROR_BIND_FAILURE);
2448 }
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002449 return null;
2450 }
Joe Onorato9c1289c2009-08-17 11:03:03 -04002451
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002452 item.minSpanX = appWidgetInfo.minSpanX;
2453 item.minSpanY = appWidgetInfo.minSpanY;
Sihua Ma0593a0d2022-10-03 16:01:48 -07002454 view = mAppWidgetHolder.createView(this, item.appWidgetId, appWidgetInfo);
Samuel Fufa9151c012020-02-24 17:06:28 -08002455 } else if (!item.hasRestoreFlag(LauncherAppWidgetInfo.FLAG_ID_NOT_VALID)
2456 && appWidgetInfo != null) {
Sihua Ma0593a0d2022-10-03 16:01:48 -07002457 mAppWidgetHolder.addPendingView(item.appWidgetId,
Samuel Fufa9151c012020-02-24 17:06:28 -08002458 new PendingAppWidgetHostView(this, item, mIconCache, false));
Sihua Ma0593a0d2022-10-03 16:01:48 -07002459 view = mAppWidgetHolder.createView(this, item.appWidgetId, appWidgetInfo);
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002460 } else {
2461 view = new PendingAppWidgetHostView(this, item, mIconCache, false);
2462 }
2463 prepareAppWidget(view, item);
2464 } finally {
Sunny Goyal67736672023-06-02 13:35:19 +00002465 TraceHelper.INSTANCE.endSection();
Sunny Goyal17c72fb2019-10-14 14:06:38 -07002466 }
2467
Sunny Goyalb23980c2017-08-17 07:45:25 -07002468 return view;
Joe Onorato9c1289c2009-08-17 11:03:03 -04002469 }
2470
Sunny Goyalff572272014-07-23 13:58:07 -07002471 /**
2472 * Restores a pending widget.
2473 *
2474 * @param appWidgetId The app widget id
Sunny Goyalff572272014-07-23 13:58:07 -07002475 */
Sunny Goyald478c832016-04-01 12:04:16 -07002476 private LauncherAppWidgetInfo completeRestoreAppWidget(int appWidgetId, int finalRestoreFlag) {
Sunny Goyalff572272014-07-23 13:58:07 -07002477 LauncherAppWidgetHostView view = mWorkspace.getWidgetForAppWidgetId(appWidgetId);
Sunny Goyal4df719a2024-01-03 19:31:32 -08002478 if (!(view instanceof PendingAppWidgetHostView)) {
Sunny Goyalff572272014-07-23 13:58:07 -07002479 Log.e(TAG, "Widget update called, when the widget no longer exists.");
Sunny Goyald478c832016-04-01 12:04:16 -07002480 return null;
Sunny Goyalff572272014-07-23 13:58:07 -07002481 }
2482
Sunny Goyal0fc1be12014-08-11 17:05:23 -07002483 LauncherAppWidgetInfo info = (LauncherAppWidgetInfo) view.getTag();
Sunny Goyald478c832016-04-01 12:04:16 -07002484 info.restoreStatus = finalRestoreFlag;
Jon Miranda2b823f42017-05-02 18:36:18 -07002485 if (info.restoreStatus == LauncherAppWidgetInfo.RESTORE_COMPLETED) {
2486 info.pendingItemInfo = null;
2487 }
Sunny Goyalff572272014-07-23 13:58:07 -07002488
Sunny Goyal4df719a2024-01-03 19:31:32 -08002489 PendingAppWidgetHostView pv = (PendingAppWidgetHostView) view;
2490 if (pv.isReinflateIfNeeded()) {
2491 pv.reInflate();
Sunny Goyalba47faa2017-10-04 16:50:57 -07002492 }
2493
Sunny Goyal43bf11d2017-02-02 13:52:53 -08002494 getModelWriter().updateItemInDatabase(info);
Sunny Goyald478c832016-04-01 12:04:16 -07002495 return info;
Sunny Goyalff572272014-07-23 13:58:07 -07002496 }
2497
Sunny Goyal527c7d32015-08-28 15:19:36 -07002498 public void clearPendingExecutor(ViewOnDrawExecutor executor) {
Sebastian Francoe4965122023-12-01 13:27:42 -06002499 if (mModelCallbacks.getPendingExecutor() == executor) {
2500 mModelCallbacks.setPendingExecutor(null);
Sunny Goyal527c7d32015-08-28 15:19:36 -07002501 }
2502 }
2503
Sebastian Franco0b461ef2023-12-08 12:20:07 -06002504 /**
2505 * Call back when ModelCallbacks finish binding the Launcher data.
2506 */
Schneider Victor-tulias927d6dc2021-08-26 11:56:47 -07002507 @TargetApi(Build.VERSION_CODES.S)
Sebastian Franco0b461ef2023-12-08 12:20:07 -06002508 public void bindComplete(int workspaceItemCount, boolean isBindSync) {
Sunny Goyal7b8d63f2022-04-14 16:37:32 -07002509 if (mOnInitialBindListener != null) {
2510 getRootView().getViewTreeObserver().removeOnPreDrawListener(mOnInitialBindListener);
2511 mOnInitialBindListener = null;
Sunny Goyalb5b9ad62016-04-02 11:23:39 -07002512 }
Fengjiang Lie5f91a42023-11-16 16:12:04 -08002513 if (!isBindSync) {
2514 mStartupLatencyLogger
2515 .logCardinality(workspaceItemCount)
Sebastian Franco0b461ef2023-12-08 12:20:07 -06002516 .logEnd(LauncherLatencyEvent.LAUNCHER_LATENCY_STARTUP_WORKSPACE_LOADER_ASYNC);
Fengjiang Lie5f91a42023-11-16 16:12:04 -08002517 }
Fengjiang Li6dff0922023-10-14 07:10:10 -07002518 MAIN_EXECUTOR.getHandler().postAtFrontOfQueue(() -> {
2519 mStartupLatencyLogger
Fengjiang Li6dff0922023-10-14 07:10:10 -07002520 .logEnd(LAUNCHER_LATENCY_STARTUP_TOTAL_DURATION)
2521 .log()
2522 .reset();
2523 if (mIsColdStartupAfterReboot) {
2524 Trace.endAsyncSection(COLD_STARTUP_TRACE_METHOD_NAME,
2525 COLD_STARTUP_TRACE_COOKIE);
2526 }
2527 });
Sebastian Franco0b461ef2023-12-08 12:20:07 -06002528 }
2529
2530 @Override
2531 public void onInitialBindComplete(IntSet boundPages, RunnableList pendingTasks,
2532 int workspaceItemCount, boolean isBindSync) {
2533 mModelCallbacks.onInitialBindComplete(boundPages, pendingTasks, workspaceItemCount,
2534 isBindSync);
Sunny Goyalb5b9ad62016-04-02 11:23:39 -07002535 }
2536
Joe Onorato9c1289c2009-08-17 11:03:03 -04002537 /**
2538 * Callback saying that there aren't any more items to bind.
Schneider Victor-tuliasfff7cef2023-04-10 15:59:23 -07002539 * <p>
Joe Onorato9c1289c2009-08-17 11:03:03 -04002540 * Implementation of the method from LauncherModel.Callbacks.
2541 */
Andras Kloczl55edfe52021-05-14 12:21:30 +02002542 public void finishBindingItems(IntSet pagesBoundFirst) {
Sebastian Franco6196b902023-12-06 11:39:52 -06002543 mModelCallbacks.finishBindingItems(pagesBoundFirst);
Winson Chungf0c6ae02012-03-21 16:10:31 -07002544 }
2545
Schneider Victor-tulias68fb4162021-09-16 13:24:01 -07002546 private boolean canAnimatePageChange() {
Sunny Goyal9b180102020-03-11 10:02:29 -07002547 if (mDragController.isDragging()) {
2548 return false;
2549 } else {
Riddle Hsu979da642020-09-22 21:52:40 +08002550 return (SystemClock.uptimeMillis() - mLastTouchUpTime)
Sunny Goyal9b180102020-03-11 10:02:29 -07002551 > (NEW_APPS_ANIMATION_INACTIVE_TIMEOUT_SECONDS * 1000);
2552 }
Winson Chunga2413752012-04-03 14:22:34 -07002553 }
2554
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002555 /**
2556 * Similar to {@link #getFirstMatch} but optimized to finding a suitable view for the app close
2557 * animation.
2558 *
2559 * @param preferredItemId The id of the preferred item to match to if it exists.
2560 * @param packageName The package name of the app to match.
2561 * @param user The user of the app to match.
Jon Mirandab42e1242022-03-08 16:37:35 -08002562 * @param supportsAllAppsState If true and we are in All Apps state, looks for view in All Apps.
2563 * Else we only looks on the workspace.
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002564 */
Jon Mirandaf58db152022-06-02 16:06:37 -07002565 public @Nullable View getFirstMatchForAppClose(int preferredItemId, String packageName,
2566 UserHandle user, boolean supportsAllAppsState) {
Sunny Goyal32084d42022-05-02 10:00:07 -07002567 final Predicate<ItemInfo> preferredItem = info ->
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002568 info != null && info.id == preferredItemId;
Sunny Goyal32084d42022-05-02 10:00:07 -07002569 final Predicate<ItemInfo> packageAndUserAndApp = info ->
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002570 info != null
2571 && info.itemType == ITEM_TYPE_APPLICATION
2572 && info.user.equals(user)
2573 && info.getTargetComponent() != null
2574 && TextUtils.equals(info.getTargetComponent().getPackageName(),
2575 packageName);
2576
Jon Mirandab42e1242022-03-08 16:37:35 -08002577 if (supportsAllAppsState && isInState(LauncherState.ALL_APPS)) {
Jon Mirandaf58db152022-06-02 16:06:37 -07002578 AllAppsRecyclerView activeRecyclerView = mAppsView.getActiveRecyclerView();
2579 View v = getFirstMatch(Collections.singletonList(activeRecyclerView),
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002580 preferredItem, packageAndUserAndApp);
Jon Mirandaf58db152022-06-02 16:06:37 -07002581
Sunny Goyalf34811d2022-10-21 20:42:34 +00002582 if (v != null && activeRecyclerView.computeVerticalScrollOffset() > 0) {
Jon Mirandaf58db152022-06-02 16:06:37 -07002583 RectF locationBounds = new RectF();
2584 FloatingIconView.getLocationBoundsForView(this, v, false, locationBounds,
2585 new Rect());
2586 if (locationBounds.top < mAppsView.getHeaderBottom()) {
2587 // Icon is covered by scrim, return null to play fallback animation.
2588 return null;
2589 }
2590 }
2591
2592 return v;
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002593 }
Federico Baron8bf1bca2022-09-27 16:19:11 -07002594
2595 // Look for the item inside the folder at the current page
2596 Folder folder = Folder.getOpen(this);
2597 if (folder != null) {
2598 View v = getFirstMatch(Collections.singletonList(
2599 folder.getContent().getCurrentCellLayout().getShortcutsAndWidgets()),
2600 preferredItem,
2601 packageAndUserAndApp);
2602 if (v == null) {
2603 folder.close(isStarted() && !isForceInvisible());
2604 } else {
2605 return v;
2606 }
2607 }
2608
2609 List<ViewGroup> containers = new ArrayList<>(mWorkspace.getPanelCount() + 1);
2610 containers.add(mWorkspace.getHotseat().getShortcutsAndWidgets());
2611 mWorkspace.forEachVisiblePage(page
2612 -> containers.add(((CellLayout) page).getShortcutsAndWidgets()));
2613
2614 // Order: Preferred item by itself or in folder, then by matching package/user
2615 return getFirstMatch(containers, preferredItem, forFolderMatch(preferredItem),
2616 packageAndUserAndApp, forFolderMatch(packageAndUserAndApp));
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002617 }
2618
2619 /**
2620 * Finds the first view matching the ordered operators across the given viewgroups in order.
2621 * @param containers List of ViewGroups to scan, in order of preference.
2622 * @param operators List of operators, in order starting from best matching operator.
2623 */
Jon Mirandaf26bdcb2022-06-09 16:09:30 -07002624 @Nullable
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002625 private static View getFirstMatch(Iterable<ViewGroup> containers,
Sunny Goyal32084d42022-05-02 10:00:07 -07002626 final Predicate<ItemInfo>... operators) {
2627 for (Predicate<ItemInfo> operator : operators) {
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002628 for (ViewGroup container : containers) {
2629 View match = mapOverViewGroup(container, operator);
2630 if (match != null) {
2631 return match;
2632 }
2633 }
2634 }
2635 return null;
2636 }
2637
2638 /**
2639 * Returns the first view matching the operator in the given ViewGroups, or null if none.
2640 * Forward iteration matters.
2641 */
Jon Mirandaf26bdcb2022-06-09 16:09:30 -07002642 @Nullable
Sunny Goyal32084d42022-05-02 10:00:07 -07002643 private static View mapOverViewGroup(ViewGroup container, Predicate<ItemInfo> op) {
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002644 final int itemCount = container.getChildCount();
2645 for (int itemIdx = 0; itemIdx < itemCount; itemIdx++) {
2646 View item = container.getChildAt(itemIdx);
Sunny Goyal32084d42022-05-02 10:00:07 -07002647 if (op.test((ItemInfo) item.getTag())) {
Jon Mirandac4a99bf2021-11-04 16:53:45 -07002648 return item;
2649 }
2650 }
2651 return null;
2652 }
2653
Winson Chungc9168342013-06-26 14:54:55 -07002654 private ValueAnimator createNewAppBounceAnimation(View v, int i) {
Sunny Goyalf0b6db72018-08-13 16:10:14 -07002655 ValueAnimator bounceAnim = new PropertyListBuilder().alpha(1).scale(1).build(v)
Sunny Goyal60e68c92020-08-12 13:59:27 -07002656 .setDuration(ItemInstallQueue.NEW_SHORTCUT_BOUNCE_DURATION);
2657 bounceAnim.setStartDelay(i * ItemInstallQueue.NEW_SHORTCUT_STAGGER_DELAY);
Sunny Goyal5a1f53b2015-05-27 10:24:24 -07002658 bounceAnim.setInterpolator(new OvershootInterpolator(BOUNCE_ANIMATION_TENSION));
Winson Chungc9168342013-06-26 14:54:55 -07002659 return bounceAnim;
2660 }
2661
Pinyao Tingc9074272019-11-11 11:51:44 -08002662 private void announceForAccessibility(@StringRes int stringResId) {
2663 getDragLayer().announceForAccessibility(getString(stringResId));
2664 }
2665
Amith Yamasani6d7fe502010-11-16 09:05:07 -08002666 /**
Josh Tsuji231c9222022-01-11 20:43:59 -05002667 * Informs us that the overlay (-1 screen, typically), has either become visible or invisible.
2668 */
Sunny Goyal82379182022-11-02 18:58:49 -07002669 public void onOverlayVisibilityChanged(boolean visible) {
2670 getStatsLogManager().logger()
2671 .withSrcState(LAUNCHER_STATE_HOME)
2672 .withDstState(LAUNCHER_STATE_HOME)
2673 .withContainerInfo(LauncherAtom.ContainerInfo.newBuilder()
2674 .setWorkspace(WorkspaceContainer.newBuilder()
2675 .setPageIndex(visible ? 0 : -1))
2676 .build())
2677 .log(visible ? LAUNCHER_SWIPELEFT : LAUNCHER_SWIPERIGHT);
2678 }
Josh Tsuji231c9222022-01-11 20:43:59 -05002679
2680 /**
2681 * Informs us that the page transition has ended, so that we can react to the newly selected
2682 * page if we want to.
2683 */
2684 public void onPageEndTransition() {}
2685
2686 /**
Sebastian Francobd7919c2023-09-19 10:55:37 -07002687 * See {@code LauncherBindingDelegate}
Joe Onorato9c1289c2009-08-17 11:03:03 -04002688 */
Sunny Goyal28daf4a2020-06-08 17:06:09 -07002689 @Override
Schneider Victor-tulias927d6dc2021-08-26 11:56:47 -07002690 @TargetApi(Build.VERSION_CODES.S)
Anushree Ganjam97434ee2023-05-18 22:03:16 +00002691 @UiThread
2692 public void bindAllApplications(AppInfo[] apps, int flags,
2693 Map<PackageUserKey, Integer> packageUserKeytoUidMap) {
Sebastian Francobd7919c2023-09-19 10:55:37 -07002694 mModelCallbacks.bindAllApplications(apps, flags, packageUserKeytoUidMap);
Schneider Victor-tulias927d6dc2021-08-26 11:56:47 -07002695 if (Utilities.ATLEAST_S) {
Sebastian Franco974cc942023-10-19 14:22:06 -07002696 Trace.endAsyncSection(DISPLAY_ALL_APPS_TRACE_METHOD_NAME,
2697 DISPLAY_ALL_APPS_TRACE_COOKIE);
Schneider Victor-tulias927d6dc2021-08-26 11:56:47 -07002698 }
Joe Onorato9c1289c2009-08-17 11:03:03 -04002699 }
2700
2701 /**
Sebastian Francobd7919c2023-09-19 10:55:37 -07002702 * See {@code LauncherBindingDelegate}
Tony Wickhambfbf7f92016-05-19 11:19:39 -07002703 */
2704 @Override
Zak Cohen658c67a2018-10-19 14:21:05 -07002705 public void bindDeepShortcutMap(HashMap<ComponentKey, Integer> deepShortcutMapCopy) {
Sebastian Francobd7919c2023-09-19 10:55:37 -07002706 mModelCallbacks.bindDeepShortcutMap(deepShortcutMapCopy);
Tony Wickham1bce7fd2016-04-28 17:39:03 -07002707 }
2708
Sunny Goyal4390ace2014-10-13 11:33:11 -07002709 @Override
Schneider Victor-tulias6a5f4312021-01-12 19:30:02 +00002710 public void bindIncrementalDownloadProgressUpdated(AppInfo app) {
Sebastian Francobd7919c2023-09-19 10:55:37 -07002711 mModelCallbacks.bindIncrementalDownloadProgressUpdated(app);
Mario Bertschler08ffaae2017-03-20 11:30:27 -07002712 }
2713
2714 @Override
Sunny Goyal29947f02017-12-18 13:49:44 -08002715 public void bindWidgetsRestored(ArrayList<LauncherAppWidgetInfo> widgets) {
Sebastian Francobd7919c2023-09-19 10:55:37 -07002716 mModelCallbacks.bindWidgetsRestored(widgets);
Sunny Goyal4390ace2014-10-13 11:33:11 -07002717 }
2718
Joe Onorato9c1289c2009-08-17 11:03:03 -04002719 /**
Sebastian Francobd7919c2023-09-19 10:55:37 -07002720 * See {@code LauncherBindingDelegate}
Sunny Goyalb50cc8c2014-10-06 16:23:56 -07002721 */
Sunny Goyal4390ace2014-10-13 11:33:11 -07002722 @Override
Sunny Goyal28f50752020-07-21 14:15:13 -07002723 public void bindWorkspaceItemsChanged(List<WorkspaceItemInfo> updated) {
Sebastian Francobd7919c2023-09-19 10:55:37 -07002724 mModelCallbacks.bindWorkspaceItemsChanged(updated);
Sunny Goyalb50cc8c2014-10-06 16:23:56 -07002725 }
2726
2727 /**
Sebastian Francobd7919c2023-09-19 10:55:37 -07002728 * See {@code LauncherBindingDelegate}
Chris Wrenaeff7ea2014-02-14 16:59:24 -05002729 */
Sunny Goyale755d462014-07-22 13:48:29 -07002730 @Override
Sunny Goyal29947f02017-12-18 13:49:44 -08002731 public void bindRestoreItemsChange(HashSet<ItemInfo> updates) {
Sebastian Francobd7919c2023-09-19 10:55:37 -07002732 mModelCallbacks.bindRestoreItemsChange(updates);
Sunny Goyala22666f2014-09-18 13:25:15 -07002733 }
2734
2735 /**
Sebastian Francobd7919c2023-09-19 10:55:37 -07002736 * See {@code LauncherBindingDelegate}
Joe Onorato9c1289c2009-08-17 11:03:03 -04002737 */
Sunny Goyal1a745e82014-10-02 15:58:31 -07002738 @Override
Sunny Goyal32084d42022-05-02 10:00:07 -07002739 public void bindWorkspaceComponentsRemoved(Predicate<ItemInfo> matcher) {
Sebastian Francobd7919c2023-09-19 10:55:37 -07002740 mModelCallbacks.bindWorkspaceComponentsRemoved(matcher);
Sunny Goyal3bbbabc2016-03-15 09:16:30 -07002741 }
Sunny Goyal4390ace2014-10-13 11:33:11 -07002742
Sebastian Francobd7919c2023-09-19 10:55:37 -07002743 /**
2744 * See {@code LauncherBindingDelegate}
2745 */
Sunny Goyal3bbbabc2016-03-15 09:16:30 -07002746 @Override
Steven Ng2f5648a2021-02-08 17:18:25 +00002747 public void bindAllWidgets(final List<WidgetsListBaseEntry> allWidgets) {
Sebastian Francobd7919c2023-09-19 10:55:37 -07002748 mModelCallbacks.bindAllWidgets(allWidgets);
Tony Wickham26b17462017-03-20 17:12:24 -07002749 }
2750
kholoud mohamedc76b2032021-12-20 16:47:38 +00002751 @Override
fbarone58aaf12023-09-25 11:34:56 -07002752 public void bindSmartspaceWidget() {
Sebastian Franco50b74c32023-11-16 11:36:49 -06002753 mModelCallbacks.bindSmartspaceWidget();
fbarone58aaf12023-09-25 11:34:56 -07002754 }
2755
2756 @Override
kholoud mohamedc76b2032021-12-20 16:47:38 +00002757 public void bindStringCache(StringCache cache) {
Sebastian Franco6dda7c72023-11-17 18:03:00 -06002758 mModelCallbacks.bindStringCache(cache);
kholoud mohamedc76b2032021-12-20 16:47:38 +00002759 }
2760
Tony Wickham86222d22017-03-29 15:30:43 -07002761 /**
2762 * @param packageUser if null, refreshes all widgets and shortcuts, otherwise only
2763 * refreshes the widgets and shortcuts associated with the given package/user
2764 */
2765 public void refreshAndBindWidgetsForPackageUser(@Nullable PackageUserKey packageUser) {
Sunny Goyalc6e97692017-06-02 13:46:55 -07002766 mModel.refreshAndBindWidgetsAndShortcuts(packageUser);
Sunny Goyal2e1efb42016-03-03 16:58:55 -08002767 }
2768
Winson Chung80baf5a2010-08-09 16:03:15 -07002769 /**
Hyunyoung Song3c7d9cb2017-01-30 15:11:27 -08002770 * $ adb shell dumpsys activity com.android.launcher3.Launcher [--all]
Joe Onoratobe386092009-11-17 17:32:16 -08002771 */
Adam Cohen16d7ffc2011-10-05 17:49:14 -07002772 @Override
2773 public void dump(String prefix, FileDescriptor fd, PrintWriter writer, String[] args) {
2774 super.dump(prefix, fd, writer, args);
Sunny Goyala1365452015-10-01 15:46:24 -07002775
Hyunyoung Song3c7d9cb2017-01-30 15:11:27 -08002776 if (args.length > 0 && TextUtils.equals(args[0], "--all")) {
2777 writer.println(prefix + "Workspace Items");
Sunny Goyal7ce471b2017-08-02 03:37:39 -07002778 for (int i = 0; i < mWorkspace.getPageCount(); i++) {
Hyunyoung Song3c7d9cb2017-01-30 15:11:27 -08002779 writer.println(prefix + " Homescreen " + i);
2780
2781 ViewGroup layout = ((CellLayout) mWorkspace.getPageAt(i)).getShortcutsAndWidgets();
2782 for (int j = 0; j < layout.getChildCount(); j++) {
2783 Object tag = layout.getChildAt(j).getTag();
2784 if (tag != null) {
Sunny Goyal576f7a52023-10-06 11:28:25 -07002785 writer.println(prefix + " " + tag);
Hyunyoung Song3c7d9cb2017-01-30 15:11:27 -08002786 }
2787 }
2788 }
2789
2790 writer.println(prefix + " Hotseat");
Sunny Goyal876e4622018-11-02 13:50:40 -07002791 ViewGroup layout = mHotseat.getShortcutsAndWidgets();
Sunny Goyala1365452015-10-01 15:46:24 -07002792 for (int j = 0; j < layout.getChildCount(); j++) {
2793 Object tag = layout.getChildAt(j).getTag();
2794 if (tag != null) {
Sunny Goyal576f7a52023-10-06 11:28:25 -07002795 writer.println(prefix + " " + tag);
Sunny Goyala1365452015-10-01 15:46:24 -07002796 }
Adam Cohen4caf2982013-08-20 18:54:31 -07002797 }
Sunny Goyala1365452015-10-01 15:46:24 -07002798 }
2799
Hyunyoung Song3c7d9cb2017-01-30 15:11:27 -08002800 writer.println(prefix + "Misc:");
Winson Chungef528762019-09-06 12:05:52 -07002801 dumpMisc(prefix + "\t", writer);
Sebastian Francoe4965122023-12-01 13:27:42 -06002802 writer.println(prefix + "\tmWorkspaceLoading=" + mModelCallbacks.getWorkspaceLoading());
Winson Chungef528762019-09-06 12:05:52 -07002803 writer.println(prefix + "\tmPendingRequestArgs=" + mPendingRequestArgs
2804 + " mPendingActivityResult=" + mPendingActivityResult);
2805 writer.println(prefix + "\tmRotationHelper: " + mRotationHelper);
Sihua Ma0593a0d2022-10-03 16:01:48 -07002806 writer.println(prefix + "\tmAppWidgetHolder.isListening: "
2807 + mAppWidgetHolder.isListening());
Winson Chungef528762019-09-06 12:05:52 -07002808
Tony Wickham646e4482020-04-06 17:25:53 -07002809 // Extra logging for general debugging
Hyunyoung Songa310a802019-04-25 13:57:16 -07002810 mDragLayer.dump(prefix, writer);
2811 mStateManager.dump(prefix, writer);
Tony Wickham646e4482020-04-06 17:25:53 -07002812 mPopupDataProvider.dump(prefix, writer);
Pat Manning5f74bfd2022-07-20 12:08:54 +01002813 mDeviceProfile.dump(this, prefix, writer);
Kevin Lim07546b82023-09-25 21:02:56 +00002814 mAppsView.getAppsStore().dump(prefix, writer);
Sunny Goyal2bba1902018-02-27 12:20:50 -08002815
2816 try {
2817 FileLog.flushAll(writer);
2818 } catch (Exception e) {
2819 // Ignore
2820 }
Hyunyoung Song3c7d9cb2017-01-30 15:11:27 -08002821
2822 mModel.dumpState(prefix, fd, writer, args);
Sunny Goyalb1d7de22019-09-06 10:36:54 -07002823 mOverlayManager.dump(prefix, writer);
Adam Cohen16d7ffc2011-10-05 17:49:14 -07002824 }
Adam Cohen487f7dd2012-06-28 18:12:10 -07002825
Sebastian Franco4080fdd2023-09-19 14:17:23 -07002826 /**
2827 * Populates the list of shortcuts. Logic delegated to {@Link KeyboardShortcutsDelegate}.
2828 *
2829 * @param data The data list to populate with shortcuts.
2830 * @param menu The current menu, which may be null.
2831 * @param deviceId The id for the connected device the shortcuts should be provided for.
2832 */
Sunny Goyal66b24572016-09-21 15:57:55 -07002833 @Override
Sunny Goyal66b24572016-09-21 15:57:55 -07002834 public void onProvideKeyboardShortcuts(
2835 List<KeyboardShortcutGroup> data, Menu menu, int deviceId) {
Sebastian Franco4080fdd2023-09-19 14:17:23 -07002836 mKeyboardShortcutsDelegate.onProvideKeyboardShortcuts(data, menu, deviceId);
Sunny Goyal66b24572016-09-21 15:57:55 -07002837 super.onProvideKeyboardShortcuts(data, menu, deviceId);
2838 }
2839
Sebastian Franco4080fdd2023-09-19 14:17:23 -07002840 /**
2841 * Logic delegated to {@Link KeyboardShortcutsDelegate}.
2842 * @param keyCode The value in event.getKeyCode().
2843 * @param event Description of the key event.
2844 */
Sunny Goyal66b24572016-09-21 15:57:55 -07002845 @Override
2846 public boolean onKeyShortcut(int keyCode, KeyEvent event) {
Sebastian Franco4080fdd2023-09-19 14:17:23 -07002847 Boolean result = mKeyboardShortcutsDelegate.onKeyShortcut(keyCode, event);
2848 return result != null ? result : super.onKeyShortcut(keyCode, event);
Sunny Goyal66b24572016-09-21 15:57:55 -07002849 }
2850
Sebastian Franco4080fdd2023-09-19 14:17:23 -07002851 /**
2852 * Logic delegated to {@Link KeyboardShortcutsDelegate}.
2853 * @param keyCode The value in event.getKeyCode().
2854 * @param event Description of the key event.
2855 */
Vadim Tryshev646a0dd2018-02-05 16:27:50 -08002856 @Override
Josep del Rio1d976c62023-05-04 16:07:50 +00002857 public boolean onKeyDown(int keyCode, KeyEvent event) {
Sebastian Franco4080fdd2023-09-19 14:17:23 -07002858 Boolean result = mKeyboardShortcutsDelegate.onKeyDown(keyCode, event);
2859 return result != null ? result : super.onKeyDown(keyCode, event);
Josep del Rio1d976c62023-05-04 16:07:50 +00002860 }
2861
Sebastian Franco4080fdd2023-09-19 14:17:23 -07002862 /**
2863 * Logic delegated to {@Link KeyboardShortcutsDelegate}.
2864 * @param keyCode The value in event.getKeyCode().
2865 * @param event Description of the key event.
2866 */
Josep del Rio1d976c62023-05-04 16:07:50 +00002867 @Override
Vadim Tryshev646a0dd2018-02-05 16:27:50 -08002868 public boolean onKeyUp(int keyCode, KeyEvent event) {
Sebastian Franco4080fdd2023-09-19 14:17:23 -07002869 Boolean result = mKeyboardShortcutsDelegate.onKeyUp(keyCode, event);
2870 return result != null ? result : super.onKeyUp(keyCode, event);
Vadim Tryshev646a0dd2018-02-05 16:27:50 -08002871 }
2872
Sunny Goyal831212e2021-05-14 14:24:09 -07002873 /**
2874 * Shows the default options popup
2875 */
2876 public void showDefaultOptions(float x, float y) {
Brian Isganitisa85ae692021-09-23 19:56:24 -04002877 OptionsPopupView.show(this, getPopupTarget(x, y), OptionsPopupView.getOptions(this),
2878 false);
2879 }
2880
Brian Isganitisa85ae692021-09-23 19:56:24 -04002881 @Override
Charlie Anderson8ad91442023-01-09 13:55:59 -05002882 public boolean canUseMultipleShadesForPopup() {
Brian Isganitisa85ae692021-09-23 19:56:24 -04002883 return getTopOpenViewWithType(this, TYPE_FOLDER) == null
2884 && getStateManager().getState() != LauncherState.ALL_APPS;
Sunny Goyal831212e2021-05-14 14:24:09 -07002885 }
2886
Sunny Goyalb5181c82021-03-10 07:39:12 +00002887 @Override
2888 protected void collectStateHandlers(List<StateHandler> out) {
2889 out.add(getAllAppsController());
2890 out.add(getWorkspace());
Andrew Sappersteinabef55a2016-06-19 12:49:00 -07002891 }
2892
Sunny Goyal210e1742019-10-17 12:05:38 -07002893 public TouchController[] createTouchControllers() {
2894 return new TouchController[] {getDragController(), new AllAppsSwipeController(this)};
2895 }
2896
Sunny Goyal1eb11242022-09-09 17:14:45 -07002897 public void onDragLayerHierarchyChanged() {
2898 updateDisallowBack();
2899 }
2900
Vinit Nayak65460402023-08-11 15:40:07 -07002901 protected void addBackAnimationCallback(BackPressHandler callback) {
2902 mBackPressedHandlers.add(callback);
2903 }
2904
2905 protected void removeBackAnimationCallback(BackPressHandler callback) {
2906 mBackPressedHandlers.remove(callback);
2907 }
2908
Sunny Goyal1eb11242022-09-09 17:14:45 -07002909 private void updateDisallowBack() {
Ats Jenk5c25c3a2023-10-12 09:24:56 -07002910 // TODO(b/304778354): remove sysprop once desktop aconfig flag supports dynamic overriding
2911 if (ENABLE_DESKTOP_WINDOWING || DESKTOP_MODE_SUPPORTED) {
Ats Jenk8121e0d2022-12-01 11:34:43 -08002912 // Do not disable back in launcher when prototype behavior is enabled
2913 return;
2914 }
Sunny Goyal1eb11242022-09-09 17:14:45 -07002915 LauncherRootView rv = getRootView();
2916 if (rv != null) {
Vinit Nayak65460402023-08-11 15:40:07 -07002917 boolean isSplitSelectionEnabled = isSplitSelectionEnabled();
Sunny Goyal1eb11242022-09-09 17:14:45 -07002918 boolean disableBack = getStateManager().getState() == NORMAL
Vinit Nayak65460402023-08-11 15:40:07 -07002919 && AbstractFloatingView.getTopOpenView(this) == null
2920 && !isSplitSelectionEnabled;
Sunny Goyal1eb11242022-09-09 17:14:45 -07002921 rv.setDisallowBackGesture(disableBack);
2922 }
2923 }
Sunny Goyal210e1742019-10-17 12:05:38 -07002924
Vinit Nayak65460402023-08-11 15:40:07 -07002925 /** To be overridden by subclasses */
Vinit Nayak1525cd72023-10-06 14:40:49 -07002926 public boolean isSplitSelectionEnabled() {
Vinit Nayak65460402023-08-11 15:40:07 -07002927 // Overridden
2928 return false;
2929 }
2930
Vinit Nayakd0fc7182023-10-06 16:05:54 -07002931 /** Call to dismiss the intermediary split selection state. */
2932 public void dismissSplitSelection() {
2933 // Overridden; move this into ActivityContext if necessary for Taskbar
2934 }
2935
Jon Miranda20fdc7b2023-12-12 16:48:01 -08002936 /**
2937 * Callback for when launcher state transition completes after user swipes to home.
2938 * @param finalState The final state of the transition.
2939 */
2940 public void onStateTransitionCompletedAfterSwipeToHome(LauncherState finalState) {
2941 // Overridden
2942 }
2943
Vinit Nayakf9b585b2019-07-10 14:25:32 -07002944 @Override
2945 public void returnToHomescreen() {
2946 super.returnToHomescreen();
2947 getStateManager().goToState(LauncherState.NORMAL);
2948 }
2949
Sebastian Franco4080fdd2023-09-19 14:17:23 -07002950 public void closeOpenViews() {
Andy Wickham65ced1b2020-03-07 02:14:19 +00002951 closeOpenViews(true);
2952 }
2953
2954 protected void closeOpenViews(boolean animate) {
2955 AbstractFloatingView.closeAllOpenViews(this, animate);
2956 }
2957
Sunny Goyal384b5782021-02-09 22:50:02 -08002958 protected LauncherAccessibilityDelegate createAccessibilityDelegate() {
2959 return new LauncherAccessibilityDelegate(this);
2960 }
Sunny Goyalf2393f12020-04-01 20:13:12 -07002961
Schneider Victor-tulias7cd0ae32023-03-21 11:46:18 -07002962 /** Enables/disabled the hotseat prediction icon long press edu for testing. */
2963 @VisibleForTesting
2964 public void enableHotseatEdu(boolean enable) {}
2965
Sunny Goyal210e1742019-10-17 12:05:38 -07002966
Sunny Goyal3dce5f32017-10-05 11:40:05 -07002967 /**
Sunny Goyalab770a12018-11-14 15:17:26 -08002968 * Just a wrapper around the type cast to allow easier tracking of calls.
2969 */
2970 public static <T extends Launcher> T cast(ActivityContext activityContext) {
2971 return (T) activityContext;
2972 }
2973
Sunny Goyalb65d7662021-03-07 15:09:11 -08002974 public boolean supportsAdaptiveIconAnimation(View clickedView) {
2975 return false;
2976 }
2977
Schneider Victor-tulias9b6babf2022-03-24 14:47:32 -07002978 /**
2979 * Animates Launcher elements during a transition to the All Apps page.
2980 *
2981 * @param progress Transition progress from 0 to 1; where 0 => home and 1 => all apps.
2982 */
2983 public void onAllAppsTransition(float progress) {
2984 // No-Op
2985 }
2986
2987 /**
2988 * Animates Launcher elements during a transition to the Widgets pages.
2989 *
2990 * @param progress Transition progress from 0 to 1; where 0 => home and 1 => widgets.
2991 */
2992 public void onWidgetsTransition(float progress) {
Alex Chau3d2c0622022-09-01 21:28:14 +01002993 float scale = Utilities.mapToRange(progress, 0f, 1f, 1f,
2994 mDeviceProfile.bottomSheetWorkspaceScale, EMPHASIZED);
2995 WORKSPACE_WIDGET_SCALE.set(getWorkspace(), scale);
2996 HOTSEAT_WIDGET_SCALE.set(getHotseat(), scale);
Schneider Victor-tulias9b6babf2022-03-24 14:47:32 -07002997 }
2998
Sunny Goyal6c0c61a2020-12-08 19:19:56 -08002999 private static class NonConfigInstance {
3000 public Configuration config;
Sunny Goyal6c0c61a2020-12-08 19:19:56 -08003001 }
thiruramc96873c2021-02-11 15:13:47 -08003002
Schneider Victor-tulias789a6a92022-03-04 12:06:09 -08003003 /** Pauses view updates that should not be run during the app launch animation. */
3004 public void pauseExpensiveViewUpdates() {
3005 // Pause page indicator animations as they lead to layer trashing.
Shikha Malhotrae957b602022-04-11 07:57:18 +00003006 getWorkspace().getPageIndicator().pauseAnimations();
Jon Miranda46ecc0c2022-06-02 11:34:15 -07003007
3008 getWorkspace().mapOverItems((info, view) -> {
3009 if (view instanceof LauncherAppWidgetHostView) {
3010 ((LauncherAppWidgetHostView) view).beginDeferringUpdates();
3011 }
3012 return false; // Return false to continue iterating through all the items.
3013 });
Schneider Victor-tulias789a6a92022-03-04 12:06:09 -08003014 }
3015
3016 /** Resumes view updates at the end of the app launch animation. */
3017 public void resumeExpensiveViewUpdates() {
Shikha Malhotrae957b602022-04-11 07:57:18 +00003018 getWorkspace().getPageIndicator().skipAnimationsToEnd();
Shikha Malhotra0f2e1b62022-03-27 21:02:21 +00003019
Jon Miranda46ecc0c2022-06-02 11:34:15 -07003020 getWorkspace().mapOverItems((info, view) -> {
3021 if (view instanceof LauncherAppWidgetHostView) {
3022 ((LauncherAppWidgetHostView) view).endDeferringUpdates();
3023 }
3024 return false; // Return false to continue iterating through all the items.
3025 });
3026 }
Ats Jenkca009e42023-01-06 09:52:40 -08003027
3028 /**
3029 * Returns {@code true} if there are visible tasks with windowing mode set to
3030 * {@link android.app.WindowConfiguration#WINDOWING_MODE_FREEFORM}
3031 */
3032 public boolean areFreeformTasksVisible() {
3033 return false; // Base launcher does not track freeform tasks
3034 }
Brian Isganitisf54c6fa2023-07-11 12:47:08 -04003035
Sebastian Franco8a3de212023-09-05 18:54:01 -07003036 // Getters and Setters
3037
Sebastian Franco8a3de212023-09-05 18:54:01 -07003038 public boolean isWorkspaceLocked() {
Sebastian Francoe4965122023-12-01 13:27:42 -06003039 return isWorkspaceLoading() || mPendingRequestArgs != null;
Sebastian Franco8a3de212023-09-05 18:54:01 -07003040 }
3041
3042 public boolean isWorkspaceLoading() {
Sebastian Francoe4965122023-12-01 13:27:42 -06003043 return mModelCallbacks.getWorkspaceLoading();
Sebastian Franco8a3de212023-09-05 18:54:01 -07003044 }
3045
Brian Isganitisf54c6fa2023-07-11 12:47:08 -04003046 @Override
Sebastian Franco8a3de212023-09-05 18:54:01 -07003047 public boolean isBindingItems() {
Sebastian Francoe4965122023-12-01 13:27:42 -06003048 return isWorkspaceLoading();
Sebastian Franco8a3de212023-09-05 18:54:01 -07003049 }
3050
3051 /**
3052 * Returns true if a touch interaction is in progress
3053 */
3054 public boolean isTouchInProgress() {
3055 return mTouchInProgress;
3056 }
3057
3058 public boolean isDraggingEnabled() {
3059 // We prevent dragging when we are loading the workspace as it is possible to pick up a view
3060 // that is subsequently removed from the workspace in startBinding().
3061 return !isWorkspaceLoading();
3062 }
3063
Tracy Zhoude8e25c2023-10-07 00:00:57 -07003064 public boolean isNaturalScrollingEnabled() {
3065 return mIsNaturalScrollingEnabled;
3066 }
3067
Sebastian Franco8a3de212023-09-05 18:54:01 -07003068 public void setWaitingForResult(PendingRequestArgs args) {
3069 mPendingRequestArgs = args;
3070 }
3071
3072 /**
3073 * Call this after onCreate to set or clear overlay.
3074 */
Sebastian Franco8a3de212023-09-05 18:54:01 -07003075 public void setLauncherOverlay(LauncherOverlay overlay) {
3076 mWorkspace.setLauncherOverlay(overlay);
3077 }
3078
Sebastian Franco8a3de212023-09-05 18:54:01 -07003079 /**
3080 * Persistent callback which notifies when an activity launch is deferred because the activity
3081 * was not yet resumed.
3082 */
3083 public void setOnDeferredActivityLaunchCallback(Runnable callback) {
3084 mOnDeferredActivityLaunchCallback = callback;
3085 }
3086
3087 /**
3088 * Sets the next pages to bind synchronously on next bind.
3089 * @param pages should not be null.
3090 */
3091 public void setPagesToBindSynchronously(@NonNull IntSet pages) {
Sebastian Franco69fd7422023-10-06 16:48:58 -07003092 mModelCallbacks.setPagesToBindSynchronously(pages);
Sebastian Franco8a3de212023-09-05 18:54:01 -07003093 }
3094
Sebastian Franco8a3de212023-09-05 18:54:01 -07003095 @Override
3096 public CellPosMapper getCellPosMapper() {
3097 return mCellPosMapper;
3098 }
3099
3100 public RotationHelper getRotationHelper() {
3101 return mRotationHelper;
3102 }
3103
3104 public ViewGroupFocusHelper getFocusHandler() {
3105 return mFocusHandler;
3106 }
3107
3108 @Override
3109 public StateManager<LauncherState> getStateManager() {
3110 return mStateManager;
3111 }
3112
3113 @NonNull
3114 @Override
3115 public PopupDataProvider getPopupDataProvider() {
3116 return mPopupDataProvider;
3117 }
3118
3119 @Override
3120 public DotInfo getDotInfoForItem(ItemInfo info) {
3121 return mPopupDataProvider.getDotInfoForItem(info);
3122 }
3123
3124 public LauncherOverlayManager getOverlayManager() {
3125 return mOverlayManager;
3126 }
3127
3128 public AllAppsTransitionController getAllAppsController() {
3129 return mAllAppsController;
3130 }
3131
3132 @Override
3133 public DragLayer getDragLayer() {
3134 return mDragLayer;
3135 }
3136
3137 @Override
3138 public ActivityAllAppsContainerView<Launcher> getAppsView() {
3139 return mAppsView;
3140 }
3141
3142 public Workspace<?> getWorkspace() {
3143 return mWorkspace;
3144 }
3145
3146 public Hotseat getHotseat() {
3147 return mHotseat;
3148 }
3149
3150 public <T extends View> T getOverviewPanel() {
3151 return (T) mOverviewPanel;
3152 }
3153
3154 public DropTargetBar getDropTargetBar() {
3155 return mDropTargetBar;
3156 }
3157
3158 @Override
3159 public ScrimView getScrimView() {
3160 return mScrimView;
3161 }
3162
3163 public LauncherWidgetHolder getAppWidgetHolder() {
3164 return mAppWidgetHolder;
3165 }
3166
3167 public LauncherModel getModel() {
3168 return mModel;
3169 }
3170
3171 /**
3172 * Returns the ModelWriter writer, make sure to call the function every time you want to use it.
3173 */
3174 public ModelWriter getModelWriter() {
3175 return mModelWriter;
3176 }
3177
Sebastian Franco8a3de212023-09-05 18:54:01 -07003178 public SharedPreferences getSharedPrefs() {
3179 return mSharedPrefs;
3180 }
3181
Sebastian Franco8a3de212023-09-05 18:54:01 -07003182 public int getOrientation() {
3183 return mOldConfig.orientation;
3184 }
3185
Sebastian Franco8a3de212023-09-05 18:54:01 -07003186 /**
3187 * Returns the CellLayout of the specified container at the specified screen.
3188 *
3189 * @param screenId must be presenterPos and not modelPos.
3190 */
3191 public CellLayout getCellLayout(int container, int screenId) {
3192 return (container == LauncherSettings.Favorites.CONTAINER_HOTSEAT)
3193 ? mHotseat : mWorkspace.getScreenWithId(screenId);
3194 }
3195
3196 @Override
3197 public StringCache getStringCache() {
Sebastian Franco6dda7c72023-11-17 18:03:00 -06003198 return mModelCallbacks.getStringCache();
Sebastian Franco8a3de212023-09-05 18:54:01 -07003199 }
3200
3201 /**
3202 * Returns target rectangle for anchoring a popup menu.
3203 */
3204 protected RectF getPopupTarget(float x, float y) {
3205 float halfSize = getResources().getDimension(R.dimen.options_menu_thumb_size) / 2;
3206 if (x < 0 || y < 0) {
3207 x = mDragLayer.getWidth() / 2;
3208 y = mDragLayer.getHeight() / 2;
3209 }
3210 return new RectF(x - halfSize, y - halfSize, x + halfSize, y + halfSize);
3211 }
3212
3213 public Stream<SystemShortcut.Factory> getSupportedShortcuts() {
3214 return Stream.of(APP_INFO, WIDGETS, INSTALL);
3215 }
3216
3217 /**
3218 * @see LauncherState#getOverviewScaleAndOffset(Launcher)
3219 */
3220 public float[] getNormalOverviewScaleAndOffset() {
3221 return new float[] {NO_SCALE, NO_OFFSET};
Brian Isganitisf54c6fa2023-07-11 12:47:08 -04003222 }
Jeremy Sim94fd07e2023-04-19 20:56:49 -07003223
3224 /**
3225 * Handles an app pair launch; overridden in
3226 * {@link com.android.launcher3.uioverrides.QuickstepLauncher}
3227 */
Jeremy Sim23fcbf22023-11-29 17:41:17 -08003228 public void launchAppPair(AppPairIcon appPairIcon) {
Jeremy Sim94fd07e2023-04-19 20:56:49 -07003229 // Overridden
3230 }
Sunny Goyal0ee66472023-08-17 16:19:22 -07003231
fbaronc0e687b2023-10-04 12:11:20 -07003232 public boolean getIsFirstPagePinnedItemEnabled() {
Sebastian Franco6dda7c72023-11-17 18:03:00 -06003233 return mModelCallbacks.getIsFirstPagePinnedItemEnabled();
fbaronc0e687b2023-10-04 12:11:20 -07003234 }
3235
Sunny Goyal0ee66472023-08-17 16:19:22 -07003236 /**
3237 * Returns the animation coordinator for playing one-off animations
3238 */
3239 public CannedAnimationCoordinator getAnimationCoordinator() {
3240 return mAnimationCoordinator;
3241 }
Sebastian Franco8a3de212023-09-05 18:54:01 -07003242
3243 @Override
3244 public View.OnLongClickListener getAllAppsItemLongClickListener() {
3245 return ItemLongClickListener.INSTANCE_ALL_APPS;
3246 }
3247
3248 @Override
3249 public StatsLogManager getStatsLogManager() {
3250 return super.getStatsLogManager().withDefaultInstanceId(mAllAppsSessionLogId);
3251 }
3252
3253 /**
3254 * Returns the current popup for testing, if any.
3255 */
3256 @VisibleForTesting
3257 @Nullable
3258 public ArrowPopup<?> getOptionsPopup() {
3259 return findViewById(R.id.popup_container);
3260 }
3261
3262 // End of Getters and Setters
Sebastian Francobd7919c2023-09-19 10:55:37 -07003263}