android widget
一、主要框架
- 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 组件
二、开发步骤
1.在res\xml中建立widget内容提供者文件，取名为widget_provider.xml
<?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>
android:initialLayout="@layout/main" 此句为指定桌面组件的布局文件。
android:updatePeriodMillis="86400000"指定刷新时间间隔（单位：ms），每隔android:updatePeriodMillis就调用onUpdate方法。另，如果android:updatePeriodMillis为0，则表示不刷新。
android:minWidth最小宽度
android:minHeight最小高度
可以根据所占单元格数计算android:minWidth和android:minHeight。
计算公式（宽高皆适用）：（单元个数*74）-2。由于像素计算会造成一定的偏差，所以最后值减2。另，屏幕最大单元格数位4*4。
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) {} 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>
上面代码中比较重要的是这一句 <meta-data android:name="android.appwidget.provider" android:resource="@xml/appwidget_provider"></meta-data> 大意为指定桌面应用程序的AppWidgetProvderInfo 文件，使其可作其管理文件。
4.使app widget组件支持点击事件
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 为其设置广播。接着在onReceiver 中通过判断传进来的广播来触发动作。
@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);
}