安卓开发小知识-AppWidget入门

AppWidget是类似我们手机桌面上的时钟小插件。它的实现需要以下几个步骤：
1、指定APPWidget相关属性的xml文件，位于res/xml文件夹下。
2、APPWidget使用的布局文件，位于layout文件夹下。
3、实现该APPWidget的Java类文件，位于src目录下。
4、在配置文件中注册。
下面我们用一个例子说明它的具体用法。

例子

1、APPWidget相关属性XML文件：new_app_widget_info.xml

<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    android:initialKeyguardLayout="@layout/new_app_widget"
    android:initialLayout="@layout/new_app_widget"
    android:minHeight="40dp"
    android:minWidth="40dp"
    android:previewImage="@drawable/example_appwidget_preview"
    android:resizeMode="horizontal|vertical"
    android:updatePeriodMillis="86400000"
    android:widgetCategory="home_screen"></appwidget-provider>

2、使用的布局文件：new_app_widget.xml

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="#09C"
    android:padding="@dimen/widget_margin">

    <TextView
        android:id="@+id/appwidget_text"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerHorizontal="true"
        android:layout_centerVertical="true"
        android:layout_margin="8dp"
        android:background="#09C"
        android:contentDescription="@string/appwidget_text"
        android:text="@string/appwidget_text"
        android:textColor="#ffffff"
        android:textSize="24sp"
        android:textStyle="bold|italic" />

</RelativeLayout>

3、实现它的Java类：NewAppWidget.java

package xml;

import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.Context;
import android.widget.RemoteViews;

import com.mindto.widgettest.R;

/**
 * Implementation of App Widget functionality.
 */
public class NewAppWidget extends AppWidgetProvider {
    //供onUpdate方法调用
    static void updateAppWidget(Context context, AppWidgetManager appWidgetManager,
                                int appWidgetId) {

        CharSequence widgetText = context.getString(R.string.appwidget_text);
        // Construct the RemoteViews object
        RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.new_app_widget);
        views.setTextViewText(R.id.appwidget_text, widgetText);

        // Instruct the widget manager to update the widget
        appWidgetManager.updateAppWidget(appWidgetId, views);
        System.out.println("updateAppWidget");
    }
    //更新时触发
    @Override
    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
        // There may be multiple widgets active, so update all of them
        for (int appWidgetId : appWidgetIds) {
            updateAppWidget(context, appWidgetManager, appWidgetId);
        }
        System.out.println("onUpdate");

    }
    //首次使用时触发
    @Override
    public void onEnabled(Context context) {
        // Enter relevant functionality for when the first widget is created
        System.out.println("onEnabled");
    }
    //最后一个被删除时触发
    @Override
    public void onDisabled(Context context) {
        // Enter relevant functionality for when the last widget is disabled
        System.out.println("onDisabled");
    }
}

4、注册。
我们会发现，注册时用了receiver标签，这就说明它是基于广播机制来实现的。只是一些参数是指定的。

    <receiver android:name="xml.NewAppWidget">
        <!--指定的filter-->
            <intent-filter>
                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
            </intent-filter>

            <meta-data
                android:name="android.appwidget.provider"<!--指定的参数-->
                android:resource="@xml/new_app_widget_info" /><!--说明该APPWidget的XML属性文件-->
        </receiver>

5、下面看下效果（中间的蓝色方块）：

在手机桌面添加小部件，会发现我们的APPWidget。

该篇结束，若有不足，望不吝赐教！