com.auxiliary.appium.tool

Class AppiumCommandUtil

java.lang.Object

com.auxiliary.appium.tool.AppiumCommandUtil

public class AppiumCommandUtil
extends Object

文件名：AppiumCommandUtil.java

用途： 定义在执行app自动化前，需要在dos下执行的常用命令。若“adb”和“aapt”命令未被添加至系统变量中， 则可分别通过setAdbFolder(File)、setAaptFolder(File)方法来设置命令所在路径

编码时间：2021年4月8日下午7:04:55

修改时间：2021年4月25日上午10:17:19

Since:

JDK 1.8

Version:

Ver1.1

Author:

彭宇琦

Method Summary

Modifier and Type	Method and Description
static boolean	connectDevice(int port, String deviceName) 用于通过指定端口的adb服务，连接指定的设备名称
static boolean	connectDevice(String deviceName) 用于通过默认端口（5037端口）的adb服务，连接指定的设备名称
static boolean	disconnectDevice(int port, String deviceName) 用于通过指定端口的adb服务，断开指定设备名称的连接
static boolean	disconnectDevice(String deviceName) 用于通过默认端口（5037端口）的adb服务，断开指定设备名称的连接
static String	getAppActivity(File appFile, String... keys) 用于获取app的启动类名
static String	getAppPackageName(File appFile) 用于获取app的包名，若包名获取失败，则返回空串
static boolean	installApp(boolean isGrant, File appFile) 用于通过默认端口（5037端口）的adb服务，安装指定路径下的app文件
static boolean	installApp(int port, boolean isGrant, File appFile) 用于通过指定端口的adb服务，安装指定路径下的app文件
static void	killAdbServer() 用于停止默认端口（5037端口）的adb服务
static void	killAdbServer(int port) 用于停止指定端口的adb服务
static void	setAaptFolder(File aaptFolder) 用于设置aapt命令所在路径的File对象
static void	setAdbFolder(File adbFolder) 用于设置adb命令所在路径的File对象
static void	startAdbServer() 用于启动默认端口（5037端口）的adb服务
static void	startAdbServer(int port) 用于启动指定端口的adb服务
static boolean	uninstallApp(File appFile) 用于通过指定端口的adb服务，卸载设备上指定的app
static boolean	uninstallApp(int port, File appFile) 用于通过指定端口的adb服务，卸载设备上指定的app
static boolean	uninstallApp(int port, String appPackageName) 用于通过指定端口的adb服务，卸载设备上指定的app
static boolean	uninstallApp(String appPackageName) 用于通过指定端口的adb服务，卸载设备上指定的app

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

setAaptFolder

public static void setAaptFolder(File aaptFolder)

用于设置aapt命令所在路径的File对象

注意：命令所在路径文件对象必须将可执行文件也包含至路径中，否则读取命令将存在异常。 例如，命令所在路径为“D:\test\aapt.exe”，则传入的File对象必须为：new File("D:\\test\\aapt.exe")

Parameters:

aaptFolder - aapt命令所在路径

setAdbFolder

public static void setAdbFolder(File adbFolder)

用于设置adb命令所在路径的File对象

注意：命令所在路径文件对象必须将可执行文件也包含至路径中，否则读取命令将存在异常。 例如，命令所在路径为“D:\test\adb.exe”，则传入的File对象必须为：new File("D:\\test\\adb.exe")

Parameters:

adbFolder - adb命令所在路径

getAppPackageName

public static String getAppPackageName(File appFile)

用于获取app的包名，若包名获取失败，则返回空串

Parameters:

appFile - app包所在路径

Returns:

包名

getAppActivity

public static String getAppActivity(File appFile,
                                    String... keys)

用于获取app的启动类名

注意：由于一个app可有多个启动类，故可根据关键词进一步对启动类名进行搜索。若搜索后仍存在多个启动类名，则将返回第一个启动类名

Parameters:

appFile - app包所在路径

keys - 关键词组

Returns:

启动类名

startAdbServer

public static void startAdbServer(int port)

用于启动指定端口的adb服务

Parameters:

port - 端口号

Throws:

IllegalDataException - 端口号不合法时抛出的异常

startAdbServer

public static void startAdbServer()

用于启动默认端口（5037端口）的adb服务

killAdbServer

public static void killAdbServer(int port)

用于停止指定端口的adb服务

Parameters:

port - 端口号

Throws:

IllegalDataException - 端口号不合法时抛出的异常

killAdbServer

public static void killAdbServer()

用于停止默认端口（5037端口）的adb服务

connectDevice

public static boolean connectDevice(int port,
                                    String deviceName)

用于通过指定端口的adb服务，连接指定的设备名称

Parameters:

port - 端口号

deviceName - 设备名称

Throws:

IllegalDataException - 未指定设备名称或端口号不合法时抛出的异常

connectDevice

public static boolean connectDevice(String deviceName)

用于通过默认端口（5037端口）的adb服务，连接指定的设备名称

Parameters:

deviceName - 设备名称

Throws:

IllegalDataException - 未指定设备名称时抛出的异常

disconnectDevice

public static boolean disconnectDevice(int port,
                                       String deviceName)

用于通过指定端口的adb服务，断开指定设备名称的连接

Parameters:

port - 端口号

deviceName - 设备名称

Throws:

IllegalDataException - 未指定设备名称或端口号不合法时抛出的异常

disconnectDevice

public static boolean disconnectDevice(String deviceName)

用于通过默认端口（5037端口）的adb服务，断开指定设备名称的连接

Parameters:

deviceName - 设备名称

Throws:

IllegalDataException - 未指定设备名称时抛出的异常

installApp

public static boolean installApp(int port,
                                 boolean isGrant,
                                 File appFile)

用于通过指定端口的adb服务，安装指定路径下的app文件

注意：需要保证指定的端口上存在设备，否则命令会一直处于等待状态，直到连上设备为止

Parameters:

port - 端口号

isGrant - 安装后是否授权所有的权限

appFile - app所在路径

Returns:

是否安装成功

installApp

public static boolean installApp(boolean isGrant,
                                 File appFile)

用于通过默认端口（5037端口）的adb服务，安装指定路径下的app文件

Parameters:

isGrant - 安装后是否授权所有的权限

appFile - app所在路径

Returns:

是否安装成功

uninstallApp

public static boolean uninstallApp(int port,
                                   String appPackageName)

用于通过指定端口的adb服务，卸载设备上指定的app

Parameters:

port - 端口

appPackageName - app包名

Returns:

是否卸载成功

uninstallApp

public static boolean uninstallApp(int port,
                                   File appFile)

用于通过指定端口的adb服务，卸载设备上指定的app

Parameters:

port - 端口

appFile - app所在路径

Returns:

是否卸载成功

uninstallApp

public static boolean uninstallApp(String appPackageName)

用于通过指定端口的adb服务，卸载设备上指定的app

Parameters:

appPackageName - app包名

Returns:

是否卸载成功

uninstallApp

public static boolean uninstallApp(File appFile)

用于通过指定端口的adb服务，卸载设备上指定的app

Parameters:

appFile - app所在路径

Returns:

是否卸载成功