开发工具桌面应用前端构建【免费下载链接】forge:electron: A complete tool for building and publishing Electron applications项目地址https://gitcode.com/gh_mirrors/fo/forge点击查看免费下载导读electron-forge/maker-rpm是 Electron Forge 官方维护的 maker 之一专门用于把已经打包好的 Electron 应用转换成.rpm格式的安装包——这是 Fedora、Red Hat Enterprise LinuxRHEL等 RedHat 系 Linux 发行版的标准软件包格式。本文将以 packages/maker/rpm/README.md 为主体骨架结合仓库内 MakerRpm.ts 的实现与 MakerRpm.spec.ts 的测试用例完整讲解环境要求、安装配置、全部可选参数以及底层打包原理。读完本文你将能在自己的 Forge 项目中一键产出可发布的 RPM 安装包并能按需定制包名、版本、依赖、图标与桌面菜单分类等元信息。一、RPM 目标与适用场景.rpmRed Hat Package Manager是 RedHat 系 Linux 发行版的原生软件包格式其对应的高层说明见 docs/config/makers/rpm.md。在 Electron Forge 中RPM maker 面向的典型场景是你的应用主要面向 Fedora、RHEL、CentOS 等发行版的桌面用户分发需要产出符合系统包管理规范依赖声明、桌面入口、应用图标、MIME 关联等的安装包。从源码角度看MakerRpm类声明了它的默认目标平台与外部依赖MakerRpm.tsexport default class MakerRpm extends MakerBaseMakerRpmConfig { name rpm; defaultPlatforms: ForgePlatform[] [linux]; requiredExternalBinaries: string[] [rpmbuild]; isSupportedOnCurrentPlatform(): boolean { return this.isInstalled(electron-installer-redhat); } }即该 maker 默认仅在linux平台生效运行构建要求系统存在rpmbuild外部二进制同时底层依赖electron-installer-redhat这个核心打包库作为optionalDependencies声明在 package.json 中。二、环境要求只有 Linux rpm/rpm-build 才能构建原文档明确指出You can only build the RPM target on Linux machines with therpmorrpm-buildpackages installed.即 RPM 包只能在 Linux 机器上构建且要求系统安装了rpm或rpm-build工具包。这与 MakerRpm 声明defaultPlatforms [linux]以及requiredExternalBinaries [rpmbuild]的实现相互印证——rpmbuild是实际驱动 RPM 构建的外部命令。不同发行版的安装方式来自 docs/config/makers/rpm.md 的 Requirements 一节# Fedora 等 dnf 系发行版 sudo dnf install rpm-build # Debian / Ubuntu 等 apt 系发行版RPM 通常用于交叉打包 sudo apt-get install rpm基类MakerBase中的ensureExternalBinariesExist()会在构建前校验这些二进制是否存在Maker.ts缺失时会抛出形如Cannot make for rpm, the following external binaries need to be installed: rpmbuild的明确错误便于快速定位环境问题。关于「能否在其他平台构建」的说明虽然理论上可以借助交叉工具在非 Linux 机器上制作 RPM但按当前仓库的实现isSupportedOnCurrentPlatform()通过this.isInstalled(electron-installer-redhat)检测依赖是否可解析其实现见 Maker.ts配合defaultPlatforms [linux]Forge 默认只会在 Linux 上执行该 maker。这与官方文档「只能构建于 Linux」的约定保持一致。三、安装与基础配置3.1 安装依赖npm install --save-dev electron-forge/maker-rpm在 pnpm/yarn 工作区环境下该包同时需要其工作区依赖electron-forge/maker-base与electron-forge/shared-types见 package.json这些通常随 Forge 主项目一并安装。3.2 最小可运行配置在forge.config.js或forge.config.mjs/forge.config.ts取决于你的 Forge 版本的makers数组中注册该 maker// forge.config.js module.exports { makers: [ { name: electron-forge/maker-rpm, config: { options: { name: QuickEdit, homepage: http://example.com } } } ] };这是原 README 给出的完整示例options中至少指定包名name与主页homepage。文档中的完整用法示例同样见 docs/config/makers/rpm.md 的 Usage 一节。3.3 触发构建配置完成后执行npx electron-forge makeForge 会先执行package得到可分发应用目录再调用本 maker 将其转换为 RPM。产出物位于out/make/rpm/arch/目录下输出路径逻辑见下文源码剖析。四、全部配置参数详解MakerRpmConfigOptions所有配置都放在 maker 配置的options字段中其类型定义为MakerRpmConfigOptions完整声明见 Config.ts。这些字段最终都会被透传给底层的electron-installer-redhat并映射到 RPM spec 文件或 freedesktop 桌面入口.desktop文件的对应字段配置项类型作用对应 spec / desktop 字段namestring包名如atom一般取小写包的Name字段productNamestring应用显示名如Atomdesktop 文件的NamegenericNamestring应用通用名如Text Editordesktop 文件的GenericNamedescriptionstring短描述spec 文件的SummaryproductDescriptionstring长描述spec 文件的%description段落versionstring包版本号spec 文件的Versionrevisionstring包修订号spec 文件的Releaselicensestring许可证声明spec 文件的Licensecopyrightstring版权字符串默认取应用 package.json 的copyright字段—groupstring包分组spec 文件的Grouprequiresstring[]运行时依赖包列表spec 文件的Requireshomepagestring项目主页 URL包元信息的HomepagecompressionLevel09包压缩级别透传给 rpmbuildbinstring应用可执行文件相对路径默认等于options.namedesktop 文件的ExecexecArgumentsstring[]传给可执行文件的命令行参数追加到 desktop 文件的Execiconstring用作应用图标的单张图片路径—categories枚举数组应用在桌面菜单中的分类desktop 文件的CategoriesmimeTypestring[]应用可打开的文件 MIME 类型desktop 文件的MimeTypecategories的可选枚举值定义于 Config.ts包括AudioVideo、Audio、Video、Development、Education、Game、Graphics、Network、Office、Science、Settings、System、Utility——这些值对应 freedesktop.org 的桌面菜单规范标准分类。配置合并cascade行为测试用例should have config cascade correctlyMakerRpm.spec.ts验证了一个关键行为即使你在顶层传入了arch: overridden这样的非法字段maker 的arch依然会由 Forge 根据目标架构覆盖为正确值而options内的字段如productName会被原样透传。也就是说options中业务字段完全交由你自定义arch、src、dest、rename等关键工程参数由 maker 内部强制接管防止配置破坏打包流程。另外MakerRpmConfig允许config既可以是普通对象也可以是一个「按架构返回配置」的函数(arch: ForgeArch) C基类会在prepareConfig阶段调用它从而支持为不同目标架构产出不同配置见 Maker.ts 与 config-fetcher.spec.ts。五、源码剖析一次 RPM 构建的完整调用链5.1 make() 主流程MakerRpm.make()的实现MakerRpm.ts核心只有几步async make({ dir, makeDir, targetArch }: MakerOptions): Promisestring[] { const { default: installer } await import(electron-installer-redhat); const outDir path.resolve(makeDir, rpm, targetArch); await this.ensureDirectory(outDir); const { packagePaths } await installer({ ...this.config, arch: rpmArch(targetArch), src: dir, dest: outDir, rename: renameRpm, }); return packagePaths; }调用链为动态import(electron-installer-redhat)——这是可选的仅在真正构建时加载避免在不需要该 maker 的环境产生额外开销计算输出目录outDir makeDir/rpm/targetArch如out/make/rpm/x64并通过基类ensureDirectory确保目录存在注意该方法会先删除已有目录再重建属于破坏性操作见 Maker.ts调用installer把options配置、转换后的arch、打包好的应用目录src、输出目录dest与自定义rename一起传入返回生成的包文件绝对路径列表packagePathsForge 会把它写入最终构建结果。MakerOptions中各字段的含义定义于 Maker.tsdir是已打包好的 Electron 应用目录makeDir是放置产物的根目录targetArch是目标 CPU 架构。5.2 架构映射rpmArchNode.js 的架构命名与 RPM 体系的架构命名并不一致rpmArch负责转换MakerRpm.tsForge / Node 架构RPM 架构ia32i386x64x86_64arm64aarch64armv7larmv7hl其他抛出Unsupported architecture ...错误这四组映射均有对应测试逐一验证MakerRpm.spec.ts未知架构会直接抛错。5.3 产物命名规则renameRpmMakerRpm.ts定义了输出文件的命名模板% name %-% version %-% revision %.% arch aarch64 ? arm64 : arch %.rpm即默认产物形如quickedit-1.2.3-1.x86_64.rpmname、version、revision取自你的options配置架构名遵循 RPM 惯例aarch64在文件名中显示为arm64其余架构直接使用 RPM 架构名如x86_64、i386。5.4 依赖透传options 如何进入 spec 文件maker 通过...this.config将你在forge.config.js中config字段里写的所有内容包括options整体传给electron-installer-redhat。因此options下的requires、license、description、productDescription、bin、execArguments、icon、categories、mimeType等字段会分别落到 RPM spec 文件的Requires、License、Summary、%description以及.desktop入口的Exec、Icon、Categories、MimeType中——这就是第四节的字段映射得以生效的底层机制。默认行为则被测试should pass through correct defaultsMakerRpm.spec.ts验证未显式提供时maker 仅注入arch、src、rename、dest四个工程参数。六、调试技巧该 maker 的底层打包工作全部由electron-installer-redhat完成。当构建失败或生成的 RPM 元信息不符合预期时可以开启针对该库的调试日志见 docs/config/makers/rpm.md 的 Debugging 一节DEBUGelectron-installer-redhat* npx electron-forge make日志会输出electron-installer-redhat在执行 rpmbuild 各阶段时的详细过程包括 spec 文件的生成内容与命令输出是排查依赖缺失、字段映射错误等问题的最直接手段。七、常见问题与注意事项必须在 Linux 上构建即使你的 CI 是 macOS 或 WindowsRPM 目标也只应在 Linux runner 上执行否则请移除该 maker 或按平台条件注册。rpmbuild缺失报错Cannot make for rpm, the following external binaries need to be installed: rpmbuild时按第二节的发行版对应命令补装即可。包名建议小写RPM 规范要求包名小写options.name建议使用类似quickedit的命名而把Atom这样的显示名放到productName。桌面入口生效若安装后发现应用没有出现在程序菜单检查categories是否使用了Categories枚举内的标准值并确认bin指向的 Exec 路径与应用内实际可执行文件一致。调试日志任何 spec/desktop 生成层面的异常优先开启第六节的DEBUG环境变量复现日志比报错堆栈更能定位问题。总结electron-forge/maker-rpm把「Electron 应用 → 可发布的 .rpm 安装包」这条链路收敛为一个声明式配置项你只需在 Forge 配置的makers数组中注册它按需填写options元信息包名、版本、依赖、图标、菜单分类等再执行electron-forge make剩余的架构映射rpmArch、输出目录组织out/make/rpm/arch、文件命名name-version-revision.arch.rpm以及 spec/desktop 文件生成全部由 maker 与electron-installer-redhat协作完成。对于面向 Fedora、RHEL 等 RedHat 系发行版分发 Electron 桌面的项目这是与 Forge 主流程深度集成、开箱即用的标准打包方案。赞分享开发工具桌面应用前端构建【免费下载链接】forge:electron: A complete tool for building and publishing Electron applications项目地址https://gitcode.com/gh_mirrors/fo/forge点击查看免费下载相关推荐Relay 客户端 Schema 扩展Client Schema Extensions实战指南用 commitLocalUpdate 读写本地状态Relay 客户端 Schema 扩展Client Schema Extensions实战指南用 commitLocalUpdate 读写本地状态 Rel开发工具桌面应用前端构建electron-builder 与 Electron Forge 集成使用 electron-forge-maker-snap 构建 Snap 安装包electron builder 与 Electron Forge 集成使用 electron forge maker snap 构建 Snap 安装包 el构建工具桌面应用开发工具LWM三步部署百万字符长对话机器人Scan Attention实战调优LWM三步部署百万字符长对话机器人Scan Attention实战调优 LWMLarge World Model是面向百万级上下文的多模态自回归模型它的开发工具桌面应用前端构建上一篇Azure SQL Database 原生向量检索实战基于 TypeScript 与 VECTOR()/VECTOR_DISTANCE() 的完整指南下一篇TanStack Query 之 createSyncStoragePersister 实战指南Preact Query 离线缓存持久化创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Electron Forge 的 RPM 打包实战：使用 @electron-forge/maker-rpm 为 RedHat 系发行版构建 .rpm 安装包
开发工具桌面应用前端构建【免费下载链接】forge:electron: A complete tool for building and publishing Electron applications项目地址https://gitcode.com/gh_mirrors/fo/forge点击查看免费下载导读electron-forge/maker-rpm是 Electron Forge 官方维护的 maker 之一专门用于把已经打包好的 Electron 应用转换成.rpm格式的安装包——这是 Fedora、Red Hat Enterprise LinuxRHEL等 RedHat 系 Linux 发行版的标准软件包格式。本文将以 packages/maker/rpm/README.md 为主体骨架结合仓库内 MakerRpm.ts 的实现与 MakerRpm.spec.ts 的测试用例完整讲解环境要求、安装配置、全部可选参数以及底层打包原理。读完本文你将能在自己的 Forge 项目中一键产出可发布的 RPM 安装包并能按需定制包名、版本、依赖、图标与桌面菜单分类等元信息。一、RPM 目标与适用场景.rpmRed Hat Package Manager是 RedHat 系 Linux 发行版的原生软件包格式其对应的高层说明见 docs/config/makers/rpm.md。在 Electron Forge 中RPM maker 面向的典型场景是你的应用主要面向 Fedora、RHEL、CentOS 等发行版的桌面用户分发需要产出符合系统包管理规范依赖声明、桌面入口、应用图标、MIME 关联等的安装包。从源码角度看MakerRpm类声明了它的默认目标平台与外部依赖MakerRpm.tsexport default class MakerRpm extends MakerBaseMakerRpmConfig { name rpm; defaultPlatforms: ForgePlatform[] [linux]; requiredExternalBinaries: string[] [rpmbuild]; isSupportedOnCurrentPlatform(): boolean { return this.isInstalled(electron-installer-redhat); } }即该 maker 默认仅在linux平台生效运行构建要求系统存在rpmbuild外部二进制同时底层依赖electron-installer-redhat这个核心打包库作为optionalDependencies声明在 package.json 中。二、环境要求只有 Linux rpm/rpm-build 才能构建原文档明确指出You can only build the RPM target on Linux machines with therpmorrpm-buildpackages installed.即 RPM 包只能在 Linux 机器上构建且要求系统安装了rpm或rpm-build工具包。这与 MakerRpm 声明defaultPlatforms [linux]以及requiredExternalBinaries [rpmbuild]的实现相互印证——rpmbuild是实际驱动 RPM 构建的外部命令。不同发行版的安装方式来自 docs/config/makers/rpm.md 的 Requirements 一节# Fedora 等 dnf 系发行版 sudo dnf install rpm-build # Debian / Ubuntu 等 apt 系发行版RPM 通常用于交叉打包 sudo apt-get install rpm基类MakerBase中的ensureExternalBinariesExist()会在构建前校验这些二进制是否存在Maker.ts缺失时会抛出形如Cannot make for rpm, the following external binaries need to be installed: rpmbuild的明确错误便于快速定位环境问题。关于「能否在其他平台构建」的说明虽然理论上可以借助交叉工具在非 Linux 机器上制作 RPM但按当前仓库的实现isSupportedOnCurrentPlatform()通过this.isInstalled(electron-installer-redhat)检测依赖是否可解析其实现见 Maker.ts配合defaultPlatforms [linux]Forge 默认只会在 Linux 上执行该 maker。这与官方文档「只能构建于 Linux」的约定保持一致。三、安装与基础配置3.1 安装依赖npm install --save-dev electron-forge/maker-rpm在 pnpm/yarn 工作区环境下该包同时需要其工作区依赖electron-forge/maker-base与electron-forge/shared-types见 package.json这些通常随 Forge 主项目一并安装。3.2 最小可运行配置在forge.config.js或forge.config.mjs/forge.config.ts取决于你的 Forge 版本的makers数组中注册该 maker// forge.config.js module.exports { makers: [ { name: electron-forge/maker-rpm, config: { options: { name: QuickEdit, homepage: http://example.com } } } ] };这是原 README 给出的完整示例options中至少指定包名name与主页homepage。文档中的完整用法示例同样见 docs/config/makers/rpm.md 的 Usage 一节。3.3 触发构建配置完成后执行npx electron-forge makeForge 会先执行package得到可分发应用目录再调用本 maker 将其转换为 RPM。产出物位于out/make/rpm/arch/目录下输出路径逻辑见下文源码剖析。四、全部配置参数详解MakerRpmConfigOptions所有配置都放在 maker 配置的options字段中其类型定义为MakerRpmConfigOptions完整声明见 Config.ts。这些字段最终都会被透传给底层的electron-installer-redhat并映射到 RPM spec 文件或 freedesktop 桌面入口.desktop文件的对应字段配置项类型作用对应 spec / desktop 字段namestring包名如atom一般取小写包的Name字段productNamestring应用显示名如Atomdesktop 文件的NamegenericNamestring应用通用名如Text Editordesktop 文件的GenericNamedescriptionstring短描述spec 文件的SummaryproductDescriptionstring长描述spec 文件的%description段落versionstring包版本号spec 文件的Versionrevisionstring包修订号spec 文件的Releaselicensestring许可证声明spec 文件的Licensecopyrightstring版权字符串默认取应用 package.json 的copyright字段—groupstring包分组spec 文件的Grouprequiresstring[]运行时依赖包列表spec 文件的Requireshomepagestring项目主页 URL包元信息的HomepagecompressionLevel09包压缩级别透传给 rpmbuildbinstring应用可执行文件相对路径默认等于options.namedesktop 文件的ExecexecArgumentsstring[]传给可执行文件的命令行参数追加到 desktop 文件的Execiconstring用作应用图标的单张图片路径—categories枚举数组应用在桌面菜单中的分类desktop 文件的CategoriesmimeTypestring[]应用可打开的文件 MIME 类型desktop 文件的MimeTypecategories的可选枚举值定义于 Config.ts包括AudioVideo、Audio、Video、Development、Education、Game、Graphics、Network、Office、Science、Settings、System、Utility——这些值对应 freedesktop.org 的桌面菜单规范标准分类。配置合并cascade行为测试用例should have config cascade correctlyMakerRpm.spec.ts验证了一个关键行为即使你在顶层传入了arch: overridden这样的非法字段maker 的arch依然会由 Forge 根据目标架构覆盖为正确值而options内的字段如productName会被原样透传。也就是说options中业务字段完全交由你自定义arch、src、dest、rename等关键工程参数由 maker 内部强制接管防止配置破坏打包流程。另外MakerRpmConfig允许config既可以是普通对象也可以是一个「按架构返回配置」的函数(arch: ForgeArch) C基类会在prepareConfig阶段调用它从而支持为不同目标架构产出不同配置见 Maker.ts 与 config-fetcher.spec.ts。五、源码剖析一次 RPM 构建的完整调用链5.1 make() 主流程MakerRpm.make()的实现MakerRpm.ts核心只有几步async make({ dir, makeDir, targetArch }: MakerOptions): Promisestring[] { const { default: installer } await import(electron-installer-redhat); const outDir path.resolve(makeDir, rpm, targetArch); await this.ensureDirectory(outDir); const { packagePaths } await installer({ ...this.config, arch: rpmArch(targetArch), src: dir, dest: outDir, rename: renameRpm, }); return packagePaths; }调用链为动态import(electron-installer-redhat)——这是可选的仅在真正构建时加载避免在不需要该 maker 的环境产生额外开销计算输出目录outDir makeDir/rpm/targetArch如out/make/rpm/x64并通过基类ensureDirectory确保目录存在注意该方法会先删除已有目录再重建属于破坏性操作见 Maker.ts调用installer把options配置、转换后的arch、打包好的应用目录src、输出目录dest与自定义rename一起传入返回生成的包文件绝对路径列表packagePathsForge 会把它写入最终构建结果。MakerOptions中各字段的含义定义于 Maker.tsdir是已打包好的 Electron 应用目录makeDir是放置产物的根目录targetArch是目标 CPU 架构。5.2 架构映射rpmArchNode.js 的架构命名与 RPM 体系的架构命名并不一致rpmArch负责转换MakerRpm.tsForge / Node 架构RPM 架构ia32i386x64x86_64arm64aarch64armv7larmv7hl其他抛出Unsupported architecture ...错误这四组映射均有对应测试逐一验证MakerRpm.spec.ts未知架构会直接抛错。5.3 产物命名规则renameRpmMakerRpm.ts定义了输出文件的命名模板% name %-% version %-% revision %.% arch aarch64 ? arm64 : arch %.rpm即默认产物形如quickedit-1.2.3-1.x86_64.rpmname、version、revision取自你的options配置架构名遵循 RPM 惯例aarch64在文件名中显示为arm64其余架构直接使用 RPM 架构名如x86_64、i386。5.4 依赖透传options 如何进入 spec 文件maker 通过...this.config将你在forge.config.js中config字段里写的所有内容包括options整体传给electron-installer-redhat。因此options下的requires、license、description、productDescription、bin、execArguments、icon、categories、mimeType等字段会分别落到 RPM spec 文件的Requires、License、Summary、%description以及.desktop入口的Exec、Icon、Categories、MimeType中——这就是第四节的字段映射得以生效的底层机制。默认行为则被测试should pass through correct defaultsMakerRpm.spec.ts验证未显式提供时maker 仅注入arch、src、rename、dest四个工程参数。六、调试技巧该 maker 的底层打包工作全部由electron-installer-redhat完成。当构建失败或生成的 RPM 元信息不符合预期时可以开启针对该库的调试日志见 docs/config/makers/rpm.md 的 Debugging 一节DEBUGelectron-installer-redhat* npx electron-forge make日志会输出electron-installer-redhat在执行 rpmbuild 各阶段时的详细过程包括 spec 文件的生成内容与命令输出是排查依赖缺失、字段映射错误等问题的最直接手段。七、常见问题与注意事项必须在 Linux 上构建即使你的 CI 是 macOS 或 WindowsRPM 目标也只应在 Linux runner 上执行否则请移除该 maker 或按平台条件注册。rpmbuild缺失报错Cannot make for rpm, the following external binaries need to be installed: rpmbuild时按第二节的发行版对应命令补装即可。包名建议小写RPM 规范要求包名小写options.name建议使用类似quickedit的命名而把Atom这样的显示名放到productName。桌面入口生效若安装后发现应用没有出现在程序菜单检查categories是否使用了Categories枚举内的标准值并确认bin指向的 Exec 路径与应用内实际可执行文件一致。调试日志任何 spec/desktop 生成层面的异常优先开启第六节的DEBUG环境变量复现日志比报错堆栈更能定位问题。总结electron-forge/maker-rpm把「Electron 应用 → 可发布的 .rpm 安装包」这条链路收敛为一个声明式配置项你只需在 Forge 配置的makers数组中注册它按需填写options元信息包名、版本、依赖、图标、菜单分类等再执行electron-forge make剩余的架构映射rpmArch、输出目录组织out/make/rpm/arch、文件命名name-version-revision.arch.rpm以及 spec/desktop 文件生成全部由 maker 与electron-installer-redhat协作完成。对于面向 Fedora、RHEL 等 RedHat 系发行版分发 Electron 桌面的项目这是与 Forge 主流程深度集成、开箱即用的标准打包方案。赞分享开发工具桌面应用前端构建【免费下载链接】forge:electron: A complete tool for building and publishing Electron applications项目地址https://gitcode.com/gh_mirrors/fo/forge点击查看免费下载相关推荐Relay 客户端 Schema 扩展Client Schema Extensions实战指南用 commitLocalUpdate 读写本地状态Relay 客户端 Schema 扩展Client Schema Extensions实战指南用 commitLocalUpdate 读写本地状态 Rel开发工具桌面应用前端构建electron-builder 与 Electron Forge 集成使用 electron-forge-maker-snap 构建 Snap 安装包electron builder 与 Electron Forge 集成使用 electron forge maker snap 构建 Snap 安装包 el构建工具桌面应用开发工具LWM三步部署百万字符长对话机器人Scan Attention实战调优LWM三步部署百万字符长对话机器人Scan Attention实战调优 LWMLarge World Model是面向百万级上下文的多模态自回归模型它的开发工具桌面应用前端构建上一篇Azure SQL Database 原生向量检索实战基于 TypeScript 与 VECTOR()/VECTOR_DISTANCE() 的完整指南下一篇TanStack Query 之 createSyncStoragePersister 实战指南Preact Query 离线缓存持久化创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考