Flathub

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

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

准备工作

要在 Flatpak 运行时中测试您的应用，您可以先在本地构建 Flatpak，然后再将您的应用上传到 Flathub。如果您想快速共享开发版本，这也很有帮助。

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

3. 构建您的 tauri 应用的 .deb 文件

4. 创建 manifest 文件

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 manifest 文件中添加它们。有两种方法可以做到这一点。对于快速本地开发，简单地包含本地系统中已构建的库文件 (.so) 可能会起作用。但是，不建议在 flatpak 的最终构建中使用此方法，因为您的本地库文件不是为 flatpak 运行时环境构建的。这可能会引入各种难以发现的错误。因此，建议将您的程序依赖的库作为构建步骤从源代码在 flatpak 内部构建。

提交到 flathub

1. Fork Flathub 仓库

2. 克隆 Fork

git clone --branch=new-pr git@github.com:your_github_username/flathub.git

3. 进入仓库

cd flathub

4. 创建新分支

git checkout -b your_app_name

5. 将您的应用 manifest 文件添加到分支。提交您的更改，然后推送它们。

6. 在 github 上针对 new-pr 分支打开一个 pull request

7. 您的应用现在将进入审查流程，在此流程中您可能会被要求对您的项目进行更改。

当您的 pull request 获得批准后，您将收到编辑您的应用仓库的邀请。从这里开始，您可以持续更新您的应用。

您可以在 flatpak 文档中阅读更多相关信息

Flathub

准备工作

添加额外的库

提交到 flathub