Flathub
有关 Flatpak 的工作原理的详细信息,您可以阅读构建第一个 Flatpak
本指南假设您希望通过 Flathub 分发您的 Flatpak,这是 Flatpak 分发最常用的平台。如果您计划使用其他平台,请参阅它们的文档。
先决条件
要测试 Flatpak 运行时内的应用程序,您可以在将应用程序上传到 Flathub 之前首先本地构建 Flatpak。这也有助于您快速共享开发版本。
1. 安装 flatpak
和 flatpak-builder
要本地构建 Flatpak,您需要 flatpak
和 flatpak-builder
工具。例如,在 Ubuntu 上,您可以运行以下命令
sudo apt install flatpak flatpak-builder
sudo pacman -S --needed flatpak flatpak-builder
sudo dnf install flatpak flatpak-builder
sudo emerge --ask \sys-apps/flatpak \dev-util/flatpak-builder
2. 安装 Flatpak 运行时
flatpak install flathub org.gnome.Platform//46 org.gnome.Sdk//46
4. 创建清单文件
id: org.your.id
runtime: org.gnome.Platformruntime-version: '46'sdk: org.gnome.Sdk
command: tauri-appfinish-args: - --socket=wayland # Permission needed to show the window - --socket=fallback-x11 # Permission needed to show the window - --device=dri # OpenGL, not necessary for all projects - --share=ipc
modules: - name: binary buildsystem: simple sources: - type: file url: https://github.com/your_username/your_repository/releases/download/v1.0.1/yourapp_1.0.1_amd64.deb sha256: 08305b5521e2cf0622e084f2b8f7f31f8a989fc7f407a7050fa3649facd61469 # This is required if you are using a remote source only-arches: [x86_64] #This source is only used on x86_64 Computers # This path points to the binary file which was created in the .deb bundle. # Tauri also creates a folder which corresponds to the content of the unpacked .deb. build-commands: - ar -x *.deb - tar -xf data.tar.gz - 'install -Dm755 usr/bin/tauri-app /app/bin/tauri-app' - install -Dm644 usr/share/applications/yourapp.desktop /app/share/applications/org.your.id.desktop - install -Dm644 usr/share/icons/hicolor/128x128/apps/yourapp.png /app/share/icons/hicolor/128x128/apps/org.your.id.png - install -Dm644 usr/share/icons/hicolor/32x32/apps/yourapp.png /app/share/icons/hicolor/32x32/apps/org.your.id.png - install -Dm644 usr/share/icons/hicolor/256x256@2/apps/yourapp.png /app/share/icons/hicolor/256x256@2/apps/org.your.id.png - install -Dm644 org.your.id.metainfo.xml /app/share/metainfo/org.your.id.rosary.metainfo.xml
Gnome 46 运行时包含标准 Tauri 应用程序的 所有依赖项及其正确版本。
5. 安装和测试应用程序
# Install the flatpakflatpak -y --user install <local repo name> <your flatpak id>
# Run itflatpak run <your flatpak id>
# Update itflatpak -y --user update <your flatpak id>
添加额外库
如果您的最终二进制文件比默认的 tauri 应用程序需要更多的库,您需要在您的 flatpak 清单中添加它们。有两种做法。对于快速本地开发,可能只需简单地将本地系统中已经构建的库文件(.so
)包括在内即可。然而,这不建议用于最终构建的 flatpak,因为您的本地库文件不是为 flatpak 运行时环境构建的。这可能会引入各种难以发现的错误。因此,建议在 flatpak 内部将其程序所依赖的库从源代码构建,作为构建步骤。
提交到 Flathub
1. forkFlathub 仓库
2. 克隆 fork
3. 进入仓库
cd flathub
4. 创建新分支
git checkout -b your_app_name
5. 将您的应用程序清单添加到分支。提交您的更改,然后推送。
6. 在 github 上对 new-pr
分支发起拉取请求
7. 您的应用程序现在将进入审核过程,您可能需要修改您的项目。
当您的拉取请求被批准时,您将收到邀请编辑您应用程序仓库。从现在开始,您可以连续更新您的应用程序。
您可以在 Flatpak 文档中了解更多
© 2025 Tauri 贡献者. CC-BY / MIT