Running Crosswalk tests
If you are making changes to Crosswalk in addition to building it yourself, you should probably run Crosswalk's tests to make sure your changes do not introduce any regressions.
This page assumes you have already built Crosswalk by following the platform-specific instructions on the other pages.
Simple test for Linux and Windows
If you just want to find out if your
xwalk or (
xwalk.exe) binary is working
as expected, you can simply pass it a manifest:
# Linux cd /path/to/crosswalk-checkout/src/YOUR-BUILD-DIR ./xwalk /path/to/manifest.json # Windows cd C:\path\to\crosswalk-checkout\src\YOUR-BUILD-DIR xwalk.exe C:\path\to\manifest.json
Crosswalk will parse the manifest and launch the application from the entry
point specified in
If you don't have any HTML applications to test, the Crosswalk samples includes a few you can try.
Build all available tests
The easiest way to build all Crosswalk tests, which are different and have
different names depending on the platform, is to build the
target. This work for on all supported platforms (Android, Windows and Linux).
cd /path/to/crosswalk-checkout/src ninja -C YOUR-BUILD-DIR xwalk_builder
Linux and Windows
On Linux and Windows, building the
xwalk_builder target generates the
following executables in
YOUR-BUILD-DIR (remember they end in
Those are also target names, so if you only want to build a subset of the tests
you can pass one of those names to ninja instead of
At the moment, Crosswalk for Android is tested using device tests which are run directly on an Android device or emulator. These are known as instrumentation tests.
xwalk_builder target is actually building the following targets (and
Those tests all come in pairs, and can be invoked like this:
cd /path/to/crosswalk-checkout/src python build/android/test_runner.py instrumentation \ --apk-under-test BUILD-DIR/apks/XWalkCoreShell.apk \ --output-directory BUILD-DIR \ --test-apk BUILD-DIR/apks/XWalkCoreTest.apk \ --test-data xwview:xwalk/test/android/data/device_files/
Chromium's Android testing infrastructure is very flexible (but also quite complex). Please take some time to read its documentation, which covers, for example, how to run only a subset of all tests or how to avoid some common setup issues with your device.