Pro Android学习笔记（一三八）：Home Screen Widgets（4）：App Widget Provider

文章转载只能用于非商业性质，且不能带有虚拟货币、积分、注册等附加条件。转载须注明出处http://blog.youkuaiyun.com/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开发相关文章