首页 > 代码库 > Android Remote Views

Android Remote Views

听名字就可以看出,remote views是一种远程view,感觉有点像远程service,其实remote views是view的一个结构,他可以在其他的进程中显示,由于它可以在其他的进程中显示,那么他就可以跨进程的更新其他进程的view,这听起来有点不可思议,感觉有点像aidl,但是我要告诉你这确实不是,那它的原理是什么呢?且听后面慢慢道来。

remote views在Android中有两个常见的应用场景:通知栏和桌面小部件。

Remote Views的应用

桌面部件与通知栏分别由AppWidgetManager 与 NotificationManager来管理.。分别与systemService进程中的AppWidgetServer的NotificationManagerServer进行通讯 ,所以,才需要RemoteView来更新界面.RemoteView实现了Paracelable,通过Bindler传递到 systemService进程中。

RemoteViews的内部结构

我们首先来看看RomoteViews的类图:

技术分享

RemoteViews:中保存Remote端的mPackage和mLayoutId;并用mActions:ArrayList<RemoteViews.Action>保存各种Action。

mPackagemLayoutId是在构造RemoteViews时传进去的[上文图中的seq#1];

mActions是设置各种Remote端的响应Intent以及图形元素的时候,保存到相应的Action中,然后把Action加入到这里保存的;

mLayoutId里的各种控件通过setTextViewText()/ setImageViewResource() / setProgressBar(),等函数在remote端设置的。这些方法再调用setType()[Type可为Boolean / Byte / Short / Int/ Long / Char / String / Uri / Bitmap/ Bundle, etc]保存到ReflectionAction中。

SetOnClickPendingIntent是用来在local端用户点击viewId时,发出pendingIntent通知的。在SetOnClickPendingIntent的构造方法中保存viewId和pendingIntent。

ReflectionAction用来在local端显示时,通过Reflect机制执行获得Remote端资源的。在ReflectionAction的构造方法中保存viewId,methodName,type以及value。

ViewGroupActionSetDrawableParameters也是RemoteViews.Action的子类,在这个场景中并未用到,基本原理相似,读者可自行分析。


AppWidgetHostView(显示RemoteViews内容

RemoteViews提供了内容之后,AppWidgetHost会通过IAppWidgetHost.updateAppWidget()被通知到Remote端有更新,本地端把RemoteViews提供的内容显示在AppWidgetHostView上。

我们来看下类图:

技术分享

我们分析下流程:

1.      获取RemoteViews里Remote端(AppWidgetProvider)的packageName和layoutId,通过packageName创建远端的context——remoteContext。

2.      通过RemoteViews的apply()方法,真正开始执行侦听Click操作的动作;通过远端Layout获得本地使用的View。

2.1.  克隆一个本地的LayoutInflater;[Seq#8]

2.2.  用克隆出的LayoutInflater对remote端的layoutId执行Inflate,获得Layout所描述的View的Hierarchy,亦即后面用到的rootView;[Seq#9~ 10]

2.3.  对2.2中获得的view执行performApply。[Seq#11~ 19]

performApply()对所有mActions中的Action都执行apply()操作。这样,

2.3.1 对于setOnClickPendingIntent来说,[Seq#12~ 15]

  •  通过rootView(2.2获得的Remote端的Layout的总的View)的findViewById(viewId),找到要侦听的View;[Seq#13]
  •  对找到的要侦听的View设置Click的Listener。[Seq#14]

2.3.2对于ReflectionAction来说,[Seq#16~ 19]

  •  通过rootView(2.2获得的Remote端的Layout的总的View)的findViewById(viewId),找到要设置内容的对象View;[Seq#17]
  •  然后通过Reflect机制,执行View实现类里的方法(比如这里是setImageResource()),把相应的资源的Id设置给它. [Seq#18]

3.      把获得的View加入到本地的View系统中。[Seq#21]

看一段关键代码,通过Reflect机制设置内容的代码片段:

@Override  
public void apply(View root) {  
    final View view = root.findViewById(viewId);  
    Class param = getParameterType();  // 通过this.type得到class:int.class  
    Class klass = view.getClass();     // 这个类在Remote的Layout中定义,这里为ImageView  
    Method method = klass.getMethod(this.methodName, param); // methodName是实现View类里的方法名:setImageResource(int)  
  
    try {  
        // 执行ImageView.setImageResource(value),value为resId  
         method.invoke(view, this.value);  
    } catch (Exception ex) {  
        throw new ActionException(ex);  
    }  
 }  

应用实例:

本文开始说过Android RemoteView主要两个应用,其中一个就是桌面小控件。那么接下来说说AppWidget。

AppWidget

AppWidget也就是“窗口小部件”,当我们点击桌面的小部件的时候,其实是触发Remote端的AppWidgetProvider实现;具体显示是Local的AppWidgetHost通过AppWidgetHostView实现。AppWidgetHost、AppWidgetProvider与AppWidgetService和AppWidgetManager按照特有的机制组合在一起,才能完整的实现AppWidget机制。接下来我们具体分析下他的实现流程。

AppWidget系统框架

技术分享技术分享

AppWidget实现Remote端提供UI元素,Local端具体显示。AppWidgetHost在AppWidget系统中是Local端;AppWidgetProvider端是Remote端。AppWidgetHost和AppWidgetProvider直接或通过IAppWidgetService或间接的通过AppWidgetManager,与AppWidgetService实现交互。AppWidgetService是所有元素的总管,负责协调其他各个部分。

AppWidget简要分析

AppWidgetHost

技术分享

AppWidgetHost通过IAppWidgetService利用Binder机制实现与系统进程中的AppWidgetService通信;

AppWidgetHost有IAppWidgetHost(通过Callbacks)的实现,并在AppWidgetHost.startListening()中注册到AppWidgetService中,实现当Remote端的数据有更新时,通过IAppWidgetHost.updateAppWidget()通知AppWidgetHost更新本地的显示;或者当Remote端的Provider改变时通知AppWidgetHost。

AppWidgetHost创建本地AppWidgetHostView时,会以AppWidgetId和AppWidgetHostView加入mViews: HashMap<Interger,AppWidgetHostView>


AppWidgetProvider

技术分享

AppWidgetProvider是AppWidget的Remote端内容提供方,并能注册响应其所提供内容的某个View被点击时,响应的Intent。

AppWidgetProvider是一个抽象类,实现类需要实现抽象方法onUpdate() / onDeleted()/ onEnabled()和onDisabled()。这是AppWidgetProvider的一个模板模式实现,要求AppWidgetProvider的实现者:

  •  在AndroidManefest.xml中声明这个AppWidgetProvider是"android.appwidget.action.APPWIDGET_UPDATE"的Receiver,这样AppWidgetProvider作为一个BroardcastReceiver才能接收到AppWidgetService发出的消息。而AppWidgetService查询系统中已经安装了哪些AppWidgetProvider也是通过查询这个接收者的Intent来的实现。所以如果没有这个Receiver,安装的Provider里就没有这个Provider,亦即,未加入到AppWidget系统中。
  •  另外,这个Receiver的meta-data的name指定为“android.appwidget.provider”;resource中用xml定义appwidget-provider内的各种属性。这些属性按包被安装时,检索出来赋给AppWidgetProviderInfo。

 

通常,对于应用开发来说不太注重AppWidget其他的部分,只是写AppWidgetProvider,但一般也都称AppWidgetProvider为AppWidget开发。


AppWidgetService

技术分享

AppWidgetService通过IAppWidgetService提供方法给AppWidgetHost、AppWidgetProvider使用。

在mInstalledProviders:AppWidgetService.Provider中保存AppWidgetProvider的信息;在mHost:AppWidgetService.Host中保存AppWidgetHost的信息;并用mAppWidgetIds:AppWidgetService.AppWidgetId保存AppWidgetHost与AppWidgetProvider的绑定关系。


注意:

AppWidgetService运行于三个各自不同的进程空间:

  •  AppWidgetService运行于system_process进程;
  •  AppWidgetHost运行于自己的进程空间,典型的桌面上的AppWidgetHost运行于Launcher中;
  •  AppWidgetProvider也是运行于自己的进程空间,典型的如“电量控制”这个AppWidgetProvider运行于Settings中。

AppWidgetHost和AppWidgetProvider要用到AppWidgetService的服务时,用Binder机制通过IAppWidgetService实现。AppWidgetService通过IAppWidgetHost通知AppWidgetHost;AppWidgetService通过发Broadcast通知AppWidgetProvider。

 

讲完概念,我们来两个实用的例子:

通知栏:

 Notification notification=new Notification();
        notification.icon=R.drawable.ic_launcher;
        notification.tickerText="hello world";
        notification.when=System.currentTimeMillis();
        notification.flags=Notification.FLAG_AUTO_CANCEL;
        Intent intent=new Intent(this,NotificationActivity.class);
        //定义延迟的意图
        PendingIntent pendingIntent=PendingIntent.getActivity(this,
                 0, intent, PendingIntent.FLAG_CANCEL_CURRENT);
        notification.setLatestEventInfo(this, "我的标题","我的文本", pendingIntent);

        RemoteViews remoteViews=new RemoteViews(getPackageName(),
                R.layout.remoteview);
        remoteViews.setTextViewText(R.id.title, "我的标题");
        remoteViews.setTextViewText(R.id.content, "我的内容");
        notification.contentView=remoteViews;
        notification.contentIntent=pendingIntent;

        NotificationManager manager=(NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
        manager.notify(1, notification);

桌面小控件:

要完成桌面小控件需要如下几个步骤:

1 自定义布局 
2 定义配置文件 
3 自定义类继承AppWidgetProvider 
4 功能清单注册

<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider 
    xmlns:android="http://schemas.android.com/apk/res/android" 
    android:minWidth="84dip"
    android:minHeight="84dip"
    android:initialLayout="@layout/widget"
    android:updatePeriodMillis="300000"
    >
</appwidget-provider>
功能清单的配置:
 <receiver android:name="com.example.remoteviewfinal.MyAppWidgetProvider">
            <intent-filter>
                <action android:name="android.appwidget.action.APPWIDGET_UPDATE"/>
            </intent-filter>
            <meta-data
                android:name="android.appwidget.provider"
                android:resource="@xml/provider_info"
                ></meta-data>
        </receiver>

自定义类:

public class MyAppWidgetProvider extends AppWidgetProvider {

    @Override
    public void onReceive(final Context context, Intent intent) {
        // TODO 自动生成的方法存根
        super.onReceive(context, intent);

        /**
         * 将图片旋转一圈
         */
        new Thread(new Runnable() {

            @Override
            public void run() {
                Bitmap bitmap=BitmapFactory.decodeResource(context.getResources(),
                        R.drawable.ic_launcher);
                AppWidgetManager manager=AppWidgetManager.getInstance(context);
                for(int i=0;i<37;i++){
                    float degree=(i*10)%360;
                    RemoteViews remoteViews=new RemoteViews(context.getPackageName(),
                            R.layout.widget);
                    remoteViews.setImageViewBitmap(R.id.imageview, rotateBitmap(context,bitmap,degree));
                    ComponentName cn=new ComponentName(context, MyAppWidgetProvider.class);
                    //更新界面
                    manager.updateAppWidget(cn, remoteViews);
                }
            }
        }).start();
    }

    @Override
    public void onUpdate(Context context, AppWidgetManager appWidgetManager,
            int[] appWidgetIds) {
        // TODO 自动生成的方法存根
        super.onUpdate(context, appWidgetManager, appWidgetIds);
    }

    /**
     * 当第一个实例被添加的时候调用
     */
    @Override
    public void onEnabled(Context context) {
        // TODO 自动生成的方法存根
        super.onEnabled(context);
    }

    /**
     * 当实例被删除的时候调用
     */
    @Override
    public void onDeleted(Context context, int[] appWidgetIds) {
        // TODO 自动生成的方法存根
        super.onDeleted(context, appWidgetIds);
    }

    /**
     * 当最后一个实例被删除的时候调用
     */
    @Override
    public void onDisabled(Context context) {
        // TODO 自动生成的方法存根
        super.onDisabled(context);
    }

    private Bitmap rotateBitmap(Context context,Bitmap bitmap,float degree){
        Matrix matrix=new Matrix();
        matrix.reset();
        matrix.setRotate(degree);
        Bitmap result=Bitmap.createBitmap(bitmap, 0, 0,bitmap.getWidth(),
                bitmap.getHeight(), matrix,true);
        return result;      
    }
}

更新不同进程的界面: 

定义界面A 来更新不同进程的界面B. 我们可以将界面A中的remoteView 传递到界面B,界面B 获取对象,调用控件的apply方法更新界面 修改A界面的process属性,使其在不同的进程中运行。

界面A:

public void send(){

        RemoteViews remoteViews=new RemoteViews(getPackageName(), R.layout.widget);
        remoteViews.setTextViewText(R.id.msg, "我的信息");
        PendingIntent pendingIntent=PendingIntent.getActivity(this,0,
                new Intent(this,NotificationActivity.class), 
                PendingIntent.FLAG_UPDATE_CURRENT);
        remoteViews.setOnClickPendingIntent(R.id.btn, pendingIntent);

        Intent intent=new Intent(Constant.ACTION);
        intent.putExtra(Constant.VIEW, remoteViews);
        sendBroadcast(intent);
    }
界面B:

 private BroadcastReceiver mRemoteBroadcastReceiver=new BroadcastReceiver() {

        @Override
        public void onReceive(Context context, Intent intent) {
            RemoteViews remoteViews=intent.getParcelableExtra(Constant.VIEW);
            if(remoteViews!=null){
                View view=remoteViews.apply(NotificationActivity.this, container);
                container.addView(view);
            }
        }
    };





Android Remote Views