| /* |
| * Copyright (C) 2018 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 android.content.om; |
| |
| import android.annotation.Nullable; |
| import android.annotation.SystemApi; |
| import android.annotation.SystemService; |
| import android.content.Context; |
| import android.os.RemoteException; |
| import android.os.ServiceManager; |
| |
| import java.util.List; |
| |
| /** |
| * Updates OverlayManager state; gets information about installed overlay packages. |
| * @hide |
| */ |
| @SystemApi |
| @SystemService(Context.OVERLAY_SERVICE) |
| public class OverlayManager { |
| |
| private final IOverlayManager mService; |
| private final Context mContext; |
| |
| /** |
| * Creates a new instance. |
| * |
| * @param context The current context in which to operate. |
| * @param service The backing system service. |
| * |
| * @hide |
| */ |
| public OverlayManager(Context context, IOverlayManager service) { |
| mContext = context; |
| mService = service; |
| } |
| |
| /** @hide */ |
| public OverlayManager(Context context) { |
| this(context, IOverlayManager.Stub.asInterface( |
| ServiceManager.getService(Context.OVERLAY_SERVICE))); |
| } |
| |
| /** |
| * Request that an overlay package is enabled and any other overlay packages with the same |
| * target package and category are disabled. |
| * |
| * @param packageName the name of the overlay package to enable. |
| * @param userId The user for which to change the overlay. |
| * @return true if the system successfully registered the request, false otherwise. |
| * |
| * @hide |
| */ |
| @SystemApi |
| public boolean setEnabledExclusiveInCategory(@Nullable final String packageName, |
| int userId) { |
| try { |
| return mService.setEnabledExclusiveInCategory(packageName, userId); |
| } catch (RemoteException e) { |
| throw e.rethrowFromSystemServer(); |
| } |
| } |
| |
| /** |
| * Request that an overlay package is enabled. |
| * |
| * @param packageName the name of the overlay package to enable. |
| * @param enable {@code false} if the overlay should be turned off. |
| * @param userId The user for which to change the overlay. |
| * @return true if the system successfully registered the request, false otherwise. |
| * |
| * @hide |
| */ |
| @SystemApi |
| public boolean setEnabled(@Nullable final String packageName, final boolean enable, |
| int userId) { |
| try { |
| return mService.setEnabled(packageName, enable, userId); |
| } catch (RemoteException e) { |
| throw e.rethrowFromSystemServer(); |
| } |
| } |
| |
| /** |
| * Returns information about all overlays for the given target package for |
| * the specified user. The returned list is ordered according to the |
| * overlay priority with the highest priority at the end of the list. |
| * |
| * @param targetPackageName The name of the target package. |
| * @param userId The user to get the OverlayInfos for. |
| * @return A list of OverlayInfo objects; if no overlays exist for the |
| * requested package, an empty list is returned. |
| * |
| * @hide |
| */ |
| @SystemApi |
| public List<OverlayInfo> getOverlayInfosForTarget(@Nullable final String targetPackageName, |
| int userId) { |
| try { |
| return mService.getOverlayInfosForTarget(targetPackageName, userId); |
| } catch (RemoteException e) { |
| throw e.rethrowFromSystemServer(); |
| } |
| } |
| } |