Android 关于RemoteViews的理解（一）移动开发老实任-

前言

RemoteViews从字面上理解是远程View，这个理解可能有点抽象，我们听过远程服务，但是远程View听说过的Android开发者应该很少,其实远程View和远程Service是一样的。谷歌设计这个View的主要目的是为了跨进程更新界面，基于这个前提我们在Android设备上这用得到RemoteViews的应用场景主要有两个地方：通知栏和桌面小部件，我打算用三篇文章去了解RemoteViews，第一篇介绍RemoteViews的使用场景。第二篇是分析RomoteViews的内部运行机制，第三篇则是分析RomoteViews的意义和跨进程更新界面的场景。

通知栏里的RemoteViews

系统通知栏我们应该很了解，这个是APP促活的一个关键手段，通过定时或活动时弹出Notification让用户点击促进App的用户粘性，同时也可以让用户查看某些功能的状态，但是另一个方面来说这个功能使用很多时候会打扰用户，让用户不堪其扰，当然这是题外话，技术永远是为了业务服务的。回到主题，RemoteViews在通知栏上的应用可以有两种状态，一个是使用系统默认效果，另一个是自定义布局。
使用系统默认布局的代码比较简单，我这里直接列出代码：

 val intent = Intent(this, NotificationOpenActivity::class.java) val pendingIntent =                 PendingIntent.getActivity(this, 0, intent, PendingIntent.FLAG_CANCEL_CURRENT) val channelId= "channelId" val channelName = "channelName" val channel = NotificationChannel(channelId, channelName, NotificationManager.IMPORTANCE_LOW) var notification = NotificationCompat.Builder(this, channelId) .setContentTitle("notification_title") .setContentText("notification_content") .setWhen(System.currentTimeMillis()) .setLargeIcon(BitmapFactory.decodeResource(getResources(), R.mipmap.ic_launcher)) .setSmallIcon(R.mipmap.ic_launcher) .setAutoCancel(true) .setDefaults(Notification.DEFAULT_LIGHTS) .setContentIntent(pendingIntent) .build() val manager = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager             manager.createNotificationChannel(channel)             manager.notify(1, notification) 

上述代码就可以弹出一个系统默认样式的通知，点击通知则清除通知，并跳转至NotificationOpenActivity,当发送通知栏的时候APP启动icon右上角也会有数量标注。

在实际项目开发中我们往往需要自定义通知栏布局，这个也比较简单，我们只需要自定义一个布局文件，然后利用RemoteViews来加载布局文件就可以更改通知栏的样式，自定义通知栏代码如下：

布局：

<?xml version="1.0" encoding="utf-8"?> <RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"     android:layout_width="match_parent"     android:layout_height="match_parent"> <ImageView         android:id="@+id/iv_notification"         android:layout_width="60dp"         android:layout_height="60dp"         android:layout_centerVertical="true"         android:layout_marginLeft="10dp" /> <TextView         android:id="@+id/tv_content"         android:layout_width="wrap_content"         android:layout_height="wrap_content"         android:layout_centerVertical="true"         android:layout_marginLeft="6dp"         android:layout_toRightOf="@id/iv_notification" /> </RelativeLayout> 

页面逻辑：

 val openActivityPendingIntent = PendingIntent.getActivity( this, 0, Intent(this, NotificationOpenActivity::class.java),                 PendingIntent.FLAG_UPDATE_CURRENT             ) val channelId = "channelId" val channelName = "channelName" val channel = NotificationChannel(channelId, channelName, NotificationManager.IMPORTANCE_LOW) val remoteViews = RemoteViews(packageName, R.layout.view_notification)             remoteViews.setTextViewText(R.id.tv_content, "自定义通知栏文字")             remoteViews.setImageViewResource(R.id.iv_notification, R.drawable.icon_notification)             remoteViews.setOnClickPendingIntent(R.id.btn_custom_notificateion, openActivityPendingIntent) val notification = NotificationCompat.Builder(this, channelId) .setWhen(System.currentTimeMillis()) .setAutoCancel(true) .setSmallIcon(R.mipmap.ic_launcher) .setDefaults(Notification.DEFAULT_LIGHTS) .setContentIntent(openActivityPendingIntent) .setCustomContentView(remoteViews) .build() val manager = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager             manager.createNotificationChannel(channel)             manager.notify(1, notification) 

效果如下：

以上就是RemoteViews在通知栏的使用，使用起来相对简单，只要提供当前应用的包名和布局文件的资源id就可以构建一个RemoteViews对象，通过布局内部子id

  remoteViews.setTextViewText(R.id.tv_content, "自定义通知栏文字")   remoteViews.setImageViewResource(R.id.iv_notification, R.drawable.icon_notification) 

就可以对文字和图片进行设置，然后RemoteViews点击事件方法则为：

