Android入门之App Widget

Android入门之App Widget

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);
 }
}