2017-05-19 01:46:11 +02:00
|
|
|
Plasma Applet Template
|
|
|
|
|
----------------------
|
|
|
|
|
|
2018-02-26 07:11:54 +01:00
|
|
|
-- Namespace adaption --
|
|
|
|
|
|
|
|
|
|
Each Plasma plugin has a unique identifier, which is also used to find related
|
|
|
|
|
resources (like the translation catalogs).
|
|
|
|
|
To avoid naming collisions, Plasma plugins use a reverse domain name notation
|
|
|
|
|
for that identifier:
|
|
|
|
|
|
|
|
|
|
* org.kde.plasma.* - plugins coming from Plasma modules
|
|
|
|
|
* org.kde.* - plugins coming from other software from KDE
|
|
|
|
|
* $(my.domain).* - plugins of your 3rd-party
|
|
|
|
|
|
|
|
|
|
The generated code uses the "org.kde.plasma" namespace for the plugin identifier.
|
|
|
|
|
As this namespace is reserved for use by plugins part of Plasma modules, you will
|
|
|
|
|
need to adapt this namespace if you are writing a plugin which is not intended to
|
|
|
|
|
end up in the Plasma modules.
|
|
|
|
|
|
|
|
|
|
|
2017-05-19 01:46:11 +02:00
|
|
|
-- Build instructions --
|
|
|
|
|
|
|
|
|
|
cd /where/your/applet/is/generated
|
|
|
|
|
mkdir build
|
|
|
|
|
cd build
|
|
|
|
|
cmake -DCMAKE_INSTALL_PREFIX=MYPREFIX ..
|
|
|
|
|
make
|
|
|
|
|
make install
|
|
|
|
|
|
|
|
|
|
(MYPREFIX is where you install your Plasma setup, replace it accordingly)
|
|
|
|
|
|
|
|
|
|
Restart plasma to load the applet
|
|
|
|
|
(in a terminal type:
|
|
|
|
|
kquitapp plasmashell
|
|
|
|
|
and then
|
|
|
|
|
plasmashell)
|
|
|
|
|
|
|
|
|
|
or view it with
|
|
|
|
|
plasmoidviewer -a YourAppletName
|
|
|
|
|
|
|
|
|
|
-- Tutorials and resources --
|
|
|
|
|
The explanation of the QML part of the template
|
|
|
|
|
https://techbase.kde.org/Development/Tutorials/Plasma5/QML2/GettingStarted
|
|
|
|
|
|
|
|
|
|
Plasma QML API explained
|
|
|
|
|
https://techbase.kde.org/Development/Tutorials/Plasma2/QML2/API
|
