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

文章转载仅仅能用于非商业性质，且不能带有虚拟货币、积分、注冊等附加条件。

转载须注明出处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开发相关文章