1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
|
Running Autopilot tests
=======================
The calculator app follows a test driven development where autopilot tests are run before every merge into trunk. If you are submitting your bugfix/patch to the calculator app, please follow the following steps below to ensure that all tests pass before proposing a merge request.
If you are looking for more info about Autopilot or writing AP tests for the calculator app, here are some useful links to help you:
- [Ubuntu - Quality](http://developer.ubuntu.com/start/quality)
- [Ubuntu - Autopilot](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 ubuntu-ui-toolkit-autopilot xserver-xephyr ratpoison xvfb
Running tests on the desktop
============================
Using terminal:
* Branch the Calculator app code, for example,
$ bzr branch lp:ubuntu-calculator-app
* Navigate to the tests/autopilot directory.
$ cd ubuntu-calculator-app/tests/autopilot
* Run all tests.
$ autopilot3 run -vv ubuntu_calculator_app
* To list all tests:
$ autopilot3 list ubuntu_calculator_app
* To run only one test (for instance: ubuntu_calculator_app.tests.test_main.MainTestCase.test_divide_by_zero)
$ autopilot3 run -vv ubuntu_calculator_app.tests.test_main.MainTestCase.test_divide_by_zero
* Debugging tests using autopilot vis
$ autopilot3 launch -i Qt qmlscene app/ubuntu-calculator-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 within virtual environment
========================================
Warning: Running virtual environment is not working with proprietary NVidia drivers.
To run all tests from sandbox, run following command from tests/autopilot:
$ autopilot3-sandbox-run -X —windowmanager ratpoison -s 400x600x24 ubuntu_calculator_app/
Running tests on device or emulator:
====================================
Using autopkg:
* Branch the Calculator app code, for example,
$ bzr branch lp:ubuntu-calculator-app
* Navigate to the source directory.
$ cd ubuntu-calculator-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>
|