RustDesk 如何用 AppImageBuilder 构建 Linux AppImage 版本【免费下载链接】rustdeskAn open-source remote desktop application designed for self-hosting, as an alternative to TeamViewer.项目地址: https://gitcode.com/GitHub_Trending/ru/rustdesk如果你已经构建好了 RustDesk 的 Linux deb 包想再产出一个免安装、可直接运行的 AppImage 分发包RustDesk 仓库自带了完整的构建路径appimage/目录下有两份 appimage-builder 配方文件 AppImageBuilder-x86_64.yml 与 AppImageBuilder-aarch64.yml官方 CI.github/workflows/flutter-build.yml中的build-appimage任务就是按这套配方执行的。本文按 CI 的实际流程说明如何在一个 Ubuntu 22.04 环境中把rustdesk-VERSION-arch.deb构建成对应的 AppImage其中VERSION和arch替换为你手上 deb 文件对应的版本号与架构x86_64或aarch64。准备输入deb 包与图标资源AppImageBuilder 的配方不直接编译 RustDesk它的输入是一个现成的 deb 包配方里的script段会做这些事见 AppImageBuilder-x86_64.ymlscript: - rm -rf ./AppDir || true - bsdtar -zxvf rustdesk.deb - tar -xvf ./data.tar.xz - mkdir ./AppDir - mv ./usr ./AppDir/usr # 32x32 icon - for i in {32,64,128}; do mkdir -p ./AppDir/usr/share/icons/hicolor/$i\x$i/apps/; cp ../res/$i\x$i.png ./AppDir/usr/share/icons/hicolor/$i\x$i/apps/rustdesk.png; done - mkdir -p ./AppDir/usr/share/icons/hicolor/scalable/apps/; cp ../res/scalable.svg ./AppDir/usr/share/icons/hicolor/scalable/apps/rustdesk.svg - rm -rf ./AppDir/usr/share/applications因此执行前需要满足三个条件当前目录下有rustdesk.deb。官方 CI 的做法是把 Linux 构建任务产出的 deb 改名放入appimage/目录mv rustdesk-VERSION-arch.deb appimage/rustdesk.debdeb 的架构必须与配方匹配x86_64 的 deb 配 x86_64 配方aarch64 同理能访问仓库根目录的res/资源脚本里用了相对路径../res/...所以要从仓库的appimage/目录内运行构建CI 正是用pushd appimage进入该目录。仓库中res/32x32.png、res/64x64.png、res/128x128.png与res/scalable.svg均已存在deb 的产物路径符合配方中app_info.exec: usr/share/rustdesk/rustdesk的约定仓库内 deb 的打包逻辑见 build.py。另外注意配方app_info中的version: 1.5.0是写入 AppImage 元数据的版本字段仓库用 res/bump.sh 对appimage/*yml等文件做批量替换来升级该值。安装构建工具按 CI 的Build appimage package步骤在 Ubuntu 22.04 上安装依赖。以下命令需要 root 权限sudo会修改系统包和 Python 环境# 配方 script 段用 bsdtar 解开 deblibfuse2 用于 AppImage 挂载所需的 FUSE sudo apt-get update -y sudo apt-get install -y libarchive-tools libfuse2 # CI 在从 git 安装 appimage-builder 前先固定 setuptools_scm 版本 sudo pip3 install setuptools_scm10 sudo pip3 install githttps://github.com/rustdesk-org/appimage-builder.git这里安装的是 RustDesk 维护的 appimage-builder forkrustdesk-org/appimage-builder与 CI 保持一致不要换成上游包。阅读配方两个架构的差异两份配方结构相同差异集中在架构相关字段修改或核对配方时对照这几处即可字段AppImageBuilder-x86_64.ymlAppImageBuilder-aarch64.ymlapt.archamd64arm64apt.sourceshttp://archive.ubuntu.com/ubuntu/的 focal20.04各组件仓库http://ports.ubuntu.com/ubuntu-ports/的 focal 仓库带[archarm64]与key_url从 keyserver 拉取签名密钥apt.includelibc6:amd64及 GTK3、libxdo3、libva、gstreamer/pipewire、wayland、pulseaudio 等运行时库libc6:arm64及同一组运行时库runtime.env中的路径x86_64-linux-gnu系列的库搜索路径APPDIR_LIBRARY_PATH、GIO_MODULE_DIR、GST_PLUGIN_PATH等aarch64-linux-gnu系列路径AppImage.archx86_64aarch64runtime.env段值得留意的两处注释是仓库原文的说明GDK_BACKEND: x11AppImage 内固定使用 X11 后端XDG_DATA_DIRS/XDG_CONFIG_DIRSAppRun 会把这两个变量设为$APPDIR/...:$XDG_DATA_DIRS从而屏蔽 XDG 默认值在 gdk-pixbuf 2.43 的发行版Arch、Fedora上会导致找不到 glycin 加载器、所有 PNG 解码失败应用会在第一次绘制远程光标时中止。配方把宿主值放在末尾保证/usr/share、/etc/xdg等默认目录仍然生效x86_64 配方还注明由于APPDIR_LIBRARY_PATH优先使用系统库apt.include里捆绑的libc6实际不会被使用注释提到若 gstreamer 崩溃可尝试LD_PRELOAD指向$APPDIR/usr/lib/x86_64-linux-gnu/libc.so.6。apt.exclude排除了humanity-icon-theme、hicolor-icon-theme、adwaita-icon-theme、ubuntu-monofiles.exclude排除了 man 页和 doc 目录下的 README/changelog 等文件用于控制产物体积。执行构建进入appimage/目录并运行配方以 x86_64 为例aarch64 换成对应配方文件pushd appimage sudo appimage-builder --skip-tests --recipe ./AppImageBuilder-x86_64.yml说明官方 CI 使用sudo运行FUSE 挂载权限相关并带--skip-tests跳过配方末尾的test段不带该参数时builder 会先执行配方中的测试任务这一步会在当前目录生成AppDir中间产物并最终产出 AppImage。验证产物仓库文档给出的核对方式有两层产物文件CI 发布步骤上传的路径是./appimage/rustdesk-VERSION-*.AppImage见 flutter-build.yml本地构建后按同样规律在appimage/目录下确认生成了带版本号与架构的rustdesk-VERSION-*.AppImage文件配方内置测试两份配方的test段定义了五组容器化验证环境每组都在appimagecrafters/tests-env镜像中执行./AppRuntest: fedora-30: image: appimagecrafters/tests-env:fedora-30 command: ./AppRun debian-stable: image: appimagecrafters/tests-env:debian-stable command: ./AppRun archlinux-latest: image: appimagecrafters/tests-env:archlinux-latest command: ./AppRun centos-7: image: appimagecrafters/tests-env:centos-7 command: ./AppRun ubuntu-xenial: image: appimagecrafters/tests-env:ubuntu-xenial command: ./AppRun不带--skip-tests运行时这些用例就是在多个发行版容器里启动./AppRun做冒烟验证可用它替代只依赖文件生成了这一条判断。限制与注意事项配方依赖仓库内相对路径../res/的图标资源脱离仓库根目录运行或单独拷出appimage/会导致cp ../res/...失败apt.sources固定指向 focalUbuntu 20.04仓库且开启allow_unauthenticated: true这是配方声明的依赖基线不要随意换成其他发行版源否则捆绑的运行时库版本可能与配方假设不符两份配方只覆盖x86_64与aarch64两种架构AppImage.update-information: guess与压缩方式comp: gzip在两份配方中一致若构建失败在 gstreamer/图形解码相关环节可先对照配方中关于APPDIR_LIBRARY_PATH优先使用系统库的注释排查而不是直接修改apt.include的捆绑库。【免费下载链接】rustdeskAn open-source remote desktop application designed for self-hosting, as an alternative to TeamViewer.项目地址: https://gitcode.com/GitHub_Trending/ru/rustdesk创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考