remoteViews.setOnClickPendingIntent(R.id.btn_custom_notificateion, openActivityPendingIntent) 

这里更新RemoteViews或许大家会觉得复杂，为什么RemoteViews没有提供类似View的findViewById这个方法呢，提供这个方法不就能获取RemoteViews里 的子View了，操作岂不是更简单，RomoteViews的内部运行机制会在第二篇文章中进行了解，大家可以留个意。

桌面小部件上的RemoteViews

桌面小部件在Android开发里的实现类是AppWidgetProvider，它本质上来说是一个广播（BroadcastReceiver）,因为这个类继承的就是BroadcastReceiver。要了解RemoteViews在桌面小部件的应用我们需要先了解桌面小部件的使用，下面我们一步步做一个桌面小部件。

1：界面布局如下：

<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"     android:layout_width="match_parent"     android:layout_height="match_parent"     android:orientation="vertical"> <ImageView         android:id="@+id/iv_app_widget"         android:layout_width="wrap_content"         android:src="@drawable/icon_notification"         android:layout_height="wrap_content" /> </LinearLayout> 

这个layout布局没什么好说的，Android开发者都知道。

2：新建xml文件夹并新建一个桌面小部件配置信息文件,我这里这个配置信息文件命名为：app-widget_provider_info.xml

<?xml version="1.0" encoding="utf-8"?> <appwidget-provider xmlns:android="https://schemas.android.com/apk/res/android"     android:initialLayout="@layout/view_app_widget"     android:minWidth="80dp"     android:minHeight="80dp"     android:updatePeriodMillis="10000" > </appwidget-provider> 

这里的配置文件含义也比较明显，分别是初始化布局和小部件最小宽高，值得说的是

  android:updatePeriodMillis="10000" 

这个参数的含义是定义小部件自动更新的周期，单位是毫秒，每个周期之后都会触发小部件的自动更新。

3：定义小部件的广播接收者

代码如下：

