Android桌面組件Widget初探
Android桌面組件widget初探是本文要介紹的內容,主要是來了解Android Widget 的應用,本來打算晚上繼續ApiDemos系列的,不過今天下午的時候無聊去玩了一下桌面組件AppWidget覺得挺不錯的一個東西,對它很是感興趣,玩了一下碰到很多問題,一直在解決問題到了晚上10點。只能怪自己理解不深刻,不過最后還是解決了,把一些領悟寫出來也算給自己一個交代。下面是本篇的大綱:
1、AppWidget框架類
2、在Android如何使用Widget
3、AppWidget框架的主要類介紹
4、DEMO講解
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、在Android如何使用Widget
1、長按主界面

2、之后彈出一個對話框,里面就有android內置的一些桌面組件

3、AppWidget框架的主要類介紹
1)AppWidgetManger類
- bindAppWidgetId(intappWidgetId,ComponentNameprovider)
通過給定的ComponentName綁定appWidgetId
- getAppWidgetIds(ComponentNameprovider)
通過給定的ComponentName獲取AppWidgetId
- getAppWidgetInfo(intappWidgetId)
通過AppWidgetId獲取AppWidget信息
- getInstalledProviders()
返回一個List的信息
- getInstance(Contextcontext)
獲取AppWidgetManger實例使用的上下文對象
- updateAppWidget(int[]appWidgetIds,RemoteViewsviews)
通過appWidgetId對傳進來的RemoteView進行修改,并重新刷新AppWidget組件
- updateAppWidget(ComponentNameprovider,RemoteViewsviews)
通過ComponentName對傳進來的RemoeteView進行修改,并重新刷新AppWidget組件
- updateAppWidget(intappWidgetId,RemoteViewsviews)
通過appWidgetId對傳進來的RemoteView進行修改,并重新刷新AppWidget組件
2)繼承自AppWidgetProvider可實現的方法為如下:
1、
- onDeleted(Contextcontext,int[]appWidgetIds)
2、
- onDisabled(Contextcontext)
3、
- onEnabled(Contextcontext)
4、
- onReceive(Contextcontext,Intentintent)
Tip:因為AppWidgetProvider是繼承自BroadcastReceiver所以可以重寫onRecevie方法,當然必須在后臺注冊Receiver
5、
- onUpdate(Contextcontext,AppWidgetManagerappWidgetManager,int[]appWidgetIds)
4、Demo講解
下面是我今天做的一個實例,提供給大家練習時做參考,效果如下:在布局中放一個TextView做桌面組件,然后設置TextView的Clickable="true"使其有點擊的功能,然后我們點擊它時改變它的字體,再點擊時變回來,詳細操作如下流程:
1、新建AppWidgetProvderInfo
2、寫一個類繼承自AppWidgetProvider
3、后臺注冊Receiver
4、使AppWidget組件支持點擊事件
5、如何使TextView在兩種文本間來回跳轉
問題拋出來了,那么一起解決它吧。
1、新建AppWidgetProvderInfo
代碼如下:
- android:minWidth="60dp"
- android:minHeight="30dp"
- android:updatePeriodMillis="86400000"
- android:initialLayout="@layout/main">
Tip:上文說過AppWidgetProvderInfo是在res/xml的文件形式存在的,看參數不難理解,比較重要的是這里android:initialLayout="@layout/main"此句為指定桌面組件的布局文件。
2、寫一個類繼承自AppWidgetProvider
主要代碼如下:
- public class widgetProvider extends AppWidgetProvider
并重寫兩個方法
- @Override
- public void onUpdate(Context context, AppWidgetManager appWidgetManager,
- int[] appWidgetIds) {}
- @Override
- public void onReceive(Context context, Intent intent) {}
Tip:onUpdate為組件在桌面上生成時調用,并更新組件UI,onReceiver為接收廣播時調用更新UI,一般這兩個方法是比較常用的。
3、后臺注冊Receiver
后臺配置文件代碼如下:
- <receiver android:name=".widgetProvider">
- <meta-data android:name="android.appwidget.provider"
- android:resource="@xml/appwidget_provider"></meta-data>
- <intent-filter>
- <action android:name="com.terry.action.widget.click"></action>
- <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
- </intent-filter>
- </receiver>
Tip:因為是桌面組件,所以暫時不考慮使用Activity界面,當然你在實現做項目時可能會需要點擊時跳轉到Activity應用程序上做操作,典型的案例為Android提供的音樂播放器。上面代碼中比較重要的是這一句大意為指定桌面應用程序的AppWidgetProvderInfo文件,使其可作其管理文件。
4、使AppWidget組件支持點擊事件
先看代碼:
- public static void updateAppWidget(Context context,
- AppWidgetManager appWidgeManger, int appWidgetId) {
- rv = new RemoteViews(context.getPackageName(), R.layout.main);
- Intent intentClick = new Intent(CLICK_NAME_ACTION);
- PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0,
- intentClick, 0);
- rv.setOnClickPendingIntent(R.id.TextView01, pendingIntent);
- appWidgeManger.updateAppWidget(appWidgetId, rv);
- }
此方法為創建組件時onUpdate調用的更新UI的方法,代碼中使用RemoteView找到組件的布局文件,同時為其設置廣播接收器CLICK_NAME_ACTION并且通過RemoteView的setOnClickPendingIntent方法找到我想觸發事件的TextView為其設置廣播。接著
- @Override
- public void onReceive(Context context, Intent intent) {
- // TODO Auto-generated method stub
- super.onReceive(context, intent);
- if (rv == null) {
- rv = new RemoteViews(context.getPackageName(), R.layout.main);
- }
- if (intent.getAction().equals(CLICK_NAME_ACTION)) {
- if (uitil.isChange) {
- rv.setTextViewText(R.id.TextView01, context.getResources()
- .getString(R.string.load));
- } else {
- rv.setTextViewText(R.id.TextView01, context.getResources()
- .getString(R.string.change));
- }
- Toast.makeText(context, Boolean.toString(uitil.isChange),
- Toast.LENGTH_LONG).show();
- uitil.isChange = !uitil.isChange;
- }
- AppWidgetManager appWidgetManger = AppWidgetManager
- .getInstance(context);
- int[] appIds = appWidgetManger.getAppWidgetIds(new ComponentName(
- context, widgetProvider.class));
- appWidgetManger.updateAppWidget(appIds, rv);
- }
在onReceiver中通過判斷傳進來的廣播來觸發動作。
5、如何使TextView在兩種文本間來回跳轉
如何TextView在來兩種狀態中來回呢?這也是我比較調試最久的一個難點,問題出在對AppWidget的理解不夠深入。如果我的設想沒錯的話AppWidget的生命周期應該在每接收一次廣播執行一次為一個生命周期結束,也就是說你在重寫的AppWidgetProvider類里面聲明全局變量做狀態判斷,每次狀態改變AppWidgetProvider再接收第二次廣播時即為你重新初始化也就是說桌件為你重新實例化了一次AppWidgetProvider。今天我因為在里面放了一個boolean值初始化為true,觀察調試看到每次進入都為TRUE故你在設置桌面組件時,全局變量把它聲明在另外一個實體類用來判斷是沒問題的,切忌放在本類。代碼參考onReceiver方法。
效果圖如下:

