Flathub
For detailed information on how Flatpak works, you can read Building your first Flatpak
This guide assumes you want to distribute your Flatpak via Flathub, the most commonly used platform for Flatpak distribution. If you plan on using other platforms, please consult their documentation instead.
Prerequisites
To test your app inside the Flatpak runtime you can build the Flatpak locally first before uploading your app to Flathub. This can also be helpful if you want to quickly share development builds.
1. Install flatpak
and flatpak-builder
To build Flatpaks locally you need the flatpak
and flatpak-builder
tools. For example on Ubuntu you can run this command:
2. Install the Flatpak Runtime
3. Build the .deb of your tauri-app
4. Create the manifest
The Gnome 46 runtime includes all dependencies of the standard Tauri app with their correct versions.
5. Install, and Test the app
Adding additional libraries
If your final binary requires more libraries than the default tauri app, you need to add them in your flatpak manifest.
There are two ways to do this. For fast local development, it may work to simply include the already built library file (.so
) from your local system.
However, this is not recommended for the final build of the flatpak, as your local library file is not built for the flatpak runtime environment.
This can introduce various bugs that can be very hard to find.
Therefore, it is recommended to build the library your program depends on from source inside the flatpak as a build step.
Submitting to flathub
1. Fork The Flathub Repository
2. Clone the Fork
3. Enter the repository
4. Create a new branch
5. Add your apps manifest to the branch. Commit your changes, and then push them.
6. Open a pull request against the new-pr
branch on github
7. Your app will now enter the review process in which you may be asked to make changes to your project.
When your pull request is approved then you will receive an invitation to edit your apps repository. From here on you can update your app continuously.
You can read more about this in the flatpak documentation
© 2024 Tauri Contributors. CC-BY / MIT