Android widget 桌面组件开发

作者：   来源：   发布时间：2011-04-12 11:16  阅读：2130 次        

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 类

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

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

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

3、Demo讲解

1.建立Widget内容提供者文件，我们在res下建立xml文件夹，并且新建一个widget_provider.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布局，代码如下:
 
     
 
       
       
      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
 
     
 
       
       
      WidetDemo.java 
      
 
       
 
       
 
        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,代码如下:
 
     
 
       
       
      AndroidManifest.xml 
      
 
       
 
       
 
        <? 
        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.添加修改资源
 
     
增加图片素材。
 
     
 
 
     
 
       
       
      string.xml 
      
 
       
 
       
 
        <? 
        xml version 
        = 
        " 
        1.0 
        " 
         encoding 
        = 
        " 
        utf-8 
        " 
        ?> 
         
 
        < 
        resources 
        > 
         
 
        < 
        string name 
        = 
        " 
        hello 
        " 
        > 
        Hello World, WidetDemo 
        !</ 
        string 
        > 
         
 
        < 
        string name 
        = 
        " 
        app_name 
        " 
        > 
        DaysToWorldCup 
        </ 
        string 
        > 
         
 
        </ 
        resources 
        >