~nik90/ubuntu-weather-app/fix-ota10-sdk-issues

« back to all changes in this revision

Viewing changes to README.autopilot

  • Committer: Tarmac
  • Author(s): Girish Rawat
  • Date: 2015-12-22 01:10:40 UTC
  • mfrom: (187.1.4 ubuntu-weather-app)
  • Revision ID: tarmac-20151222011040-0r880cfuola0l20j
Updated and fixed READMEs.

Approved by Jenkins Bot, Victor Thompson, Andrew Hayzen, Nicholas Skaggs.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Running Autopilot tests
2
 
 
3
 
The Weather 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 Weather app, please follow the following steps below to ensure that all tests pass before proposing a merge request.
4
 
 
5
 
If you are looking for more info about Autopilot or writing AP tests for the weather app, here are some useful links to help you:
6
 
 
7
 
- http://developer.ubuntu.com/start/quality
8
 
- https://developer.ubuntu.com/api/autopilot/python/1.5.0/
9
 
 
10
 
For help and options on running tests, see:
11
 
 
12
 
- https://developer.ubuntu.com/en/start/platform/guides/running-autopilot-tests/
13
 
 
14
 
## Prerequisites
15
 
 
16
 
Install the following autopilot packages required to run the tests,
17
 
$ sudo apt-get install python3-autopilot libautopilot-qt ubuntu-ui-toolkit-autopilot python3-autopilot-vis
18
 
 
19
 
## Running tests on the desktop
20
 
 
21
 
Using terminal:
22
 
 
23
 
*  Branch the Weather app code, for example,
24
 
    $ bzr branch lp:ubuntu-weather-app
25
 
    
26
 
*  Navigate to the tests/autopilot directory.
27
 
    $ cd ubuntu-weather-app/tests/autopilot
28
 
 
29
 
*  run all tests.
30
 
    $ autopilot3 run -vv ubuntu_weather_app
31
 
 
32
 
    to list all tests:
33
 
    $ autopilot3 list ubuntu_weather_app
34
 
 
35
 
    To run only one test (for instance: ubuntu_weather_app.tests.test_empty_state.TestEmptyState.test_add_location_button)
36
 
    $ autopilot3 run -vv ubuntu_weather_app.tests.test_empty_state.TestEmptyState.test_add_location_button
37
 
 
38
 
    Debugging tests using autopilot vis
39
 
    $ autopilot3 launch -i Qt qmlscene app/ubuntu-weather-app.qml
40
 
    $ autopilot3 vis
41
 
 
42
 
 
43
 
## Running tests on device or emulator:
44
 
 
45
 
Using autopkg:
46
 
 
47
 
*  Branch the Weather app code, for example,
48
 
    $ bzr branch lp:ubuntu-weather-app
49
 
 
50
 
*  Navigate to the source directory.
51
 
    $ cd ubuntu-weather-app
52
 
 
53
 
*  Build a click package
54
 
    $ click-buddy .
55
 
 
56
 
*  Run the tests on device (assumes only one click package in the directory)
57
 
    $ adt-run . *.click --- ssh -s adb -- -p <PASSWORD>