/* * 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.compat; import android.content.ComponentName; import android.content.Context; import android.content.Intent; import android.content.pm.ApplicationInfo; import android.content.pm.LauncherActivityInfo; import android.graphics.Rect; import android.os.Bundle; import android.os.UserHandle; import android.support.annotation.Nullable; import com.android.launcher3.LauncherAppState; import com.android.launcher3.ShortcutInfo; import com.android.launcher3.Utilities; import com.android.launcher3.graphics.LauncherIcons; import com.android.launcher3.shortcuts.ShortcutInfoCompat; import java.util.List; public abstract class LauncherAppsCompat { public interface OnAppsChangedCallbackCompat { void onPackageRemoved(String packageName, UserHandle user); void onPackageAdded(String packageName, UserHandle user); void onPackageChanged(String packageName, UserHandle user); void onPackagesAvailable(String[] packageNames, UserHandle user, boolean replacing); void onPackagesUnavailable(String[] packageNames, UserHandle user, boolean replacing); void onPackagesSuspended(String[] packageNames, UserHandle user); void onPackagesUnsuspended(String[] packageNames, UserHandle user); void onShortcutsChanged(String packageName, List shortcuts, UserHandle user); } protected LauncherAppsCompat() { } private static LauncherAppsCompat sInstance; private static Object sInstanceLock = new Object(); public static LauncherAppsCompat getInstance(Context context) { synchronized (sInstanceLock) { if (sInstance == null) { if (Utilities.isAtLeastO()) { sInstance = new LauncherAppsCompatVO(context.getApplicationContext()); } else { sInstance = new LauncherAppsCompatVL(context.getApplicationContext()); } } return sInstance; } } public abstract List getActivityList(String packageName, UserHandle user); public abstract LauncherActivityInfo resolveActivity(Intent intent, UserHandle user); public abstract void startActivityForProfile(ComponentName component, UserHandle user, Rect sourceBounds, Bundle opts); public abstract ApplicationInfo getApplicationInfo( String packageName, int flags, UserHandle user); public abstract void showAppDetailsForProfile(ComponentName component, UserHandle user); public abstract void addOnAppsChangedCallback(OnAppsChangedCallbackCompat listener); public abstract void removeOnAppsChangedCallback(OnAppsChangedCallbackCompat listener); public abstract boolean isPackageEnabledForProfile(String packageName, UserHandle user); public abstract boolean isActivityEnabledForProfile(ComponentName component, UserHandle user); public abstract List getCustomShortcutActivityList(); /** * 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 ShortcutInfo immediately * to the model (which may involves a single post-to-worker-thread). That will guarantee * that (d) happens after model is updated. */ @Nullable public static ShortcutInfo createShortcutInfoFromPinItemRequest( Context context, PinItemRequestCompat request) { if (request != null && request.getRequestType() == PinItemRequestCompat.REQUEST_TYPE_SHORTCUT && request.isValid() && request.accept()) { ShortcutInfoCompat compat = new ShortcutInfoCompat(request.getShortcutInfo()); ShortcutInfo info = new ShortcutInfo(compat, context); // Apply the unbadged icon and fetch the actual icon asynchronously. info.iconBitmap = LauncherIcons .createShortcutIcon(compat, context, false /* badged */); LauncherAppState.getInstance(context).getModel() .updateAndBindShortcutInfo(info, compat); return info; } else { return null; } } }