Confirm
1,753
edits
Changes
no edit summary
This page has instructions for running Firefox tests locally on a device (Android phone, tablet, or emulator) of your choice.
Having trouble? Ping :gbrown on #mobile, or ask for help on #ateam.
== For the impatient... ==
mach cppunittest
mach geckoview-junit
mach web-platform-test
mach marionette-test
mach test
They all run against a connected Android device using your Firefox for Android build. Don't have a device? These commands will offer to start an emulator.
mach robocop <test-name>
Notes:
* To run one test at a time, find the test name (like "testLoad") in <tt>mobile/android/tests/browser/robocop/robocop.ini</tt> and pass it as an argument, like: <tt>mach robocop testLoad</tt>.
* A rooted device is required. Test harnesses may need to kill processes, copy and delete files, or perform other operations which may require special permissions on some devices.
Notes:
* A rooted device is recommended, but may not be required. Test harnesses may need to kill processes, copy and delete files, or perform other operations which may require special permissions on some devices.
* Setup can take several minutes! Setup is faster if unzip is available on the remote device; if your device does not have unzip, try installing busybox.
--remoteTestRoot=<remote-directory>
== Trouble-shooting testing problems ==
** Make sure _SERVER_ADDR in the test output is the same as your machine's IP address.
* If using MOZ_HOST_BIN, ensure the binaries in your MOZ_HOST_BIN folder are executable, in case you pull them down from the FTP site. You might see "OSError: [Errno 13] Permission denied" if they are not executable. Use chmod to fix them. Check certutil, pk12util and ssltunnel.
* Is your device rooted? Many test suites require root permissions. Don't want to root your device? Consider using an emulator with 'mach android-emulator'.
