HandBrake/HandBrake-docs
1
0
Fork 0
mirror of https://github.com/HandBrake/HandBrake-docs.git synced 2025-12-11 04:35:53 -06:00
Code Issues Packages Projects Releases 1 Wiki Activity

flatpak: add repository hosting notes

Browse Source
This commit is contained in:
John Stebbins 2018-07-01 13:53:23 -07:00
parent 687af2cb17
commit c318bdf012
No known key found for this signature in database
GPG Key ID: 49F1D7B260D4D0F7
1 changed files with 63 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

63
source/docs/en/latest/developer/flatpak-repo.markdown
View File

@ -85,3 +85,66 @@ List contents of the repo
Install the application (if you wish to test it)
flatpak --user install <repo-name> <app-name>
# Maintaining a separate OSTree repository
There are situations where you don't want to keep your repository on the same server as you built the flatpak on. Rather than exporting the entire repo-dir that is built by flatpak-builder, you can import your bundles into a seperate OSTree repository.
## Create a new empty repository
```
ostree init --mode=archive-z2 --reop=<repo-dir>
```
## Add flatpakrepo file to the repository
This file is used by flatpak clients to add your repoitory to their list of remotes.
Create a file named \<yourproject\>.flatpakrepo in \<repo-dir\>. The format looks like this:
```
[Flatpak Repo]
Title=Yourproject
Url=https://dl.yourproject.org:8080/repo/
Homepage=https://yourproject.org/
Comment=Repository of yourproject
Description=Repository of yourproject
Icon=https://dl.yourproject.org/repo/logo.svg
GPGKey=<base64 encoded raw public gpg>
```
Note that the port above is optional and defaults to 80. I use 8080 for test purposes.
To base64 encode the gpg signing key
```
gpg2 --export <key-id> > key.gpg
base64 --wrap=0 < key.gpg > key.base64
```
## Importing flatpak bundles into the repository
```
flatpak build-import-bundle --gpg-sign=<key-id> <repo-dir> <flatpak-bundle>
```
## Update repository summary information
```
flatpak build-update-repo --generate-static-deltas --gpg-sign=<key-id>
```
## Host your repository with a web server
For test purposes, I just use pythons builtin web server.
```
python3 -m http.server 8080 --directory <repo-dir>
```
Note, requires python 3.7 or above.
## Publish the location of \<yourproject\>.flatpakrepo
Users can add your repository to their list of remotes with:
```
flatpak remote-add --if-not-exists yourproject https://dl.yourproject.org:8080/repo/yourproject.flatpakrepo
```