Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

4.5. 使用 spec 文件

要打包新软件，您必须创建一个 spec 文件。您可以使用以下方法之一创建 spec 文件：

  • 从头开始手动编写新的 spec 文件。
  • 使用 rpmdev-newspec 工具。这个工具会创建一个未填充的 spec 文件，您可以在其中填充必要的指令和字段。
注意

某些以程序员为中心的文本编辑器，预先使用自己的 spec 模板填充一个新的 spec 文件。rpmdev-newspec 工具提供了一个与编辑器无关的方法。

您可以使用 rpmdev-newspec 工具为 Hello World! 程序的三个实现创建一个 spec 文件。

先决条件

流程

  1. 进到 ~/rpmbuild/SPECS 目录： 

    $ cd ~/rpmbuild/SPECS
    Copy to Clipboard Toggle word wrap

  2. 为 Hello World! 程序的三个实现创建一个 spec 文件： 

    $ rpmdev-newspec bello
bello.spec created; type minimal, rpm version >= 4.11.

$ rpmdev-newspec cello
cello.spec created; type minimal, rpm version >= 4.11.

$ rpmdev-newspec pello
pello.spec created; type minimal, rpm version >= 4.11.
    Copy to Clipboard Toggle word wrap

    ~/rpmbuild/SPECS/ 目录现在包含三个 spec 文件，名为 bello.spec、cello.spec 和 pello.spec。

  3. 检查创建的文件。

    文件中的指令代表 About spec files 中描述的指令。在以下部分中，您将在 rpmdev-newspec 的输出文件中填充特定的部分。

4.5.2. 修改原始 spec 文件
复制链接

rpmdev-newspec 工具生成的 spec 文件的原始输出代表一个您必须修改的模板，以便为 rpmbuild 工具提供必要的指令。然后，rpmbuild 使用这些指令来构建 RPM 软件包。

先决条件

流程

  1. 打开 rpmdev-newspec 工具提供的 ~/rpmbuild/SPECS/<name>.spec 文件。

  2. 填充 spec 文件 Preamble 部分的以下指令：

    Name
    Name 已被指定为 rpmdev-newspec 的参数。
    Version
    将 Version 设置为与源代码的上游版本匹配。
    发布
    Release 被自动设置为 1%{?dist}，它最初是 1。
    Summary
    输入软件包的一行解释。
    License
    输入与源代码关联的软件许可证。
    URL
    输入上游软件网站的 URL。为实现一致性，请使用 %{name} RPM 宏变量，并使用 https://example.com/%{name} 格式。
    Source

    输入上游软件源代码的 URL。直接到被打包的软件版本的连接。

    注意

    本文档中的 URL 示例包括可能在以后更改的硬编码的值。同样，发行版本也可以更改。要简化这些潜在的更改，请使用 %{name} 和 %{version} 宏。通过使用这些宏，您只需要更新 spec 文件中的一个字段。

    BuildRequires
    指定软件包的构建时依赖项。
    Requires
    指定软件包的运行时依赖项。
    BuildArch
    指定软件架构。

  3. 填充 spec 文件 Body 部分的以下指令：您可以将这些指令视为部分标题，因为这些指令可以定义要发生的多行、多指令或脚本化任务。

    %description
    输入软件的完整描述。
    %prep
    输入准备构建软件的命令或一系列命令。
    %build
    输入构建软件的命令或一系列命令。
    %install
    输入指示 rpmbuild 命令如何将软件安装到 BUILDROOT 目录中的命令或一系列命令。
    %files
    指定 RPM 软件包提供的要安装在您的系统上的文件的列表。
    %changelog

    输入软件包的每个 Version-Release 的日期戳条目的列表。

    启动带有一个星号(*)字符，后跟 Day-of-Week Month Day Year Name Surname <email> - Version-Release 的 %changelog 部分的第一行

    对于实际更改条目，请遵循这些规则：

    • 每个更改条目都可以包含多个项，每个代表一个更改。
    • 每项都从新行开始。
    • 每项都以连字符(-)字符开头。

现在，您已为所需程序编写了一个完整的 spec 文件。

4.5.3. Bash 程序示例的 spec 文件示例
复制链接

对于使用 bash 编写的 bello 程序，您可以使用以下示例 spec 文件作为参考。

使用 bash 编写的 bello 程序的 spec 文件示例

Name:           bello
Version:        0.1
Release:        1%{?dist}
Summary:        Hello World example implemented in bash script

License:        GPLv3+
URL:            https://www.example.com/%{name}
Source0:        https://www.example.com/%{name}/releases/%{name}-%{version}.tar.gz

Requires:       bash

BuildArch:      noarch

%description
The long-tail description for our Hello World Example implemented in
bash script.

%prep
%setup -q

%build

%install

mkdir -p %{buildroot}/%{_bindir}

install -m 0755 %{name} %{buildroot}/%{_bindir}/%{name}

%files
%license LICENSE
%{_bindir}/%{name}

