App Widgets 详解一 简单使用_小部件 appwidget_enabled

导读:

本文根据谷歌官方文档,加上本人理解汇编而成,如有雷同,说明都是从官方文档学习的.

• App Widget 小部件系列其他文章链接

App Widgets 详解一 简单使用

App Widgets 详解二 Configuration Activity

App Widgets 详解三 Activity中添加App Widgets

App Widgets 详解四 RemoteViews、RemoteViewsService和RemoteViewsFactory

App Widget 简介

• App Widgets (微型应用视图),它能够嵌入到其他的应用程序(如系统桌面/其他应用的Activity)并接受定期更新,主要用于展现程序的快捷入口

• 如果想创建一个AppWidget 需要:

一、 AppWidgetProviderInfo object

描述了App Widget 的mtadata(元数据),如 App Widget 的布局,更新频率和AppWidgetProvider类等.这需要在XML文件中定义.

AppWidgetProviderInfo 官方文档链接

二、 AppWidgetProvider class implementation

AppWidgetProvider 接口基于BroadcastReciver,通过定义这个接口,当 App Widget updata(数据发生改变),enabled(启动),disabled(禁用)和deletd(删除)时,我们将会受到广播

三、 View layout

定义App Widget 的初始化XML布局文件,另外,可以在App Widget 启动前,添加一个Activity用于配置Widget的一些参数

---

简单使用:

一、在AndroidMainfest.xml清单文件声明我们定义的AppWidgetProvider 类

<receiver android:name="ExampleAppWidgetProvider" >

    <intent-filter>
        <--!指定AppWidgetProvider接受系统的APPWIDGET_UPDATE广播-->
        <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
    </intent-filter>

    <--!指定Meta_data名称,使用android.appwidgetb必须确定AppWidgetProviderInfo描述符的数据-->
    <--!指定AppWidgetProviderInfo资源XML文件-->
    <meta-data android:name="android.appwidget.provider"
               android:resource="@xml/example_appwidget_info" />
</receiver>

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

二、创建AppWidgetProviderInfo XML文件

该XML文件定义 App Widget 的基本属性,在res/xml/目录下创建appwidger-provider 标签的XML文件

<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    android:minWidth="40dp"
    android:minHeight="40dp"
    android:updatePeriodMillis="86400000"
    android:previewImage="
1
2
3
4
5
6