桌面AppWidget组件使用

最近项目需要做到桌面widget部件，之前也没做过，所以研究了下。

废话不多说，AppWidget桌面部件也可以说是应用的另外一种入口。能获取到应用的信息，以及可视化得展示应用的内容。
AppWidget可以被定时更新。与一般应用程序有所不同。一般应用虽也可以以图标的形式（快捷方式）放在桌面，但必须点击运行和查看；而AppWidget一般不须点击即直观呈现其主要内容。当然，AppWidget也可以被设置为点击打开其它屏幕或应用等.

用法：
AppWidget的布局是像普通布局一样，在layout目录中创建布局。然后需要在res目录下载新建xml目录，里面新建xml文件，来配置Widget，比如

“<appwidget-provider
xmlns:android="http://schemas.android.com/apk/res/android"
android:initialLayout="@layout/xxx"
android:minHeight="xxxx"
android:minResizeHeight="xxxx"
android:minResizeWidth="xxxx"
android:minWidth="xxxx"
android:configure="xxxx.xx.Config"
android:previewImage="@drawable/alc_widget_prev_weth_4x2"
android:resizeMode="horizontal|vertical"
android:updatePeriodMillis="30000"/>”

initalLayout是初始化加载widget的布局。minResizexx是widget能被调整的最小宽高度。 configure是如果需要在启动前先启动一个Activity进行设置，在这里给出Activity的完整类名。previewImage是在桌面菜单选择该部件时显示的默认图片，也即演示图片。resizeMode是调整size模式。updatePeriodMillis也是最重要的参数，即是组件更新的时间间隔。

然后也需要在清单文件中去配置接收者

“<receiver android:name="xxx.xx.xx.XXWidgetProvider">  
         <intent-filter>  
             <action android:name="android.appwidget.action.APPWIDGET_UPDATE"/>  
             <!-- 自定义action -->  
             <action android:name="xxxx.xxx"/>  
         </intent-filter>  
         <meta-data android:name="android.appwidget.provider"  
             android:resource="@xml/xxx"/>  
             <!--  android:resource="" 定义了Widget的信息使用xxxx.xml描述 -->  
</receiver>"

其中meta配置的xml也就是上面的xml配置文件。

最后也就是要处理Widget相关事件的，需要创建类去继承AppWidgetProvider。实现onUpdate方法。方法的意思是。更新部件时调用，在第1次添加部件时也会调用

"@Override //更新部件时调用，在第1次添加部件时也会调用  
public void onUpdate(Context context, AppWidgetManager appWidgetManager,  
        int[] appWidgetIds) {  
    super.onUpdate(context, appWidgetManager, appWidgetIds);  
    System.out.println("onUpdate widget：" + Arrays.toString(appWidgetIds));  
    /* 
     * 构造pendingIntent发广播，onReceive()根据收到的广播，更新 
     */  
    Intent intent = new Intent(context, xxxReciver.class);  
    PendingIntent pendingIntent = PendingIntent.getService(context, 0, intent, 0);  
    RemoteViews rv = new RemoteViews(context.getPackageName(), R.layout.xxxx);  这里使用RemoteView去加载widget的布局。
    rv.setOnClickPendingIntent(R.id.xxx, pendingIntent);  
    appWidgetManager.updateAppWidget(appWidgetIds, rv);  
}  
  
@Override   //部件从host中删除  
public void onDeleted(Context context, int[] appWidgetIds) {  
    super.onDeleted(context, appWidgetIds);  
    System.out.println("onDeleted widget");  
}  
  
@Override //第1次创建时调用，之后再创建不会调用  
public void onEnabled(Context context) {  
    super.onEnabled(context);  
    System.out.println("onEnabled widget");  
}  
  
@Override //当最后一个部件实例 被删除时 调用  用于清除onEnabled执行的操作  
public void onDisabled(Context context) {  
    super.onDisabled(context);  
    System.out.println("onDisabled widget");  
}  
  
