Robocop uses Robotium to inject events into the Java front-end of Firefox for Android and to monitor and verify Firefox events and UI views.
Related The source code for the Robocop harness, and the test source code, is maintained on mozilla-central:* test source code in <tt>mobile/android/base/tests* Robocop source in build/mobilebrowser/robocop</tt>.
Robocop-based UI functionality tests are run with the mochitest test harness and appear on Treeherder under the symbols rc1 and rc2.
== Setup ==
==== Step one: Build Fennec ====* Follow the instructions at https://wiki.mozilla.org/Mobile/Fennec/Android#Building_Fennec to build, package, and install Fennec on your device.
==== Step two: Build Firefox (Necessary for XPCShell) ====Follow [the instructions at https://developerwiki.mozilla.org/EnMobile/Fennec/Simple_Firefox_build these instructions] Android#Building_Fennec to build Firefox for desktop, just so that you can build xpcshellpackage, and install Fennec on your device.
(mcomella, 2/4/14=== Step two: Unable to do the following via OS X or Arch Linux - various dynamic libraries are unable to be found)Install MOZ_HOST_BIN ===
As an alternative, you can download a "tests" zip from a current build for your platform from [ftpFollow the instructions at https://ftpwiki.mozilla.org/pubMobile/mozilla.org/firefox/nightly/latest-mozilla-central/ here], such as ftp://ftp.mozilla.orgFennec/pubAndroid/mozilla.org/firefox/nightly/latest-mozilla-central/firefox-23.0a1.en-US.linux-i686Testing#Host_Builds_.tests28MOZ_HOST_BIN.zip -- unzip and find xpcshell29.
== Running tests ==
==== Running all the tests ====
From the root directory:
<pre>./ mach build buildmobile/android/tests/mobilebrowser/robocop./ mach robocop</pre>
Some notes for running tests:
== Updating your test directory ==
It is not always necessary to rebuild Fennec to use new tests. If you are updating the build with your own test, ensure that your test has been added to the manifest in /PATH/TO/FENNEC/SOURCE/<tt>mobile/android/basetests/browser/testsrobocop/robocop.ini </tt>.
Otherwise, you can retrieve tests from the repository by executing:
<pre> hg pull hg update</pre>
Now you can build the robocop part of Fennec by executing:
<pre>cd objdirmake -C mach buildmobile/mobileandroid/robocoptests/make package <browser/pre>robocop
== Frequently found errors ==
If you do not see your specific error below, it can sometimes help to uninstall and reinstall. To do this (and run the tests):
<pre> adb uninstall org.mozilla.roboexample.testmake -C $OBJDIR mochitest-robocop</pre> ===OOM Error===This is an error found after use of Robocop frequently, but once it has happened, Fennec itself continues to crash. To fix it, simply uninstall and reinstall. This does not occur of frequent use of Robocop, as I have run 30 iterations of just robocop without it throwing this error. ===InvocationTargetException Error===This is an issue arising when using a Tegra.It looks like the following:<br><pre>W/System.err( 2610): java.lang.reflect.InvocationTargetExceptionW/System.err( 2610): at org.mozilla.gecko.GeckoAppShell.unregisterGeckoEventListener(GeckoAppShell.java:1565)...</pre> ===Build Error===This is resolved by doing a clean mach build.<pre>make[7]: Entering directory `/media/sdan/birch/objdir-native-droid/mobile/android/basetests/locales'make[7]: Leaving directory `browser/media/sdan/birch/objdir-native-droid/mobile/android/base/locales'robocopres/values/strings.xml:1: error: Error parsing XML: no element foundres/layout/awesomebar_search.xml:9: error: Error: No resource found that matches the given name (at 'hint' with value '@string/awesomebar_default_text').res/layout-v11/awesomebar_search.xml:9: error: Error: No resource found that matches the given name (at 'hint' with value '@string/awesomebar_default_text').res/layout/browser_toolbar.xml:7: error: Error: No resource found that matches the given name (at 'hint' with value '@string/awesomebar_default_text').res/layout/crash_reporter.xml:6: error: Error: No resource found that matches the given name (at 'text' with value '@string/crash_message').res/layout/crash_reporter.xml:14: error: Error: No resource found that matches the given name (at 'text' with value '@string/crash_help_message').res/layout/crash_reporter.xml:21: error: Error: No resource found that matches the given name (at 'text' with value '@string/crash_send_report_message')....</pre> mach robocop testLoad
===Infrequent Runtime Errors===
