首页 > 代码库 > Android学习笔记:Home Screen Widgets(2):关于Widget

Android学习笔记:Home Screen Widgets(2):关于Widget

通过widget定义,我们在widget列表中看到了我们的TestWidget,当我们拖拽widget到主页时,如果在appwidet-provider中定义了android:configure的java类,在widget实例创建后会马上唤起配置activity。这个activity主要完成两个任务:1、配置初始化数据;2、将配置数据适配到widget实例中。

利用preference中存贮配置数据

widget数据可以保持在文件、Share preference,或者SQLite3中。widget作为小工具配置数据量小,通常可以方便地存贮在preference中。preference中数据存贮和读取使用BirthDayStoreData类来处理。我们在Pro Android学习笔记(六三):Preferences(7):代码控制首选项中的“利用preference保存状态”已经介绍过如何实现,在此,复习一下。

我们需要存贮的内容有widgetID,名字,生日,Preference是以键值对的方式保存,我们以name_widgetID作为key,生日作为value来进行信息存贮。

public class BirthDayStoreData { 
    private final static String BIRTHDAY_WIDGET_PROVIDER_NAME = "cn.wei.flowingflying.testwidget.provider"; 

    //保存配置数据:创建widget实例,通过configure activity进行配置时,保存相关配置数据 
    public static void storeData(Context context,int widgetId, String name,String value){
        String key = getKey(widgetId,name);            
        //第一个参数是preferences文件,如果不存在则创建之。具体为/data/data/cn.wei.flowingflying.testwidget/shared_prefs/cn.wei.flowingflying.testwidget.provider.xml,可以在DDMS中查看。
        Editor editor = context.getSharedPreferences(BIRTHDAY_WIDGET_PROVIDER_NAME, Context.MODE_PRIVATE).edit();
        editor.putString(key, value); 
        editor.commit();
    
    } 

    //删除配置数据:删除widget实例的同时,需要删除该实例的相关数据
    public static void removeData(Context context, int widgetId){ 
        String key = getKeyById(context, widgetId); 
        if(key == null) 
            return; 
        Editor editor = context.getSharedPreferences(BIRTHDAY_WIDGET_PROVIDER_NAME, Context.MODE_PRIVATE).edit();
        editor.remove(key); 
        editor.commit(); 
    } 
    //清空全部的配置数据 
    public static void removeAllData(Context context){ 
        Editor editor = context.getSharedPreferences(BIRTHDAY_WIDGET_PROVIDER_NAME, Context.MODE_PRIVATE).edit();
        editor.clear(); 
        editor.commit();        
    }    

    //显示配置数据:用于我们在LogCat中进行跟踪,在此,我们也演示了如何通过轮询方式,显示全部的数据,通过类似的方式,我们可以同widgetId查得对应的名字和生日,通过类似的方法,可根据widgetId查询key,名字,生日,相关代码从略。
    public static void showData(Context context){ 
        SharedPreferences prefs = context.getSharedPreferences(BIRTHDAY_WIDGET_PROVIDER_NAME, Context.MODE_PRIVATE);
        Map<String,?> pairs = prefs.getAll();  
        Log.d("DATA","Total " + pairs.size() + " widgets:");
        for(String key:pairs.keySet()){ 
           String value = http://www.mamicode.com/(String)pairs.get(key);
 
            Log.d("DATA",key + " - " + value);
       } 
    }  
     
    public static String getNameById(Context context, int widgetId){ 
        … … 
    } 
    
    public static String getDateById(Context context ,int widgetId){ 
        … …   
    } 
    
    private static String getKey(int widgetId, String name){ 
        return name + "_" + widgetId; 
    }   
     
    private static String getKeyById(Context context,int widgetId){  
        … … 
    }  
    
}

配置初始化数据

配置configure activity的代码如下:

public class ConfigBirthDayWidgetActivity extends Activity{ 
    private static String tag = "ConfigActivity"; 
    private int myWidgetId = AppWidgetManager.INVALID_APPWIDGET_ID; 
    
    @Override //配置activity的操作和普通activity的一样,但在被AppWidgetManage唤起时,intent是携带widgetId的信息,我们在onCreate()中获取Widget ID。 
    protected void onCreate(Bundle savedInstanceState) { 
        … …  
        Intent intent = getIntent(); 
        Bundle b = intent.getExtras(); 
        if(b != null){ 
            myWidgetId = b.getInt(AppWidgetManager.EXTRA_APPWIDGET_ID,AppWidgetManager.INVALID_APPWIDGET_ID);           
        } 
        
        if(myWidgetId == AppWidgetManager.INVALID_APPWIDGET_ID){  
            Toast.makeText(this, "Widget Error : 无有效widget ID", Toast.LENGTH_LONG).show();
            finish(); 
        }  

    } 
    
    .. ….  
      
   //点击配置button后调用的方法 
    private void getAndStoreConfigInfo(){  
        … …  String name为用户输入名字,String date为用户输入的有效日期
        //【1】在preference中保持数据,并显示所有数据 
        BirthDayStoreData.storeData(this, myWidgetId, name, date);
        BirthDayStoreData.showData(this); 
        //【2】将配置数据与具体的widget实例相关联,具体实现见后面
        BirthDayStoreData.updateAppWidget(this, myWidgetId,name, date); 
        
        //【3】将结果返回给AppWidget Manager,以通知它Configurator已经完成。作用如同startActivityForResult()给出返回值,通知AppWidgetManager某个widgetId已经完成配置,可以在主页上显示创建的widget实例 
        Intent resultIntent = new Intent(); 
        resultIntent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, myWidgetId);
        setResult(RESULT_OK, resultIntent);
 
        //【4】关闭activity
        finish(); 
    }      
}

配置数据适配到widget实例中

Widget实例的view要通过RemoteViews进行控制,小例子采用静态方法的方式,代码片段如下:

public class BirthDayStoreData {  
    ... ... 
      
    public static void updateAppWidget(Context context,int widgetId,String name, String date){
       //【1】设置Remote view的信息 
        // 1.1)、获得remote view对象
        RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.birday_widget);
        // 1.2)、对remote view进行setText()设置
        views.setTextViewText(R.id.bd_name, widgetId + ":" + name);
        views.setTextViewText(R.id.bd_date, date);  
        views.setTextViewText
(R.id.bd_days, Long.toString(Utils.howFarInDays(Utils.getDate(date))));//Utils是处理日期的类
        // 1.3)、通过PendingIntent设置某个view的点击处理,采用intent方式,可以打开activity,service,receiver等等。本小例子将打开某个网页 
        Intent intent = new Intent(Intent.ACTION_VIEW,Uri.parse("http://www.taobao.com"));
        PendingIntent pi = PendingIntent.getActivity(context, 0, intent, 0); 
        views.setOnClickPendingIntent(R.id.bd_buy, pi);
 
        
        //【2】通过AppWidgetManger,具体实施到widgetId实例上。
        AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
        appWidgetManager.updateAppWidget(widgetId,views);
 
    } 
    
    public static void updateAppWidget(Context context,int widgetId){
        … …  
    }
 

}

根据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图片获取,作为列表显示图标。



Android学习笔记:Home Screen Widgets(2):关于Widget