android桌面组件开发

Widget是Android1.5版所引进的特性之一.Widget,可让用户在主屏幕界面及时了解程序显示的重要信息.标准的Android系统已包含几个Widget的示例,如模拟时钟,音乐播放器等.

1、AppWidget 框架类

• 1、AppWidgetProvider ：继承自 BroadcastRecevier ， 在AppWidget 应用 update、enable、disable 和 delete 时接收通知。其中，onUpdate、onReceive 是最常用到的方法，它们接收更新通知。
• 2、 AppWidgetProvderInfo：描述 AppWidget 的大小、更新频率和初始界面等信息，以XML 文件形式存在于应用的 res/xml/目录下。
• 3、AppWidgetManger ：负责管理 AppWidget ，向 AppwidgetProvider 发送通知。
• 4、RemoteViews ：一个可以在其他应用进程中运行的类，向 AppWidgetProvider 发送通知。

 2、AppWidget 框架的主要类介绍

 1) AppWidgetManger 类

• bindAppWidgetId(int appWidgetId, ComponentName provider)
    通过给定的ComponentName 绑定appWidgetId
• getAppWidgetIds(ComponentName provider)
    通过给定的ComponentName 获取AppWidgetId
• getAppWidgetInfo(int appWidgetId)
    通过AppWidgetId 获取 AppWidget 信息
• getInstalledProviders()
    返回一个List<AppWidgetProviderInfo>的信息
• getInstance(Context context)
    获取 AppWidgetManger 实例使用的上下文对象
• updateAppWidget(int[] appWidgetIds, RemoteViews views)
    通过appWidgetId 对传进来的 RemoteView 进行修改，并重新刷新AppWidget 组件
• updateAppWidget(ComponentName provider, RemoteViews views)
    通过 ComponentName 对传进来的 RemoeteView 进行修改，并重新刷新AppWidget 组件
• updateAppWidget(int appWidgetId, RemoteViews views)
    通过appWidgetId 对传进来的 RemoteView 进行修改，并重新刷新AppWidget 组件

2) 继承自 AppWidgetProvider 可实现的方法为如下：

• 1、onDeleted(Context context, int[] appWidgetIds)
• 2、onDisabled(Context context)
• 3、onEnabled(Context context)
• 4、onReceive(Context context, Intent intent)
    Tip:因为 AppWidgetProvider 是继承自BroadcastReceiver  所以可以重写onRecevie 方法，当然必须在后台注册Receiver
• 5、onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds)

3、Demo讲解

1.建立Widget内容提供者文件，我们在res下建立xml文件夹，并且新建一个widget_provider.xml代码入下:

<? xml version = " 1.0 "  encoding = " utf-8 " ?>  < appwidget - provider xmlns: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布局，代码如下:

<? xml version = " 1.0 "  encoding = " utf-8 " ?> 
< LinearLayout xmlns: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

package  com.android.tutor; import  java.util.Calendar; import  java.util.Date; import  java.util.GregorianCalendar; import  java.util.Timer; import  java.util.TimerTask; import  android.appwidget.AppWidgetManager; import  android.appwidget.AppWidgetProvider; import  android.content.ComponentName; import  android.content.Context; import  android.widget.RemoteViews; public  class  WidetDemo  extends  AppWidgetProvider { /**  Called when the activity is first created.  */  @Override public  void  onUpdate(Context context, AppWidgetManager appWidgetManager, int [] appWidgetIds) {Timer timer  =  new  Timer();timer.scheduleAtFixedRate( new  MyTime(context,appWidgetManager),  1 ,  60000 ); super .onUpdate(context, appWidgetManager, appWidgetIds);} private  class  MyTime  extends  TimerTask{RemoteViews remoteViews;AppWidgetManager appWidgetManager;ComponentName thisWidget; public  MyTime(Context context,AppWidgetManager appWidgetManager){ this .appWidgetManager  =  appWidgetManager;remoteViews  =  new  RemoteViews(context.getPackageName(),R.layout.main);thisWidget  =  new  ComponentName(context,WidetDemo. class );} public  void  run() {Date date  =  new  Date();Calendar calendar  =  new  GregorianCalendar( 2010 , 06 , 11 ); long  days  =  (((calendar.getTimeInMillis() - date.getTime()) / 1000 )) / 86400 ;remoteViews.setTextViewText(R.id.wordcup,  " 距离南非世界杯还有 "  +  days + " 天 " );appWidgetManager.updateAppWidget(thisWidget, remoteViews);}}}

Tips:

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。

[启动  -  无confiure Activity]
onReceive
onEnabled —— 第一个widget被显示
onReceive
onUpdate —— 刷新界面

[启动  -  带confiuration Activity]
onReceive
onUpdate

[拖动]
< 无状态变化 >

[周期更新]
onReceive
onUpdate

[删除]
onReceive
onDeleted —— widget被删除
onReceive
onDisabled —— 最后一个widget被移除

[启动时位置不够]
onReceive
onEnabled
onReceive
onUpdate
onReceive
onDeleted
onReceive
onDisabled

*每次状态的变化会触发onReceive，一般该函数是不需要重写的。 

4.修改配置文件AndroidManifest.xml，后台注册Receiver,代码如下:

<? xml version = " 1.0 "  encoding = " utf-8 " ?>  < manifest xmlns:android = " http://schemas.android.com/apk/res/android "  package = " com.android.tutor "  android:versionCode = " 1 "  android:versionName = " 1.0 " >  < application android:icon = " @drawable/icon "  android:label = " @string/app_name " >  < receiver android:name = " .WidetDemo "  android:label = " @string/app_name " >  < intent - filter >  < action android:name = " android.appwidget.action.APPWIDGET_UPDATE "  />  </ intent - filter >  < meta - data android:name = " android.appwidget.provider "  android:resource = " @xml/widget_provider "  />  </ receiver >  </ application >  < uses - sdk android:minSdkVersion = " 7 "  />  </ manifest >

Tips:

因为是桌面组件，所以暂时不考虑使用Activity 界面，当然你在实现做项目时可能会需要点击时跳转到Activity 应用程序上做操作，典型的案例为Android  提供的音乐播放器。

上面代码中比较重要的是这一句 <meta-data android:name="android.appwidget.provider"  android:resource="@xml/appwidget_provider"></meta-data>  大意为指定桌面应用程序的AppWidgetProvderInfo  文件，使其可作其管理文件。

5.添加修改资源

增加图片素材。

<? xml version = " 1.0 "  encoding = " utf-8 " ?> 
< resources > 
< string name = " hello " > Hello World, WidetDemo !</ string > 
< string name = " app_name " > DaysToWorldCup </ string > 
</ resources >

扫描二维码，一起学习