GitHub

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

最后，它还将展示如何为 Linux Arm AppImages 设置更复杂的构建管道。

开始使用

要设置 tauri-action，你必须首先设置一个 GitHub 仓库。你也可以在一个尚未配置 Tauri 的仓库上使用此 Action，因为它可以为你自动初始化 Tauri，请参阅 Action 的自述文件以了解必要的配置选项。

转到你的 GitHub 项目页面上的 Actions 选项卡，选择”New workflow”，然后选择”Set up a workflow yourself”。将文件替换为下面的工作流程或 Action 的示例之一。

Arm 运行器编译

此工作流程使用 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/[email protected]
        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 }}

Support on Open Collective Sponsor on GitHub

GitHub

开始使用

配置

如何触发

示例工作流程

Arm 运行器编译

故障排除

GitHub 环境令牌