1/* 2 * Copyright (C) 2011 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 17package com.android.internal.appwidget; 18 19import android.content.ComponentName; 20import android.content.Intent; 21import android.content.IntentSender; 22import android.content.pm.ApplicationInfo; 23import android.appwidget.AppWidgetProviderInfo; 24import com.android.internal.appwidget.IAppWidgetHost; 25import android.os.Bundle; 26import android.os.IBinder; 27import android.widget.RemoteViews; 28 29/** {@hide} */ 30interface IAppWidgetService { 31 32 // 33 // for AppWidgetHost 34 // 35 int[] startListening(IAppWidgetHost host, String callingPackage, int hostId, 36 out List<RemoteViews> updatedViews); 37 void stopListening(String callingPackage, int hostId); 38 int allocateAppWidgetId(String callingPackage, int hostId); 39 void deleteAppWidgetId(String callingPackage, int appWidgetId); 40 void deleteHost(String packageName, int hostId); 41 void deleteAllHosts(); 42 RemoteViews getAppWidgetViews(String callingPackage, int appWidgetId); 43 int[] getAppWidgetIdsForHost(String callingPackage, int hostId); 44 IntentSender createAppWidgetConfigIntentSender(String callingPackage, int appWidgetId, 45 int intentFlags); 46 47 // 48 // for AppWidgetManager 49 // 50 void updateAppWidgetIds(String callingPackage, in int[] appWidgetIds, in RemoteViews views); 51 void updateAppWidgetOptions(String callingPackage, int appWidgetId, in Bundle extras); 52 Bundle getAppWidgetOptions(String callingPackage, int appWidgetId); 53 void partiallyUpdateAppWidgetIds(String callingPackage, in int[] appWidgetIds, 54 in RemoteViews views); 55 void updateAppWidgetProvider(in ComponentName provider, in RemoteViews views); 56 void notifyAppWidgetViewDataChanged(String packageName, in int[] appWidgetIds, int viewId); 57 List<AppWidgetProviderInfo> getInstalledProvidersForProfile(int categoryFilter, 58 int profileId); 59 AppWidgetProviderInfo getAppWidgetInfo(String callingPackage, int appWidgetId); 60 boolean hasBindAppWidgetPermission(in String packageName, int userId); 61 void setBindAppWidgetPermission(in String packageName, int userId, in boolean permission); 62 boolean bindAppWidgetId(in String callingPackage, int appWidgetId, 63 int providerProfileId, in ComponentName providerComponent, in Bundle options); 64 void bindRemoteViewsService(String callingPackage, int appWidgetId, in Intent intent, 65 in IBinder connection); 66 void unbindRemoteViewsService(String callingPackage, int appWidgetId, in Intent intent); 67 int[] getAppWidgetIds(in ComponentName providerComponent); 68} 69 70