Merge lp:~fginther/ubuntu-test-cases/click-testing into lp:ubuntu-test-cases/touch

[Francis Ginther]

Add README documentation for testing a modified click app.

Add README documentation for testing a modified click app.

[Francis Ginther (fginther)]

I've also been playing with a modified version oh phablet-click-test-setup (from phablet-tools) which takes care of installation of the test sources and would allow removing the following:

33 +The above phablet-click-test-setup command will install the standard test
34 +dependencies and the click application's test sources as specified in the
35 +manifest. This is usually the application's trunk branch. To override the test
36 +sources with local changes, replace the test sources that were copied to the
37 +device. This example assumes the application code is checked out under the
38 +'dropping-letters' directory with the test sources under 'tests/autopilot'::
39 +
40 + adb shell rm -rf /home/phablet/autopilot/dropping_letters_app
41 + adb push dropping-letters/tests/autopilot \
42 + /home/phablet/autopilot

[Paul Larson (pwlars)]

is pkcon preferred over click install?

[Francis Ginther (fginther)]

> is pkcon preferred over click install?

I've been unable to find info in any of the wiki's but the 'click' command provides this:
"
phablet@ubuntu-phablet:~$ click install --help
Usage: click install [options] PACKAGE-FILE

This is a low-level tool; to install a package as an ordinary user
you should generally use "pkcon install-local PACKAGE-FILE"
instead.
"

Will keep looking.

[Colin Watson (cjwatson)]

The click documentation should be considered authoritative on this.

Unmerged revisions

=== modified file 'README-cli.rst'
--- README-cli.rst	2014-11-10 19:28:56 +0000
+++ README-cli.rst	2015-03-02 14:56:20 +0000
@@ -96,3 +96,47 @@
 Then execute the following script::
 
   ./scripts/run-mp.sh
+
+Running Tests for a Modified Click Application
+----------------------------------------------
+
+First privision the device with the desired image. To get the very latest::
+
+  ./scripts/provision.sh -w
+
+Alternatively, to install the latest ubuntu-rtm image::
+
+  export IMAGE_OPT="--bootstrap --developer-mode --channel=ubuntu-touch/ubuntu-rtm/14.09-proposed"
+  ./scripts/provision.sh -w
+
+Once the image has been provisioned, install the click app to test.
+The dropping-letters application is used in this example::
+
+  adb push com.ubuntu.dropping-letters_0.1.2.2.67_all.click /tmp
+  adb shell pkcon --allow-untrusted install-local \
+      /tmp/com.ubuntu.dropping-letters_0.1.2.2.67_all.click
+
+Now install the test sources ('--wipe' will remove any previously installed
+test sources)::
+
+  phablet-click-test-setup --wipe --click com.ubuntu.dropping-letters
+
+The above phablet-click-test-setup command will install the standard test
+dependencies and the click application's test sources as specified in the
+manifest. This is usually the application's trunk branch. To override the test
+sources with local changes, replace the test sources that were copied to the
+device. This example assumes the application code is checked out under the
+'dropping-letters' directory with the test sources under 'tests/autopilot'::
+
+  adb shell rm -rf /home/phablet/autopilot/dropping_letters_app
+  adb push dropping-letters/tests/autopilot \
+      /home/phablet/autopilot
+
+Finally, run the application tests::
+
+  ./scripts/run-autopilot-tests.sh -a dropping_letters_app
+
+The test results are available under::
+
+  clientlogs/dropping_letters_app/test_results.xml
+