Android Widget 案頭組件開發介紹_Android

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] onReceiveonEnabled —— 第一個widget被顯示onReceiveonUpdate —— 重新整理介面[啟動 - 帶confiuration Activity] onReceiveonUpdate[拖動] <無狀態變化>[周期更新] onReceiveonUpdate[刪除] onReceiveonDeleted —— widget被刪除onReceiveonDisabled —— 最後一個widget被移除[啟動時位置不夠] onReceiveonEnabledonReceiveonUpdateonReceiveonDeletedonReceiveonDisabled

 *每次狀態的變化會觸發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 資料的整理，希望能協助需要的朋友。