GitHub

本指南將說明如何在 GitHub Actions 中使用 tauri-action，以輕鬆建置和上傳您的應用程式，以及如何讓 Tauri 的更新器查詢新建立的 GitHub 發行版本以進行更新。

最後，它也將展示如何為 Linux Arm AppImages 設定更複雜的建置管線。

開始使用

若要設定 tauri-action，您必須先設定 GitHub 儲存庫。您也可以在尚未設定 Tauri 的儲存庫上使用此動作，因為它可以自動為您初始化 Tauri，請參閱 action 的 readme 以取得必要的設定選項。

前往 GitHub 專案頁面上的 Actions 標籤，然後選取「New workflow」，接著選擇「Set up a workflow yourself」。將檔案替換為來自下方或來自 action 範例之一的工作流程。

Arm Runner 編譯

此工作流程使用 pguyot/arm-runner-action 直接在模擬的 Arm runner 上編譯。這彌合了 AppImage 工具中缺少跨架構建置支援的差距。

name: 'Publish Linux Arm builds'

on:
  workflow_dispatch:
  push:
    branches:
      - release

jobs:
  build:
    runs-on: ubuntu-22.04

    strategy:
      matrix:
        arch: [aarch64, armv7l]
        include:
          - arch: aarch64
            cpu: cortex-a72
            base_image: https://dietpi.com/downloads/images/DietPi_RPi-ARMv8-Bookworm.img.xz
            deb: arm64
            rpm: aarch64
            appimage: aarch64
          - arch: armv7l
            cpu: cortex-a53
            deb: armhfp
            rpm: arm
            appimage: armhf
            base_image: https://dietpi.com/downloads/images/DietPi_RPi-ARMv7-Bookworm.img.xz

    steps:
      - uses: actions/checkout@v3

      - name: Cache rust build artifacts
        uses: Swatinem/rust-cache@v2
        with:
          workspaces: src-tauri
          cache-on-failure: true

      - name: Build app
        uses: pguyot/arm-runner-action@v2.6.5
        with:
          base_image: ${{ matrix.base_image }}
          cpu: ${{ matrix.cpu }}
          bind_mount_repository: true
          image_additional_mb: 10240
          optimize_image: no
          #exit_on_fail: no
          commands: |
            # Prevent Rust from complaining about $HOME not matching eid home
            export HOME=/root

            # Workaround to CI worker being stuck on Updating crates.io index
            export CARGO_REGISTRIES_CRATES_IO_PROTOCOL=sparse

            # Install setup prerequisites
            apt-get update -y --allow-releaseinfo-change
            apt-get autoremove -y
            apt-get install -y --no-install-recommends --no-install-suggests curl libwebkit2gtk-4.1-dev build-essential libssl-dev libgtk-3-dev libayatana-appindicator3-dev librsvg2-dev patchelf libfuse2 file
            curl https://sh.rustup.rs -sSf | sh -s -- -y
            . "$HOME/.cargo/env"
            curl -fsSL https://deb.nodesource.com/setup_lts.x | bash
            apt-get install -y nodejs

            # Install frontend dependencies
            npm install

            # Build the application
            npm run tauri build -- --verbose

      - name: Get app version
        run: echo "APP_VERSION=$(jq -r .version src-tauri/tauri.conf.json)" >> $GITHUB_ENV

      # TODO: Combine this with the basic workflow and upload the files to the Release.
      - name: Upload deb bundle
        uses: actions/upload-artifact@v3
        with:
          name: Debian Bundle
          path: ${{ github.workspace }}/src-tauri/target/release/bundle/deb/appname_${{ env.APP_VERSION }}_${{ matrix.deb }}.deb

      - name: Upload rpm bundle
        uses: actions/upload-artifact@v3
        with:
          name: RPM Bundle
          path: ${{ github.workspace }}/src-tauri/target/release/bundle/rpm/appname-${{ env.APP_VERSION }}-1.${{ matrix.rpm }}.rpm

      - name: Upload appimage bundle
        uses: actions/upload-artifact@v3
        with:
          name: AppImage Bundle
          path: ${{ github.workspace }}/src-tauri/target/release/bundle/appimage/appname_${{ env.APP_VERSION }}_${{ matrix.appimage }}.AppImage

GitHub Token 由 GitHub 自動為每個工作流程執行發行，無需進一步設定，這表示沒有洩漏密碼的風險。但是，此 Token 預設只有讀取權限，並且在執行工作流程時可能會收到「Resource not accessible by integration」錯誤。如果發生這種情況，您可能需要為此 Token 新增寫入權限。若要執行此操作，請前往您的 GitHub 專案設定，選取 Actions，向下捲動至 Workflow permissions，然後勾選「Read and write permissions」。

您可以在工作流程中透過此行看到 GitHub Token 傳遞到工作流程

env:
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

GitHub

開始使用

設定

如何觸發

範例工作流程

Arm Runner 編譯

疑難排解

GitHub 環境 Token