Android Widget 桌面组件开发介绍
Androidwidget桌面组件开发
Widget是Android1.5版所引进的特性之一.Widget,可让用户在主屏幕界面及时了解程序显示的重要信息.标准的Android系统已包含几个Widget的示例,如模拟时钟,音乐播放器等.
一、AppWidget框架类
1、AppWidgetProvider：继承自BroadcastRecevier，在AppWidget应用update、enable、disable和delete时接收通知。其中，onUpdate、onReceive是最常用到的方法，它们接收更新通知。
2、AppWidgetProvderInfo：描述AppWidget的大小、更新频率和初始界面等信息，以XML文件形式存在于应用的res/xml/目录下。
3、AppWidgetManger：负责管理AppWidget，向AppwidgetProvider发送通知。
4、RemoteViews：一个可以在其他应用进程中运行的类，向AppWidgetProvider发送通知。
二、AppWidget框架的主要类介绍
1)AppWidgetManger类
bindAppWidgetId(intappWidgetId,ComponentNameprovider)
通过给定的ComponentName绑定appWidgetId
getAppWidgetIds(ComponentNameprovider)
通过给定的ComponentName获取AppWidgetId
getAppWidgetInfo(intappWidgetId)
通过AppWidgetId获取AppWidget信息
getInstalledProviders()
返回一个List<AppWidgetProviderInfo>的信息
getInstance(Contextcontext)
获取AppWidgetManger实例使用的上下文对象
updateAppWidget(int[]appWidgetIds,RemoteViewsviews)
通过appWidgetId对传进来的RemoteView进行修改，并重新刷新AppWidget组件
updateAppWidget(ComponentNameprovider,RemoteViewsviews)
通过ComponentName对传进来的RemoeteView进行修改，并重新刷新AppWidget组件
updateAppWidget(intappWidgetId,RemoteViewsviews)
通过appWidgetId对传进来的RemoteView进行修改，并重新刷新AppWidget组件
2)继承自AppWidgetProvider可实现的方法为如下：
1、onDeleted(Contextcontext,int[]appWidgetIds)
2、onDisabled(Contextcontext)
3、onEnabled(Contextcontext)
4、onReceive(Contextcontext,Intentintent)
Tip:因为AppWidgetProvider是继承自BroadcastReceiver 所以可以重写onRecevie方法，当然必须在后台注册Receiver
5、onUpdate(Contextcontext,AppWidgetManagerappWidgetManager,int[]appWidgetIds)
三,Demo详解
1.建立Widget内容提供者文件，我们在res下建立xml文件夹，并且新建一个widget_provider.xml代码入下:
<?xmlversion="1.0"encoding="utf-8"?> <appwidget-providerxmlns:android="http://schemas.android.com/apk/res/android" android:minWidth="50dip" android:minHeight="50dip" android:updatePeriodMillis="10000" android:initialLayout="@layout/main" />
Tip:上文说过AppWidgetProvderInfo是在res/xml的文件形式存在的，看参数不难理解，比较重要的是这里android:initialLayout="@layout/main"此句为指定桌面组件的布局文件。
主要设置的参数如下:
minWidth:定义Wdiget组件的宽度
minHeight:定义Wdiget组件的高度
updatePeriodMillis:更新的时间周期
initialLayout:Widget的布局文件
configure:如果需要在启动前先启动一个Activity进行设置，在这里给出Activity的完整类名(后面会说到，与一般Activity的实现有些许差别)
*Widget大小的计算:(单元格数*74)-2，API上说是为了防止像素计算时的整数舍入导致错所以-2...不是很明白
2.修改main.xml布局，代码如下:
<?xmlversion="1.0"encoding="utf-8"?> <LinearLayoutxmlns:android="http://schemas.android.com/apk/res/android" android:orientation="vertical" android:layout_width="fill_parent" android:layout_height="fill_parent" android:background="@drawable/wordcup" > <TextView android:id="@+id/wordcup" android:layout_width="fill_parent" android:layout_height="wrap_content" android:text="@string/hello" android:textSize="12px" android:textColor="#ff0000" /> </LinearLayout>
Tips:定义了Widget界面布局的XML文件(位于res/layout/..)，需要注意的是使用的组件必须是RemoteViews所支持的，目前原生API中支持的组件如下：
FrameLayout、LinearLayout、RelativeLayout
AnalogClock、Button、Chronmeter、ImageButton、ImageView、ProgressBar、TextView
*如果使用了除此之外的组件，则在Widget创建时会导致android.view.InflateExceptionn异常。
PS:这就导致有一些功能或样式无法实现，如很基本的list或文本编辑框都是无法直接实现的。如果想自定义Widget中的View的话只能通过修改framework来提供相应组件的支持。
3.写一个类继承自AppWidgetProvider
packagecom.android.tutor;
importjava.util.Calendar;
importjava.util.Date;
importjava.util.GregorianCalendar;
importjava.util.Timer;
importjava.util.TimerTask;
importandroid.appwidget.AppWidgetManager;
importandroid.appwidget.AppWidgetProvider;
importandroid.content.ComponentName;
importandroid.content.Context;
importandroid.widget.RemoteViews;
publicclassWidetDemoextendsAppWidgetProvider{
/**Calledwhentheactivityisfirstcreated.*/
@Override
publicvoidonUpdate(Contextcontext,AppWidgetManagerappWidgetManager,
int[]appWidgetIds){
Timertimer=newTimer();
timer.scheduleAtFixedRate(newMyTime(context,appWidgetManager),1,60000);
super.onUpdate(context,appWidgetManager,appWidgetIds);
}
privateclassMyTimeextendsTimerTask{
RemoteViewsremoteViews;
AppWidgetManagerappWidgetManager;
ComponentNamethisWidget;
publicMyTime(Contextcontext,AppWidgetManagerappWidgetManager){
this.appWidgetManager=appWidgetManager;
remoteViews=newRemoteViews(context.getPackageName(),R.layout.main);
thisWidget=newComponentName(context,WidetDemo.class);
}
publicvoidrun(){
Datedate=newDate();
Calendarcalendar=newGregorianCalendar(2010,06,11);
longdays=(((calendar.getTimeInMillis()-date.getTime())/1000))/86400;
remoteViews.setTextViewText(R.id.wordcup,"距离南非世界杯还有"+days+"天");
appWidgetManager.updateAppWidget(thisWidget,remoteViews);
}
}
}
AppWidgetProvider实际上就是一个BroadcastReceiver，里面提供了以下函数：
onReceive(Context,Intent)
onUpdate(Context,AppWidgetManager,int[]appWidgetIds)
onEnabled(Context)
onDeleted(Context,int[]appWidgetIds)
onDisabled(Context)
可通过重写以上函数来监听Widget状态的变化并进行相应的处理。
onUpdate为组件在桌面上生成时调用，并更新组件UI，onReceiver为接收广播时调用更新UI，一般这两个方法是比较常用的。
Widget的更新与Activity不同，必须借助于RemoteViews和AppWidgetMananger。
函数调用周期 [启动-无confiureActivity] onReceive onEnabled——第一个widget被显示 onReceive onUpdate——刷新界面 [启动-带confiurationActivity] onReceive onUpdate [拖动] <无状态变化> [周期更新] onReceive onUpdate [删除] onReceive onDeleted——widget被删除 onReceive onDisabled——最后一个widget被移除 [启动时位置不够] onReceive onEnabled onReceive onUpdate onReceive onDeleted onReceive onDisabled
*每次状态的变化会触发onReceive，一般该函数是不需要重写的。
四、修改配置文件AndroidManifest.xml，后台注册Receiver,代码如下:
<?xmlversion="1.0"encoding="utf-8"?> <manifestxmlns:android="http://schemas.android.com/apk/res/android" package="com.android.tutor" android:versionCode="1" android:versionName="1.0"> <applicationandroid:icon="@drawable/icon"android:label="@string/app_name"> <receiverandroid:name=".WidetDemo" android:label="@string/app_name"> <intent-filter> <actionandroid:name="android.appwidget.action.APPWIDGET_UPDATE"/> </intent-filter> <meta-dataandroid:name="android.appwidget.provider" android:resource="@xml/widget_provider" /> </receiver> </application> <uses-sdkandroid:minSdkVersion="7"/> </manifest>
Tips:
因为是桌面组件，所以暂时不考虑使用Activity界面，当然你在实现做项目时可能会需要点击时跳转到Activity应用程序上做操作，典型的案例为Android 提供的音乐播放器。
上面代码中比较重要的是这一句<meta-dataandroid:name="android.appwidget.provider" android:resource="@xml/appwidget_provider"></meta-data> 大意为指定桌面应用程序的AppWidgetProvderInfo 文件，使其可作其管理文件。
五、添加修改资源
增加图片素材。
<?xmlversion="1.0"encoding="utf-8"?> <resources> <stringname="hello">HelloWorld,WidetDemo!</string> <stringname="app_name">DaysToWorldCup</string> </resources>
以上就是对Androidwidget资料的整理，希望能帮助需要的朋友。