代碼:
代碼
- package com.terry;
- import android.app.PendingIntent;
- import android.appwidget.AppWidgetManager;
- import android.appwidget.AppWidgetProvider;
- import android.content.ComponentName;
- import android.content.Context;
- import android.content.Intent;
- import android.widget.RemoteViews;
- import android.widget.Toast;
- public class widgetProvider extends AppWidgetProvider {
- private static final String CLICK_NAME_ACTION = "com.terry.action.widget.click";
- private static RemoteViews rv;
- @Override
- public void onUpdate(Context context, AppWidgetManager appWidgetManager,
- int[] appWidgetIds) {
- // TODO Auto-generated method stub
- final int N = appWidgetIds.length;
- for (int i = 0; i < N; i++) {
- int appWidgetId = appWidgetIds[i];
- updateAppWidget(context, appWidgetManager, appWidgetId);
- }
- }
- @Override
- public void onReceive(Context context, Intent intent) {
- // TODO Auto-generated method stub
- super.onReceive(context, intent);
- if (rv == null) {
- rv = new RemoteViews(context.getPackageName(), R.layout.main);
- }
- if (intent.getAction().equals(CLICK_NAME_ACTION)) {
- if (uitil.isChange) {
- rv.setTextViewText(R.id.TextView01, context.getResources()
- .getString(R.string.load));
- } else {
- rv.setTextViewText(R.id.TextView01, context.getResources()
- .getString(R.string.change));
- }
- Toast.makeText(context, Boolean.toString(uitil.isChange),
- Toast.LENGTH_LONG).show();
- uitil.isChange = !uitil.isChange;
- }
- AppWidgetManager appWidgetManger = AppWidgetManager
- .getInstance(context);
- int[] appIds = appWidgetManger.getAppWidgetIds(new ComponentName(
- context, widgetProvider.class));
- appWidgetManger.updateAppWidget(appIds, rv);
- }
- public static void updateAppWidget(Context context,
- AppWidgetManager appWidgeManger, int appWidgetId) {
- rv = new RemoteViews(context.getPackageName(), R.layout.main);
- Intent intentClick = new Intent(CLICK_NAME_ACTION);
- PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0,
- intentClick, 0);
- rv.setOnClickPendingIntent(R.id.TextView01, pendingIntent);
- appWidgeManger.updateAppWidget(appWidgetId, rv);
- }
- }
小結:Android桌面組件widget初探的內容介紹完了,希望通過Android Widget 的應用內容的學習能對你有所幫助!