Tauri 开发实践 — 使用 CI/CD 自动构建发布 Tauri 桌面端应用

简介: 本文介绍如何使用 CI/CD 自动构建发布 Tauri 应用。Tauri 是一个轻量级跨平台客户端框架,适合个人应用。文章首先概述了 CI/CD 的基本流程,并介绍了 GitHub Actions、GitLab CI 和 Jenkins 三种工具。最终选择了 GitHub Actions 进行配置。文中详细展示了使用 GitHub Actions 脚本实现 Tauri 应用构建的过程,并解决了权限和安全问题。项目源码可在 GitHub 上获取。

本文首发微信公众号:前端徐徐。

大家好我是徐徐。今天主题是如何使用 CI/CD  自动构建发布 Tauri 应用。

前言

Tauri 是一个跨平台的客户端框架,体积小而且很精悍,如果做个人应用,再合适不过了。不过要想丝滑的发布自己的应用,还需要想想办法,不可能每次发布都依赖自己的本地环境去做打包发布变更,主要原因是你很难做到同时拥有多种操作系统的设备。为了解决这个问题,最近研究了一下如何用 CI/CD 去打包构建和发布 Tauri 应用,让这种桌面客户端的发布如 Web 端的发布一样简单流畅。

CI/CD 流程概述

这里先简单概述一下 CI/CD 的流程,因为有的小伙伴不一定知道 CI/CD 。

上图是一个最简单的CI / CD的流程图,大概逻辑就是开发者提交代码之后版本控制系统(如 Git)触发CI / CD流程,通过代码检出,构建应用等关键动作自动化完成整个发布。当然在一些工程化的体系中还可能加很多其他节点,比如代码分析,各种测试(单元测试、集成测试、性能测试等),发布卡点设计,发布通知等,不过我们这里只实现最核心的流程节点。

选择 CI/CD 工具

上面讲到了 CI/CD 的基本流程,我们现在需要了解几个常见的 CI/CD 工具,然后根据自己的场景去选择合适的工具完成相应的工作,下面几个常见的工具可供大家选择。

GitHub Actions

  • 与GitHub仓库紧密集成
  • 配置简单,使用YAML文件
  • 免费计划对开源项目很慷慨
  • 支持多种操作系统,适合跨平台应用构建
  • 缺点:
  • 私有仓库的免费额度有限
  • 与GitHub绑定,不适合使用其他代码托管平台的项目

GitLab CI

  • 与GitLab平台无缝集成
  • 提供完整的DevOps生命周期工具
  • 可以自托管,也有云服务选项
  • 配置灵活,使用YAML文件
  • 缺点:
  • 学习曲线可能比GitHub Actions稍陡
  • 自托管时需要管理自己的运行器

Jenkins

  • 高度可定制,插件生态系统丰富
  • 可以处理复杂的构建和部署流程
  • 支持各种版本控制系统和构建工具
  • 完全自托管,适合对数据安全性要求高的场景
  • 缺点:
  • 设置和维护相对复杂
  • 需要自己管理服务器和资源
  • 用户界面相对陈旧

三个工具我都用过,用得最多的是 GitHub Actions,其余两个有会在工作中用到,企业级的应用基本都会用到Gitlab CI 或者 Jenkins。如果是个人应用或者开源项目,可以无脑选择 GitHub Actions,免费好用,支持的环境多样,而且配置门槛低,所以我选择 GitHub Actions。

为 Tauri 应用配置 CI/CD

在进行配置前,我们需要梳理一下整个构建的动作,这里的构建动作就跟我们本地开发一样,但是更加细致化一些,大概的流程如下。

上面提到的步骤,我们需要用 GitHub Actions 的脚本来实现,下面我们就来看看具体的实现。

name: Build and release
on:
  push:
    branches: [feature-testci]
  workflow_dispatch:
jobs:
  release:
    permissions:
      contents: write
      actions: write
      attestations: write
      deployments: write
      packages: write
      id-token: write
    strategy:
      fail-fast: false
      matrix:
        platform: [macos-latest, windows-latest]
    runs-on: ${{ matrix.platform }}
    steps:
      # 检出存储库
      - name: Checkout repository
        uses: actions/checkout@v4
      # 设置 rust 环境
      - name: Rust setup
        uses: dtolnay/rust-toolchain@stable
      # rust 缓存
      - name: Rust cache
        uses: swatinem/rust-cache@v2
        with:
          workspaces: './src-tauri -> target'
      
      # 设置 node 环境
      - name: Sync node version and setup cache
        uses: actions/setup-node@v4
        with:
          node-version: 'lts/*'
      # 全局安装pnpm
      - name: Install pnpm
        run: npm install -g pnpm
      
      # 安装前端依赖
      - name: Install frontend dependencies
        run: pnpm install
      # 构建应用
      - name: Build the app
        uses: tauri-apps/tauri-action@v0
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        with:
          tagName: ${{ github.ref_name }}
          releaseName: 'XTools v__VERSION__'
          releaseBody: 'See the assets to download and install this version.'
          releaseDraft: true
          prerelease: false

我大概解释一下整个脚本的意思。

  • 名称和触发条件
name: Build and release
on:
  push:
    branches: [feature-testci]
  workflow_dispatch:

这个工作流的名称是 "Build and release"。它会在两种情况下触发:

  • 当推送的分支为 feature-testci 时
  • 通过手动触发(workflow_dispatch)
  • 作业定义