%changelog
* Tue May 31 2016 Adam Miller <maxamillion@fedoraproject.org> - 0.1-1
- First bello package
- Example second item in the changelog for version-release 0.1-1
Copy to Clipboard Toggle word wrap

  • BuildRequires 指令指定软件包的 build-time 依赖项已被删除，因为没有可用于 bello 的构建步骤。Bash 是原始解释编程语言，文件仅安装到其系统上的位置。
  • Requires 指令，其指定软件包的运行时依赖项，仅包含 bash，因为 bello 脚本只需要 bash shell 环境即可执行。
  • 指定如何构建软件的 %build 部分为空，因为不需要构建 bash 脚本。
注意

要安装 bello，您必须创建目标目录，并在其中安装可执行的 bash 脚本文件。因此，您可以在 %install 部分中使用 install 命令。您可以使用 RPM 宏来执行此操作，而无需硬编码路径。

4.5.4. Python 程序示例的 spec 文件示例
复制链接

您可以对使用 Python 编程语言编写的 pello 程序使用以下示例 spec 文件作为参考。

使用 Python 编写的 pello 程序的 spec 文件示例

Name:           pello
Version:        0.1.1
Release:        1%{?dist}
Summary:        Hello World example implemented in Python

License:        GPLv3+
URL:            https://www.example.com/%{name}
Source0:        https://www.example.com/%{name}/releases/%{name}-%{version}.tar.gz

BuildRequires:  python
Requires:       python
Requires:       bash

BuildArch:      noarch

%description
The long-tail description for our Hello World Example implemented in Python.

%prep
%setup -q

%build

python -m compileall %{name}.py

%install

mkdir -p %{buildroot}/%{_bindir}
mkdir -p %{buildroot}/usr/lib/%{name}

cat > %{buildroot}/%{_bindir}/%{name} <<EOF
#!/bin/bash
/usr/bin/python /usr/lib/%{name}/%{name}.pyc
EOF

chmod 0755 %{buildroot}/%{_bindir}/%{name}

install -m 0644 %{name}.py* %{buildroot}/usr/lib/%{name}/

%files
%license LICENSE
%dir /usr/lib/%{name}/
%{_bindir}/%{name}
/usr/lib/%{name}/%{name}.py*

%changelog
* Tue May 31 2016 Adam Miller <maxamillion@fedoraproject.org> - 0.1.1-1
  - First pello package
Copy to Clipboard Toggle word wrap

  • Requires 指令指定软件包的运行时依赖项，其中包括两个软件包：

    • python 软件包需要在运行时执行字节编译的代码。
    • bash 软件包需要执行小入口点脚本。
  • BuildRequires 指令指定软件包的 build-time 依赖项，它只包括 python 软件包。pello 程序需要 python 来执行字节编译构建过程。
  • %build 部分指定如何构建软件，创建脚本的字节编译版本。请注意，在实际打包中，它通常会根据所使用的发行版自动完成。
  • %install 部分对应于这样的事实，即您必须将字节文件安装到系统上的库目录中，以便可以访问它。

在 spec 文件中内联创建包装程序脚本的示例表明 spec 文件本身是可以写成脚本的。此打包程序脚本使用 此文档 执行 Python 字节编译的代码。

4.5.5. C 程序示例的 spec 文件示例
复制链接

您可以对使用 C 编程语言编写的 cello 程序使用以下示例 spec 文件作为参考。

使用 C 编写的 cello 程序的 spec 文件示例

Name:           cello
Version:        1.0
Release:        1%{?dist}
Summary:        Hello World example implemented in C

License:        GPLv3+
URL:            https://www.example.com/%{name}
Source0:        https://www.example.com/%{name}/releases/%{name}-%{version}.tar.gz

Patch0:         cello-output-first-patch.patch

BuildRequires:  gcc
BuildRequires:  make

%description
The long-tail description for our Hello World Example implemented in
C.

%prep
%setup -q

%patch0

%build
make %{?_smp_mflags}

%install
%make_install

%files
%license LICENSE
%{_bindir}/%{name}

%changelog
* Tue May 31 2016 Adam Miller <maxamillion@fedoraproject.org> - 1.0-1
- First cello package
Copy to Clipboard Toggle word wrap

  • BuildRequires 指令，其指定软件包的 build-time 依赖项，包括以下执行编译构建过程所需的软件包：

    • gcc
    • make
  • 本例中省略了该软件包的运行时依赖项 Requires 指令。所有运行时要求都由 rpmbuild 进行处理，而 cello 程序不需要核心 C 标准库之外的任何内容。
  • %build 部分反映了这样一个事实，即此示例中，为 cello 程序编写了 Makefile 文件。因此，您可以使用 GNU make 命令。但是，您必须删除对 %configure 的调用，因为您没有提供配置脚本。

您可以使用 %make_install 宏安装 cello 程序。这是可能是因为 cello 程序的 Makefile 文件可用。

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat