AppWidgetManager

ACTION_APPWIDGET_BIND

String ACTION_APPWIDGET_BIND

当您要绑定要显示的AppWidget并且bindAppWidgetIdIfAllowed返回false时，从您的 AppWidgetHost活动启动的活动操作。

您必须提供以下额外服务：

系统将通过onActivityResult调用进行响应，其意图中包含以下额外内容：

当您从AppWidget绑定活动收到结果时，如果resultCode为RESULT_OK ，则AppWidget已被绑定。 然后，您应该检查AppWidgetProviderInfo以获取返回的AppWidget，如果它有，则启动其配置活动。 如果返回RESULT_CANCELED ，则应删除appWidgetId。

常量值：“android.appwidget.action.APPWIDGET_BIND”

ACTION_APPWIDGET_CONFIGURE

String ACTION_APPWIDGET_CONFIGURE

在AppWidget添加到主机时配置AppWidget时发送。 此操作不作为广播发送到AppWidget提供程序，而是作为AppWidgetProviderInfo meta-data指定活动的startActivity发送。

意图将包含以下额外内容：

如果您使用Activity.setResult()返回RESULT_OK ，则会添加AppWidget，并且您将收到针对此AppWidget的ACTION_APPWIDGET_UPDATE广播。 如果您返回RESULT_CANCELED ，主机将取消添加并且不显示此AppWidget，并且您将收到ACTION_APPWIDGET_DELETED广播。

常量值：“android.appwidget.action.APPWIDGET_CONFIGURE”

ACTION_APPWIDGET_DELETED

String ACTION_APPWIDGET_DELETED

从主机中删除AppWidget的实例时发送。

这是一个受保护的意图，只能由系统发送。

常量值：“android.appwidget.action.APPWIDGET_DELETED”

ACTION_APPWIDGET_DISABLED

String ACTION_APPWIDGET_DISABLED

从最后一个主机中删除此提供程序的最后一个AppWidget时发送。

这是一个受保护的意图，只能由系统发送。

常量值：“android.appwidget.action.APPWIDGET_DISABLED”

ACTION_APPWIDGET_ENABLED

String ACTION_APPWIDGET_ENABLED

当AppWidget的一个实例第一次被添加到主机时发送。 如果安装了此提供程序的实例的AppWidgetHost，则会在引导时发送此广播。

这是一个受保护的意图，只能由系统发送。

常量值：“android.appwidget.action.APPWIDGET_ENABLED”

ACTION_APPWIDGET_HOST_RESTORED

String ACTION_APPWIDGET_HOST_RESTORED

与主机相关的AppWidget状态已从备份中恢复后，发送到小部件主机。 意图包含有关如何将AppWidget ID从恢复的数据转换为新的等价物的信息。 如果应用程序维护多个独立的小部件主机实例，它将分别为每个实例接收此广播。

意图将包含以下额外内容：

这是一个受保护的意图，只能由系统发送。

常量值：“android.appwidget.action.APPWIDGET_HOST_RESTORED”

ACTION_APPWIDGET_OPTIONS_CHANGED

String ACTION_APPWIDGET_OPTIONS_CHANGED

自定义额外的AppWidget更改时发送。

这是一个受保护的意图，只能由系统发送。

常量值：“android.appwidget.action.APPWIDGET_UPDATE_OPTIONS”

ACTION_APPWIDGET_PICK

String ACTION_APPWIDGET_PICK

当您想要选择要显示的AppWidget时，从您的AppWidgetHost活动启动的活动动作。 AppWidget选取器活动将启动。

您必须提供以下额外服务：

系统将通过onActivityResult调用进行响应，其意图中包含以下额外内容：

当您从AppWidget选择活动收到结果时，如果resultCode为RESULT_OK ，则已选择一个AppWidget。 然后，您应该检查AppWidgetProviderInfo以获取返回的AppWidget，如果它有，则启动其配置活动。 如果返回RESULT_CANCELED ，则应删除appWidgetId。

常量值：“android.appwidget.action.APPWIDGET_PICK”

ACTION_APPWIDGET_RESTORED

String ACTION_APPWIDGET_RESTORED

