跳转到内容

Flathub

有关 Flatpak 的工作原理的详细信息,您可以阅读构建第一个 Flatpak

本指南假设您希望通过 Flathub 分发您的 Flatpak,这是 Flatpak 分发最常用的平台。如果您计划使用其他平台,请参阅它们的文档。

先决条件

要测试 Flatpak 运行时内的应用程序,您可以在将应用程序上传到 Flathub 之前首先本地构建 Flatpak。这也有助于您快速共享开发版本。

1. 安装 flatpakflatpak-builder

要本地构建 Flatpak,您需要 flatpakflatpak-builder 工具。例如,在 Ubuntu 上,您可以运行以下命令

终端窗口
sudo apt install flatpak flatpak-builder

2. 安装 Flatpak 运行时

终端窗口
flatpak install flathub org.gnome.Platform//46 org.gnome.Sdk//46

3. 构建您的 tauri-app 的 .deb 文件

4. 创建清单文件

id: org.your.id
runtime: org.gnome.Platform
runtime-version: '46'
sdk: org.gnome.Sdk
command: tauri-app
finish-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 flatpak
flatpak -y --user install <local repo name> <your flatpak id>
# Run it
flatpak run <your flatpak id>
# Update it
flatpak -y --user update <your flatpak id>

添加额外库

如果您的最终二进制文件比默认的 tauri 应用程序需要更多的库,您需要在您的 flatpak 清单中添加它们。有两种做法。对于快速本地开发,可能只需简单地将本地系统中已经构建的库文件(.so)包括在内即可。然而,这不建议用于最终构建的 flatpak,因为您的本地库文件不是为 flatpak 运行时环境构建的。这可能会引入各种难以发现的错误。因此,建议在 flatpak 内部将其程序所依赖的库从源代码构建,作为构建步骤。

提交到 Flathub

1. forkFlathub 仓库

2. 克隆 fork

终端窗口
git clone --branch=new-pr [email protected]:your_github_username/flathub.git

3. 进入仓库

终端窗口
cd flathub

4. 创建新分支

终端窗口
git checkout -b your_app_name

5. 将您的应用程序清单添加到分支。提交您的更改,然后推送。

6. 在 github 上对 new-pr 分支发起拉取请求

7. 您的应用程序现在将进入审核过程,您可能需要修改您的项目。

当您的拉取请求被批准时,您将收到邀请编辑您应用程序仓库。从现在开始,您可以连续更新您的应用程序。

您可以在 Flatpak 文档中了解更多


© 2025 Tauri 贡献者. CC-BY / MIT