Widget

一、是什么

一个桌面插件

二、如何使用

从一个小Demo来做起：
1、在AndroidManifest中声明 App Widget
2、在xml目录定义 App Widget的初始化xml文件
3、实现Widget具体布局的Layout xml
4、继承APPWidgetProvider类，实现具体的Widget业务逻辑。

实现步骤：
1、新建一个类TestWidet继承AppWidgetProvider；
再在AndroidManifest里注册

 <receiver android:name=".TestWidget">
            <intent-filter>
                <action android:name="android.appwidget.action.APPWIDGET_UPDATE"/>
            </intent-filter>
            <meta-data android:name="android.appwidget.provider" //指定provider的resource，manifest中存储数据，这里存储了name，name告诉我们这是一个receiver同时还是一个widgetprovider；resource是配置选项，配置选项在xxx.xml文件里。 android:resource="@layout/widget_setting"/>
        </receiver>

intent-filter中过滤了APPWIDGET_UPDATE事件，这个事件是由系统触发的更新事件，每个widget必须包含这个事件；meta-data标签描述的是widget的配置文件指向，该文件描述了widget的一些基本信息。

2、定义resource（定义配置文件）

在这里定义 layout、最小宽高度、在Widget里的背景、更新时间等。

<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="match_parent" android:layout_height="match_parent" android:minWidth="140dp" android:minHeight="140dp" android:previewImage="@drawable/girl" android:initialLayout="@layout/layout_widget" android:updatePeriodMillis="20000" android:widgetCategory="home_screen">

</appwidget-provider>

3、layout_widget布局文件

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:orientation="vertical" android:layout_width="match_parent" android:layout_height="match_parent">

    <TextView  android:layout_width="wrap_content" android:layout_height="wrap_content" android:textAppearance="?android:attr/textAppearanceLarge" android:text="Large Text" android:id="@+id/widget_textView"/>

    <Button  android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="New Button" android:id="@+id/widget_button"/>
</LinearLayout>

4、具体的Widget业务逻辑（onReceive方法和onUpdate方法）

package com.example.chenjinhua.myapplication;

import android.app.PendingIntent;
import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.ComponentName;
import android.content.Context;
import android.content.Intent;
import android.graphics.Color;
import android.text.TextUtils;
import android.util.Log;
import android.widget.RemoteViews;

/** * Created by chenjinhua on 16/3/26. */
public class TestWidget extends AppWidgetProvider {

    public static final String WIDGET_BUTTON_ACTION = "widget_button_action";

    @Override
    public void onReceive(Context context, Intent intent) {
        super.onReceive(context, intent);
        if ( intent != null && TextUtils.equals(intent.getAction(),WIDGET_BUTTON_ACTION)){
            Log.i("WIDGET_BUTTON_ACTION", "be clicked");

            /* * 设置组件的变化 * */
            //必须重新new一遍RemoteViews，不然RemoteViews不会更新的。
            RemoteViews remoteViews = new RemoteViews(context.getPackageName(),R.layout.layout_widget);
            remoteViews.setTextViewText(R.id.widget_textView,"be clicked");
            remoteViews.setTextColor(R.id.widget_textView, Color.BLUE);

            /* * 更新组件 * */
            AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
            //获取组件的名字
            ComponentName componentName = new ComponentName(context,TestWidget.class);
            appWidgetManager.updateAppWidget(componentName,remoteViews);
        }
    }

    /* 当程序初始化时会调用onUpdate方法 * */
    @Override
    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
        super.onUpdate(context, appWidgetManager, appWidgetIds);

        //远程视图，把布局文件读出来，读成一个remoteViews的界面
        /* * 1、在RemoteViews的构造函数中，通过传入layout文件的id来获取 “layout文件对应的视图(RemoteViews)"; * 2、然后，调用RemoteViews中的方法能对layout中的组件进行设置; * 3、可以调用setOnClickPendingIntent() 来设置Button的点击响应事件 * */
        RemoteViews remoteViews = new RemoteViews(context.getPackageName(),R.layout.layout_widget);

        Intent intent = new Intent();
        //广播发给TestWidget.class本身，它本身可在onReceive方法里接收。
        intent.setClass(context,TestWidget.class);
        intent.setAction(WIDGET_BUTTON_ACTION);
        PendingIntent pendingIntent = PendingIntent.getBroadcast(context,0,intent,0);

        remoteViews.setOnClickPendingIntent(R.id.widget_button,pendingIntent);
        //更新视图，告诉它我们做了这件事情
        appWidgetManager.updateAppWidget(appWidgetIds,remoteViews);
    }
}

Tips

1、 RemoteViews

顾名思义，它是一个远程视图。App Widget中的视图，都是通过RemoteViews表现的。 

在RemoteViews的构造函数中，通过传入layout文件的id来获取 “layout文件对应的视图(RemoteViews)”；然后，调用RemoteViews中的方法能对layout中的组件进行设置(例如，可以调用setTextViewText()来设置TextView组件的文本，可以调用setOnClickPendingIntent() 来设置Button的点击响应事件)。

因此，我们可以将 “RemoteViews 看作是 layout文件中所包含的全部视图的集合”。

2、更新AppWidget界面

（1）、如果是在onUpdate()方法内更新AppWidget界面
eg: appWidgetManager.updateAppWidget(appWidgetIds, ActivityView);
（2）、如果是在onUpdate()方法外（一般为Service内）更新AppWidget界面，则需要定义几个变量
eg: public RemoteViews views; //RemoteView对象
public ComponentName thisWidget; //组件名
public AppWidgetManager manager; // AppWidget管理器

 thisWidget = new ComponentName(this, PictureAppWidgetProvider.class);
 manager = AppWidgetManager.getInstance(this);
 manager.updateAppWidget(thisWidget, views);

其他：

1、与service通信
2、Widget控件的交互方法
3、如何做一个桌面播放器Widget