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