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
|
=================
Ubuntu UI Toolkit
=================
Introduction
------------
This project consists of a set of QML components to ease the creation of
beautiful applications in QML for Ubuntu.
QML alone lacks built-in components for basic widgets like Button, Slider,
Scrollbar, etc, meaning a developer has to build them from scratch. This
toolkit aims to stop this duplication of work, supplying beautiful components
ready-made and with a clear and consistent API.
These components are fully themeable so the look and feel can be easily
customized. Resolution independence technology is built in so UIs are scaled
to best suit the display.
Other features:
- localisation through gettext
This project supports QML2 and above.
Building & Setup
----------------
You need Qt5 installed to proceed. To build this repository, run
$ qmake
$ make
View the components gallery by running
$ ./gallery.sh
To install these components, run
$ make install
You may need to be root for this command to succeed.
To use these components in QML without installing them, you need to set the
QML2_IMPORT_PATH environment variable. This is done by running
$ source export_qml_dir.sh
from the root directory of this repository, but is lost when you close your
shell.
Tests
-----
tests
- autopilot/ubuntuuitoolkit: Autopilot test cases and CPOs
./run_tests.sh list
./run_tests.sh run [TESTCASE]
- api: Tests for apicheck (API description generator)
Run 'make check' in the folder
- license: Script to verify that sources contains copright headers
make license
- resources: Manual test cases (deprecated, should move to unit/visual)
- unit:
Unit tests using QTest/UbuntuTestCase
Run 'make check[_BASENAME_WITH_UNDERSCORES]' in the respective subfolder
eg. 'tst_label_extras.13.qml' becomes 'make check_tst_label_extras_13'
This is driven by runtest.sh and checkresults.sh.
- visual: All tests in this folder can be run as unit tests as well as
interactively. That means 'make check' or via gallery.sh.
Optional: prefix with './tests/xvfb.sh' to run inside XVfb.
Note for adding new files: The root must be a visual Item-based type
with a width and height. TestCase or UbuntuTestCase must be a child.
Verify the whole Toolkit API:
'./tests/qmlapicheck.sh' inspects components.api and produces components.api.new
Verify the tidyness of packaging:
./packaging-sorting.sh
Verify the coding style of Python source code:
pyflakes .
'source export_qml_dir.sh' can be used in bash to setup the environment.
Documentation
-------------
Once built, you may view the documentation by opening
documentation/html/overview-ubuntu-sdk.html
in your favorite web browser.
Autopilot SDK Helpers Documentation (Sphinx docs):
++++++++++++++++++++++++++++++++++++++++++++++++++
To build the Autopilot SDK Helpers documentation, you need to install sphinx.
After installation, change directory to documentation/autopilot-helpers
and executing make.
* $ sudo apt-get install python3-sphinx
* $ cd documentation/autopilot-helpers
* $ make singlehtml
* Once built, you may view the documentation by opening
`_build/singlehtml/index.html` in your favorite web browser.
|