1、AppWidgetProviderInfo
为 App widget提供元数据,包括布局,更新频率等数据。这个对象被定义在xml文件当中。
2、AppWidgetProvider
定义App widget的基本生命周期
创建一个App widget得步骤:
1、定义AppWidgetProviderInfo:
在res/xml文件夹当中定义一个名为example_appwidget_info.xml的文件:
<appwidget-provider
xmlns:Android="http://schemas.android.com/apk/res/android"
android:minWidth="294dp"
android:minHeight="72dp"
android:updatePeriodMillis="86400000"
android:initialLayout="@layout/example_appwidget"
>
</appwidget-provider>
2、为App widget指定样式和布局
定义一个新的布局文件example_appwidget.xml,在本例当中只是简单定义一个TextView:
<TextView
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:text="hello"
android:id="@+id/widgetTextld"
/>
3、继承AppWidgetProvider
onUpdate:在到达指定的更新时间之后或者当用户桌面添加App widget时会调用该方法
onDelete:当App widget被删除时,会调用该方法
onEnabled:当一个App widget得实例第一次被创建时,会调用该方法
onDisabled:当最后一个App widget实例被删除后,会调用该方法
onReveice:接收广播事件
例子:
在res/layout目录下添加example_appwidget.xml
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="vertical"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
>
<TextView
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:text="firstWidgetText"
android:id="@+id/widgetTextld"
android:background="#0000FF"
/>
</LinearLayout>
在res/xml目录下添加example_appwidget_info.xml
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
android:minWidth="294dp"
android:minHeight="72dp"
android:updatePeriodMillis="86400000"
android:initialLayout="@layout/example_appwidget"
>
</appwidget-provider>
在androidManifest.xml文件application节点之间添加如下代码:
<receiver android:name=".AppWidgetProviderTest">
<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"></meta-data>
</receiver>
好了,配置文件就到此结束了,下面写java代码:
新建一个AppWidgetProviderTest类继承AppWidgetProvider类,内容如下:
import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.Context;
import android.content.Intent;
public class AppWidgetProviderTest extends AppWidgetProvider {
//接收广播事件
@Override
public void onReceive(Context context, Intent intent) {
System.out.println("onReceive");
super.onReceive(context, intent);
}
//在到达指定的更新时间之后或者当用户桌面添加App widget时会调用该方法
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager,
int[] appWidgetIds) {
System.out.println("onUpdate");
super.onUpdate(context, appWidgetManager, appWidgetIds);
}
//当App widget被删除时,会调用该方法
@Override
public void onDeleted(Context context, int[] appWidgetIds) {
System.out.println("onDeleted");
super.onDeleted(context, appWidgetIds);
}
//当一个App widget得实例第一次被创建时,会调用该方法
@Override
public void onEnabled(Context context) {
System.out.println("onEnabled");
super.onEnabled(context);
}
//当最后一个App widget实例被删除后,会调用该方法
@Override
public void onDisabled(Context context) {
System.out.println("onDisabled");
super.onDisabled(context);
}
}