~ci-train-bot/dialer-app/dialer-app-ubuntu-xenial-landing-044

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
dialer-app hacking guide
========================

Getting dialer-app
------------------

To get the main development branch of dialer-app:

    $ bzr branch lp:dialer-app


Building the app
----------------

This app is built using cmake. Here's an example on how to build it:

    $ cmake .
    $ make -j 8


Running the built app
---------------------

After building the app, it can be run with:

    $ ./src/dialer-app


Test coverage
-------------

dialer-app has autopilot tests which cover basic use cases like making an
outgoing call and receiving an incoming call. They are integration tests which
cover dialer-app itself, all the user session APIs below it (libofono-qt,
telephony-service, telepathy-ofono), and the ofono service on the system D-BUS.
They assume that ofono has been set up with the "phonesim" driver to avoid
depending on any particular hardware; if phonesim is not set up, the tests will
be skipped.

The tests should run on both a desktop (like an Ubuntu desktop live session or
Otto [http://launchpad.net/otto]) and a phone environment.


Running the autopilot tests with the installed app
--------------------------------------------------

The easiest and standard way across Ubuntu phablet packages is to install the
dialer-app-autopilot package and run the tests from the system Python path:

    $ sudo apt-get install dialer-app-autopilot
    $ autopilot3 run dialer_app

dialer-app-autopilot depends on ofono-phonesim-autostart to set up the
simulated Modem automatically, and all the other additional test dependencies
for autopilot. You can also run the tests right out of the source tree for
development:

    $ cd tests/autopilot
    $ autopilot3 run dialer_app

(but you still need all the dialer-app-autopilot dependencies installed).


Running the autopilot tests with the built app
----------------------------------------------

After building the app, the autopilot tests can be run with:

    $ make test-autopilot