手把手教你做android widget

手把手教你做android widget

最近要在项目中把Barcode scanner（条形码扫描）做成一个widget（小部件）放到手机桌面。网上查了一些资料，调查了一下，把方法和大家分享。

先讲一下什么是widget。widget就是桌面小部件。　Android本身已经自带了时钟、音乐播放器、相框和Google搜索4个 Widget程序，不过这并不能阻止大家开发自己更加美观，功能更丰富的版本。另外，微博客、RSS订阅、股市信息、天气预报这些Widget也都有流行 的可能。

那怎么把widget添加至桌面呢？
长按手机桌面，弹出dialog，选择widget即进入手机的widget列表。列表中显示手机中可使用的所有widget，包括我们自己制作的（做完这个例子后，你会发现我们自己制作的widget夜出现在这里），选中则该widget将出现在桌面。

下面介绍一下widget的制作步骤：
1.申明AppWidgetProvider类在应用的AndroidManifest.xml文件里 <receiver android:name="com.Demo_barcodeWidget.BarcodeWidgetProvider"
            android:icon="@drawable/homenav_barcode"
            android:label="Yellowbook Barcode Scanner">
            <intent-filter>
                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
            </intent-filter>
            <meta-data android:name="android.appwidget.provider" android:resource="@xml/barcode_widget" />
        </receiver>

• <intent-filter>元素必须包含带有android:name属性的<action>元素。这一属性指明 AppWigetProvider可接收ACTION_APPWIDGET_UPDATE广播。这是你必须明确声明的唯一广播。 AppWidgetManager自动发送Widget广播到AppWidgetProvider。

•      <meta-data>元素指明AppWidgetProviderInfo资源，需要如下属性：android:name-指明元数 据名称。使用android.appwidget.provider把数据指定为对AppWidgetProviderInfo的描述。

      android:resource-指明AppWidgetProviderInfo资源的位置。

2. 增加AppWidgetProviderInfor元数据在res/xml/widget_provider.xml中:
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    android:minWidth="47dip"
    android:minHeight="44dip"
    android:updatePeriodMillis="10000"
    >
</appwidget-provider>

• 这个文件放在res/xml/文件夹下，若res中没有xml文件夹，则需新建一个。

• 注：AppWidgetProviderInfo 定义基本的Widget属性，如最小布局维数，初始的布局资源，更新Widget频率和在创建时间启动Activity的配置。在XML资源里使用单一 的<appwidget-provider>元素定义AppWidgetProviderInfo对象并且把它保存在工程的res/xml /文件夹下。

3. 创建Widget布局文件在res/layout/中：
<ImageView xmlns:android="http://schemas.android.com/apk/res/android"
    android:src="@drawable/homenav_barcode" android:id="@+id/barcode_widget_logo"
    android:layout_height="wrap_content" android:layout_width="wrap_content"></ImageView>

• 这是widget在桌面显示的layout。本例中很简单，只有一个imageview。
• 你 必须在XML里为你的Widget定义一个初始的布局文件，然后保存在工程的res/layout/目录下。如果你熟悉在XML中声明布局，那么创建 Widget布局是简单的。你可以使用View对象设计你的Widget，然而你必须注意Widget基于RemoteViews，它并不支持布局或者 view控件中的每一种。

4.创建appWidgetProvider类

package com.Demo_barcodeWidget;

import android.app.PendingIntent;
import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.ComponentName;
import android.content.Context;
import android.content.Intent;
import android.widget.RemoteViews;

public class BarcodeWidgetProvider extends AppWidgetProvider{
    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds){
        RemoteViews mRemoteViews = buildUpdate(context);
        ComponentName thisWidget = new ComponentName(context, BarcodeWidgetProvider.class);
        AppWidgetManager manager = AppWidgetManager.getInstance(context);
        manager.updateAppWidget(thisWidget, mRemoteViews);
    }

    private RemoteViews buildUpdate(Context context) {
        RemoteViews rv = new RemoteViews(context.getPackageName(), R.layout.barcode_scanner_widget);
        Intent i = new Intent(context, Demo_barcodeWidget.class);
        i.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
        rv.setOnClickPendingIntent(R.id.barcode_widget_logo, PendingIntent.getActivity(context, 0, i, 0));
        return rv;
    }
}

• 继承于BroadcastReceiver的AppWidgetProvider类是一种很方便处理Widget广播的类。 AppWidgetProvider只接收与Widget相关的事件广播，如当Widget更新，删除，可用和不可用的时候。当这些广播事件发生的时 候，AppWidgetProvider收到如下的方法调 用：onUpdated,onDeleted,onEnabled,onDisabled,onReceive。

• 最 重要的AppWidgetProvider回调函数是onUpdated，因为当每一个Widget增加的时候它都会被调用（除非你使用配置 Activity）。如果你的Widget接收任意用户交互事件，那么你需要在回调函数中注册事件handler。如果你的Widget没有创建临时文件 或者数据库，或者执行需要clean－up的工作，那么onUpdated可能是你需要注册的唯一回调函数。
• 这里使用 remoteView来实现widget的事件响应（onclick事件）和widget页面的显示刷新（实际上本例很简单，只是说明widget的制作 步骤。并没有显示什么数据，而widget得click事件也只是跳转到程序的main activity）。实际上widget功能丰富：别看它们小，却服务周到，它可以为你报告新闻、帮你买东西、列出你最喜欢的乐队，还有你最近看的视频。 另外，它还是一个殷勤的管家，你不必亲自去Flickr或者天气预报网站，Widget会将信息主动带给你。Widget可以以多种形式呈现出来，幻灯 秀、视频、地图、新闻、小游戏……