文章转载只能用于非商业性质,且不能带有虚拟货币、积分、注册等附加条件。转载须注明出处http://blog.csdn.net/flowingflying/以及作者@恺风Wei。
根据widget定义,我们App Widget Provider的Java类为BirthDayWidgetProvider,这个类用于管理Widget的各个生命周期。
public class BirthDayWidgetProvider extends AppWidgetProvider{
private static String tag = "BirthDayWidgetProvider";
@Override /* 在3种情况下会调用OnUpdate()。onUpdate()是在main线程中进行,因此如果处理需要花费时间多于10秒,处理应在service中完成。
(1)在时间间隔到时调用,时间间隔在widget定义的android:updatePeriodMillis中设置;
(2)用户拖拽到主页,widget实例生成。无论有没有设置Configure activity,我们在Android4.4的测试中,当用户拖拽图片至主页时,widget实例生成,会触发onUpdate(),然后再显示activity(如果有)。这点和资料说的不一样,资料认为如果设置了Configure acitivity,就不会在一开始调用onUpdate(),而实验显示当实例生成(包括创建和重启时恢复),都会先调用onUpate()。在本例,由于此时在preference尚未有相关数据,创建实例时不能有效进行数据设置。
(3)机器重启,实例在主页上显示,会再次调用onUpdate()*/
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
Log.d(tag,"onUpdate() called. 有 " + appWidgetIds.length + "个widgets");
for(int i = 0 ; i< appWidgetIds.length; i ++){
Log.d(tag,"update widget ID " + appWidgetIds[i]);
BirthDayStoreData.updateAppWidget(context, appWidgetIds[i]);
}
}
@Override /* 某个/些widget从主页中删除,在此删除该widget的相关数据 */
public void onDeleted(Context context, int[] appWidgetIds) {
Log.d(tag,"onDeleted() called");
for(int i = 0 ; i < appWidgetIds.length; i ++){
Log.d(tag,"delete widget " + appWidgetIds[i] + " data");
BirthDayStoreData.removeData(context, appWidgetIds[i]);
}
BirthDayStoreData.showData(context);
}
@Override /* 一般无需重写此方法。App Widget provider本质是receiver,在此可以跟踪收到什么消息,这些消息包括AppWidgetManager.ACTION_APPWIDGET_DELETED/UPDATE/ENABLED/DISABLED,super.onReceiver()会根据消息类型触发不同的回调函数。如果采用AlarmManager或者自定义的广播,可以再次进行处理。 */
public void onReceive(Context context, Intent intent) {
Log.i(tag,"onReceive() : " + intent);
super.onReceive(context, intent);
}
@Override /* 表明至少有一个widget实例被拖到主页上,即当第一个widget出现时的回调函数。我们需要允许广播接收器接收消息,第一个widget出现了。我们可以在此注册其它感兴趣的自定义的广播*/
public void onEnabled(Context context) {
Log.d(tag,"onEnabled() called, context " + context.toString());
// setComponentEnabledSetting相当于在AndriodMenifest.xml文件中队组件设置android:enabled为true|false。此处是对receiver进行设置,如果true,则允许进行监听,包括开机重启。
PackageManager pm = context.getPackageManager();
/*使用new ComponentName("cn.wei.flowingflying.testwidget",".BirthDayWidgetProvider")出现不明原因错误,
* 可对类名采用完全名称,及new ComponentName("cn.wei.flowingflying.testwidget",
* "cn.wei.flowingflying.testwidget.BirthDayWidgetProvider"),
* 或通过系统获取组件名的方式new ComponentName(context, getClass())*/
pm.setComponentEnabledSetting(new ComponentName(context, getClass()),
PackageManager.COMPONENT_ENABLED_STATE_ENABLED,
PackageManager.DONT_KILL_APP);
}
@Override /*最后一个widget已从主页中删除,在此,确保删除所有配置数据,无需进行广播监听,色织enabled=false,如果有注册的自定义广播,在此unregister */
public void onDisabled(Context context) {
BirthDayStoreData.removeAllData(context);
PackageManager pm = context.getPackageManager();
pm.setComponentEnabledSetting(new ComponentName(context, getClass()),
PackageManager.COMPONENT_ENABLED_STATE_DISABLED,
PackageManager.DONT_KILL_APP);
}
}
如果主页没有实例,新实例的生成触发顺序为:onEnabled() –>onUpdate() –>Configure Activity,头两个顺序可能会出现变化。估计是AppWidgetManager的异步处理导致广播消息出现的先后顺序问题。如果已经有实例,新实例生成触发顺序为onUpdate() –> Configure activity。配置后,等待定义的时间间隔,进行定期触发onUpdate()。
机器重启 onEnabled() –>onUpdate() –> onUpdate(),同样头两个顺序可能会交换,此后,等待widget定义的时间间隔,进行定期触发onUpdate()。
如果我们更新或重装apk,实例并不会被删除,会触发onUpdate()。
补充:Widget图标
Widget在widget列表中显示的通常都是widget的外貌,Android模拟器有一个应用Widget Preview可以帮助我们获取widget的外观图标,如下:
通过adb pull将存贮在模拟器SD卡Download路径下的preview图片获取,作为列表显示图标。
小例子代码在:Pro Android学习:widget小例子
相关链接:我的Android开发相关文章