Android-强大的酷特性 “ Widget “

什么是 “Widget” ?

微件（Web widget，简称Widget）是一种 Web2.0 的衍生物，它好像是一个小型的应用程式，它可以是一个时钟，一个日记簿，一段视频，天气预报，一个 Flash 游戏等等。

简单说Widget可以理解为“应用小插件”，一种可供用户制作和自由下载的小工具，它包含了娱乐、工作、学习等多种实用功能。目前的Widget应用大体可分为三种：Desktop Widget、WEB Widget以及Mobile Widget。

了解了什么是 Widget，那么就来做一个小 Demo吧

• 在 AndroidManifest.xml 中声明 App Widget
• 在 xml 目录定义 App Widget 的初始化 xml
• 实现 Widget 具体布局的 Layout xml
• 继承 AppWidgetProvider 类，实现具体的 Widget 业务逻辑

实现步骤：

• 10.1 创建 WidgetDemo并继承于 AppWidgetProvider

  /**
   * AppWidgetProvider 居然继承于 BroadcastReceiver(广播接收器)
   */
  public class WidgetDemo extends AppWidgetProvider {
  
      @Override
      public void onReceive(Context context, Intent intent) {
          // 接收广播
          super.onReceive(context, intent);
      }
  }
  

• 10.2 在 Androidmanifest.xml 中定义

  

  meta-data是用于存储数据的

• 10.3 在 layout文件夹下创建 setting_widget.xml 并定义其属性

  <?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/android"
      android:initialLayout="@layout/layout_widget"
      android:updatePeriodMillis="20000"
      android:widgetCategory="home_screen">
  
  </appwidget-provider>
  

  minWidth：最小宽度；minHeight：最小高度；previewImage：在widget中背景图片；

  updatePeriodMillis：更新时间；initialLayout：初始布局；widgetCategory：显示地方

• 10.4 创建 layout_widget.xml布局文件，并创建一个Button按钮TextView文本框组件

  

• 10.5 效果预览 在线预览

  [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-sqS4XM2l-1601388768791)(https://i.loli.net/2020/03/17/8CdsW4jP5OlxvUS.gif)]

10.6 当我们点击按钮时改变 TextView中的文本内容

• 在 WidgetDemo中重写 onUpdate() 方法发送一个广播，并在 onCreate() 方法中接收广播

  /**
   * AppWidgetProvider 居然继承于 BroadcastReceiver(广播接收器)
   * 为什么不直接继承于 BroadcastReceiver呢？
   * 因为 AppWidgetProvider做了一些改造，但本质上还是广播。当这个小部件发生改变（不管是安上去还是删掉）的时候都会发送广播
   */
  public class WidgetDemo extends AppWidgetProvider {
      private static final String WIDGET_BUTTON_ACTION = "widget_button_action";
      private RemoteViews mRemoteViews;
  
      @Override
      public void onReceive(Context context, Intent intent) {
          // 接收广播
          super.onReceive(context, intent);
          if (intent != null && TextUtils.equals(intent.getAction(), WIDGET_BUTTON_ACTION)) {
              // 意图不为 null，且当行为匹配时，就表示接收到了 button的点击
  //            Log.i(WIDGET_BUTTON_ACTION, "be clicked");
              // 注意：这时还需要将 RemoteViews创建一遍，否则不会更新
              mRemoteViews = new RemoteViews(context.getPackageName(), R.layout.layout_widget);
              // 设置 TextView中的文本内容
              mRemoteViews.setTextViewText(R.id.widget_text_view, "我被点击了");
              mRemoteViews.setTextColor(R.id.widget_text_view, Color.RED);
  
              AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
              // 获取组件的名字
              ComponentName componentName = new ComponentName(context, WidgetDemo.class);
              // 更新控件
              appWidgetManager.updateAppWidget(componentName, mRemoteViews);
          }
      }
  
      @Override
      public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
          super.onUpdate(context, appWidgetManager, appWidgetIds);
          // 创建一个 RemoteViews(远程视图)
          mRemoteViews = new RemoteViews(context.getPackageName(), R.layout.layout_widget);
  
          Intent intent = new Intent();
          intent.setClass(context, WidgetDemo.class); // 发给它本身
          intent.setAction(WIDGET_BUTTON_ACTION); // 设置行为
  
          // PendingIntent: 未来将要执行的意图。也就是说我有一个意图，但不是要立即执行
          PendingIntent pendingIntent = PendingIntent.getBroadcast(context,0,intent,0);
  
          // 设置一个点击事件，当点击 Button时，改变 TextView中的内容
          mRemoteViews.setOnClickPendingIntent(R.id.widget_button, pendingIntent);
  
          // 再更新控件
          appWidgetManager.updateAppWidget(appWidgetIds, mRemoteViews);
      }
  }
  

• 这时我们再来点击按钮。效果预览：