Android widget 桌面組件開發(fā)

Widget是Android1.5版所引進(jìn)的特性之一.Widget,可讓用戶在主屏幕界面及時(shí)了解程序顯示的重要信息.標(biāo)準(zhǔn)的Android系統(tǒng)已包含幾個(gè)Widget的示例,如模擬時(shí)鐘,音樂播放器等.

一、AppWidget 框架類

1、AppWidgetProvider ：繼承自 BroadcastRecevier ， 在AppWidget 應(yīng)用 update、enable、disable 和 delete 時(shí)接收通知。其中，onUpdate、onReceive 是最常用到的方法，它們接收更新通知。

2、 AppWidgetProvderInfo：描述 AppWidget 的大小、更新頻率和初始界面等信息，以XML 文件形式存在于應(yīng)用的 res/xml/目錄下。

3、AppWidgetManger ：負(fù)責(zé)管理 AppWidget ，向 AppwidgetProvider 發(fā)送通知。

4、RemoteViews ：一個(gè)可以在其他應(yīng)用進(jìn)程中運(yùn)行的類，向 AppWidgetProvider 發(fā)送通知。

二、AppWidget 框架的主要類介紹

 1) AppWidgetManger 類

bindAppWidgetId(int appWidgetId, ComponentName provider)
  通過給定的ComponentName 綁定appWidgetId

getAppWidgetIds(ComponentName provider)
  通過給定的ComponentName 獲取AppWidgetId

getAppWidgetInfo(int appWidgetId)
  通過AppWidgetId 獲取 AppWidget 信息

getInstalledProviders()
  返回一個(gè)List<AppWidgetProviderInfo>的信息

getInstance(Context context)
  獲取 AppWidgetManger 實(shí)例使用的上下文對象

updateAppWidget(int[] appWidgetIds, RemoteViews views)
  通過appWidgetId 對傳進(jìn)來的 RemoteView 進(jìn)行修改，并重新刷新AppWidget 組件

updateAppWidget(ComponentName provider, RemoteViews views)
  通過 ComponentName 對傳進(jìn)來的 RemoeteView 進(jìn)行修改，并重新刷新AppWidget 組件

updateAppWidget(int appWidgetId, RemoteViews views)
  通過appWidgetId 對傳進(jìn)來的 RemoteView 進(jìn)行修改，并重新刷新AppWidget 組件

2) 繼承自 AppWidgetProvider 可實(shí)現(xiàn)的方法為如下：

1、onDeleted(Context context, int[] appWidgetIds)

2、onDisabled(Context context)

3、onEnabled(Context context)

4、onReceive(Context context, Intent intent)
  Tip:因?yàn)?AppWidgetProvider 是繼承自BroadcastReceiver  所以可以重寫onRecevie 方法，當(dāng)然必須在后臺(tái)注冊Receiver

5、onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds)

三,Demo 詳解

 1.建立Widget內(nèi)容提供者文件，我們在res下建立xml文件夾，并且新建一個(gè)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 的文件形式存在的，看參數(shù)不難理解，比較重要的是這里android:initialLayout="@layout/main" 此句為指定桌面組件的布局文件。

 主要設(shè)置的參數(shù)如下:

minWidth: 定義Wdiget組件的寬度

minHeight: 定義Wdiget組件的高度

updatePeriodMillis: 更新的時(shí)間周期

initialLayout: Widget的布局文件

configure: 如果需要在啟動(dòng)前先啟動(dòng)一個(gè)Activity進(jìn)行設(shè)置，在這里給出Activity的完整類名(后面會(huì)說到，與一般Activity的實(shí)現(xiàn)有些許差別)

*Widget大小的計(jì)算 :(單元格數(shù)*74)-2，API上說是為了防止像素計(jì)算時(shí)的整數(shù)舍入導(dǎo)致錯(cuò)所以-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創(chuàng)建時(shí)會(huì)導(dǎo)致android.view.InflateExceptionn異常。

PS:這就導(dǎo)致有一些功能或樣式無法實(shí)現(xiàn)，如很基本的list或文本編輯框都是無法直接實(shí)現(xiàn)的。如果想自定義Widget中的View的話只能通過修改framework來提供相應(yīng)組件的支持。

 3.寫一個(gè)類繼承自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實(shí)際上就是一個(gè)BroadcastReceiver，里面提供了以下函數(shù)：

onReceive(Context, Intent)

onUpdate(Context , AppWidgetManager, int[] appWidgetIds)

onEnabled(Context)

onDeleted(Context, int[] appWidgetIds)

onDisabled(Context)

可通過重寫以上函數(shù)來監(jiān)聽Widget狀態(tài)的變化并進(jìn)行相應(yīng)的處理。

onUpdate 為組件在桌面上生成時(shí)調(diào)用，并更新組件UI，onReceiver 為接收廣播時(shí)調(diào)用更新UI，一般這兩個(gè)方法是比較常用的。

Widget的更新與Activity不同，必須借助于RemoteViews和AppWidgetMananger。

函數(shù)調(diào)用周期

[啟動(dòng) - 無confiure Activity] 
onReceive
onEnabled —— 第一個(gè)widget被顯示
onReceive
onUpdate —— 刷新界面

[啟動(dòng) - 帶confiuration Activity] 
onReceive
onUpdate

[拖動(dòng)] 
<無狀態(tài)變化>

[周期更新] 
onReceive
onUpdate

[刪除] 
onReceive
onDeleted —— widget被刪除
onReceive
onDisabled —— 最后一個(gè)widget被移除

[啟動(dòng)時(shí)位置不夠] 
onReceive
onEnabled
onReceive
onUpdate
onReceive
onDeleted
onReceive
onDisabled

 *每次狀態(tài)的變化會(huì)觸發(fā)onReceive，一般該函數(shù)是不需要重寫的。

 四、修改配置文件AndroidManifest.xml，后臺(tái)注冊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:

因?yàn)槭亲烂娼M件，所以暫時(shí)不考慮使用Activity 界面，當(dāng)然你在實(shí)現(xiàn)做項(xiàng)目時(shí)可能會(huì)需要點(diǎn)擊時(shí)跳轉(zhuǎn)到Activity 應(yīng)用程序上做操作，典型的案例為Android  提供的音樂播放器。

上面代碼中比較重要的是這一句 <meta-data android:name="android.appwidget.provider"  android:resource="@xml/appwidget_provider"></meta-data>  大意為指定桌面應(yīng)用程序的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 資料的整理，希望能幫助需要的朋友。

最新評論