ivangabriele/tauri Docker 镜像 - 轩辕镜像

Tauri Docker Image

基于Rust非精简Debian镜像的全功能Tauri Docker镜像，包含以下组件：

• Tauri
• Node.js（附带Yarn）
• Tarpaulin
• tauri-driver *（附带WebDriver/WebDriverIO）
• psmisc（包含fuser）

[!WARNING]
(*) tauri-driver目前处于pre-alpha阶段
更多信息请查看官方文档。

该镜像适合作为CI（构建、单元测试、E2E测试等）的基础环境，也可用于本地运行。

镜像每日自动更新。

• 支持的标签及对应的Dockerfile链接
  • Debian v12（"bookworm"）
  • Debian v11（"bullseye"）
  • Fedora v40
  • 旧版标签
• E2E测试
  • WebDriverIO
• 持续集成
  • Github Actions
• 路线图
• 贡献
  • 前提条件
  • 构建
  • 运行
  • 测试

支持的标签及对应的Dockerfile链接

Debian v12（"bookworm"）

[!NOTE]
这些标签同时支持Tauri v1和v2。目前仍在测试其与Tauri v2的兼容性。

• debian-bookworm-22
  • 基础镜像：rust:1-bookworm
  • 包含：Debian v12（"bookworm"）+ Rust v1 + Node v22
• debian-bookworm-22-nightly
  • 基础镜像：rust:1-bookworm
  • 包含：Debian v12（"bookworm"）+ Rust v1（nightly）+ Node v22
• debian-bookworm-20
  • 基础镜像：rust:1-bookworm
  • 包含：Debian v12（"bookworm"）+ Rust v1 + Node v20
• debian-bookworm-20-nightly
  • 基础镜像：rust:1-bookworm
  • 包含：Debian v12（"bookworm"）+ Rust v1（nightly）+ Node v20

Debian v11（"bullseye"）

[!IMPORTANT]
这些标签仅支持Tauri v1。详见tauri-apps/tauri#9039。

• debian-bullseye-22
  • 基础镜像：rust:1-bullseye
  • 包含：Debian v11（"bullseye"）+ Rust v1 + Node v22
• debian-bullseye-22-nightly
  • 基础镜像：rust:1-bullseye
  • 包含：Debian v11（"bullseye"）+ Rust v1（nightly）+ Node v22
• debian-bullseye-20
  • 基础镜像：rust:1-bullseye
  • 包含：Debian v11（"bullseye"）+ Rust v1 + Node v20
• debian-bullseye-20-nightly
  • 基础镜像：rust:1-bullseye
  • 包含：Debian v11（"bullseye"）+ Rust v1（nightly）+ Node v20

Fedora v40

[!NOTE]
这些标签仅支持Tauri v2。目前仍在测试中。

• fedora-40
  • 基础镜像：fedora:40
  • 包含：Debian v12（"bookworm"）+ Rust v1 + Node v22
• fedora-40-nightly
  • 基础镜像：fedora:40
  • 包含：Debian v12（"bookworm"）+ Rust v1（nightly）+ Node v22
• fedora-40
  • 基础镜像：fedora:40
  • 包含：Debian v12（"bookworm"）+ Rust v1 + Node v20
• fedora-40-nightly
  • 基础镜像：fedora:40
  • 包含：Debian v12（"bookworm"）+ Rust v1（nightly）+ Node v20

旧版标签

这些标签仍然存在，但镜像不再更新。

• debian-bookworm-18
• debian-bookworm-18-nightly
• debian-bullseye-18
• debian-bullseye-18-nightly
• fedora-37-20
• fedora-37-20-nightly
• fedora-37-18
• fedora-37-18-nightly

E2E测试

WebDriverIO

由于tauri-driver在该镜像中作为全局命令可用，您可以直接在wdio.config.js中使用（参见文档）：

js
// ...

const config = {
  // ...

  beforeSession: () => {
    // => 无需这样：`path.resolve(os.homedir(), '.cargo', 'bin', 'tauri-driver')`
    tauriDriver = spawn("tauri-driver", [], {
      stdio: [null, process.stdout, process.stderr],
    });
  },

  // ...
};

// ...

持续集成

Github Actions

示例：

yml
jobs:
  core_unit_test:
    name: 核心单元测试
    runs-on: ubuntu-latest
    container:
      image: ivangabriele/tauri:debian-bullseye-18
      # 如果使用`tarpaulin`，这是必需的
      # [***]
      # [***]
      options: --security-opt seccomp=unconfined
    steps:
      - name: 检出代码
        uses: actions/checkout@v3
      - name: 运行测试
        run: cargo test
        working-directory: ./src-tauri
      # [***]
      - name: 生成覆盖率报告
        run: cargo tarpaulin --all-features --out Xml --timeout 120 --verbose
        working-directory: ./src-tauri
      # 在此处添加上传覆盖率报告的步骤

  e2e_test:
    name: E2E测试
    runs-on: ubuntu-latest
    container:
      image: ivangabriele/tauri:debian-bullseye-18
    steps:
      - name: 检出代码
        uses: actions/checkout@v3
      - name: 安装Node.js依赖
        run: yarn --frozen-lockfile # 或 `npm ci`
      - name: 构建
        # 添加核心和WebView的构建命令
        run: ...
      # 建议在此处使用`nick-fields/retry@v2` action
      # 配合`fuser -n tcp -k 4445`命令杀死占用端口的进程（可能是Selenium）
      # 因为WebdriverIO在首次运行时经常挂起（无法连接）
      - name: 运行测试
        uses: nick-fields/retry@v2
        with:
          timeout_seconds: 600
          max_attempts: 3
          retry_on: error
          # [***]
          command: |
            fuser -n tcp -k 4445
            xvfb-run wdio run ./configs/wdio.config.js

路线图

除Ubuntu外，以下计划的发行版目前均为可能的选项。

• Arch
• Fedora 38
• NixOS
• openSUSE
• Ubuntu 22

贡献

X是操作系统名称+版本（debian-bookworm、debian-bullseye、fedora-37之一）。
y是Node.js标签（18、20之一）。
Z是Rust变体（-nightly或空）。

前提条件

• Docker（Desktop 或 Engine）
• Node.js（如果要运行测试）

构建

sh
DOCKER_IMAGE_TAG=[DOCKER_TAG] make build

示例：DOCKER_IMAGE_TAG=debian-bullseye-18 make build

运行

sh
DOCKER_IMAGE_TAG=[DOCKER_TAG] make run

示例：DOCKER_IMAGE_TAG=debian-bullseye-18 make run

测试

运行测试需要安装Node.js：

sh
DOCKER_IMAGE_TAG=[DOCKER_TAG] make test

示例：DOCKER_IMAGE_TAG=debian-bullseye-18 make test。