一步步教你创建widget

首先我们要先了解AppWidgetProvider这个类，其中主要的回调函数的方法有：

onUpdate，onDeleted，onDisabled, onEnabled,onReceive, 其中个人认为最重要的是onUpdate方法，如果只是简单的widget小组件只重写onUpdate组建就可以了

我们涉及的类还有

import android.app.PendingIntent;
import android.app.Service;
import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.ComponentName;
import android.os.IBinder;
import android.widget.RemoteViews;

下面我们就以一个小组件为例分享widget的做法，这个小组件主要实现了显示系统的device信息，包括：Build.ID，Build.MODEL,时间等，这个主要是可以再布局文件中添加，或改变。

首先书写AndroidManifest.xml文件：

    <application android:icon="@drawable/icon" android:label="@string/app_name">
        <receiver android:name=".BuildWidget" android:label="@string/widget_name">
            <intent-filter>
                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
            </intent-filter>
            <meta-data android:name="android.appwidget.provider" android:resource="@xml/widget_build" />
        </receiver>
        <service android:name=".BuildWidget$UpdateService" />
    </application>
    

 其中BuildWidget是AppWidgetProvider的子类，并且通过<meta-data android:name="android.appwidget.provider" android:resource="@xml/widget_build" />去指出widget的布局文件

我们再看widget_build.xml文件:

<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    android:minWidth="72dip"
    android:minHeight="72dip"
    android:updatePeriodMillis="0"
    android:initialLayout="@layout/widget"
/>

其中android:initialLayout="@layout/widget"指出了布局文件为widget.xml.

这个widget.xml文件比较简单，主要是为了测试功能加上了几个textview

        <TextView
            android:id="@+id/build_info"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:gravity="center"
            style="@style/Text.BuildInfo.Fancy"
            android:textSize="18dip"
            />

        <TextView
            android:id="@+id/build_date"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:gravity="center"
            style="@style/Text.BuildInfo.Fancy"
            android:textSize="14dip"
            />
        <TextView
            android:id="@+id/build_extra"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:gravity="center"
            style="@style/Text.BuildInfo.Fancy"
            />
        

res中的布局文件差不多已经完成了，然后我们就可以再onUpdate中去写相应的逻辑了。

一般的非UI逻辑我们不建议在UI主线程中去完成，因为这会导致ANR timeout产生的可能性。所以我们建立一个service响应点击widget的事件。

在BuildWidget中建立内部子类UpdateService继承自Service。

在onUpdate方法中启动service。

在service onStart方法中添加处理逻辑，添加widget中的UI元素，这里我们用到了RemoteView来创建UI

废话少说，大家来参详代码吧。

public class BuildWidget extends AppWidgetProvider {
    @Override
    public void onUpdate(Context context, AppWidgetManager appWidgetManager,
            int[] appWidgetIds) {
        // To prevent any ANR timeouts, we perform the update in a service
        context.startService(new Intent(context, UpdateService.class));
    }

    public static class UpdateService extends Service {
        @Override
        public void onStart(Intent intent, int startId) {
            // Build the widget update
            RemoteViews updateViews = buildUpdate(this);

            // Push update for this widget to the home screen
            ComponentName thisWidget = new ComponentName(this, BuildWidget.class);
            AppWidgetManager manager = AppWidgetManager.getInstance(this);
            manager.updateAppWidget(thisWidget, updateViews);
        }

        public RemoteViews buildUpdate(Context context) {
            // Pick out month names from resources
            Resources res = context.getResources();
            RemoteViews updateViews = new RemoteViews(
                context.getPackageName(), R.layout.widget);

            PendingIntent pendingIntent = PendingIntent.getActivity(context,
                    0 /* no requestCode */, 
                    new Intent("android.settings.DEVICE_INFO_SETTINGS"),
                    0 /* no flags */);
            updateViews.setOnClickPendingIntent(R.id.widget, pendingIntent);

            updateViews.setTextViewText(R.id.build_info, android.os.Build.ID);
            updateViews.setTextViewText(R.id.build_date, 
                    DateUtils.formatDateTime(context, android.os.Build.TIME, 
                        DateUtils.FORMAT_NUMERIC_DATE));
            updateViews.setTextViewText(R.id.build_extra, android.os.Build.MODEL);
            return updateViews;
        }

        @Override
        public IBinder onBind(Intent intent) {
            // We don't need to bind to this service
            return null;
        }
    }
}