| /* |
| * Copyright (C) 2014 The Android Open Source Project |
| * |
| * Licensed under the Apache License, Version 2.0 (the "License"); |
| * you may not use this file except in compliance with the License. |
| * You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| |
| package com.android.launcher3.pm; |
| |
| import static com.android.launcher3.util.Executors.MODEL_EXECUTOR; |
| |
| import android.annotation.TargetApi; |
| import android.content.Context; |
| import android.content.Intent; |
| import android.content.pm.LauncherApps; |
| import android.content.pm.LauncherApps.PinItemRequest; |
| import android.content.pm.ShortcutInfo; |
| import android.content.pm.ShortcutManager; |
| import android.os.Build; |
| import android.os.Parcelable; |
| import android.os.SystemClock; |
| |
| import androidx.annotation.Nullable; |
| |
| import com.android.launcher3.LauncherAppState; |
| import com.android.launcher3.icons.ShortcutCachingLogic; |
| import com.android.launcher3.model.data.WorkspaceItemInfo; |
| |
| public class PinRequestHelper { |
| |
| /** |
| * request.accept() will initiate the following flow: |
| * -> go-to-system-process for actual processing (a) |
| * -> callback-to-launcher on UI thread (b) |
| * -> post callback on the worker thread (c) |
| * -> Update model and unpin (in system) any shortcut not in out model. (d) |
| * |
| * Note that (b) will take at-least one frame as it involves posting callback from binder |
| * thread to UI thread. |
| * If (d) happens before we add this shortcut to our model, we will end up unpinning |
| * the shortcut in the system. |
| * Here its the caller's responsibility to add the newly created WorkspaceItemInfo immediately |
| * to the model (which may involves a single post-to-worker-thread). That will guarantee |
| * that (d) happens after model is updated. |
| */ |
| @Nullable |
| @TargetApi(Build.VERSION_CODES.O) |
| public static WorkspaceItemInfo createWorkspaceItemFromPinItemRequest( |
| Context context, final PinItemRequest request, final long acceptDelay) { |
| if (request != null && request.getRequestType() == PinItemRequest.REQUEST_TYPE_SHORTCUT |
| && request.isValid()) { |
| |
| if (acceptDelay <= 0) { |
| if (!request.accept()) { |
| return null; |
| } |
| } else { |
| // Block the worker thread until the accept() is called. |
| MODEL_EXECUTOR.execute(() -> { |
| SystemClock.sleep(acceptDelay); |
| if (request.isValid()) { |
| request.accept(); |
| } |
| }); |
| } |
| |
| ShortcutInfo si = request.getShortcutInfo(); |
| WorkspaceItemInfo info = new WorkspaceItemInfo(si, context); |
| // Apply the unbadged icon synchronously using the caching logic directly and |
| // fetch the actual icon asynchronously. |
| info.bitmap = new ShortcutCachingLogic().loadIcon(context, si); |
| LauncherAppState.getInstance(context).getModel().updateAndBindWorkspaceItem(info, si); |
| return info; |
| } else { |
| return null; |
| } |
| } |
| |
| @TargetApi(Build.VERSION_CODES.O) |
| public static PinItemRequest getPinItemRequest(Intent intent) { |
| Parcelable extra = intent.getParcelableExtra(LauncherApps.EXTRA_PIN_ITEM_REQUEST); |
| return extra instanceof PinItemRequest ? (PinItemRequest) extra : null; |
| } |
| |
| /** |
| * Returns a PinItemRequest corresponding to the provided ShortcutInfo |
| */ |
| public static PinItemRequest createRequestForShortcut(Context context, ShortcutInfo info) { |
| return context.getSystemService(LauncherApps.class) |
| .getPinItemRequest(context.getSystemService(ShortcutManager.class) |
| .createShortcutResultIntent(info)); |
| } |
| } |