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。