一、主要框架
- 1、AppWidgetProvider :继承自 BroadcastRecevier , 在AppWidget 应用 update、enable、disable 和 delete 时接收通知。其中,onUpdate、onReceive 是最常用到的方法,它们接收更新通知。
-
- 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 组件
- bindAppWidgetId(int appWidgetId, ComponentName provider)
- 2、 AppWidgetProvderInfo:描述 AppWidget 的大小、更新频率和初始界面等信息,以XML 文件形式存在于应用的 res/xml/目录下。
- 3、AppWidgetManger :负责管理 AppWidget ,向 AppwidgetProvider 发送通知。
- 4、RemoteViews :一个可以在其他应用进程中运行的类,向 AppWidgetProvider 发送通知。
二、开发步骤
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>
<?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
public class widgetProvider extends AppWidgetProvider
并重写两个方法- @Override
- public void onUpdate(Context context, AppWidgetManager appWidgetManager,
- int[] appWidgetIds) {}
- @Override
- public void onReceive(Context context, Intent intent) {}
@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>
<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);
- }
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);
- }