首页 > 代码库 > Cts框架解析(5)

Cts框架解析(5)

2024-07-28 05:58:27   221人阅读

解析配置文件


Cts框架分为9大部分：


cmd_options：命令行接受的参数选项，command包中。

device_requirements：设备相关要求，device包中

device_options：设备参数，device包中

builde_provider：版本提供者，build包中

target_preparer：预置条件准备，targetprep包中

test：测试类型，存在testtype包中

device_recovery：任务执行过程中设备异常后的设备恢复，device包中

logger：日志系统，log包中

result_reporter：结果统计报告，result包中


每一种任务都要配置好这9个组件，如果不配置，框架就采用自己的默认配置，但也是相当于配置了这几项，所以cts框架的核心在Configuration中。


private static synchronized Map<String, ObjTypeInfo> getObjTypeMap() {
        if (sObjTypeMap == null) {
            sObjTypeMap = new HashMap<String, ObjTypeInfo>();
            sObjTypeMap.put(BUILD_PROVIDER_TYPE_NAME, new ObjTypeInfo(IBuildProvider.class, false));
            sObjTypeMap.put(TARGET_PREPARER_TYPE_NAME, new ObjTypeInfo(ITargetPreparer.class, true));
            sObjTypeMap.put(TEST_TYPE_NAME, new ObjTypeInfo(IRemoteTest.class, true));
            sObjTypeMap.put(DEVICE_RECOVERY_TYPE_NAME, new ObjTypeInfo(IDeviceRecovery.class, false));
            sObjTypeMap.put(LOGGER_TYPE_NAME, new ObjTypeInfo(ILeveledLogOutput.class, false));
            sObjTypeMap.put(RESULT_REPORTER_TYPE_NAME, new ObjTypeInfo(ITestInvocationListener.class,
                    true));
            sObjTypeMap.put(CMD_OPTIONS_TYPE_NAME, new ObjTypeInfo(ICommandOptions.class,
                    false));
            sObjTypeMap.put(DEVICE_REQUIREMENTS_TYPE_NAME, new ObjTypeInfo(IDeviceSelection.class,
                    false));
            sObjTypeMap.put(DEVICE_OPTIONS_TYPE_NAME, new ObjTypeInfo(TestDeviceOptions.class,
                    false));
        }
        return sObjTypeMap;
    }

    /**
     * Creates an {@link Configuration} with default config objects.
     */
    public Configuration(String name, String description) {
        mName = name;
        mDescription = description;
        mConfigMap = new LinkedHashMap<String, List<Object>>();
        setCommandOptions(new CommandOptions());
        setDeviceRequirements(new DeviceSelectionOptions());
        setDeviceOptions(new TestDeviceOptions());
        setBuildProvider(new StubBuildProvider());
        setTargetPreparer(new StubTargetPreparer());
        setTest(new StubTest());
        setDeviceRecovery(new WaitDeviceRecovery());
        setLogOutput(new StdoutLogger());
        setTestInvocationListener(new TextResultReporter());
    }

在getObjTypeMap()可以看出来cts框架为这9个组件定义的接口，只要你的类实现了这个接口，cts就可以通过反射机制找到你的类。Configuration类的构造方法中设置了这几个接口默认的实现类，如果你没有配置其他的替代类，cts会默认去加载这些实现类。这些类都是实现了上面方法中对应关系的接口，才能被设置成配置项的。




所有关于类的配置，cts只认你在Configuration类接口的实现类，你如果写了一个类没有继承9大类中的一个接口，你添加了，也会报错的。从上图可以看出，cts默认配置了上面几项，没有配置的采用默认的。这个讲完了，我们就从文章开头的代码开始将它是如何一步一步完成这些配置的。


Debug


以上一篇文章中的解析配置文件代码开始：


IConfiguration config = getConfigFactory().createConfigurationFromArgs(args);




调用的是ConfigurationFactory.createConfigurationFromArgs方法：


/**
     * {@inheritDoc}
     */
    @Override
    public IConfiguration createConfigurationFromArgs(String[] arrayArgs)
            throws ConfigurationException {
        List<String> listArgs = new ArrayList<String>(arrayArgs.length);
        IConfiguration config = internalCreateConfigurationFromArgs(arrayArgs, listArgs);
        config.setOptionsFromCommandLineArgs(listArgs);

        return config;
    }

该方法又调用了internalCreateConfigurationFromArgs方法，传入的是参数run cts --plan Signature字符串数组和一个空字符串。


 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));
        // first arg is config name
        final String configName = optionArgsRef.remove(0);
        ConfigurationDef configDef = getConfigurationDef(configName, false);
        return configDef.createConfiguration();
    }

该方法中取出第一个参数cts然后传入getConfigurationDef方法中，获取ConfigurationDef对象。首先看看ConfigurationDef对象是什么？很简单，一个ConfigurationDef代表一个配置文件。



public class ConfigurationDef {

    /** a map of object type names to config object class name(s). */
    private final Map<String, List<String>> mObjectClassMap;
    /** a list of option name/value pairs. */
    private final List<OptionDef> mOptionList;
    /** a cache of the frequency of every classname */
    private final Map<String, Integer> mClassFrequency;

    static class OptionDef {
        final String name;
        final String key;
        final String value;

        OptionDef(String optionName, String optionValue) {
            this(optionName, null, optionValue);
        }

        OptionDef(String optionName, String optionKey, String optionValue) {
            this.name = optionName;
            this.key = optionKey;
            this.value = http://www.mamicode.com/optionValue;>
主要关注下面2个属性：

mObjectClassMap：保存9大组件的，例如上面的build_provider、device_recovery、test、logger、result_reporter这些标签对应的类都保持该map对象中。
mOptionList：保存option标签的值，例如上面的enable-root的值。

现在进入debug模式验证一下是不是用上面两个属性保存的。将断点打在ConfigurationDef configDef = getConfigurationDef(configName, false);上，删除其他断点。重启debug。按F6跳到下一行，来看一下Variables一栏中值



可以看到mObjectClassMap的值为：

{build_provider=[com.android.cts.tradefed.build.CtsBuildProvider], device_recovery=[com.android.tradefed.device.WaitDeviceRecovery], test=[com.android.cts.tradefed.testtype.CtsTest], logger=[com.android.tradefed.log.FileLogger],result_reporter=[com.android.cts.tradefed.result.CtsXmlResultReporter, com.android.cts.tradefed.result.IssueReporter]}


和配置文件里的是一样的。

















Cts框架解析(5)


联系
我们