与该提供程序相关的AppWidget状态已从备份中恢复之后，发送到AppWidgetProvider 。 意图包含有关如何将AppWidget ID从恢复的数据转换为新的等价物的信息。

意图将包含以下额外内容：

这是一个受保护的意图，只能由系统发送。

常量值：“android.appwidget.action.APPWIDGET_RESTORED”

ACTION_APPWIDGET_UPDATE

String ACTION_APPWIDGET_UPDATE

在需要更新AppWidget时发送。

这可以响应于已经实例化该AppWidget提供者的新实例而发送，所请求的 update interval已经失效或者系统引导。

意图将包含以下额外内容：

常量值：“android.appwidget.action.APPWIDGET_UPDATE”

EXTRA_APPWIDGET_ID

String EXTRA_APPWIDGET_ID

包含一个appWidgetId的意图附加。

该值将是一个可以像这样获取的int值：

Bundle extras = intent.getExtras();
int appWidgetId = extras.getInt(AppWidgetManager.EXTRA_APPWIDGET_ID);

常量值：“appWidgetId”

EXTRA_APPWIDGET_IDS

String EXTRA_APPWIDGET_IDS

包含多个appWidgetIds的意图附加。

该值将是一个可以像这样检索的int数组：

Bundle extras = intent.getExtras();
int[] appWidgetIds = extras.getIntArray(AppWidgetManager.EXTRA_APPWIDGET_IDS);

常量值：“appWidgetIds”

EXTRA_APPWIDGET_OLD_IDS

String EXTRA_APPWIDGET_OLD_IDS

包含多个appWidgetIds的意图附加。 这些是在最近从备份恢复过程中向应用程序提供的id值。 它附加到ACTION_APPWIDGET_RESTORED广播意图。

该值将是一个可以像这样检索的int数组：

Bundle extras = intent.getExtras();
int[] appWidgetIds = extras.getIntArray(AppWidgetManager.EXTRA_APPWIDGET_IDS);

常量值：“appWidgetOldIds”

EXTRA_APPWIDGET_OPTIONS

String EXTRA_APPWIDGET_OPTIONS

一个额外的意图，指向一个特定的widget ID额外的信息包。 尤其是这个包可以包含OPTION_APPWIDGET_MIN_WIDTH ， OPTION_APPWIDGET_MIN_HEIGHT ， OPTION_APPWIDGET_MAX_WIDTH ， OPTION_APPWIDGET_MAX_HEIGHT 。

常量值：“appWidgetOptions”

EXTRA_APPWIDGET_PROVIDER

String EXTRA_APPWIDGET_PROVIDER

包含AppWidget提供程序的组件名称的意图附加程序。

该值将是 ComponentName 。

常量值：“appWidgetProvider”

EXTRA_APPWIDGET_PROVIDER_PROFILE

String EXTRA_APPWIDGET_PROVIDER_PROFILE

一个意图额外的内容，其中包含AppWidget提供程序注册的配置文件的用户句柄。

该值将是 UserHandle 。

常量值：“appWidgetProviderProfile”

EXTRA_CUSTOM_EXTRAS

String EXTRA_CUSTOM_EXTRAS

一个额外的意图传递给包含List个Bundle对象的AppWidget选择器，以混合到所安装的AppWidgets列表中。 它将被添加到从选择器活动返回的Intent上的extras对象。

常量值：“customExtras”

EXTRA_CUSTOM_INFO

String EXTRA_CUSTOM_INFO

一个额外的意图传递给包含的AppWidget选择器List的AppWidgetProviderInfo对象在混合到已安装AppWidgets的列表。 （这是启动器显示搜索小部件的方式）。

常量值：“customInfo”

EXTRA_HOST_ID

String EXTRA_HOST_ID

一个额外附加到 ACTION_APPWIDGET_HOST_RESTORED广播的意图，指示其小部件刚刚恢复的主机的整数ID。

常量值：“hostId”

INVALID_APPWIDGET_ID

int INVALID_APPWIDGET_ID

AppWidget管理器永远不会以appWidgetId形式返回的标记值。

常量值：0（0x00000000）

META_DATA_APPWIDGET_PROVIDER

String META_DATA_APPWIDGET_PROVIDER

清单元数据标签的字段。

常量值：“android.appwidget.provider”

