Compare the Layout in Different Mobile Apps via SDK

Run mobile app layout comparisons programmatically with SDK-based visual testing.

If you want to check a layout on multiple different mobile apps, you can use a Appium-based comparison test.

Android-based Comparison Test

If you need to interact with the app (e.g. to reach a certain state), the Appium-based test is the right choice. You need to specify the platform(s) and apps on which you want to run the Appium test on. The function in the example executeTestInApp does all the interaction with the app and creates states at each point in time you want to later check for possible differences in layout.

1
2

BrowserSessionId appSessionId =  executeTestInApp("{{appPackage}}", "{{appActivity}}")
BrowserSessionId referenceAppSessionId = executeTestInApp("{refAppPackage}", "{refAppActivity}")

You can now run the comparison and wait for the result

1
2
3
4
5
6
7

TestRun testRun = webmateSession.testMgmt.startExecutionWithBuilder(ExpeditionComparisonSpec.ExpeditionComparisonCheckBuilder.builder(
   "Example app comparison",
        new OfflineExpeditionSpec(appSessionId),
        ImmutableList.of(new OfflineExpeditionSpec(referenceAppSessionId))
));

TestRunInfo testRunInfo = testRun.waitForCompletion();

All code:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

BrowserSessionId appSessionId =  executeTestInApp("com.example.exampleApp1", "com.example.exampleApp1.MainActivity")
BrowserSessionId referenceAppSessionId = executeTestInApp("com.example.exampleApp2", "com.example.exampleApp2.MainActivity")

TestRun testRun = webmateSession.testMgmt.startExecutionWithBuilder(ExpeditionComparisonSpec.ExpeditionComparisonCheckBuilder.builder(
   "Example app comparison",
        new OfflineExpeditionSpec(appSessionId),
        ImmutableList.of(new OfflineExpeditionSpec(referenceAppSessionId))
));

TestRunInfo testRunInfo = testRun.waitForCompletion();

View results

You can find the test results in the TestLab by clicking on your test run.

The top bar contains meta information, e.g. runtime, used Appium version etc. (1), followed by the list of compared expeditions/apps (2). You can select the Apps for which you want to view the results, if you applied the test on multiple URLs (3).

Below that you see a side-by-side comparison of the two apps.(1) In the right sidebar there is the list of differences between the two views (2). Moving the cursor over an item in the list will highlight the corresponding elements in the app views.