如何实现一个桌面小部件（一）

实现一个桌面小部件，分为三个步骤：
1、继承一个AppWidgetProvider或者一个BoardcastReceiver，用来实现自己的小部件更新接收广播。
建议使用AppWidgetProvider，这样也可以在AppWidgetProvider中添加新的action，用来使小部件根据其他的广播更新信息。
在AppWidgetProvider代码中：

    public void onReceive(Context context, Intent intent) {
        String action = intent.getAction();
        if (AppWidgetManager.ACTION_APPWIDGET_UPDATE.equals(action)) {
            Bundle extras = intent.getExtras();
            if (extras != null) {
                int[] appWidgetIds = extras.getIntArray(AppWidgetManager.EXTRA_APPWIDGET_IDS);
                if (appWidgetIds != null && appWidgetIds.length > 0) {
                    this.onUpdate(context, AppWidgetManager.getInstance(context), appWidgetIds);
                }
            }
        } else if (AppWidgetManager.ACTION_APPWIDGET_DELETED.equals(action)) {
            Bundle extras = intent.getExtras();
            if (extras != null && extras.containsKey(AppWidgetManager.EXTRA_APPWIDGET_ID)) {
                final int appWidgetId = extras.getInt(AppWidgetManager.EXTRA_APPWIDGET_ID);
                this.onDeleted(context, new int[] { appWidgetId });
            }
        } else if (AppWidgetManager.ACTION_APPWIDGET_OPTIONS_CHANGED.equals(action)) {
            Bundle extras = intent.getExtras();
            if (extras != null && extras.containsKey(AppWidgetManager.EXTRA_APPWIDGET_ID)
                    && extras.containsKey(AppWidgetManager.EXTRA_APPWIDGET_OPTIONS)) {
                int appWidgetId = extras.getInt(AppWidgetManager.EXTRA_APPWIDGET_ID);
                Bundle widgetExtras = extras.getBundle(AppWidgetManager.EXTRA_APPWIDGET_OPTIONS);
                this.onAppWidgetOptionsChanged(context, AppWidgetManager.getInstance(context),
                        appWidgetId, widgetExtras);
            }
        } else if (AppWidgetManager.ACTION_APPWIDGET_ENABLED.equals(action)) {
            this.onEnabled(context);
        } else if (AppWidgetManager.ACTION_APPWIDGET_DISABLED.equals(action)) {
            this.onDisabled(context);
        } else if (AppWidgetManager.ACTION_APPWIDGET_RESTORED.equals(action)) {
            Bundle extras = intent.getExtras();
            if (extras != null) {
                int[] oldIds = extras.getIntArray(AppWidgetManager.EXTRA_APPWIDGET_OLD_IDS);
                int[] newIds = extras.getIntArray(AppWidgetManager.EXTRA_APPWIDGET_IDS);
                if (oldIds != null && oldIds.length > 0) {
                    this.onRestored(context, oldIds, newIds);
                    this.onUpdate(context, AppWidgetManager.getInstance(context), newIds);
                }
            }
        }
    }

在代码中，广播接收器根据不同的action执行不同的方法，在AppWidgetProvider中，这些方法都是空方法，所以，我们既可以自己继承BoardcastReceiver
来实现我们的AppWidgetProvider也可以通过继承AppWidgetProvider来实现在父类中的空方法，这些都是可以的！！！

在广播我们需要在manifest进行注册：
这里假设我们的使用< ExampleAppWidgetProvider extends AppWidgetProvider >

public static final String ACTION_APPWIDGET_UPDATE = "android.appwidget.action.APPWIDGET_UPDATE";

    <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>

根据注册的信息，我们的广播只会接收到小部件更新的广播，不明白为什么不一起加上呢！！

这里的meta-data用来描述一个AppWidgetProviderInfo，其实现实在xml中完成的：
res/xml/example_appwidget_info.xml

    <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>

