ubuntu-touch-coreapps-reviewers team mailing list archive

[Nicholas Skaggs <nskaggs@xxxxxxxxxx>]

Nicholas Skaggs has proposed merging lp:~nskaggs/ubuntu-rssreader-app/add-ap-readme into lp:ubuntu-rssreader-app.

Commit message:
Add readme for autopilot tests

Requested reviews:
  Ubuntu Shorts Developers (ubuntu-shorts-dev)

For more details, see:
https://code.launchpad.net/~nskaggs/ubuntu-rssreader-app/add-ap-readme/+merge/288405

Add readme for autopilot tests
-- 
Your team Ubuntu Shorts Developers is requested to review the proposed merge of lp:~nskaggs/ubuntu-rssreader-app/add-ap-readme into lp:ubuntu-rssreader-app.

=== added file 'README.Autopilot.md'
--- README.Autopilot.md	1970-01-01 00:00:00 +0000
+++ README.Autopilot.md	2016-03-08 14:03:00 +0000
@@ -0,0 +1,74 @@
+Running Autopilot tests
+=======================
+If you are looking for more info about Autopilot or writing AP tests, here are some useful links to help you:
+
+- [Ubuntu - Quality](http://developer.ubuntu.com/start/quality)
+- [Autopilot - Python](https://developer.ubuntu.com/api/autopilot/python/1.5.0/)
+
+For help and options on running tests, see:
+
+- [Autopilot tests](https://developer.ubuntu.com/en/start/platform/guides/running-autopilot-tests/)
+
+Prerequisites
+=============
+
+Install the following autopilot packages required to run the tests,
+
+    $ sudo apt-get install python3-autopilot libautopilot-qt ubuntu-ui-toolkit-autopilot python3-autopilot-vis
+
+Running tests on the desktop
+============================
+
+Using terminal:
+
+*  Branch the code
+
+    $ bzr branch lp:ubuntu-rssreader-app
+
+*  Navigate to the tests/autopilot directory.
+
+    $ cd tests/autopilot
+
+*  run all tests.
+
+    $ autopilot3 run -vv shorts_app
+
+* to list all tests:
+
+    $ autopilot3 list shorts_app
+
+ To run only one test
+
+    $ autopilot3 run -vv shorts.tests.test_name
+
+* Debugging tests using autopilot vis
+
+    $ autopilot3 launch -i Qt qmlscene shorts/qml/shorts-app.qml
+
+    $ autopilot3 vis
+
+Running tests using Ubuntu SDK
+==============================
+
+Refer this [tutorial](https://developer.ubuntu.com/en/start/platform/guides/running-autopilot-tests/) to run tests on Ubuntu SDK:
+
+Running tests on device or emulator:
+====================================
+
+Using autopkg:
+
+*  Branch the code
+
+    $ bzr branch lp:ubuntu-rssreader-app
+
+*  Navigate to the source directory.
+
+    $ cd ubuntu-rssreader-app
+
+*  Build a click package
+
+    $ click-buddy .
+
+*  Run the tests on device (assumes only one click package in the directory)
+
+    $ adt-run . *.click --- ssh -s adb -- -p <PASSWORD>
\ No newline at end of file