Android之AppWidgetProvider使用详解

AppWidget 即桌面小部件，也叫桌面控件，就是能直接显示在Android系统桌面上的小程序。图中用黄色箭头指示的即为AppWidget，一些用户使用比较频繁的程序，可以做成AppWidget，这样能方便地使用。典型的程序有时钟、天气、音乐播放器等。AppWidget 是Android 系统应用开发层面的一部分，有着特殊用途，使用得当的话，的确会为app 增色不少，它的工作原理是把一个进程的控件嵌入到别外一个进程的窗口里。需要说明的是，AppWidgetProvider本质是一个广播，即BroadcastReceiver，在实际的使用中，把AppWidgetProvider当成一个BroadcastReceiver即可。这里就简单的介绍一下开发一个AppWidget的流程吧。

想要在应用中创建一个AppWidget，至少需要以下几样东西：

• 需要创建一个AppWidgetProviderInfo，来描述AppWidget的元数据。
• 需要实现一个自己的AppWidgetProvider对AppWidget进行更新等操作。
• 需要布局文件来描述AppWidget的布局。

1. 为AppWidget提供一个文件，定义小控件的基本配置信息

在资源文件夹res目录下新建xml文件夹，假设名字为flash_light_widget_info.xml，文件内容为：

<?xml version="1.0" encoding="utf-8"? 
  <!--小控件宽高-- 
  <!--android:minWidth="40dp"-- 
  <!--android:minHeight="40dp"-- 
  <!--更新时间-- 
  <!--android:updatePeriodMillis="86400000"-- 
  <!--用于指定预览图片。即搜索到widget时，查看到的图片。若没有设置的话，系统为指定一张默认图片。-- 
  <!--android:previewImage="@drawable/widget_flashlight"-- 
  <!--widget 添加到手机主屏幕中的layout-- 
  <!--android:initialLayout="@layout/flash_light_widget"-- 
  <!--android:resizeMode ： widget可以被拉伸的方向。horizontal表示可以水平拉伸，vertical表示可以竖直拉伸-- 
  <!--android:resizeMode="horizontal|vertical"-- 

<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
  android:minWidth="40dp"
  android:minHeight="40dp"
  android:updatePeriodMillis="86400000"
  android:previewImage="@drawable/ic_launcher"
  android:initialLayout="@layout/widget_layout"
  android:resizeMode="horizontal|vertical" 
</appwidget-provider 

2. 创建一个WidgetProvider继承自AppWidgetProvider；

public class MyAppWidgetProvider extends AppWidgetProvider {
  //没接收一次广播消息就调用一次，使用频繁 
  public void onReceive(Context context, Intent intent) {
    super.onReceive(context, intent);
  }

  //每次更新都调用一次该方法，使用频繁 
  public void onUpdate(Context context, AppWidgetManager appWidgetManager,
             int[] appWidgetIds) {
    super.onUpdate(context, appWidgetManager, appWidgetIds);
  }

  //没删除一个就调用一次 
  public void onDeleted(Context context, int[] appWidgetIds) {
    super.onDeleted(context, appWidgetIds);
  }

  //当该Widget第一次添加到桌面是调用该方法，可添加多次但只第一次调用 
  public void onEnabled(Context context) {
    super.onEnabled(context);
  }

  //当最后一个该Widget删除是调用该方法，注意是最后一个 
  public void onDisabled(Context context) {
    super.onDisabled(context);
  }
}

3. 为 WidgetProvider创建一个布局文件

布局就是正常布局，假设名字为widget_layout.xml：

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
  android:layout_width="64dp"
  android:layout_height="64dp"
    
  <ImageButton
    android:id="@+id/widget_led"
    android:layout_margin="2dp"
    android:background="@drawable/widget_led"
    android:src="@drawable/ic_launcher"
    android:scaleType="center"
    android:layout_width="64.0dip"
    android:layout_height="64.0dip" / 

</RelativeLayout 

4. 注册Manifest.xml

配置基本和广播一样，使用receiver 节点，meta-data 节点的name 为固定格式，resource为第一步定义的配置信息，intent-filter节点第三个action必须提供：

