drawio-desktop Linux 构建完整指南：如何生成 AppImage 与 deb 安装包

drawio-desktop Linux 构建完整指南如何生成 AppImage 与 deb 安装包【免费下载链接】drawio-desktopOfficial electron build of draw.io项目地址: https://gitcode.com/GitHub_Trending/dr/drawio-desktopdrawio-desktop 是 draw.io 的官方 Electron 桌面版编辑器离线运行图表数据只存本地整个项目采用 Apache 2.0 协议。本文解决一个具体问题在 Linux 上如何从源码构建出AppImage与deb两种安装包包括打包形态怎么选、命令怎么敲、产物怎么核对以及失败时从哪几步查起。AppImage 还是 deb先想清楚要哪种打包形态两种形态从同一份配置构建选型依据是装不装进系统对比项AppImagedeb安装方式单文件chmod x后直接运行不改系统文件dpkg安装注册进应用菜单与包数据库适用场景临时机器、多架构机器共用一份文件、放进 U 盘Ubuntu、Debian 日常长期使用卸载方式删掉文件即卸载交给包管理器卸载版本信息可被系统追踪架构x64 / arm64由构建参数指定x64 / arm64由构建参数指定日常固定在 Ubuntu 上使用选 deb 更省心应用入口、文件关联.drawio、.vsdx等见 electron-builder-linux-mac.json 的fileAssociations都由安装过程注册。需要免安装、或者机器权限不全选 AppImage。构建前需要准备什么git 递归克隆draw.io 编辑器本体是drawio/子模块不递归克隆就拿不到构建必失败Node.jspackage.json的engines字段要求22.12.0低于此版本装依赖就会报错npm随 Node 自带无需额外安装git clone --recursive https://gitcode.com/GitHub_Trending/dr/drawio-desktop cd drawio-desktop克隆完成后先做两件事——版本同步和依赖安装顺序不能反npm run sync npm installnpm run sync的作用是读取子模块里的drawio/VERSION把版本号写入package.json同时生成src/main/disableUpdate.js。这一步跳过时sync 脚本会直接报错退出而产物的版本号正是取自这里。生成 AppImage 的正确姿势npx electron-builder --config electron-builder-linux-mac.json --linux AppImage --x64 --publish never几个参数的作用--linux AppImage只构建 AppImage 一种目标配置里其实还定义了 deb 和 rpm命令行给定的目标会替换配置文件中的列表--x64目标架构默认即 x64ARM 机器换成--arm64--publish never不尝试把产物发布到任何远程仓库。项目里的npm run release-linux脚本带着--publish always是给 CI 发布用的本地构建不建议直接跑构建结束后在dist/目录找到产物然后chmod x dist/draw.io-x64-版本号.AppImage ./dist/draw.io-x64-版本号.AppImageAppImage 本质是可执行压缩包首次运行时会解包到临时目录因此磁盘空间建议留足几百 MB。它不写注册表式的系统状态删掉文件就等于卸载。deb 包构建与安装生成 deb 的命令只把目标换掉npx electron-builder --config electron-builder-linux-mac.json --linux deb --x64 --publish never在 Ubuntu / Debian 上安装sudo dpkg -i dist/draw.io_版本号_amd64.deb装完后应用菜单里会出现 draw.io.drawio/.vsdx/.mmd等类型被关联为编辑器打开方式。后续apt upgrade也能识别这个包。构建产物的命名规则怎么读文件名由 electron-builder-linux-mac.json 里的artifactName决定模板是${productName}-${arch}-${version}.${ext}所有产物统一输出到dist/。以 x64 架构为例对应关系是draw.io-x64-版本.AppImage—— 免安装单文件draw.io_版本_amd64.deb—— deb 包架构标识在 deb 命名里用amd64draw.io-版本.rpm等 —— rpm本文不展开一个容易踩的细节产品名默认是draw.io而不是drawio所以本地构建的 deb 与官方 drawio 包可以并存、互不覆盖如果想和官方命名一致需要在构建前把配置里的产品名改成drawio见 doc/BUILDING_FOR_PERSONAL_USE.md 的说明。构建失败时按这三步排查1. 提示找不到drawio/VERSION。这是子模块没拉下来的典型报错。补跑git submodule update --init再重新执行npm run sync即可。2. 不需要 rpm但构建卡住了。配置里同时定义了 AppImage、deb、rpm 三个目标构建 rpm 还要求系统装rpm工具。按本文命令显式指定--linux AppImage或--linux debelectron-builder 就只会做你点名的那种。3. 缺系统库或权限异常。报缺某个系统库时按提示安装对应的-dev/-devel开发包不要用sudo跑npm install装出来的依赖会带 root 属主后面 electron-builder 写入构建目录时可能直接失败。网络超时导致的依赖安装失败可以换个 npm 镜像源重试。最后提醒一句个人构建的产物是未签名的官方文档明确这类构建仅供自用、不要当作 draw.io 分发。项目本身不接受外部代码贡献遇到构建问题可以到仓库的 issues 区反馈。构建细节想深入时可以从 DEVELOPMENT.md 和 doc/BUILDING_FOR_PERSONAL_USE.md 两个文档继续读起。【免费下载链接】drawio-desktopOfficial electron build of draw.io项目地址: https://gitcode.com/GitHub_Trending/dr/drawio-desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考