Interested in getting started with Kirigami development in a few minutes? Since version 5.63 of the Kirigami framework, there is an easy way to do so: an application template. The template facilitates the creation of a new application, using CMake as the build system, and linking to Kirigami dynamically as a plugin at runtime.
Let’s see how it works. As a starting point, we will use a virtual environment running the latest KDE Neon User edition. This is by no means a requirement, any Linux distribution with Kirigami 5.63 or later perfectly fits our needs. KDE Neon has been chosen just because it provides -by design- the latest Qt, KDE frameworks and applications. Moreover, a virtual machine will let us play fearlessly with the system directories.
At first, we install the packages required:
sudo apt install qtbase5-dev build-essential git gcc g++ qtdeclarative5-dev qml-module-qtquick-controls libqt5svg5-dev qtmultimedia5-dev automake cmake qtquickcontrols2-5-dev libkf5config-dev libkf5service-dev libkf5notifications-dev libkf5kiocore5 libkf5kio-dev qml-module-qtwebengine gettext extra-cmake-modules libkf5wallet-dev qtbase5-private-dev qtwebengine5-dev libkf5wallet-dev qt5-default kirigami2-dev kdevelop kapptemplate
We are ready to convert the template to a working application. We will do it in two different ways:
- Using the KAppTemplate tool
- With KDevelop
The KAppTemplate way
KAppTemplate, the Qt and KDE template generator, consumes templates and generates source code. After launching KAppTemplate, on the second page of the wizard, we select Kirigami Application. The Kirigami template can be found under Qt > Graphical on the leftmost panel. We also provide a project name, e.g. hellokirigami.
Choose your project template
On the last page of the wizard, we set the application directory and, optionally, some details about our application.
Set the project properties
After clicking to Generate, the source code of our application is created; we are ready to start building it.
cd /home/user/src/hellokirigami mkdir build cd build cmake .. make -j4 sudo make install
Since the development environment is a virtual one, we are free to install our application in the system directories. Otherwise, in case of working on the host machine, custom install prefixes would be recommended.
KDevelop is a full-featured IDE that integrates perfectly with application templates. On the Project menu, after clicking to the New From Template menu item, the application template wizard is shown.
Create a KDevelop project from template
We just select the Qt category on the leftmost panel and Kirigami Application on the right one, and set a project name, e.g. hellokirigami2.
Kirigami template on KDevelop
On the last screen of the template wizard, we may also select a version control system, if needed. Not this time.
Back to KDevelop, we may set a custom installation prefix. Since we are not going to to install anything, we just select Debug as Build type and don’t bother with installation prefixes.
Set the build directory
The Projects pane enables us to examine the source code file hierarchy, while on the right we can see the code of each file. To test our application, we Build and, finally, Execute our application. Both actions can be found on the main toolbar.
Build and execute
Having clicked to Execute, on the Launch Configurations dialog, we Add a new configuration, selecting the scr/hellokirigami2 project target.
Set application target on KDevelop
To check how the application will run on Plasma Mobile, we have to configure again a little bit our environment. In particular, on the Run menu, we click to the Configure Launches item. The configuration dialog will be displayed.
Launch configurations on KDevelop
Then, we add the following to Environment:
Set mobile environment variables
We are prompted with the mobile version of our application.
That’s all. It’s time to add your own code bits. Happy hacking!