@Override //  
public void onReceive(Context context, Intent intent) {  
    super.onReceive(context, intent);  
    System.out.println("onReceive widget");  
    /* 
     * 接收 <action android:name="xxx.xx.xxx"/> 自定义的action
       在其他组件或activity或service中发送这些广播 
        
     */  
    if (intent.getAction().equals("com.test.action.start")) {  
        long time = intent.getLongExtra("time", 0);  
         updateWidget(context, time);  
         System.out.println("receive com.test.action.start");  
    }  
}  
  
private void updateWidget(Context context, long time) {  
    //RemoteViews处理异进程中的View  
    RemoteViews rv = new RemoteViews(context.getPackageName(), R.layout.xxx);  
    System.out.println("time=" + time);  
    rv.setTextViewText(R.id.xxx, "xxx"); //这里比较特殊，设置文本使用这个方法。 
      
    AppWidgetManager am = AppWidgetManager.getInstance(context);  
    int[] appWidgetIds = am.getAppWidgetIds(new ComponentName(context, xxx.class));  //xxx.class,表示本类的class文件。
    am.updateAppWidget(appWidgetIds, rv);//更新 所有实例  
}"  

上面有说xml中有个配置configure，加上配置活动(configure=activity)也就是添加Widget时，会先打开一个Activity，进行配置操作。

"/* 
    * 配置部件 
    * 在onCreate中setContentView()函数前添加setResult(RESULT_CANCLE) ，这样如果在Activity初始化完成前按下了BACK按键，则Widget不会启动； 
    * 在setContentView()函数之后（不一定要在onCreate中，在Activity退出前即可），添加如下设置以指定需要启动的Widget 
*/   
    public class AppWidgetConfigureActivity extends Activity implements OnClickListener {  
         Button config1, config2, config3;  
         @Override  
        protected void onCreate(Bundle savedInstanceState) {  
           super.onCreate(savedInstanceState);  
           Intent intent = getIntent();  
           Bundle extras = intent.getExtras();  
           if (extras != null) {  
               int widgetid = extras.getInt(AppWidgetManager.EXTRA_APPWIDGET_ID, -1);//从intent中得出widgetid  
               //通知 appwdiget 的配置已取消  
               Intent reslut = new Intent();  
               reslut.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, widgetid);  
               setResult(RESULT_CANCELED, reslut);  
               System.out.println("result cancel");  
           }  
           setContentView(R.layout.switch_configure);  
          
           config1 = (Button) findViewById(R.id.btn_config1);  
           config2 = (Button) findViewById(R.id.btn_config2);  
           config3 = (Button) findViewById(R.id.btn_config3);  
           config1.setOnClickListener(this);  
           config2.setOnClickListener(this);  
           config3.setOnClickListener(this);  
    }  
      
    @Override  
    protected void onResume() {  
        super.onResume();  
          
    }  
  
    private void onCompletedConfigure() {  
        Intent intent = getIntent();  
        Bundle extras = intent.getExtras();  
        if (extras != null) {  
            int widgetid = extras.getInt(AppWidgetManager.EXTRA_APPWIDGET_ID, -1);//从intent中得出widgetid  
            //通知 appwdiget 的配置已完成  
            Intent reslut = new Intent();  
            reslut.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, widgetid);  
            setResult(RESULT_OK, reslut);  
            System.out.println("result ok");  
            finish();  
            System.out.println("finish ok");  
        }  
    }  

    @Override  
    public void onClick(View v) {  
        if (v == config1) {  
            //do config1  
        } else if (v == config2) {  
            //do config2  
        } else if (v == config3) {  
            //do config3  
        }  
        onCompletedConfigure();  
    }       
}"

widget的基础实现也就是这样。具体的实现基本上是在appWidgetProvider的类中去完成。通过onRecive方法，接收到action去完成相应的方法。再更新RemoteViews的视图。