Guidelines and HOWTOs/Flatpak: Difference between revisions

From KDE Community Wiki
(Add note about --user switch)
m (Mention new Userbase page)
 
(46 intermediate revisions by 19 users not shown)
Line 1: Line 1:
Flatpak is a solution for creating sandboxed software builds for GNU/Linux systems. You can find more information [http://flatpak.org/ here].
The development information of this page has been moved [https://develop.kde.org/docs/build/flatpak/ here].


= KDE Runtime =
The usage information of this page has been moved [https://userbase.kde.org/Tutorials/Flatpak here].
KDE Software approach to Flatpak is still not ready. Nevertheless, it's being shaped up. If you're interested in helping, please send an e-mail to [mailto:[email protected] [email protected]].
 
The idea behind flatpak is that your applications will depend on a runtime. KDE provides a runtime with Qt and all KDE Frameworks 5 (except for the 4th tier) to make sure it's easily adaptable for any KDE Application and possibly most Qt-based applications as well.
 
This runtime can be added by following these instructions:
<syntaxhighlight lang="bash">
wget http://distribute.kde.org/kdeflatpak.asc
flatpak remote-add kde http://distribute.kde.org/flatpak-testing/ --gpg-import=kdeflatpak.asc
flatpak install kde org.kde.Platform
flatpak install kde org.kde.Sdk
</syntaxhighlight>
{{ Warning | Do NOT use this in production, it's work in progress and it doesn't enable important safety features. It might also eat your pet or first-born .}}
 
= Compile your application =
 
Now you get to compile your favorite application. If you want to see how it's done, you can see some of the ones that have already been built. You can find it [https://quickgit.kde.org/?p=scratch%2Fapol%2Fxdgapp-nightly-apps.git&a=tree here].
 
To compile an applications, you should create a json file similar to the ones in the previous link. Then you'd just need to trigger the build and get it into a repository. For testing, I recommend just creating a local one (to publish an rsync will be required).
 
<syntaxhighlight lang="bash">
mkdir app repo
flatpak-builder --ccache --require-changes --repo=repo --subject="Build of AWESOMEAPP `date`" app org.kde.AWESOMEAPP.json
</syntaxhighlight>
 
This will do everything required and create a repository in ./repo. To test the application we add the repository (called remotes), we install the application and then we run it:
<syntaxhighlight lang="bash">
flatpak remote-add awesomeapp repo --no-gpg-verify
flatpak install awesomeapp org.kde.AWESOMEAPP
flatpak run org.kde.AWESOMEAPP
</syntaxhighlight>
 
Now you will see that some things don't work and you'll have the privilege to start fixing things!
 
{{ Note | All flatpak commands (such as <code>remote-add</code> and <code>install</code>) accept a <code>--user</code> option to install things at the user level, without being prompted for the sudo password every time. }}
 
= Contribute! =
In the following repositories you'll find the code in charge of packaging the runtime (Qt 5 and KF5) and then several (but not all, yet) KDE Applications.
* Runtime: https://quickgit.kde.org/?p=flatpak-kde-runtime.git
* Applications: https://quickgit.kde.org/?p=flatpak-kde-applications.git

Latest revision as of 13:42, 6 January 2023

The development information of this page has been moved here.

The usage information of this page has been moved here.