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 python-pello
python-pello.spec created; type minimal, rpm version >= 4.11.
    Copy to Clipboard Toggle word wrap
    重要

    将 Python 项目打包到 RPM 中时，需要将 python- 前缀添加到项目的原始名称中。此处的项目名称是 Pello，因此 spec 的名称是 python-pello。

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

  3. 检查创建的文件。

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

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

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

先决条件

流程

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

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

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

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

    注意

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

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

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

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

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

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

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

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

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

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

您可以将以下 spec 文件示例用于 bash 中编写的 bello 程序供您参考。

使用 bash 编写的程序的 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
%autosetup

%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 环境才能执行。
  • %autosetup 宏解压缩源存档，由 Source0 指令引用，并更改它。
  • %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 文件示例
复制链接

您可以将以下示例 spec 文件用于使用 C 编程语言编写的 cello 程序供您参考。

使用 C 语言编写的程序的 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.patch

BuildRequires:  gcc
BuildRequires:  make

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

%prep
%autosetup

%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 标准库之外的任何内容。
  • %autosetup 宏解压缩源存档，由 Source0 指令引用，并更改它。
  • %build 部分反映在本示例中，cello 程序的 Makefile 文件被写入。因此，您可以使用 GNU make 命令。但是，您必须删除对 %configure 的调用，因为您没有提供配置脚本。

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

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat