GitHub

本教程将向您展示如何在 GitHub Actions 中使用 tauri-action 来轻松构建和上传您的应用程序，以及如何使 Tauri 的 updater 插件通过 GitHub Releases 获取更新。

本文还将展示如何为 Linux Arm AppImage 设置更复杂的构建工作流。

开始

要设置 tauri-action，您必须首先设置一个 GitHub 仓库。您也可以在尚未配置 Tauri 的仓库中使用此操作，因为它可以自动为您初始化 Tauri，具体配置选项请参见 action 的自述文件。

进入您的 GitHub 项目页面的 Actions 选项卡，选择“New workflow”，然后选择“Set up a workflow yourself”。用下面的工作流或 action 的示例中的一个替换该文件。

使用 Arm Runner 编译

此工作流使用 pguyot/arm-runner-action 在模拟的 Arm 运行器上直接编译。这弥补了 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_RPi5-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: |
            # 防止 Rust 抱怨 $HOME 与 eid home 不匹配
            export HOME=/root

            # 解决 CI 工作节点卡在更新 crates.io 索引的问题
            export CARGO_REGISTRIES_CRATES_IO_PROTOCOL=sparse

            # 安装设置先决条件
            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

            # 安装前端依赖
            npm install

            # 构建应用程序
            npm run tauri build -- --verbose

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

      # TODO: 将此与基本工作流结合并上传文件到 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 会为每次工作流运行自动签发 GitHub 令牌，无需进一步配置，这意味着没有机密泄露的风险。然而，此令牌默认情况下仅具有读取权限，在运行工作流时，您可能会遇到 “Resource not accessible by integration” 错误。如果发生这种情况，您可能需要为此令牌添加写入权限。为此，请转到您的 GitHub 项目设置，选择 Actions，向下滚动到 Workflow permissions，并勾选 “Read and write permissions”。

您可以通过工作流中的这一行看到传递给工作流的 GitHub 令牌：

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

Support on Open Collective Sponsor on GitHub

GitHub

开始

配置

配置触发器

示例工作流

使用 Arm Runner 编译

故障排除

GitHub 环境令牌