android自动化测试CTS源码分析之一

1, 概述

CTS(Compatibility Test Suite)全名兼容性测试,主要目的就是让Android设备开发商能够开发出兼容性更好的android设备。

本文的CTS源码基于android 5.1,和其他自动化测试指令一样,CTS测试命令也是通过脚本运行的。

CTS源码中的脚本路径: CTS/tools/tradefed-host/etc/ cts-tradefed

Linux环境中也是运行cts-tradefed脚本进行测试。

cts-tradefed脚本最后一行如下,

java $RDBG_FLAG \
-cp ${JAR_PATH} -DCTS_ROOT=${CTS_ROOT} com.android.cts.tradefed.command.CtsConsole "$@"

由此可见,android系统中测试的入口为CtsConsole.java类的main方法。

2,main方法

main方法的流程图如下,



CtsConsole的main方法如下,

public static void main(String[] args) throws InterruptedException, ConfigurationException {
Console console = new CtsConsole(); // 构造CtsConsole对象
Console.startConsole(console, args); // 调用父类的startConsole方法
}

CtsConsole继承于Console,而Console继承于Thread类。

startConsole方法如下,

public static void startConsole(Console console, String[] args)
throws InterruptedException, ConfigurationException
{
// 将命令参数复制到ArrayList中
List<String> nonGlobalArgs = GlobalConfiguration.createGlobalConfiguration(args);

console.setArgs(nonGlobalArgs); // 将命令参数保存在变量mMainArgs中
console.setCommandScheduler(GlobalConfiguration.getInstance().getCommandScheduler());
console.setDaemon(true);
console.start(); // 启动线程 调用run方法

console.awaitScheduler();
}
}

CtsConsole的run方法如下

@Override
public void run() {
printLine(String.format("Android CTS %s", CtsBuildProvider.CTS_BUILD_VERSION));
super.run();
}

首先看看打印信息的printLine方法,在父类Console中实现。

protected void printLine(String output)
{
System.out.print(output);
System.out.println();
}

Console的run方法会做一些检查,最后会调用executeCmdRunnable方法。然后回调内部类ArgRunnable的run方法。

2.1 任务添加

Console的run方法会还会调用CommandScheduler的start方法启动线程。

this.mScheduler.start();
this.mScheduler.await();

ArgRunnable的run方法会调用CommandScheduler的addCommand方法添加任务。

addCommand调用流程图如下



internalAddCommand方法首先调用ConfigurationFactory的createConfigurationFromArgs方法解析配置文件，

然后根据配置文件的信息调用addExecCommandToQueue将执行计划放入到队列中。

private boolean internalAddCommand(String[] args, long totalExecTime, String cmdFilePath)
throws ConfigurationException
{
assertStarted();
IConfiguration config = getConfigFactory().createConfigurationFromArgs(args);
•••
config.validateOptions();
if (config.getCommandOptions().runOnAllDevices())
{
addCommandForAllDevices(totalExecTime, args, cmdFilePath);
}
else
{
CommandTracker cmdTracker = createCommandTracker(args, cmdFilePath);
cmdTracker.incrementExecTime(totalExecTime);
ExecutableCommand cmdInstance = createExecutableCommand(cmdTracker, config, false);
addExecCommandToQueue(cmdInstance, 0L);
}
return true;
}
return false;
}

addExecCommandToQueue方法如下,

private synchronized boolean addExecCommandToQueue(final ExecutableCommand cmd, long delayTime)
{
if (isShutdown()) {
return false;
}
if (delayTime > 0L)
{
this.mSleepingCommands.add(cmd);

Runnable delayCommand = new Runnable()
{
public void run()
{
synchronized (CommandScheduler.this)
{
if (CommandScheduler.this.mSleepingCommands.remove(cmd))
{
CommandScheduler.this.mReadyCommands.add(cmd);
CommandScheduler.this.mCommandProcessWait.signalEventReceived();
}
}
}
};
this.mCommandTimer.schedule(delayCommand, delayTime, TimeUnit.MILLISECONDS);
}
else
{
this.mReadyCommands.add(cmd);
this.mCommandProcessWait.signalEventReceived();
}
return true;
}

另外开一个线程利用回调添加任务,添加到mReadyCommands中

private List<ExecutableCommand> mReadyCommands;

2.2 组件配置

internalCreateConfigurationFromArgs方法如下,

private IConfiguration internalCreateConfigurationFromArgs(String[] arrayArgs, List<String> optionArgsRef)
throws ConfigurationException
{
if (arrayArgs.length == 0) {
throw new ConfigurationException("Configuration to run was not specified");
}
optionArgsRef.addAll(Arrays.asList(arrayArgs));

String configName = (String)optionArgsRef.remove(0);
ConfigurationDef configDef = getConfigurationDef(configName, false);
return configDef.createConfiguration();
}

该方法中取出第一个参数cts然后传入getConfigurationDef方法中，获取ConfigurationDef对象。

ConfigurationDef根据测试指令配置相关属性,然后保存在变量中

private final Map<String, List<String>> mObjectClassMap;
private final List<OptionDef> mOptionList;
private final Map<String, Integer> mClassFrequency;
private final String mName;

属性值的定义在Configuration中。

这样属性也配置好了,如果使用脚本执行CTS测试,每个CTS测试任务都会放入队列中,然后取出依次执行,直到所有执行完为止。