cargo-generate-rpm

Cargo 辅助命令，用于从 Cargo 项目生成二进制 RPM 软件包 (.rpm)。

此命令不依赖于 rpmbuild，并使用 rpm 包生成 RPM 软件包文件，而不需要 spec 文件。

由于 rpm-rs 兼容性问题，不再支持需要 RPMv3 的旧系统（例如 CentOS 7）。对于此类系统，请使用 0.15 版本之前的版本。

安装

cargo install cargo-generate-rpm

用法

cargo build --release
strip -s target/release/XXX
cargo generate-rpm

在您的 cargo 项目中运行 cargo generate-rpm，将在 target/generate-rpm/XXX.rpm 中创建二进制 RPM 软件包文件。您可以使用 -o 选项更改 RPM 软件包文件位置。

预先运行 cargo build --release 并删除调试符号（strip -s target/release/XXX），因为这些目前不会在 cargo generate-rpm 中运行。

配置

此命令从 Cargo.toml 文件 生成 RPM 元数据

[package.metadata.generate-rpm] 选项

• name: 包名。如果不存在，则使用 package.name。
• 版本：包的版本。如果不存在，则使用 package.version。
• 许可证：包的许可证。如果不存在，则使用 package.license。
• 摘要：包的摘要/描述。如果不存在，则使用 package.description。
• URL：包的主页URL。如果不存在，则使用 package.homepage。如果都不存在，则使用 package.repository。
• 资源：（必需）包含在包中的文件数组
  • 源：该资源在Rust项目中的位置。（例如 target/release/XXX）允许使用通配符 *。
  • 目标：安装目标。（例如 /usr/bin/XXX）它应当是一个文件路径或以 / 结尾的目录路径。如果源包含通配符 *，则它必须是一个目录，而不是文件路径。
  • 模式：八进制字符串形式的权限。（例如 755 表示 -rwxr-xr-x）
  • 配置：如果是配置文件，则设置为 true。为了避免覆盖已修改的现有文件，可以设置为字符串 "noreplace"。目前不支持 "missingok"。
  • 文档：如果是文档文件，则设置为 true。
  • 用户：文件的拥有者。
  • 组：文件的组所有者。
  • 能力：可选的能力字符串。（例如 cap_sys_admin=pe）
• 发布：可选的发布字符串。
• 纪元：可选的纪元数字。
• 预安装脚本：可选的预安装脚本字符串或文件路径。
  • 预安装脚本标志：可选的整数值，用于设置脚本标志。
  • 预安装脚本程序：可选的字符串数组，用于设置脚本解释器/参数。
• 预卸载脚本：可选的预卸载脚本字符串或文件路径。
  • 预卸载脚本标志：可选的整数值，用于设置脚本标志。
  • 预卸载脚本程序：可选的字符串数组，用于设置脚本解释器/参数。
• 预转换脚本：可选的预转换脚本字符串或文件路径。
  • 预转换脚本标志：可选的整数值，用于设置脚本标志。
  • 预转换脚本程序：可选的字符串数组，用于设置脚本解释器/参数。
• 预反向转换脚本：可选的预反向转换脚本字符串或文件路径。
  • 预反向转换脚本标志：可选的整数值，用于设置脚本标志。
  • 预反向转换脚本程序：可选的字符串数组，用于设置脚本解释器/参数。
• 后安装脚本：可选的后安装脚本字符串或文件路径。
  • 后安装脚本标志：可选的整数值，用于设置脚本标志。
  • 后安装脚本程序：可选的字符串数组，用于设置脚本解释器/参数。
• 后卸载脚本：可选的后卸载脚本字符串或文件路径。
  • 后卸载脚本标志：可选的整数值，用于设置脚本标志。
  • 后卸载脚本程序：可选的字符串数组，用于设置脚本解释器/参数。
• 后转换脚本：可选的后转换脚本字符串或文件路径。
  • 后转换脚本标志：可选的整数值，用于设置脚本标志。
  • 后转换脚本程序：可选的字符串数组，用于设置脚本解释器/参数。
• 后反向转换脚本：可选的后反向转换脚本字符串或文件路径。
  • 后反向转换脚本标志：可选的整数值，用于设置脚本标志。
  • 后反向转换脚本程序：可选的字符串数组，用于设置脚本解释器/参数。
• 需要：可选的“需要”列表。
• auto-req：可选字符串 "no" 以禁用自动依赖过程
• require-sh：可选布尔值 false 以从需求中省略 /bin/sh
• obsoletes：可选的 Obsoletes 列表
• conflicts：可选的 Conflicts 列表
• provides：可选的 Provides 列表
• recommends：可选的 Recommends 列表
• supplements：可选的 Supplements 列表
• suggests：可选的 Suggests 列表
• enhances：可选的 Enhances 列表
• vendor：可选的 Vendor 字符串

[package.metadata.generate-rpm]
assets = [
    { source = "target/release/XXX", dest = "/usr/bin/XXX", mode = "755" },
    { source = "<path_relative_to_project_root>/XXX.desktop", dest = "/usr/share/applications/XXX.desktop", mode = "644" },
    { source = "<path_relative_to_project_root>/*/apps/XXX.png", dest = "/usr/share/icons/hicolor/", mode = "644" },
]

[package.metadata.generate-rpm.requires]
alternative = "*"
filesystem = ">= 3"

cargo build --release
strip -s target/release/XXX
cargo generate-rpm -p XXX

cargo build --release --target x86_64-unknown-linux-gnu
cargo generate-rpm --target x86_64-unknown-linux-gnu

pre_install_script = """
echo preinstall
"""
pre_install_script_flags = 0b011 # Enables EXPAND and QFORMAT flags
pre_install_script_prog = ["/bin/blah/bash", "-c"] # Sets the interpreter/argument settings for the scriptlet