Android Widget 桌面元件開發介紹

NO IMAGE

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 資料的整理,希望能幫助需要的朋友。

您可能感興趣的文章:

Android開發入門之Appwidget用法分析Android開發之App widget用法例項分析講解Android中的Widget及AppWidget小工具的建立例項Android程式開發之自定義設定TabHost,TabWidget樣式Android桌面元件App Widget完整案例Android桌面元件App Widget用法入門教程android實現widget時鐘示例分享Android 桌面Widget開發要點解析(時間日期Widget)Android TabWidget切換卡的實現應用