GitHub

本指南将向您展示如何在 GitHub Actions 中使用 tauri-action 来轻松构建并上传您的应用，以及如何使 Tauri 的更新程序查询新创建的 GitHub 发布版本以获取更新。

最后，它还将展示如何为 Linux Arm AppImage 设置一个更复杂的构建流水线。

入门指南

要设置 tauri-action，您必须首先设置一个 GitHub 仓库。您也可以在尚未配置 Tauri 的仓库上使用此操作，因为它能为您自动初始化 Tauri。请查看该操作的自述文件 (README) 以了解必要的配置选项。

转到 GitHub 项目页面上的“Actions”选项卡并选择“New workflow”，然后选择“Set up a workflow yourself”。将文件替换为下方的工作流程，或从该操作的示例中选择一个。

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: |
            # 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 令牌是由 GitHub 为每次工作流程运行自动颁发的，无需额外配置，这意味着不存在密钥泄露的风险。但是，此令牌默认仅具有读取权限，您在运行工作流程时可能会收到“Resource not accessible by integration”（集成无法访问资源）错误。如果发生这种情况，您可能需要向该令牌添加写入权限。要执行此操作，请转到您的 GitHub 项目设置，选择 Actions，向下滚动到 Workflow permissions，并选中“Read and write permissions”。

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

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

在 Open Collective 上支持在 GitHub 上赞助

GitHub

入门指南

配置

如何触发

工作流程示例

Arm Runner 编译

故障排除

GitHub 环境令牌