Kitkat小屏幕模式单手操作研究之wm命令的实现方式分析

第二节：wm命令的实现方式分析

 

wm命令是在Wm.java文件中实现的。我们来分析一下执行的过程：

 

通过上述的可以看出是在adb shell中调用wm命令，可以知道wm是一个可执行文件，那么对于java类来说入口方法时main()方法。所以来看Wm类的main()方法如下：

public static void main(String[] args) {

        (new Wm()).run(args);

    }

 

使用Wm类的默认构造方法创建了一个Wm的实例，然后调用run()方法继续执行，将命令行传入的参数args一并传入。

由于run()方法是从Wm的父类BaseCommand继承来的，代码如下。

下面来看run()方法的内容：

public void run(String[] args) {

      ……

            onRun();

       …….

}

 

经过一些对参数的验证，最后调用Wm实现的onRun()方法，代码如下：

public void onRun() throws Exception {

        mWm = IWindowManager.Stub.asInterface(ServiceManager.checkService(

                        Context.WINDOW_SERVICE));

        …….

        String op = nextArgRequired();

        if (op.equals("size")) {

            runDisplaySize();

        } else if (op.equals("density")) {

            runDisplayDensity();

        } else if (op.equals("overscan")) {

            runDisplayOverscan();

        } else {

            …….

        }

    }

从前面章节对wm命令的介绍，都是对屏幕的进行操作的，必然涉及到WmS的操作，所以这里要获得WmS的代理对象，赋值给mWm变量，后续的我们要调用WmS的方法，都是通过mWm来调用的。

接下来通过nextArgRequired()获得命令字符串，然后根据命令字符串，执行不同的命令。

注意：这里使用了多个if语句，其实在JDK7开始，switch的条件语句已经可以使用字符串了。

 

根据命令的不同分别调用runDisplaySize()、runDisplayDensity()、runDisplayOverscan()方法，见名知义，所以这里不赘述。我们以runDisplayOverscan()方法为例，进行分析，其他的类似，最后都是通过mWm调用WmS的某个方法，对DisplayContent进行设置。

 

下面我们上该方法的代码：

private void runDisplayOverscan() throws Exception {

        String overscanStr = nextArgRequired();

        Rect rect = new Rect();

        int density;

        if ("reset".equals(overscanStr)) {

            rect.set(0, 0, 0, 0);

        } else {

            final Pattern FLATTENED_PATTERN = Pattern.compile(

                    "(-?\\d+),(-?\\d+),(-?\\d+),(-?\\d+)");

            Matcher matcher = FLATTENED_PATTERN.matcher(overscanStr);

            if (!matcher.matches()) {

                System.err.println("Error: bad rectangle arg: " + overscanStr);

                return;

            }

            rect.left = Integer.parseInt(matcher.group(1));

            rect.top = Integer.parseInt(matcher.group(2));

            rect.right = Integer.parseInt(matcher.group(3));

            rect.bottom = Integer.parseInt(matcher.group(4));

        }

 

        try {

            mWm.setOverscan(Display.DEFAULT_DISPLAY, rect.left, rect.top, rect.right, rect.bottom);

        } catch (RemoteException e) {

        }

    }

 

1. 获得命令的第一个参数，如果是resize，就意味着要恢复到原始的overscan的值，看到给rect矩形变量设置了四个0，这意味着设备原始是没有overscan值的。

 

2. 如果第一个参数不是resize，就意味着要对overscan进行设置，但是从wm overscan的参数模式可以看出是四个使用逗号（，）的整数值，可以是负整数值。这里使用正则表达式，将该参数转换成一个数组放到到matcher中，接着依次取出，分别赋值给rect的left，top，right，bottom的值。

 

3.当执行以上两步后，我们已经给rect矩形变量设置完值了，接下来就是告诉WmS，可以根据这些值，更新屏幕的overscan的值了。这里调用WmS的setOverscan()方法，把rect的四个坐标值传入。

注意：这里仅仅使用rect来存储left,top,right,bottom的值，并不代表overcan是一个矩形区域，其实overscan代表的是不绘制屏幕内容的区域。如下图中的浅橙色所示：

 

图2-1 屏幕的绘制参数示意图

4.接下来我们来看WmS中的setOverscan()的实现：

@Override

    public void setOverscan(int displayId, int left, int top, int right, int bottom) {

        if (mContext.checkCallingOrSelfPermission(

                android.Manifest.permission.WRITE_SECURE_SETTINGS) !=

                PackageManager.PERMISSION_GRANTED) {

            throw new SecurityException("Must hold permission " +

                    android.Manifest.permission.WRITE_SECURE_SETTINGS);

        }

        final long ident = Binder.clearCallingIdentity();

        try {

            synchronized(mWindowMap) {

                DisplayContent displayContent = getDisplayContentLocked(displayId);

                if (displayContent != null) {

                    setOverscanLocked(displayContent, left, top, right, bottom);

                }

            }

        } finally {

            Binder.restoreCallingIdentity(ident);

        }

    }

1 首先来检查执行方法的类是否有足够的权限，这里必须有android.Manifest.permission.WRITE_SECURE_SETTINGS的权限才能调用该方法。

2 接着就是获得DisplayContent对象，这里我们传入的displayId就是Display.DEFAULT_DISPLAY，值为0，其实对于手机来说只有一块屏幕，所以就是DEFAULT_DISPLAY。当displayContent不为null的时候，调用WmS的setOverscanLocked()私有方法继续进行设置。

3 我们来看看setOverscanLocked()方法

private void setOverscanLocked(DisplayContent displayContent,

            int left, int top, int right, int bottom) {

        final DisplayInfo displayInfo = displayContent.getDisplayInfo();

        synchronized (displayContent.mDisplaySizeLock) {

            displayInfo.overscanLeft = left;

            displayInfo.overscanTop = top;

            displayInfo.overscanRight = right;

            displayInfo.overscanBottom = bottom;

        }

 

        mDisplaySettings.setOverscanLocked(displayInfo.name, left, top, right, bottom);

        mDisplaySettings.writeSettingsLocked();

 

        reconfigureDisplayLocked(displayContent);

    }

该方法中做了三件事情：

l  调用displayContent的getDisplayInfo()方法获得DisplayInfo对象，然后根据传入的overscan的值，设置DisplayInfo中的响应的值。

l  调用mDisplaySettings的setOverscanLocked()方法，将overscan的值保存成一条名字为diaplayInfo.name的记录，通过这个名字，我们就可以从mDisplaySettings中读出该DisplayContent的overscan的内容。接着调用那个mDisplaySettings的writeSettingsLocked()方法，将刚才设置的内容写入到display_settings.xml设置文件中。

l  调用reconfigureDisplayLocked(displayContent)方法，进一步更新DisplayContent的内容，然后调用

performLayoutAndPlaceSurfacesLocked()方法对屏幕进行绘制。这个过程不再进行介绍。