<receiver android:name=".jf.jfclean.widget.FlashLightWidget" 
      <intent-filter 
        <action android:name="action_led_on" / 
        <action android:name="action_led_off" / 
        <action android:name="android.appwidget.action.APPWIDGET_UPDATE" / 
      </intent-filter 

      <meta-data
        android:name="android.appwidget.provider"
        android:resource="@xml/flash_light_widget_info" / 
    </receiver 

5. 使用PendingIntent和RemoteViews对AppWidget进行更新

 static void updateAppWidget(Context context, AppWidgetManager appWidgetManager,
    int appWidgetId) {
 
    CharSequence widgetText = context.getString(R.string.appwidget_text);　　
    // Construct the RemoteViews object
    RemoteViews views = new RemoteViews(context.getPackageName(),
        // 这个layout就是我们之前定义的initiallayout
        R.layout.my_app_widget_provider);
    // 更新里面某一个子view值
    views.setTextViewText(R.id.appwidget_text, widgetText);
    // Instruct the widget manager to update the widget
    appWidgetManager.updateAppWidget(appWidgetId, views);
 }
 
 @Override
 public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
    // There may be multiple widgets active, so update all of them
     for (int appWidgetId : appWidgetIds) {
          updateAppWidget(context, appWidgetManager, appWidgetId);
     }
 // 或者点击widget跳转逻辑
     mRemoteViews = new RemoteViews(context.getPackageName(), R.layout.mul_app_widget_provider);
     mRemoteViews.setImageViewResource(R.id.iv_test, R.mipmap.ic_launcher);
     mRemoteViews.setTextViewText(R.id.btn_test, "点击跳转到Activity");
     Intent skipIntent = new Intent(context, MainActivity.class);
     PendingIntent pi = PendingIntent.getActivity(context, 200, skipIntent, PendingIntent.FLAG_CANCEL_CURRENT);
     mRemoteViews.setOnClickPendingIntent(R.id.btn_test, pi);
 }

这里，简单介绍下RemoteViews：

RemoteViews

RemoteViews，从字面意思理解为它是一个远程视图。是一种远程的 View，它在其它进程中显示，却可以在另一个进程中更新。RemoteViews 在Android中的使用场景主要有：自定义通知栏和桌面小部件。

在RemoteViews 的构造函数中，第二个参数接收一个 layout 文件来确定 RemoteViews 的视图；然后，我们调用RemoteViews 中的 set 方法对 layout 中的各个组件进行设置，例如，可以调用 setTextViewText() 来设置 TextView 组件的文本。

widget小部件布局文件可以添加的组件是有限制的，它可以支持的 View 类型包括四种布局：FrameLayout、LinearLayout、RelativeLayout、GridLayout 和 13 种View: AnalogClock、Button、Chronometer、ImageButton、ImageView、ProgressBar、TextView、ViewFlipper、ListView、GridView、StackView、AdapterViewFlipper、ViewSub。注意：RemoteViews 也并不支持上述 View 的子类。

RemoteViews 提供了一系列 setXXX() 方法来为小部件的子视图设置属性。具体可以参考 API 文档。

RemoteViewsService

RemoteViewsService，是管理RemoteViews的服务。一般，当AppWidget 中包含 GridView、ListView、StackView 等集合视图时，才需要使用RemoteViewsService来进行更新、管理。RemoteViewsService 更新集合视图的一般步骤是：

1. 通过 setRemoteAdapter() 方法来设置 RemoteViews 对应 RemoteViewsService 。
2. 之后在 RemoteViewsService 中，实现 RemoteViewsFactory 接口。然后，在 RemoteViewsFactory 接口中对集合视图的各个子项进行设置，例如 ListView 中的每一Item。

RemoteViewsFactory

通过RemoteViewsService中的介绍，我们知道RemoteViewsService是通过 RemoteViewsFactory来具体管理layout中集合视图的，RemoteViewsFactory是RemoteViewsService中的一个内部接口。RemoteViewsFactory提供了一系列的方法管理集合视图中的每一项。例如：

• RemoteViews getViewAt(int position)

通过getViewAt()来获取“集合视图”中的第position项的视图，视图是以RemoteViews的对象返回的。

• int getCount()

通过getCount()来获取“集合视图”中所有子项的总数。

---

简单回顾发现，AppWidget常见就是放在Launcher上的一块控件，实际上是有其他进程（比如音乐）提供数据的，xml定义的循环时间通过AppManager更新。点击widget点击事件也是在AppWidgetProvider里提供。