mobile/android/base/tests/README.rst

Wed, 31 Dec 2014 07:22:50 +0100

author
Michael Schloh von Bennewitz <michael@schloh.com>
date
Wed, 31 Dec 2014 07:22:50 +0100
branch
TOR_BUG_3246
changeset 4
fc2d59ddac77
permissions
-rw-r--r--

Correct previous dual key logic pending first delivery installment.

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.

mercurial