CrossDesk Linux 构建镜像
这个目录维护 CrossDesk 专用的 Ubuntu 20.04 兼容构建环境。镜像包含 GCC 10、
CMake 3.31、xmake、Rust、Linux 开发库（包括 D-Bus、DRM，以及仅用于编译的
PipeWire 0.3/SPA 头文件 SDK）以及根据项目
xmake.lua 提前编译好的依赖。
Xmake 最低支持 3.1.1，与移动端一致，构建环境校验允许更新版本。发布镜像的工具链 tag 记录实际安装的版本；默认使用最低支持版本验证构建。
常规应用构建目前复用已发布的 xmake3.0.9 工具链镜像，并在容器启动后检查
Xmake 版本：缺失或低于 3.1.1 时安装或升级，达标时保留现有版本，随后再次校验。
Linux、macOS 和 Windows 桌面构建共用 .github/actions/ensure-xmake；Linux 还会
执行仓库中的 verify-build-image.sh 校验环境。这样既保留预编译
依赖缓存，也不依赖尚未发布的 xmake3.1.1 镜像。切换镜像 tag 前必须确认
amd64 和 arm64 变体均已发布。
发布方式
推送影响镜像的文件到 ci/linux-build-image 分支时，
build-linux-image.yml 会在 GitHub 原生 amd64/arm64 runner 上分别构建和验证，
全部通过后再合并为同一个 multi-arch 镜像：
crossdesk/ubuntu20.04:buildenv-cuda12.6.3-gcc10-cmake3.31.6-pipewire0.3.48-xmake3.1.1-rust1.92.0
Docker 会根据运行机器自动选择正确架构。amd64 变体以
nvidia/cuda:12.6.3-devel-ubuntu20.04 为基础；arm64 变体不包含当前构建
用不到的 CUDA SDK。两个变体都使用 Ubuntu 20.04/glibc 2.31，因此生成的
普通版和 Xfce 虚拟桌面版安装包均可运行在 Ubuntu 20.04 及更高版本。
Ubuntu 20.04 仓库只提供 PipeWire 0.2。镜像通过
install-pipewire-sdk.sh 安装固定版本的 PipeWire 0.3.48/SPA 头文件，但不
安装或打包 PipeWire 动态库。CrossDesk 在运行时通过 dlopen() 使用宿主系统
提供的 PipeWire 0.3：Ubuntu 20.04 没有该运行库时仍可使用 X11（以及构建时
启用的 DRM），Ubuntu 22.04 及更高版本则可使用 Wayland 捕获。
每次成功发布还会生成 sha-<完整提交 SHA>，用于精确回滚；latest 和上面的
工具链版本 tag 只会在两个架构都验证成功后更新。
GitHub 配置
在仓库的 Actions secrets 中配置：
DOCKERHUB_USERNAME：有权推送crossdesk/ubuntu20.04的 Docker Hub 用户名DOCKERHUB_TOKEN：该用户的 Docker Hub access token
工作流文件进入默认分支后，也可以从 Actions 页面手动运行。为了避免首次发布
新 tag 时应用构建先于镜像完成，常规 build.yml 不响应
ci/linux-build-image 分支的 push。第一次启用时，应先推送该分支并等待镜像
发布成功，再把应用构建工作流的修改合并到 main。
更新依赖
修改 Dockerfile、xmake 清单、本地包配方或子模块中的包配方后，推送该分支即可。
升级工具链时应先修改 Dockerfile 的版本参数和镜像工作流中的 STACK_TAG，
等两个架构的镜像发布成功后，再修改常规构建工作流引用的镜像 tag。