mobile/android/base/tests/README.rst@6474c204b198 (annotated)
mobile/android/base/tests/README.rst
Wed, 31 Dec 2014 06:09:35 +0100
- author
- Michael Schloh von Bennewitz <michael@schloh.com>
- date
- Wed, 31 Dec 2014 06:09:35 +0100
- changeset 0
- 6474c204b198
- permissions
- -rw-r--r--
Cloned upstream origin tor-browser at tor-browser-31.3.0esr-4.5-1-build1
revision ID fc1c9ff7c1b2defdbc039f12214767608f46423f for hacking purpose.
| michael@0 | 1 | Robocop Mochitest |
| michael@0 | 2 | ================= |
| michael@0 | 3 | |
| michael@0 | 4 | *Robocop Mochitest* tests run on Native Android builds marked with an |
| michael@0 | 5 | 'rc' in TBPL. These are Java based tests which run from the mochitest |
| michael@0 | 6 | harness and generate similar log files. These are designed for |
| michael@0 | 7 | testing the native UI of Android devices by sending events to the |
| michael@0 | 8 | front end. |
| michael@0 | 9 | |
| michael@0 | 10 | See the documentation at |
| michael@0 | 11 | https://wiki.mozilla.org/Auto-tools/Projects/Robocop/WritingTests for |
| michael@0 | 12 | details. |
| michael@0 | 13 | |
| michael@0 | 14 | Development cycle |
| michael@0 | 15 | ----------------- |
| michael@0 | 16 | |
| michael@0 | 17 | To deploy the robocop APK to your device and start the robocop test |
| michael@0 | 18 | suite, use:: |
| michael@0 | 19 | |
| michael@0 | 20 | make -C $OBJDIR mochitest-robocop |
| michael@0 | 21 | |
| michael@0 | 22 | To run a specific test case, such as ``testLoad``:: |
| michael@0 | 23 | |
| michael@0 | 24 | make -C $OBJDIR mochitest-robocop TEST_PATH=testLoad |
| michael@0 | 25 | |
| michael@0 | 26 | The Java files in ``mobile/android/base/tests`` are dependencies of the |
| michael@0 | 27 | robocop APK built by ``build/mobile/robocop``. If you modify Java files |
| michael@0 | 28 | in ``mobile/android/base/tests``, you need to rebuild the robocop APK |
| michael@0 | 29 | with:: |
| michael@0 | 30 | |
| michael@0 | 31 | mach build build/mobile/robocop |
| michael@0 | 32 | |
| michael@0 | 33 | Changes to ``.html``, ``.css``, ``.sjs``, and ``.js`` files in |
| michael@0 | 34 | ``mobile/android/base/tests`` do not require rebuilding the robocop |
| michael@0 | 35 | APK -- these changes are always 'live', since they are served by the |
| michael@0 | 36 | mochitest HTTP server and downloaded each test run by your device. |
| michael@0 | 37 | |
| michael@0 | 38 | ``mach package`` does build and sign a robocop APK, but ``make |
| michael@0 | 39 | mochitest-robocop`` does not use it. (This signed APK is used to test |
| michael@0 | 40 | signed releases on the buildbots). |
| michael@0 | 41 | |
| michael@0 | 42 | As always, changes to ``mobile/android/base``, ``mobile/android/chrome``, |
| michael@0 | 43 | ``mobile/android/modules``, etc., require:: |
| michael@0 | 44 | |
| michael@0 | 45 | mach build mobile/android/base && mach package && mach install |
| michael@0 | 46 | |
| michael@0 | 47 | as usual. |
