用 6 步做出 LocalSend Linux AppImage：从配置到跨发行版验证

用 6 步做出 LocalSend Linux AppImage从配置到跨发行版验证【免费下载链接】localsendAn open-source cross-platform alternative to AirDrop项目地址: https://gitcode.com/GitHub_Trending/lo/localsend本文讲解如何制作 LocalSend Linux AppImage适合想把这款工具分发到混合发行版环境的 Linux 用户以及想学习 Flutter Linux AppImage 打包的维护者。内容覆盖最小可行构建流程、appimage-builder 配置读法和 ARM64 的配法照做即可产出一个单文件可执行程序。适用场景与你能得到什么你要把工具发给同事他们的机器混用 Ubuntu、Fedora、Debian 等环境不想逐发行版处理依赖需要以单个文件分发用户chmod x后即可运行希望同一套代码同时跑在 x86_64 与 ARM64 设备上你正在做 Flutter 桌面应用的 Linux 发布想验证整条打包链路收益比较直接使用者不装运行时依赖系统版本不影响应用能否启动你也不用为每个发行版维护一套 deb/rpm 包。为什么选 AppImage 作为打包格式AppImage 把应用二进制、运行时库和桌面集成文件打进一个文件运行时自动解压挂载。相比逐发行版打包无依赖问题库随包携带避免这个发行版能跑、那个发行版起不来免安装不需要 root删除文件即卸载验证成本一致同一个文件可以在多个发行版上验证CI 也不必逐发行版准备环境LocalSend 的 AppImage 内容实际包含 Flutter 构建产物、托盘与 SVG 图标渲染所需的两个系统库以及桌面入口文件。桌面形态就是你在官方页面看到的这个界面文件可以在桌面与手机之间直接互发最小可行制作流程第一步安装构建依赖与 AppImage 工具。# Flutter 构建依赖 sudo apt install curl clang cmake libgtk-3-dev ninja-build sudo apt install libayatana-appindicator3-dev # AppImage 运行时与打包依赖 sudo apt install libfuse2 squashfs-tools再从工具官方发布页获取 appimage-builder 可执行文件chmod x后放入/usr/local/bin。第二步构建并打包。整条流程可以概括为一条流水线对应命令如下git clone https://gitcode.com/GitHub_Trending/lo/localsend cd localsend submodules/flutter/bin/flutter pub get submodules/flutter/bin/flutter pub run build_runner build -d submodules/flutter/bin/flutter build linux mkdir AppDir cp -r build/linux/x64/release/bundle/* AppDir cp support/build/appimage/AppImageBuilder_x86_64.yml AppImageBuilder.yml ./appimage-builder仓库里的 Linux AppImage 构建脚本 就是把这些步骤包成了脚本可以直接对照阅读。最终产物命名为LocalSend-版本号-x86_64.AppImage。appimage-builder 配置怎么读配置文件位于 support/build/appimage/每种架构一份 yml关键字段app_info.id / exec应用标识与可执行文件名exec_args: $表示透传全部命令行参数app_info.version会进入产物文件名发新版本时记得同步修改apt.arch要拉取的 apt 依赖架构apt.sources锁定 Ubuntu Jammy 的一组源用于固定依赖版本apt.include只放运行时必需的两个库托盘与 SVG 渲染files.exclude排除 man 页与文档文件控制体积runtime.env把系统路径补进XDG_DATA_DIRS保证应用能找到桌面资源关键片段x86_64 版本AppDir: app_info: id: org.localsend.localsend_app exec: localsend_app exec_args: $ apt: arch: [amd64] include: - libayatana-appindicator3-1:amd64 - librsvg2-common:amd64 runtime: env: XDG_DATA_DIRS: /usr/local/share/:/usr/share/:${XDG_DATA_DIRS}配置文件顶部的script块还有一条自动检查mksquashfs是否安装的语句写自己的配置时可以参考这个写法。跨架构与跨发行版注意事项两份架构配置之间只有三处不同项目x86_64ARM64apt.archamd64arm64include 架构后缀:amd64:arm64AppImage.archx86_64arm_64做跨发行版部署时另外注意三点依赖基线是 Ubuntu Jammy LTS目标发行版 glibc 越新越容易直接运行若要面向老系统先确认最低 glibc 版本构建机最好与目标架构一致不想准备两套机器就需要自行解决 Flutter 与 apt 的交叉编译yml 里有注释掉的test块可以在不同发行版镜像里跑./AppRun适合放到 CI 中启用 常见失败点与排查方法运行 AppImage 报 FUSE 相关错误目标机缺 libfuse2安装它或确认内核启用了 FUSE打包时提示找不到 mksquashfs构建机安装 squashfs-tools应用能启动但托盘没有图标检查apt.include里的libayatana-appindicator3-1是否带正确架构后缀SVG 图标显示为方块缺少 librsvg2-common产物架构或文件名不对用file命令查看产物架构并与 yml 中AppImage.arch比对 发布前精简检查清单yml 中version号与本次发布版本一致两份架构文件同步修改arch、include 后缀、AppImage.arch干净容器里 AppRun 能正常启动桌面环境下托盘图标与通知显示正常产物体积合理明显变大时检查是哪个包新带了文件已设置可执行位chmod x以上自检全部通过后你就可以把这个 AppImage 交给使用者了。下一步建议先在你支持的最老发行版上验证再在本地日常环境试用文件名保留版本号方便用户区分新旧版本。【免费下载链接】localsendAn open-source cross-platform alternative to AirDrop项目地址: https://gitcode.com/GitHub_Trending/lo/localsend创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考