android分布式测试工具。

简介

android众多的版本和机型给android app测试工作带来不小的挑战。Spoon通过将case分布式地执行、将执行结果更友好地展示出来，从而简化android app的测试工作。

Spoon没有开发新的测试框架，而是让已经存在的测试框架更有效。现在的测试框架，一般都是通过测试apk来驱动被测apk，Spoon可以让这些case在多台设备上同时运行。一旦测试结束，Spoon就是生成一份html报表，来展示每台设备上的执行结果。

Spoon会检测到adb devices命令中显示的全部设备，并在这些设备上执行case。所以我们在使用spoon时，可以插入不同的手机、平板、或者不同配置的模拟器。

插入的设备越多、越杂，那么最终的测试结果展示的信息就越多。

截图

除了单纯地跑case，Spoon还可以在case执行中，进行截图，并在结果中进行展示。在最后的结果中，我们可以看到不同设备跑一个case时的截图，来测试app的兼容性。

使用Spoon的截图功能，必须在被测app中引入spoon-clientjar包，在我们的测试代码中调用screenshot方法进行截图，这些截图会被打上标签。

    Spoon.screenshot(activity, "initial_state");
    //这里编写登陆代码
    Spoon.screenshot(activity, "after_login");

代码里指定的tag用来命名截图，以便在测试兼容性的时候进行不同设备间的横向比较。
我们也可以连贯地浏览每台设备上的截图，来查看运行过程。

下载

下载最新的runner jar包或者最新的client jar包，或者通过maven来获取：

<dependency>
    <groupId>com.squareup.spoon</groupId>
    <artifactId>spoon-client</artifactId>
    <version>(insert latest version)</version>
</dependency>

执行

Spoon既可以单独运行，又可以集成到maven里，作为maven命令的一部分来执行。

单独运行，需要被测apk包和测试apk包，执行下面的命令即可：

    java -jar spoon-runner-1.0.0-jar-with-dependencies.jar \
        --apk example-app.apk \
        --test-apk example-tests.apk

执行结果，默认会放在当前目录的spoon-output文件夹下。当然还有一些其他的参数，具体如下：

    Options:
        --apk               被测apk
        --fail-on-failure   Non-zero exit code on failure
        --output            结果路径
        --sdk               android sdk路径
        --test-apk          测试apk
        --title             Execution title
        --class-name        Test class name to run (fully-qualified)
        --method-name       Test method name to run (must also use --class-name)
        --no-animations     Disable animated gif generation
        --size              Only run test methods annotated by testSize (small, medium, large)
        --adb-timeout       Set maximum execution time per test in seconds (10min default)

如果使用maven来执行，有个maven插件可以用。在pom.xml中加入下面代码：

    <plugin>
        <groupId>com.squareup.spoon</groupId>
        <artifactId>spoon-maven-plugin</artifactId>
        <version>(insert latest version)</version>
    </plugin>

这个插件会自动寻找被测试的apk包。这个apk包通常还会以jar包的形式在dependency中进行声明。

    <dependency>
        <groupId>com.example</groupId>
        <artifactId>example-app</artifactId>
        <version>${project.version}</version>
        <type>jar</type>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>com.example</groupId>
        <artifactId>example-app</artifactId>
        <version>${project.version}</version>
        <type>apk</type>
        <scope>provided</scope>
    </dependency>

配置了上面的插件，我们可以通过mvn spoon:run来执行。执行结果放在target/spoon-output/文件夹。如果想手动指定test class，可以在命令中添加参数-Dspoon.test.class=fully.qualified.ClassName。如果想手动指定test method，可以在命令中再添加参数-Dspoon.test.method=testAllTheThings。

Tags: Androidjava代码技术移动终端自动化测试软件软件测试