下面是本篇的大綱：
* 1、AppWidget 框架類
* 2、在 Android 如何使用 Widget
* 3、AppWidget 框架的主要類介紹
* 4、DEMO 講解
1、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ā)送通知。
2、在 Android 如何使用 Widget * 1、長(zhǎng)按主界面
* 2、之后彈出一個(gè)對(duì)話框，里面就有android 內(nèi)置的一些桌面組件
3、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í)例使用的上下文對(duì)象
* updateAppWidget(int[] appWidgetIds, RemoteViews views)
通過appWidgetId 對(duì)傳進(jìn)來的 RemoteView 進(jìn)行修改，并重新刷新AppWidget 組件
* updateAppWidget(ComponentName provider, RemoteViews views)
通過 ComponentName 對(duì)傳進(jìn)來的 RemoeteView 進(jìn)行修改，并重新刷新AppWidget 組件
* updateAppWidget(int appWidgetId, RemoteViews views)
通過appWidgetId 對(duì)傳進(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)注冊(cè)Receiver
* 5、onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds)
4、Demo講解下面是我今天做的一個(gè)實(shí)例，提供給大家練習(xí)時(shí)做參考，效果如下：在布局中放一個(gè) TextView 做桌面組件，然后設(shè)置TextView 的 Clickable="true" 使其有點(diǎn)擊的功能，然后我們點(diǎn)擊它時(shí)改變它的字體，再點(diǎn)擊時(shí)變回來，詳細(xì)操作如下流程：
* 1、新建AppWidgetProvderInfo
* 2、寫一個(gè)類繼承自AppWidgetProvider
* 3、后臺(tái)注冊(cè)Receiver
* 4、使 AppWidget 組件支持點(diǎn)擊事件
* 5、如何使TextView 在兩種文本間來回跳轉(zhuǎn)
問題拋出來了，那么一起解決它吧。
1、新建AppWidgetProvderInfo代碼如下：
- <?xml version="1.0" encoding="UTF-8"?>
- <appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
- android:minWidth="60dp"
- android:minHeight="30dp"
- android:updatePeriodMillis="86400000"
-
- android:initialLayout="@layout/main">
- </appwidget-provider>
復(fù)制代碼 Tip:上文說過AppWidgetProvderInfo 是在res/xml 的文件形式存在的，看參數(shù)不難理解，比較重要的是這里android:initialLayout="@layout/main" 此句為指定桌面組件的布局文件。
2、寫一個(gè)類繼承自AppWidgetProvider主要代碼如下：
- public class widgetProvider extends AppWidgetProvider
復(fù)制代碼 并重寫兩個(gè)方法
- @Override
- public void onUpdate(Context context, AppWidgetManager appWidgetManager,
- int[] appWidgetIds) {}
- @Override
- public void onReceive(Context context, Intent intent) {}
復(fù)制代碼 Tip：onUpdate 為組件在桌面上生成時(shí)調(diào)用，并更新組件UI，onReceiver 為接收廣播時(shí)調(diào)用更新UI，一般這兩個(gè)方法是比較常用的。
3、后臺(tái)注冊(cè)Receiver后臺(tái)配置文件代碼如下：
- <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>
復(fù)制代碼 Tip:因?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 文件，使其可作其管理文件。
4、使 AppWidget 組件支持點(diǎn)擊事件先看代碼：
- 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);
- }
復(fù)制代碼 此方法為創(chuàng)建組件時(shí) onUpdate 調(diào)用的更新UI的方法，代碼中使用RemoteView 找到組件的布局文件，同時(shí)為其設(shè)置廣播接收器CLICK_NAME_ACTION并且通過RemoteView 的setOnClickPendingIntent 方法找到我想觸發(fā)事件的TextView 為其設(shè)置廣播。接著
- @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);
- }
復(fù)制代碼 在onReceiver 中通過判斷傳進(jìn)來的廣播來觸發(fā)動(dòng)作。
5、如何使TextView 在兩種文本間來回跳轉(zhuǎn)
如何 TextView 在來兩種狀態(tài)中來回呢？這也是我比較調(diào)試最久的一個(gè)難點(diǎn)，問題出在對(duì) AppWidget 的理解不夠深入。 如果我的設(shè)想沒錯(cuò)的話AppWidget 的生命周期應(yīng)該在每接收一次廣播執(zhí)行一次為一個(gè)生命周期結(jié)束，也就是說你在重寫的 AppWidgetProvider 類里面聲明全局變量做狀態(tài)判斷，每次狀態(tài)改變AppWidgetProvider 再接收第二次廣播時(shí)即為你重新初始化也就是說桌件為你重新實(shí)例化了一次AppWidgetProvider 。今天我因?yàn)樵诶锩娣帕艘粋€(gè)boolean 值初始化為true ，觀察調(diào)試看到每次進(jìn)入都為TRUE 故你在設(shè)置桌面組件時(shí)，全局變量把它聲明在另外一個(gè)實(shí)體類用來判斷是沒問題的，切忌放在本類。代碼參考o(jì)nReceiver方法。
效果圖如下：
代碼：
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
;
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);
}
}
widget.rar (42.55 KB, 下載次數(shù): 42)
2011-3-22 23:52:34 上傳
下載次數(shù): 42