下面是本篇的大綱:
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(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)
4、Demo講解
下面是我今天做的一個實例,提供給大傢練習時做參考,效果如下:在佈局中放一個TextView 做桌面組件,然後設置TextView 的Clickable="true" 使其有點擊的功能,然後我們點擊它時改變它的字體,再點擊時變回來,詳細操作如下流程:
1、新建AppWidgetProvderInfo
2、寫一個類繼承自AppWidgetProvider
3、後臺註冊Receiver
4、使AppWidget 組件支持點擊事件
5、如何使TextView 在兩種文本間來回跳轉
問題拋出來瞭,那麼一起解決它吧。
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>
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 提供的音樂播放器。上面代碼中比較重要的是這一句<meta-data android:name="android.appwidget.provider" android:resource="@xml/appwidget_provider"></meta-data> 大意為指定桌面應用程序的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);
}
}