README
README.rst
1Robocop Mochitest
2=================
3
4*Robocop Mochitest* is a Mozilla project which uses Robotium to test
5 Firefox on Android devices.
6
7*Robocop Mochitest* tests run on Native Android builds marked with an
8'rc' on treeherder. These are Java based tests which run from the mochitest
9harness and generate similar log files. These are designed for
10testing the native UI of Android devices by sending events to the
11front end.
12
13See the documentation at
14https://wiki.mozilla.org/Auto-tools/Projects/Robocop/WritingTests for
15details.
16
17Development cycle
18-----------------
19
20To deploy the robocop APK to your device and start the robocop test
21suite, use::
22
23 mach robocop
24
25To run a specific test case, such as ``testLoad``::
26
27 mach robocop testLoad
28
29The Java files in ``mobile/android/tests/browser/robocop`` are dependencies of the
30robocop APK built by ``build/mobile/robocop``. If you modify Java files
31in ``mobile/android/tests/browser/robocop``, you need to rebuild the robocop APK
32with::
33
34 mach build build/mobile/robocop
35
36Changes to ``.html``, ``.css``, ``.sjs``, and ``.js`` files in
37``mobile/android/tests/browser/robocop`` do not require rebuilding the robocop
38APK -- these changes are always 'live', since they are served by the
39mochitest HTTP server and downloaded each test run by your device.
40
41``mach package`` does build and sign a robocop APK, but ``mach
42robocop`` does not use it. (This signed APK is used to test
43signed releases on the buildbots).
44
45As always, changes to ``mobile/android/base``, ``mobile/android/chrome``,
46``mobile/android/modules``, etc., require::
47
48 mach build mobile/android/base && mach package && mach install
49
50as usual.
51
52Licensing
53---------
54
55Robotium is an open source tool licensed under the Apache 2.0 license and the original
56source can be found here:
57https://github.com/RobotiumTech/robotium
58
59We are including robotium-solo-5.5.4.jar as a binary and are not modifying it in any way
60from the original download found at:
61https://github.com/RobotiumTech/robotium/wiki/Downloads
62