package com.sjr.remoteviewsdemo  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.Bitmap import android.graphics.BitmapFactory import android.graphics.Matrix import android.os.SystemClock import android.util.Log import android.widget.RemoteViews import android.widget.Toast  /**  * Created by sjr on 2020/5/1  */ class MyAppWidgetProvider : AppWidgetProvider() { override fun onReceive(context: Context, intent: Intent) { super.onReceive(context, intent) if (intent.action == CLICK_ACTION) {             Toast.makeText(context, "clicked it", Toast.LENGTH_SHORT).show() Thread(Runnable { val srcbBitmap = BitmapFactory.decodeResource(                     context.resources, R.drawable.icon_notification                 ) val appWidgetManager = AppWidgetManager.getInstance(context) for (i in 0..36) { val degree = (i * 10 % 360).toFloat() val remoteViews = RemoteViews(                         context                             .packageName, R.layout.view_app_widget                     )                     remoteViews.setImageViewBitmap(                         R.id.iv_app_widget, rotateBitmap(srcbBitmap, degree) ) val intentClick = Intent()                     intentClick.action = CLICK_ACTION                     val pendingIntent = PendingIntent                         .getBroadcast(context, 0, intentClick, 0)                     remoteViews.setOnClickPendingIntent(R.id.iv_app_widget, pendingIntent)                     appWidgetManager.updateAppWidget( ComponentName(                             context, MyAppWidgetProvider::class.java                         ), remoteViews                     )                     SystemClock.sleep(30) } }).start() } } override fun onUpdate(         context: Context, appWidgetManager: AppWidgetManager,         appWidgetIds: IntArray     ) { super.onUpdate(context, appWidgetManager, appWidgetIds) val counter = appWidgetIds.size          for (i in 0 until counter) { val appWidgetId = appWidgetIds[i] onWidgetUpdate(context, appWidgetManager, appWidgetId) } } private fun onWidgetUpdate(         context: Context,         appWidgeManger: AppWidgetManager, appWidgetId: Int     ) { val remoteViews = RemoteViews(             context.packageName,             R.layout.view_app_widget         ) // 窗口小部件点击事件发送的Intent广播 val intentClick = Intent()         intentClick.action = CLICK_ACTION         val pendingIntent = PendingIntent.getBroadcast(             context, 0,             intentClick, 0 )         remoteViews.setOnClickPendingIntent(R.id.iv_app_widget, pendingIntent)         appWidgeManger.updateAppWidget(appWidgetId, remoteViews) } private fun rotateBitmap(srcbBitmap: Bitmap, degree: Float): Bitmap { val matrix = Matrix()         matrix.reset()         matrix.setRotate(degree) return Bitmap.createBitmap(             srcbBitmap, 0, 0,             srcbBitmap.width, srcbBitmap.height, matrix, true ) } companion object { val CLICK_ACTION = "com.sjr.remoteviewsdemo.action.CLICK" } } 

以上代码就实现了一个简单的桌面小部件，小部件显示一张图片，将下够不见添加至桌面之后，点击小部件小部件会旋转一周，可以看到小部件的布局更新是通过RemoteViews来实现的。

4：在AndroidManifest.xml中声明小部件

 <receiver android:name=".MyAppWidgetProvider" > <meta-data                 android:name="android.appwidget.provider"                 android:resource="@xml/app_widget_provider_info" > </meta-data> <intent-filter> <action android:name="com.sjr.remoteviewsdemo.action.CLICK" /> <action android:name="android.appwidget.action.APPWIDGET_UPDATE" /> </intent-filter> </receiver> 

四大组件都需要在AndroidManifest中声明，桌面小部件本质上也是一个BroadcastReceiver，所以也需要在此进行注册，上面的小部件一共有两个action，一个是用来识别小部件的点击，一个是系统规定作为小部件必须有的标识。

AppWidgetProvider的onREceive方法的分发源码如下：

/**      * Implements {@link BroadcastReceiver#onReceive} to dispatch calls to the various      * other methods on AppWidgetProvider.        *      * @param context The Context in which the receiver is running.      * @param intent The Intent being received.      */ // BEGIN_INCLUDE(onReceive) public void onReceive(Context context, Intent intent) { // Protect against rogue update broadcasts (not really a security issue, // just filter bad broacasts out so subclasses are less likely to crash).         String action = intent.getAction(); if (AppWidgetManager.ACTION_APPWIDGET_UPDATE.equals(action)) {             Bundle extras = intent.getExtras(); if (extras != null) { int[] appWidgetIds = extras.getIntArray(AppWidgetManager.EXTRA_APPWIDGET_IDS); if (appWidgetIds != null && appWidgetIds.length > 0) { this.onUpdate(context, AppWidgetManager.getInstance(context), appWidgetIds); } } } else if (AppWidgetManager.ACTION_APPWIDGET_DELETED.equals(action)) {             Bundle extras = intent.getExtras(); if (extras != null && extras.containsKey(AppWidgetManager.EXTRA_APPWIDGET_ID)) { final int appWidgetId = extras.getInt(AppWidgetManager.EXTRA_APPWIDGET_ID); this.onDeleted(context, new int[] { appWidgetId }); } } else if (AppWidgetManager.ACTION_APPWIDGET_OPTIONS_CHANGED.equals(action)) {             Bundle extras = intent.getExtras(); if (extras != null && extras.containsKey(AppWidgetManager.EXTRA_APPWIDGET_ID) && extras.containsKey(AppWidgetManager.EXTRA_APPWIDGET_OPTIONS)) { int appWidgetId = extras.getInt(AppWidgetManager.EXTRA_APPWIDGET_ID);                 Bundle widgetExtras = extras.getBundle(AppWidgetManager.EXTRA_APPWIDGET_OPTIONS); this.onAppWidgetOptionsChanged(context, AppWidgetManager.getInstance(context),                         appWidgetId, widgetExtras); } } else if (AppWidgetManager.ACTION_APPWIDGET_ENABLED.equals(action)) { this.onEnabled(context); } else if (AppWidgetManager.ACTION_APPWIDGET_DISABLED.equals(action)) { this.onDisabled(context); } else if (AppWidgetManager.ACTION_APPWIDGET_RESTORED.equals(action)) {             Bundle extras = intent.getExtras(); if (extras != null) { int[] oldIds = extras.getIntArray(AppWidgetManager.EXTRA_APPWIDGET_OLD_IDS); int[] newIds = extras.getIntArray(AppWidgetManager.EXTRA_APPWIDGET_IDS); if (oldIds != null && oldIds.length > 0) { this.onRestored(context, oldIds, newIds); this.onUpdate(context, AppWidgetManager.getInstance(context), newIds); } } } } 

由以上源码可以看到，根据不同的Action，OnReceive会调用onEnable、onDisable、onUpdate
下面逐个说明：

• onEnable：当小部件第一次添加到桌面的时候会调用这个方法，添加到桌面可以多次，但是这个方法只会被调用一次；
• onUpdate：小部件被点击或者周期间隔会调用这个方法；
• onDelete ：每删除一次桌面小部件就会调用一次；
• onDisabled：当最后一个该类型的小部件被删除时会调用这个方法；
• onREceive：分发具体的事件给各个方法；

到这里就是整个桌面小部件开发的流程了，从整个流程我们可以发现，桌面小部件的操作都是通过RemoteViews来完成的，不管是初始化还是更新。

小结

通过这两个RemoteViews的应用我们初步了解了RemoteViews这个远程View，由于篇幅有限，所以不会在一篇内了解完RemoteViews，下一篇文章会分析RemoteViews的机制。