一、在Manifast.xml文件中声明你自定义的AppWidgetProvider:
<receiver android:name="ExampleAppWidgetProvider" >
<intent-filter>
<action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
</intent-filter>
<meta-data android:name="android.appwidget.provider"
android:resource="@xml/example_appwidget_info" />
</receiver>
receiver name 属性为自定义的类,需继承 AppWidgetProvider,resource 属性指明AppWidgetProviderInfo所在的文件位置;该类对小部件的基本属性做定义。
二、在res文件夹下新建xml文件夹,新建metadata resource属性指定的文件:
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
android:minWidth="40dp"
android:minHeight="40dp"
android:updatePeriodMillis="86400000"
android:previewImage="@drawable/preview"
android:initialLayout="@layout/example_appwidget"
android:configure="com.example.android.ExampleAppWidgetConfigure"
android:resizeMode="horizontal|vertical"
android:widgetCategory="home_screen">
</appwidget-provider>
minWidth与minHeight属性表示了App Widget所需的最小布局区域。
Widget框架调用AppWidgetProvider的onUpdate方法的频率。
linitialLayout属性标识了初始布局文件。
configure属性定义了当用户添加App Widget时调用的Activity。(这是可选的)
previewImage定义了App Widget的缩略图,当用户从widget列表中选择时,显示的就是这张图。如果没设置,用户将看见的是你的应用的默认图标。
resizeMode属性标识了widget重新布局的规则。
三、在layout文件夹下新建initialLayout属性值指定的xml文件,定义widget的布局:
<FrameLayout
android:layout_width="match_parent"
android:layout_height="match_parent"
android:padding="@dimen/widget_margin">
<LinearLayout
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="horizontal"
android:background="@drawable/my_widget_background">
…
</LinearLayout>
</FrameLayout>
四、实现自定义的AppWidgetProvider类,覆盖其中的方法:
onEnabled():小部件第一次创建的时候调用;
onUpdate():小部件更新时调用,如用户添加小部件的时候,指定的更新时间到的时候;
onDeleted():删除一个小部件时调用;
onDisabled():最后一个小部件被删除时调用。