手把手教你做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可以以多种形式呈现出来,幻灯 秀、视频、地图、新闻、小游戏……