OPTION_APPWIDGET_HOST_CATEGORY

String OPTION_APPWIDGET_HOST_CATEGORY

向AppWidgetProvider提示拥有此小部件的主机类别的附加包。 可以具有值WIDGET_CATEGORY_HOME_SCREEN或WIDGET_CATEGORY_KEYGUARD或WIDGET_CATEGORY_SEARCHBOX 。

常量值：“appWidgetCategory”

OPTION_APPWIDGET_MAX_HEIGHT

String OPTION_APPWIDGET_MAX_HEIGHT

一个额外的包，它包含一个小部件实例的当前宽度的上限（以骤降为单位）。

常量值：“appWidgetMaxHeight”

OPTION_APPWIDGET_MAX_WIDTH

String OPTION_APPWIDGET_MAX_WIDTH

一个额外的包，它包含一个小部件实例的当前宽度的上限（以骤降为单位）。

常量值：“appWidgetMaxWidth”

OPTION_APPWIDGET_MIN_HEIGHT

String OPTION_APPWIDGET_MIN_HEIGHT

一个额外的包，它包含一个小部件实例的当前高度下限（以骤降为单位）。

常量值：“appWidgetMinHeight”

OPTION_APPWIDGET_MIN_WIDTH

String OPTION_APPWIDGET_MIN_WIDTH

一个额外的包，它包含一个小部件实例当前宽度的下限（以骤数为单位）。

常量值：“appWidgetMinWidth”

bindAppWidgetIdIfAllowed

boolean bindAppWidgetIdIfAllowed (int appWidgetId, 
                ComponentName provider)

为给定的appWidgetId设置组件。

您需要BIND_APPWIDGET权限，或者用户必须始终为您的组件启用绑定小部件。 应该由主持小部件的应用程序使用; 如果此方法返回false，请致电ACTION_APPWIDGET_BIND以请求绑定权限

bindAppWidgetIdIfAllowed

boolean bindAppWidgetIdIfAllowed (int appWidgetId, 
                UserHandle user, 
                ComponentName provider, 
                Bundle options)

如果调用者拥有权限，请为给定的appWidgetId设置提供者。

注意：您需要BIND_APPWIDGET权限，或者用户必须始终为您的组件启用绑定小部件。 应由主持小部件的应用程序使用。 如果此方法返回false，请致电ACTION_APPWIDGET_BIND以请求绑定权限。

bindAppWidgetIdIfAllowed

boolean bindAppWidgetIdIfAllowed (int appWidgetId, 
                ComponentName provider, 
                Bundle options)

为给定的appWidgetId设置组件。

您需要BIND_APPWIDGET权限，或者用户必须始终为您的组件启用绑定小部件。 应该由主持小部件的应用程序使用; 如果此方法返回false，请致电ACTION_APPWIDGET_BIND以请求绑定权限

getAppWidgetIds

int[] getAppWidgetIds (ComponentName provider)

获取已绑定到给定AppWidget提供程序的appWidgetIds列表。

getAppWidgetInfo

AppWidgetProviderInfo getAppWidgetInfo (int appWidgetId)

获取有关AppWidget的可用信息。

getAppWidgetOptions

Bundle getAppWidgetOptions (int appWidgetId)

获取与给定小部件实例关联的额外内容。

额外信息可用于嵌入关于此小部件的其他信息，以便通过关联的小部件的AppWidgetProvider访问。

getInstalledProviders

List<AppWidgetProviderInfo> getInstalledProviders ()

返回当前安装的AppWidget提供程序列表。

getInstalledProvidersForProfile

List<AppWidgetProviderInfo> getInstalledProvidersForProfile (UserHandle profile)

获取给定用户配置文件的AppWidget提供程序。 用户配置文件只能是当前用户或当前用户的配置文件。 例如，当前用户可能有公司资料。 在这种情况下，父级用户配置文件具有子配置文件，即公司配置文件。

getInstance

AppWidgetManager getInstance (Context context)

获取AppWidgetManager实例以用于提供的 Context对象。

notifyAppWidgetViewDataChanged

void notifyAppWidgetViewDataChanged (int appWidgetId, 
                int viewId)

通知指定的AppWidget实例中的指定collection视图使其数据无效。

