首页 > 代码库 > bootstrap之Orientation
bootstrap之Orientation
Orientation
调整屏幕方向的操作。
package io.appium.android.bootstrap.handler; import android.os.RemoteException; import com.android.uiautomator.core.UiDevice; import io.appium.android.bootstrap.*; import org.json.JSONException; import java.util.Hashtable; /** * This handler is used to get or set the orientation of the device. * */ public class Orientation extends CommandHandler { /* * @param command The {@link AndroidCommand} used for this handler. * * @return {@link AndroidCommandResult} * * @throws JSONException * * @see io.appium.android.bootstrap.CommandHandler#execute(io.appium.android. * bootstrap.AndroidCommand) */ @Override public AndroidCommandResult execute(final AndroidCommand command) throws JSONException { final Hashtable<String, Object> params = command.params(); if (params.containsKey("orientation")) { // Set the rotation final String orientation = (String) params.get("orientation"); try { return handleRotation(orientation); } catch (final Exception e) { return getErrorResult("Unable to rotate screen: " + e.getMessage()); } } else { // Get the rotation return getRotation(); } } /** * Returns the current rotation * * @return {@link AndroidCommandResult} */ private AndroidCommandResult getRotation() { String res = null; final UiDevice d = UiDevice.getInstance(); final OrientationEnum currentRotation = OrientationEnum.fromInteger(d .getDisplayRotation()); Logger.debug("Current rotation: " + currentRotation); switch (currentRotation) { case ROTATION_0: case ROTATION_180: res = "PORTRAIT"; break; case ROTATION_90: case ROTATION_270: res = "LANDSCAPE"; break; } if (res != null) { return getSuccessResult(res); } else { return getErrorResult("Get orientation did not complete successfully"); } } /** * Set the desired rotation * * @param orientation * The rotation desired (LANDSCAPE or PORTRAIT) * @return {@link AndroidCommandResult} * @throws RemoteException * @throws InterruptedException */ private AndroidCommandResult handleRotation(final String orientation) throws RemoteException, InterruptedException { final UiDevice d = UiDevice.getInstance(); OrientationEnum desired; OrientationEnum current = OrientationEnum.fromInteger(d .getDisplayRotation()); Logger.debug("Desired orientation: " + orientation); Logger.debug("Current rotation: " + current); if (orientation.equalsIgnoreCase("LANDSCAPE")) { switch (current) { case ROTATION_0: d.setOrientationRight(); desired = OrientationEnum.ROTATION_270; break; case ROTATION_180: d.setOrientationLeft(); desired = OrientationEnum.ROTATION_270; break; default: return getSuccessResult("Already in landscape mode."); } } else { switch (current) { case ROTATION_90: case ROTATION_270: d.setOrientationNatural(); desired = OrientationEnum.ROTATION_0; break; default: return getSuccessResult("Already in portrait mode."); } } current = OrientationEnum.fromInteger(d.getDisplayRotation()); // If the orientation has not changed, // busy wait until the TIMEOUT has expired final int TIMEOUT = 2000; final long then = System.currentTimeMillis(); long now = then; while (current != desired && now - then < TIMEOUT) { Thread.sleep(100); now = System.currentTimeMillis(); current = OrientationEnum.fromInteger(d.getDisplayRotation()); } if (current != desired) { return getErrorResult("Set the orientation, but app refused to rotate."); } return getSuccessResult("Rotation (" + orientation + ") successful."); } }
这个事件有点小复杂哈,当初研究uiautomator源代码时就被它折腾的不行。也仅仅实验了左和上的方向成功。
没办法,既然又遇到了,那就仅仅能纯理论讲啦。
execute方法中。首先推断參数中是否含有orientation,假设含有调用handleRotation。否则调用getRotation。
所以execute又分流到上面的2个方法中。
handleRotation
这样的情况是參数里含有orientation,此时。我们来看看该方法中做了哪些事。
final UiDevice d = UiDevice.getInstance(); OrientationEnum desired; OrientationEnum current = OrientationEnum.fromInteger(d .getDisplayRotation());
首先获取当前设备的方向,然后初始化一个私有变量,以备后用。当中OrientationEnum枚举类里定义了4个方向,fromInteger方法是依据整数值得到对应的枚举值,当中各个值的意思。
public enum OrientationEnum { ROTATION_0(0), ROTATION_90(1), ROTATION_180(2), ROTATION_270(3); public static OrientationEnum fromInteger(final int x) { switch (x) { case 0: return ROTATION_0; case 1: return ROTATION_90; case 2: return ROTATION_180; case 3: return ROTATION_270; } return null; }
ROTATION_0:你正常查看手机时,竖屏。此时屏幕的方向为0度。此时的power键在顶端。
例如以下:
ROTATION_90:你将上面的屏幕向右顺时针旋转90度,此时设备旋转角度为90度,此时我的power键在右端。假设此时你的设备能够自己主动旋转屏幕的话。你屏幕里面的内容应该是什么样的?例如以下所看到的
ROTATION_180:从90度角再向下顺时针旋转90度。此时我的power键在下端。此时的角度为180.因为我的手机禁止了这样的自由旋转,所以此时的屏幕展如今我的面前是这样一番景象:
ROTATION_270:从180度再顺时针想左旋转90度。此时我power键在左边。此时为270度。展如今我面前的图例如以下:
假设你理解了上面4个keyword的意思。那么以下理解代码就非常easy啦。
handleRotation方法里做完初始化操作以后。就要推断client要求是横屏还是竖屏。假设是横屏,处理例如以下:
if (orientation.equalsIgnoreCase("LANDSCAPE")) { switch (current) { case ROTATION_0: d.setOrientationRight(); desired = OrientationEnum.ROTATION_270; break; case ROTATION_180: d.setOrientationLeft(); desired = OrientationEnum.ROTATION_270; break; default: return getSuccessResult("Already in landscape mode."); } }
假设是横屏的话,那么仅仅须要处理屏幕处于0度和180度的情况,由于90度和270度都已经是横屏啦,自然不须要再处理。
假设是ROTATION_0,说明设备朝上,此时想要横屏,自然是顺时针向右旋转一下屏幕。此时,正常情况下能够旋转的话。屏幕里的视图应该是从左到右的,所以desired的值才会被设置为ROTATION_270.所以要分清屏幕的角度和视图的角度。
以下就是向右顺时针旋转90度后,里面的视图是270度的。此时power键在右端。
假设是ROTATION_180度,说明设备拿反了,power键朝下。此时你向左顺时针旋转90度或者向右逆时针旋转90度。都能达到横屏的效果。源代码里是向左旋转的,此时power键朝左,视图和上面是一样的,desired的值为ROTATION——270.
====================================================================================================================================
假设client传递过来的命令想要的是竖屏。就要走else里的代码块:
else { switch (current) { case ROTATION_90: case ROTATION_270: d.setOrientationNatural(); desired = OrientationEnum.ROTATION_0; break; default: return getSuccessResult("Already in portrait mode."); } }
此时仅仅要处理90度和270的情况。我们要把它变为ROTATION_0的情况,d.setOrientationNatural()是设置设备转到自然方向,该方向就是设备初始设置的方向。说明通常的设备横屏的2个方向能够旋转。竖屏方向就仅仅有一个方向能够旋转。上面的处理完成后,方法会做一个推断,推断是否旋转成功。
current = OrientationEnum.fromInteger(d.getDisplayRotation()); // If the orientation has not changed, // busy wait until the TIMEOUT has expired final int TIMEOUT = 2000; final long then = System.currentTimeMillis(); long now = then; while (current != desired && now - then < TIMEOUT) { Thread.sleep(100); now = System.currentTimeMillis(); current = OrientationEnum.fromInteger(d.getDisplayRotation()); } if (current != desired) { return getErrorResult("Set the orientation, but app refused to rotate."); } return getSuccessResult("Rotation (" + orientation + ") successful.");
首先获得此时屏幕的方向,然后推断一下与预期的是否同样。假设不同样,等待2秒钟,再获取一次屏幕的方向,假设经过这么一次验证完成后。当前的屏幕方向仍然和预期的不同样,那么就返回旋转失败的消息给client。假设同样的话,就返回旋转成功的消息给client。
到此为止handleRotation处理完成。以下处理參数里不含有orientation的情况。
getRotation
该方法中就是依据当前的屏幕的方向得到横屏还是竖屏,将结果返回给client。
非常easy。
总结
通过上面的分析。说明client关于屏幕方向的命令有2种:
- 获取屏幕的方向
- 改变屏幕的方向
大家要特别主要选择方向的定义,设备的方向和里面视图的方向的差别。
bootstrap之Orientation