学习rpm打包，一篇文章就够了

本文详细讲解打包的各个步骤并重点讲述spec文件的编写。

rpm打包过程使用的源码包制作可以参考教程：Linux源码包的制作教程

RPM（Redhat Package Manager）是用于Redhat、CentOS、Fedora等Linux 分发版（distribution）的常见的软件包管理器。因为它允许分发已编译的软件，所以用户只用一个命令就可以安装软件。

本文从配置文件到打包，从打包到安装，从安装到原理深度解析。并用案例展示详细步骤，也可供作为模板修改，也可作为打包时的资料查询。

如果只是想知道怎么打包，不需要了解原理，请从“案例”直接看，并修改相应内容即可。

本文基于CentOS 7.9系统，rpm版本4.11.3，理论上只要是使用rpm的发行版都适用

gcc，make 用于编译c语言源代码

tree 方便查看文件夹目录

dos2unix 保证文件可执行性

RPM打包使用的是rpmbuild命令，这个命令来自rpm-build包，这个是必装的

当然也可以直接安装rpmdevtools，这个工具还包含一些其他的工具，同时它依赖rpm-build，所以直接安装的话会同时把rpm-build装上。

RPM打包的时候需要编译源码，还需要把编译好的配置文件啊二进制命令文件啊之类的东西按照安装好的样子放到合适的位置，还要根据需要对RPM的包进行测试，这些都需要先有一个标准化的“工作空间”。

rpmdev-setuptree这个命令就是安装rpmdevtools带来的 。可以看到运行了这个命令之后，在$HOME家目录下多了一个叫做rpmbuild的文件夹 。

如果没有安装rpmdevtools的话，其实用mkdir命令创建这些文件夹也是可以的。

SPECS下是RPM包的配置文件，是RPM打包的“图纸”，这个文件会告诉rpmbuild命令如何去打包。“宏代码”这一列就可以在SPEC文件中用来代指所对应的目录，类似于编程语言中的宏或全局变量。当然~/rpmbuild这个文件夹也是有宏代码的，叫做%_topdir。

rpmbuild 默认工作路径的确定，通常由在 /usr/lib/rpm/macros 这个文件里的一个叫做 %_topdir 的宏变量来定义。如果用户想更改这个目录名，rpm 官方并不推荐直接更改这个目录，而是在用户家目录下建立一个名为 .rpmmacros 的隐藏文件(Linux下隐藏文件,前面的点不能少)，然后在里面重新定义 %_topdir，指向一个新的目录名。这样就可以满足某些用户的差异化需求了。.rpmmacros 文件里内容，比如：

SPEC 文件，rpm构建包的核心文件，命名格式一般是“软件名-版本.spec”的形式，需将其拷贝到 SPECS 目录下

rpm宏是直接文本替换

查看宏对应的实际内容

使用vim命令生成模板文件

使用rpmdevtools 工具生成模板文件

spec文件序言部分

spec文件Body部分

tips:

%changelog 标签应包含每个 Release 所做的更改日志，尤其应包含上游的安全/漏洞补丁的说明。Changelog 日志可使用 rpm –changelog -q 查询，通过查询可得知已安装的软件是否包含指定漏洞和安全补丁。%changelog 条目应包含版本字符串，以避免 rpmlint 工具警告

%changelog 格式

多行的部分，如 %changelog 或 %description 由指令下一行开始，空行结束

spec中不能有空项目和无用项目 (如 BuildRequires 和 Requires) ，可以删除无内容的项目，也可使用 ‘#’ 注释

spec文件示例

%prep 部分描述了解压源码包的方法。一般而言，其中包含 %autosetup 命令。另外，还可以使用 %setup 和 %patch 命令来指定操作 Source0、Patch0 等标签的文件。

%autosetup 命令用于解压源码包。可用选项包括：

如果使用 %setup 命令，通常使用 -q 抑止不必要的输出。 如果需要解压多个文件，有更多 %spec 选项可用，这对于创建子包很有用。常用选项如下：

如果使用 %autosetup 命令，则不需要手动进行补丁管理。如果你的需求很复杂，或需要与 EPEL 兼容，需要用到此部分的内容。%patch0 命令用于应用 Patch0（%patch1 应用 Patch1，以此类推）。Patches 是修改源码的最佳方式。常用的 -pNUMBER 选项，向 patch 程序传递参数，表示跳过 NUM 个路径前缀。

补丁文件名通常像这样 telnet-0.17-env.patch，命名格式为 %{name} - %{version} - REASON.patch（有时省略 version 版本）。补丁文件通常是 diff -u 命令的输出；如果你在 ~/rpmbuild/BUILD 子目录执行此命令，则之后便不需要指定 -p 选项。