jobs:
  release:
    permissions:
      contents: write
      actions: write
      attestations: write
      deployments: write
      packages: write
      id-token: write
    strategy:
      fail-fast: false
      matrix:
        platform: [macos-latest, windows-latest]
    runs-on: ${{ matrix.platform }}

定义了一个名为 "release" 的作业。权限有6个写的权限,使用矩阵策略在 macOS 和 Windows 最新版本上运行。

  • 步骤:
  • 检出仓库:使用 actions/checkout@v4 action 来获取代码。
  • 设置 Rust 环境:使用 dtolnay/rust-toolchain@stable 来设置稳定版的Rust。
  • Rust 缓存:使用 swatinem/rust-cache@v2 来缓存Rust依赖,加速后续构建。
  • 设置 Node环境:使用 actions/setup-node@v4 来设置最新的LTS版本Node.js。
  • 安装 pnpm:全局安装pnpm包管理器。
  • 安装前端依赖:使用 pnpm安装项目的前端依赖。
  • 构建应用:使用 tauri-apps/tauri-action@v0 来构建Tauri应用。这一步也负责创建GitHub release,上传构建的应用作为release资产。
  • 发布配置:
env:
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
with:
  tagName: ${{ github.ref_name }}
  releaseName: 'XTools v__VERSION__'
  releaseBody: 'See the assets to download and install this version.'
  releaseDraft: true
  prerelease: false

这部分配置了发布的详细信息,包括使用的 GitHub 令牌、标签名、发布名称、发布说明等,这里用作测试,创建一个草稿版本,不是预发布版本。

如果一切顺利的话,当你push feature-testci 这个分支的时候会出现如下两张图:

一张图是Action的构建过程,两个平台都构建完成了;一张图是生成的安装包,两个平台的包都有了。

常见问题

权限问题

其实这个里面有的时候会遇到一些问题,最主要的问题是权限的问题。GitHub 环境令牌,此令牌默认只有读取权限,在运行工作流时你可能会收到“Resource not accessible by integration”错误。

这个需要在设置里面配置相应的权限,在Action—General的最下方

生成应用的安全问题

CI/CD 生成的开源包一般都会被阻止打开,所以Windows 直接仍要运行就行,Mac 去隐私设置里面尝试再打开软件就可以,原因是没有证书签名的软件都会被拦截。

项目源码地址

https://github.com/Xutaotaotao/XTools/tree/feature-testci

结语

CI/CD 在前端开发中非常重要,本文简单的讲述了使用 CI/CD 自动构建发布 Tauri 桌面端应用的全过程,通过自动化的发布不仅能大大提高我们的发布效率,还能保证不同平台的一致性,如果是个人开发者或者开源项目,非常适合使用这种方式发布。

相关文章
|
2月前
|
JavaScript 前端开发 持续交付
Prettier 高级应用:集成 CI/CD 流水线与插件开发
【10月更文挑战第18天】Prettier 是一款流行的代码格式化工具,它能够自动将代码格式化成一致的风格,从而提高代码的可读性和维护性。对于希望进一步发挥 Prettier 潜力的高级用户而言,将 Prettier 集成到持续集成(CI)和持续部署(CD)流程中,确保每次提交的代码都符合团队标准,是非常重要的。此外,通过开发自定义插件来支持更多语言或扩展 Prettier 的功能也是值得探索的方向。本文将详细介绍这两方面的内容。
55 2
|
7月前
|
测试技术 持续交付 开发工具
《Git 简易速速上手小册》第6章:Git 在持续集成/持续部署(CI/CD)中的应用(2024 最新版)
《Git 简易速速上手小册》第6章:Git 在持续集成/持续部署(CI/CD)中的应用(2024 最新版)
127 2
|
2月前
|
JavaScript API 开发工具
使用GitHub Actions自动发布electron多端安装程序
使用GitHub Actions自动发布electron多端安装程序
56 8
|
2月前
|
Rust 前端开发 iOS开发
Tauri 开发实践— Tauri 工程搭建
本文首发于微信公众号“前端徐徐”,介绍了在 macOS 环境下使用 Rust 和 Tauri 构建跨平台桌面应用的过程。首先需安装 Rust 及系统依赖,参考链接:[Rust 入门](https://www.rust-lang.org/zh-CN/learn/get-started) 和 [Tauri 前置条件](https://tauri.app/zh-cn/v1/guides/getting-started/prerequisites)。
58 0
Tauri 开发实践— Tauri 工程搭建
|
4月前
|
JavaScript IDE 前端开发
前端开发工具配置 nodejs & git & IDE
前端开发工具配置 nodejs & git & IDE
|
Web App开发 前端开发 JavaScript
用electron打包前端应用初体验
用electron打包开发桌面应用遇到的各种问题和解决办法
224 1
Qt-做一个快速打包插件(一键完成项目软件打包)
Qt-做一个快速打包插件(一键完成项目软件打包)
133 0
|
测试技术 Shell 持续交付
提升开发效率之利用GitLab CI/CD打包Android项目
提升开发效率之利用GitLab CI/CD打包Android项目
|
IDE 测试技术 开发工具
软件测试|Github基础命令与 IDE 的 Git 集成
软件测试|Github基础命令与 IDE 的 Git 集成
软件测试|Github基础命令与 IDE 的 Git 集成
|
jenkins Java Devops
Window安装构建神器Jenkins
Window安装构建神器Jenkins
150 0
Window安装构建神器Jenkins

热门文章

最新文章