summaryrefslogtreecommitdiffstats
path: root/mobile/android/tests/browser/robocop/README.rst
diff options
context:
space:
mode:
authorMatt A. Tobin <mattatobin@localhost.localdomain>2018-02-02 04:16:08 -0500
committerMatt A. Tobin <mattatobin@localhost.localdomain>2018-02-02 04:16:08 -0500
commit5f8de423f190bbb79a62f804151bc24824fa32d8 (patch)
tree10027f336435511475e392454359edea8e25895d /mobile/android/tests/browser/robocop/README.rst
parent49ee0794b5d912db1f95dce6eb52d781dc210db5 (diff)
downloadUXP-5f8de423f190bbb79a62f804151bc24824fa32d8.tar
UXP-5f8de423f190bbb79a62f804151bc24824fa32d8.tar.gz
UXP-5f8de423f190bbb79a62f804151bc24824fa32d8.tar.lz
UXP-5f8de423f190bbb79a62f804151bc24824fa32d8.tar.xz
UXP-5f8de423f190bbb79a62f804151bc24824fa32d8.zip
Add m-esr52 at 52.6.0
Diffstat (limited to 'mobile/android/tests/browser/robocop/README.rst')
-rw-r--r--mobile/android/tests/browser/robocop/README.rst61
1 files changed, 61 insertions, 0 deletions
diff --git a/mobile/android/tests/browser/robocop/README.rst b/mobile/android/tests/browser/robocop/README.rst
new file mode 100644
index 000000000..7ace7cdeb
--- /dev/null
+++ b/mobile/android/tests/browser/robocop/README.rst
@@ -0,0 +1,61 @@
+Robocop Mochitest
+=================
+
+*Robocop Mochitest* is a Mozilla project which uses Robotium to test
+ Firefox on Android devices.
+
+*Robocop Mochitest* tests run on Native Android builds marked with an
+'rc' on treeherder. These are Java based tests which run from the mochitest
+harness and generate similar log files. These are designed for
+testing the native UI of Android devices by sending events to the
+front end.
+
+See the documentation at
+https://wiki.mozilla.org/Auto-tools/Projects/Robocop/WritingTests for
+details.
+
+Development cycle
+-----------------
+
+To deploy the robocop APK to your device and start the robocop test
+suite, use::
+
+ mach robocop
+
+To run a specific test case, such as ``testLoad``::
+
+ mach robocop testLoad
+
+The Java files in ``mobile/android/tests/browser/robocop`` are dependencies of the
+robocop APK built by ``build/mobile/robocop``. If you modify Java files
+in ``mobile/android/tests/browser/robocop``, you need to rebuild the robocop APK
+with::
+
+ mach build build/mobile/robocop
+
+Changes to ``.html``, ``.css``, ``.sjs``, and ``.js`` files in
+``mobile/android/tests/browser/robocop`` do not require rebuilding the robocop
+APK -- these changes are always 'live', since they are served by the
+mochitest HTTP server and downloaded each test run by your device.
+
+``mach package`` does build and sign a robocop APK, but ``mach
+robocop`` does not use it. (This signed APK is used to test
+signed releases on the buildbots).
+
+As always, changes to ``mobile/android/base``, ``mobile/android/chrome``,
+``mobile/android/modules``, etc., require::
+
+ mach build mobile/android/base && mach package && mach install
+
+as usual.
+
+Licensing
+---------
+
+Robotium is an open source tool licensed under the Apache 2.0 license and the original
+source can be found here:
+https://github.com/RobotiumTech/robotium
+
+We are including robotium-solo-5.5.4.jar as a binary and are not modifying it in any way
+from the original download found at:
+https://github.com/RobotiumTech/robotium/wiki/Downloads