notifyAppWidgetViewDataChanged

void notifyAppWidgetViewDataChanged (int[] appWidgetIds, 
                int viewId)

在所有指定的AppWidget实例中通知指定的集合视图以使其数据无效。

partiallyUpdateAppWidget

void partiallyUpdateAppWidget (int appWidgetId, 
                RemoteViews views)

对由appWidgetId指定的小部件执行增量更新或命令。

此更新与updateAppWidget(int, RemoteViews)不同之处在于， updateAppWidget(int, RemoteViews)的RemoteViews对象被理解为该窗口小部件的不完整表示，因此不会被AppWidgetService缓存。 请注意，因为这些更新没有被缓存，所以它们修改的任何状态都不会被restoreInstanceState恢复，在使用AppWidgetService中的缓存版本恢复Widget的情况下将不会持续。 与使用showNext(int) ， showPrevious(int) ， setScrollPosition(int, int)和类似的命令。

在ACTION_APPWIDGET_UPDATE广播内部和处理器之外调用此方法是可以的。 此方法仅在拥有AppWidget提供者的uid中调用时才有效。

如果小部件未通过 updateAppWidget(int[], RemoteViews)收到完整更新，则此方法将被忽略。

partiallyUpdateAppWidget

void partiallyUpdateAppWidget (int[] appWidgetIds, 
                RemoteViews views)

对由appWidgetIds指定的小部件执行增量更新或命令。

此更新与updateAppWidget(int[], RemoteViews)不同之处在于， updateAppWidget(int[], RemoteViews)的RemoteViews对象被理解为该窗口小部件的不完整表示形式，因此不会替代该窗口小部件的高速缓存表示形式。 从API级别17开始，在视图对象中设置的新属性将被附加到小部件的缓存表示中，因此将会持续存在。 与使用showNext(int) ， showPrevious(int) ， setScrollPosition(int, int)和类似的命令。

在ACTION_APPWIDGET_UPDATE广播内部和处理器之外调用此方法是可以的。 此方法仅在拥有AppWidget提供者的uid中调用时才有效。

如果小部件未通过 updateAppWidget(int[], RemoteViews)收到完整更新，则此方法将被忽略。

updateAppWidget

void updateAppWidget (ComponentName provider, 
                RemoteViews views)

将RemoteViews设置为用于提供的AppWidget提供程序的所有AppWidget实例。

在ACTION_APPWIDGET_UPDATE广播内部和处理器之外调用此方法是可以的。 此方法仅在拥有AppWidget提供者的uid中调用时才有效。

updateAppWidget

void updateAppWidget (int[] appWidgetIds, 
                RemoteViews views)

设置RemoteViews以用于指定的appWidgetIds。

请注意，RemoteViews参数将由AppWidgetService缓存，因此应该包含小部件的完整表示。 要执行部分小部件更新，请参阅partiallyUpdateAppWidget(int[], RemoteViews) 。

在ACTION_APPWIDGET_UPDATE广播内部和处理器之外调用此方法是可以的。 此方法仅在拥有AppWidget提供者的uid中调用时才有效。

RemoteViews对象使用的总位图内存不能超过1.5倍填充屏幕所需的内存量，即。 （屏幕宽度×屏幕高度×4×1.5）字节。

updateAppWidget

void updateAppWidget (int appWidgetId, 
                RemoteViews views)

设置RemoteViews以用于指定的appWidgetId。

请注意，RemoteViews参数将由AppWidgetService缓存，因此应该包含小部件的完整表示。 要执行部分小部件更新，请参阅partiallyUpdateAppWidget(int, RemoteViews) 。

在ACTION_APPWIDGET_UPDATE广播内部和处理程序之外调用此方法是可以的。 此方法仅在拥有AppWidget提供者的uid中调用时才有效。

RemoteViews对象使用的总位图内存不能超过1.5倍填充屏幕所需的内存量，即。 （屏幕宽度×屏幕高度×4×1.5）字节。

updateAppWidgetOptions

void updateAppWidgetOptions (int appWidgetId, 
                Bundle options)

更新给定小部件实例的额外资源。

额外信息可用于嵌入关于此小部件的其他信息，以便通过关联的小部件的AppWidgetProvider访问。