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
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
|
webbrowser-app is a lightweight web browser tailored for Ubuntu,
based on the Oxide web engine and using the Ubuntu UI components.
It requires Qt 5.4 to build and run.
= Building =
The build system uses cmake.
To compile, simply invoke cmake and then make:
$ cmake .
$ make
The application can also be cross compiled for an ARM target on a X86 host.
To do that, just pass this additional parameter to cmake:
$ cmake -DCMAKE_TOOLCHAIN_FILE=cmake/ubuntu-arm-linux-gnueabihf.cmake .
= Running =
webbrowser-app can be run from the development branch without the need to
install any files. Just run:
$ ./src/app/webbrowser/webbrowser-app
The executable accepts command line switches and parameters. To find out which,
just run:
$ ./src/app/webbrowser/webbrowser-app --help
= Unit tests =
To run the unit tests, you can use the commands below:
$ make test
- or -
$ ctest
= Automated UI tests =
webbrowser-app uses autopilot (https://launchpad.net/autopilot) to test its UI.
To run the tests locally, you will need to install python3-autopilot and
autopilot-qt5.
Then do the following:
$ cd tests/autopilot/
$ autopilot3 run webbrowser_app
You can get a list of all available tests with the following command:
$ autopilot3 list webbrowser_app
In order to run the tests in a virtual machine with an environment closer to
what a user will get in Ubuntu Touch, see the Dep8 tests section.
= Code coverage =
To generate a report with detailed code coverage, you need to re-run cmake with
"CMAKE_BUILD_TYPE=coverage":
$ cmake -DCMAKE_BUILD_TYPE=coverage .
$ make
$ make test
$ make coverage
This will generate a coverage report in XML format (coverage.xml) and an
interactive human-readable report in HTML format (coveragereport/index.html).
= Dep8 tests =
Dep8 tests exercise the package "as-installed".
Currently, the webbrowser-app has one suite of dep8 tests that uses autopilot
(https://launchpad.net/autopilot) to test from the point of view of the user.
To run the tests you will need autopkgtest:
$ sudo apt-get install autopkgtest
You can use multiple test beds to execute the tests. Below you will find
instructions to run them in a virtual machine
You can find more information with:
$ man adt-run
== Run dep8 tests ==
To run the tests in a qemu virtual machine, you will first have to create it
(see /usr/share/doc/autopkgtest/README.running-tests.rst.gz). We output the
image to ~/ rather than the current directory, so it will be in a safer
place to avoid rebuilding images every time. You can store it in any
directory you wish. This image is better consumed "fresh", building it daily
will avoid long updates/upgrades when running the tests.
$ adt-buildvm-ubuntu-cloud -r $(lsb_release -c -s) -a amd64 -o ~/
Then run the tests using adt-run with the qemu virtualization host against
the current archive.
$ adt-run -B -U --unbuilt-tree . \
-o ~/adt-browser-test/$(date +%Y-%m-%d-%H-%M) \
--- qemu ~/adt-$(lsb_release -c -s)-amd64-cloud.img
The tests can also be run on a local phone.
$ adt-run -B -U --unbuilt-tree . \
-o ~/adt-browser-test/$(date +%Y-%m-%d-%H-%M) \
--- ssh -s adb -- -p <password> --serial <ADB_SERIAL>
== Examine the dep8 autopilot results ==
To examine the test results, which are in subunit format, additional tools are
required, such as trv (https://launchpad.net/trv).
You can find the results file in the directory
~/adt-browser-test/$(date +%Y-%m-%d-%H-%M)/artifacts.
= Settings =
webbrowser-app supports a limited set of custom settings, persisted on disk in
the following INI-like file:
$HOME/.config/webbrowser-app/webbrowser-app.conf
The following keys are supported:
- 'homepage': a URL that the browser will open when launched if no URL is
specified on the command line
- 'searchengine': a custom search engine specification, looked up in
$HOME/.local/share/webbrowser-app/searchengines/{value}.xml and following
the OpenSearch document description format
(http://www.opensearch.org/Specifications/OpenSearch/1.1)
- restoreSession: whether to restore the previous browsing session at startup
(defaults to true)
|