%build阶段顾名思义就是对解压到%_builddir下的源码进行编译的阶段，整个过程在该目录下完成。 许多程序使用 GNU configure 进行配置。默认情况下，文件会安装到前缀为 “/usr/local” 的路径下，对于手动安装很合理。然而，打包时需要修改前缀为 “/usr”。共享库路径视架构而定，安装至 /usr/lib 或 /usr/lib64 目录。 由于 GNU configure 很常见，可使用 %configure 宏来自动设置正确选项（例如，设置前缀为 /usr）。一般用法如下：

若需要覆盖 makefile 变量，请将变量作为参数传递给 make：

你会发现SPEC中会用到很多预定义好的宏，用来通过一个简单的宏来完成一个或一系列常见的操作，比如：%prep阶段用于解压的%setup和%autosetup，%build阶段的%configure等。

此阶段包含安装阶段需要执行的命令，即从 %{_builddir} 复制相关文件到 %{buildroot} 目录（通常表示从 ~/rpmbuild/BUILD 复制到 ~/rpmbuild/BUILDROOT/XXX) 目录，并根据需要在 %{buildroot} 中创建必要目录。

容易混淆的术语：

一般，这里执行 “make install” 之类的命令：

理想情况下，对于支持的程序，你应该使用 %makeinstall（这又是一个宏），它等同于 DESTDIR=%{buildroot}，它会将文件安装到 %{buildroot} 目录中。

使用 “%makeinstall” 宏。此方法可能有效，但也可能失败。该宏会展开为 make prefix=%{buildroot}%{_prefix} bindir=%{buildroot}%{_bindir} … install，可能导致某些程序无法正常工作。请在 %{buildroot} 根据需要创建必要目录。

使用 auto-destdir 软件包的话，需要 BuildRequires: auto-destdir，并将 make install 修改为 make-redir DESTDIR=%{buildroot} install。这仅适用于使用常用命令安装文件的情况，例如 cp 和 install。

手动执行安装。这需要在 %{buildroot} 下创建必要目录，并从 %{_builddir} 复制文件至 %{buildroot} 目录。要特别注意更新，通常会包含新文件。示例如下：

如果需要执行测试，使用 %check 是个好主意。测试代码应写入 %check 部分（紧接在 %install 之后，因为需要测试 %{buildroot} 中的文件），而不是写入 %{build} 部分，这样才能在必要时忽略测试。通常，此部分包含：

此部分列出了需要被打包的文件和目录。

%defattr 用于设置默认文件权限，通常可以在 %files 的开头看到它。注意，如果不需要修改权限，则不需要使用它。其格式为：

第 4 个参数通常会省略。常规用法为 %defattr(-,root,root,-)，其中 “-” 表示默认权限。 您应该列出该软件包拥有的所有文件和目录。尽量使用宏代替目录名，具体的宏列表如下：

如果路径以 “/” 开头（或从宏扩展），则从 %{buildroot} 目录取用。否则，假设文件在当前目录中（例如：在 %{_builddir} 中，包含需要的文档）。如果您的包仅安装一个文件，如 /usr/sbin/mycommand，则 %files 部分如下所示：

若要使软件包不受上游改动的影响，可使用通配符匹配所有文件：

包含一个目录：

