Android Widget 桌面组件开发介绍

Android widget 桌面组件开发

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(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)

三,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);   

    }   

  }   

}  

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，一般该函数是不需要重写的。

 四、修改配置文件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  文件，使其可作其管理文件。

五、添加修改资源

增加图片素材。

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

以上就是对Android widget 资料的整理，希望能帮助需要的朋友。