* 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、長按主界面
* 2、之后彈出一個(gè)對話框,里面就有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í)例使用的上下文對象
* 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)然必須在后臺注冊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、后臺注冊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>
2、寫一個(gè)類繼承自AppWidgetProvider
主要代碼如下:
- public class widgetProvider extends AppWidgetProvider
- @Override
- public void onUpdate(Context context, AppWidgetManager appWidgetManager,
- int[] appWidgetIds) {}
- @Override
- public void onReceive(Context context, Intent intent) {}
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>
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);
- }
- @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);
- }
5、如何使TextView 在兩種文本間來回跳轉(zhuǎn)
如何 TextView 在來兩種狀態(tài)中來回呢?這也是我比較調(diào)試最久的一個(gè)難點(diǎn),問題出在對 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);
}
}