注意，%{_bindir}/* 不会声明此软件包拥有 /usr/bin 目录，而只包含其中的文件。如果您列出一个目录，则该软件包拥有这个目录，及该目录内的所有文件和子目录。因此，不要列出 %{_bindir}，并且要小心的处理那些可能和其他软件包共享的目录。

如果存在以下情况，可能引发错误：

通配符未匹配到任何文件或目录 文件或目录被多次列出 未列出 %{buildroot} 下的某个文件或目录 您也可以使用 %exclude 来排除文件。这对于使用通配符来列出全部文件时会很有用，注意如果未匹配到任何文件也会造成失败。

上边的“hello”的示例中，%files部分还有用到%doc等宏，可能您看得一知半解，这里详细介绍一下。 如果需要在 %files 部分添加一个或多个前缀，用空格分隔。

%doc 用于列出 %{_builddir} 内，但不复制到 %{buildroot} 中的文档。通常包括 README 和 INSTALL等。它们会保存至 /usr/share/doc 下适当的目录中，不需要声明 /usr/share/doc 的所有权。

注意： 如果指定 %doc 条目，rpmbuild < 4.9.1 在安装前会将 %doc 目录删除。这表明已保存至其中的文档，例如，在 %install 中安装的文档会被删除，因此最终不会出现在软件包中。如果您想要在 %install 中安装一些文档，请将它们临时安装到 build 目录（不是 build root 目录）中，例如 _docs_staging，接着在 %files 中列出，如 %doc _docs_staging/* 这样。

配置文件保存在 /etc 中，一般会这样指定（确保用户的修改不会在更新时被覆盖）：

如果更新的配置文件无法与之前的配置兼容，则应这样指定：

“%attr(mode, user, group)” 用于对文件进行更精细的权限控制，”-” 表示使用默认值：

“%caps(capabilities)” 用于为文件分配 POSIX capabilities。例如：

如果包含特定语言编写的文件，请使用 %lang 来标注：

使用区域语言（Locale）文件的程序应遵循 处理 i18n 文件的建议方法：

当用户安装或卸载 RPM 时，您可能想要执行一些命令。这可以通过 scriptlets 完成。

脚本片段可以：

例如，每个二进制 RPM 包都会在动态链接器的默认路径中存储共享库文件，并在 %post 和 %postun 中调用 ldconfig 来更新库缓存。如果软件包有多个包含共享库的子包，则每个软体包也需要执行相同动作。

%post -p /sbin/ldconfig %postun -p /sbin/ldconfig

如果仅执行一个命令，则 “-p” 选项会直接执行，而不启用 shell。然而，若有许多命令时，不要使用此选项，按正常编写 shell 脚本即可。

如果你在脚本片段中执行任何程序，就必须以 Requires(CONTEXT)（例： Requires(post)）的形式列出所有依赖。

%pre、%post、%preun 和 %postun 提供 $1 参数，表示动作完成后，系统中保留的此名称的软件包数量。因此可用于检查软件安装情况，不过不要比较此参数值是否等于 2，而是比较是否大于等于 2。对于%pretrans 和 %posttrans，$1 的值恒为 0。

例如，如果软件包安装了一份 info 手册，那么可以用 info 包提供的 install-info 来更新 info 手册索引。首先，我们不保证系统已安装 info 软件包，除非明确声明需要它；其次，我们不想在 install-info 执行失败时，使软件包安装失败：

上边的示例中还有一个安装 info 手册时的小问题需要解释一下。install-info 命令会更新 info 目录，所以我们应该在 %install 阶段删除 %{buildroot} 中无用的空目录：

RPM包文件名格式：Name-Version-Release[dist].BuildArch

rpmbuild 命令的选项 rpmbuild 命令有不少选项，用得比较多的有：

为避免常见错误，请先使用 rpmlint 查找 SPEC 文件的错误：

如果返回错误/警告，使用 “-i” 选项查看更详细的信息。

也可以使用 rpmlint 测试已构建的 RPM 包，检查 SPEC/RPM/SRPM 是否存在错误。 如果你位于 SPEC 目录中，请执行：

进入 ~/rpmbuild/RPMS 下的特定架构目录中，您会发现有许多二进制 RPM 包。使用以下命令快速查看 RPM 包含的文件和权限

make 是 Linux 开发套件里面自动化编译的一个控制程序，他通过借助 Makefile 里面编写的编译规范（语法很多，类似一个可以运行的脚本程序。反正我是看不懂，所以你也别问我怎么编写）。进行自动化的调用 gcc 、ld 以及运行某些需要的程序进行编译的程序。

一般情况下，他所使用的 Makefile 控制代码，由 configure 这个设置脚本根据给定的参数和系统环境生成。

makefile 是用于自动编译和链接的，一个工程有很多文件组成，每一个文件的改变都会导致工程的重新链接–但是不是所有的文件都需要重新编译，makefile 能够纪录文件的信息，决定在链接的时候需要重新编译哪些文件。

从名字上看，老的 Unix 系统的 CC 程序叫做 C Compiler 。但 GCC 这个名字按 GNU 的说法叫做 Gnu Compiler Collection ，注意这是一个编译器集合，不仅仅是 c 或 c++。gcc 包含很多编译器(C, C++, Objective-C, Ada, Fortran,and Java) 。所以它们是不一样的，一个是一个古老的 C 编译器，一个是编译器的 Gnu 的编译器的集合(Gcc里的 C 编译器比 CC 强大太多了，所以你没必要用 CC)。

cc 是 gcc 的连接。cc 来自于昂贵的 Unix 系统，cc 是商业软件，gcc 是编译器。

GCC 可以用来编译 C/C++、FORTRAN、JAVA、OBJC、ADA等语言的程序，可根据需要选择安装支持的语言。

原因:debug信息，忽略即可

解决:在spec文件任意位置添加如下代码

原因:在windows下编辑造成的空格或tab不识别

解决:使用vim或者vi在服务器上对spec文件进行编辑

文章作者 ZhangKQ

上次更新 2022-07-01