updatePeriodMillis表示的是小部件自动更新的时间间隔，单位是毫秒，这里设置的是24小时，这个值应该是有最小限制的，如果设置为0，你就只能自己发送广播让小部件更新了，
网上说framework自动更新小部件的最小间隔为半个小时，在文档中没有看到！！！不过在任何情况下，我们都可以手动更新我们的小部件（通过定时发送Intent，或者直接监听时间变化的广播）

previewImage属性表示小部件在未添加的时候的预览图，如果不设置的话，默认会使用应用的图标！！！这也是很多自定义的小部件在预览的时候看到都是小机器的缘故！！

initialLayout属性代表的是小部件的真实布局，是一个layout文件！！

widgetCategory属性表示小部件是否允许被现实在主界面或者锁屏界面，在5.0之前的版本，小部件可以显示在锁屏界面，但是在5.0之后，小部件不允许被显示在锁屏在界面！！

configure属性表示在小部件被创建的时候进行的配置Activity，
在AppWidgetHostActivity中，可以看到源代码：

    void configureAppWidget(int requestCode, int appWidgetId, ComponentName configure) {
        Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_CONFIGURE);
        intent.setComponent(configure);
        intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId);
        SharedPreferences.Editor prefs = getPreferences(0).edit();
        prefs.putInt(PENDING_APPWIDGET_ID, appWidgetId);
        prefs.commit();
        startActivityForResult(intent, requestCode);
    }

从这里就可以看到，我们自己的ConfigureActivity的action已经被确定了，即为：AppWidgetManager.ACTION_APPWIDGET_CONFIGURE

    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        switch (requestCode) {
        case DISCOVER_APPWIDGET_REQUEST:
            handleAppWidgetPickResult(resultCode, data);
            break;
        case CONFIGURE_APPWIDGET_REQUEST:
            handleAppWidgetConfigureResult(resultCode, data);
        }
    }

    void handleAppWidgetConfigureResult(int resultCode, Intent data) {
        int appWidgetId = getPreferences(0).getInt(PENDING_APPWIDGET_ID, -1);
        Log.d(TAG, "resultCode=" + resultCode + " appWidgetId=" + appWidgetId);
        if (appWidgetId < 0) {
            Log.w(TAG, "was no preference for PENDING_APPWIDGET_ID");
            return;
        }
        if (resultCode == RESULT_OK) {
            AppWidgetProviderInfo appWidget = mAppWidgetManager.getAppWidgetInfo(appWidgetId);
            addAppWidgetView(appWidgetId, appWidget);
        } else {
            mHost.deleteAppWidgetId(appWidgetId);
        }
    }

//如果配置没有完成，在自定义的配置activity中设置结果码不为ok，就不会成功添加小部件了！！

    void addAppWidgetView(int appWidgetId, AppWidgetProviderInfo appWidget) {
        // Inflate the AppWidget's RemoteViews
        AppWidgetHostView view = mHost.createView(this, appWidgetId, appWidget);

        // Add it to the list
        LinearLayout.LayoutParams layoutParams = new LinearLayout.LayoutParams(
                LinearLayout.LayoutParams.MATCH_PARENT,
                LinearLayout.LayoutParams.WRAP_CONTENT);
        mAppWidgetContainer.addView(view, layoutParams);
        registerForContextMenu(view);
    }

小部件布局：

    <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>

配置Activity：

    <activity android:name=".ExampleAppWidgetConfigure">
        <intent-filter>
            <action android:name="android.appwidget.action.APPWIDGET_CONFIGURE"/>
        intent-filter>
    activity>

小部件的点击事件通过使用RemoteView+PendingIntent实现，小部件的更新实现在onUpdate方法中实现
有一点需要特别注意，由于AppWidgetProvider是继承了BoardcastReceiver，所以它的进程生命周期与广播接收器的进程生命周期是一致的。即，只有在广播发生时才会进入AppWidgetProvider中的各个方法。所以在从网络上更新信息时，需要注意，应该从新启动一个service来帮助完场信息的更新。

在下一篇博客中，我将用一个实例，来说明如何实现一个桌面小部件！！！

这是我的微信公众号，如果可以的话，希望您可以帮忙关注一下，这将是对我最大的鼓励了，谢谢！！