Fedora包装指南

一般来说，这些指南适用于当前发布的，Fedora的非报废版本，以及Fedora（生皮）的开发版本。如果这些指南的特定部分是相关的仅适用于这些版本的子集，这将被特别注意。然而，请注意生皮会迅速变化，有时会出现变化这里还没有反映出来。

该指南也在一定程度上涵盖了EPEL、，但仅当与EPEL包装指南.Fedora包装的变化远比EPEL包装快，因此，随着时间的推移，这些指导方针将偏离更远来自任何特定的EPEL版本以及支持较早的EPEL版本这些差异可能非常显著。这些指南中不适用于EPEL的部分通常不会显示。

由于这些指南永远无法涵盖所有可能的意外情况，总会有需要例外的包。包装商有责任遵守这些指南尽可能接近并清楚记录，作为包规范文件中的注释，无法遵循的实例。

如果在指南中使用了“应该”或“建议”的语言而且该方案不可能符合该指南，包装商可能会偏离它。偏差的性质及其背后的原因必须记录在规范文件中。

如果使用“必须”、“必须”或“需要”等语言，包装商可能会偏离指南只有经过包装委员会的批准。请按照包装委员会用于发出这些请求的页面。

请审阅可以打包的内容以确保要包装的东西在Fedora是允许的。

你应该通过命名原则以确保包的名称正确。

包含使用版本和发布字段的正确方法的文档可以找到在这里.

您应该查看以下信息决定在Fedora允许的许可证和许可指南确保您的软件包获得适当的许可并且许可证被正确地指示。

许多特定语言或领域的指南都提到“库”，“模块”、“插件”或其他特定于该语言的术语，或域。这对包装特别重要命名。一些应用程序可能包括库，而一些库可能包括应用程序，因此区别并不总是很清楚。

在技术可行的情况下，软件包应可独立安装，但如有必要，它们必须指定正确类型对其他包的依赖关系，看见依赖项类型如下所示。

桌面应用程序不得依赖于其他桌面应用程序除非严格要求。特别是，包含可见.桌面文件（a）.桌面不包含该行的文件NoDisplay=真)不应该有要求,建议,或补充资料在包含可见桌面文件的任何其他软件包上，直接或间接。

例如，使用视频游戏级别的编辑器是合理的需要相关的视频游戏才能运行，或者应用程序的插件需要关联的应用程序。但申请不合理碰巧使用了数据库库依赖于与该库关联的数据库管理套件，或者用于碰巧使用特定编程语言的应用程序依赖于与该编程语言相关联的管理工具。

如果源程序包提供多个图形应用程序，如果可行，这些应用程序应该打包在单独的子包中。

spec文件（“spec”）是打包工作流中的基本元素。对包所做的任何更改都将包括对规范的更改。因为Fedora中的包是由一群包装商维护的以及自动化工具，规范必须遵循某些约定。这些包装指南的大部分内容涉及规范中的内容，但这里有一些一般项目。

上游项目发布其发布的OpenPGP签名时，Fedora软件包应该作为RPM构建过程的一部分，验证该签名。

虽然源文件中的校验和可以证明从后备缓存中检索的文件是打包者上传的那个，对于该文件是否是上游项目发布的文件，它没有给出答案。上游开发商的签名证明消息来源与他们发布的内容相同。作为构建的一部分验证签名可确保包装商不会忘记验证。

所有Fedora包都必须成功编译和构建在至少一个受支持的主体系结构上转换为二进制rpm，除非该包仅在二级体系结构上有用（例如特定于体系结构的引导实用程序、微码加载器、，或硬件配置工具）。Fedora包装商应尽一切努力支持主要体系结构.

内容、不需要编译或构建的代码，与体系结构无关的代码（noarch）是显著的例外。

费多拉遵循文件系统层次结构标准关于文件系统布局，例外情况如下。FHS定义了文件应放在系统中的位置。

在二进制和源rpm上运行rpmlint以检查它们是否存在常见错误，并修复它们（除非rpmlint是错误的，这种情况也可能发生）。如果你发现rpmlint的输出很神秘，这个-e（电子）切换到它可以使用以获取大多数错误和警告的详细描述。请注意，rpmlint将执行其他检查如果给定已安装包的名称。例如，dnf安装foo-1.0-1.f20.x86_64.rpm；rpmlint-i foo将对foo包执行一组测试rpm链接foo-1.0-1.f20.x86_64.rpm不能。可以找到关于rpmlint问题的社区维护页面在这里.

所有包依赖项（构建时或运行时、常规、弱或其他）必须始终在官方的Fedora存储库中令人满意。

RPM可以自动确定大多数编译库的依赖项以及一些脚本语言，如Perl。自动确定的依赖关系不得重复通过手动依赖性。

但是，必须明确列出生成依赖项，除非使用自动生成依赖项生成器（例如。生锈或蟒蛇).请参阅构建时间依赖项（BuildRequires）.

只能使用版本依赖项（构建时或运行时）在实际需要时保证包的正确版本存在。如果满足版本依赖项通过之前三个Fedora版本中的版本那么不需要版本化依赖项而应该使用常规的未版本化依赖项。

定义了Epoch的包上的版本依赖项必须包含在该依赖项中。否则，依赖关系将无法按预期运行。

包中列出所有必要的构建依赖项很重要使用构建要求：标签。您可以假设有足够的环境供RPM运行，构建包并执行基本shell脚本，但您不应该假设存在任何其他包作为RPM依赖项以及由构建系统带入buildroot的任何东西可以随时间变化。

如果规范文件包含条件依赖项根据是否存在可选--有（无）foo参数到rpmbuild公司,使用默认选项构建要提交的源RPM，也就是说，这些参数都不存在在中rpmbuild公司命令行。原因是这些需求被“序列化”了到生成的源RPM中，即，条件不再适用。

摘要应该是对文件包的简短描述。描述对此进行了扩展。说明中不包括安装说明；这不是一本手册。如果软件包需要一些手动配置或者对用户有其他重要指示，请用户参阅包中的文档。添加自述。费多拉或类似的，如果你觉得这是必要的。此外，请确保描述中没有行长度超过80个字符。

请把个人偏好放在一边并在摘要和描述中使用美式英语拼写。包可以包含其他翻译的摘要/描述对于支持的非英语语言，如果可用。

源分发中包含的任何相关文档应包含在适当的文档目录中的包中。无关文档包括构建说明、，无所不在的安装包含通用构建指令的文件，或示例，和非Linux系统的文档，例如。自述。世界末日.还要注意在哪个子包中包含文档。例如，API文档属于-开发子包，不是主要的。或者如果有很多文档，考虑把它放在一个子包中。在这种情况下，建议使用*-文件作为子包名称。

标记a相对的路径具有%文件在中%文件部分将导致RPM复制引用的文件或目录从%_建筑工人到适当的位置进行文档记录。文件也可以放在%_pkgdocdir公司,而正在打包的软件的构建脚本可能会自动执行此操作当被召唤时%安装.然而，混合使用这些方法是有问题的并可能导致文件重复或冲突，所以使用%文件具有相对的文件的路径和安装直接进入%_pkgdocdir公司禁止在同一源包中。

标记为文档的文件不得导致包比没有文档时引入更多的依赖项。一种在大多数情况下确保这一点的简单方法是从中的文件中删除所有可执行权限%_pkgdoc目录.

文件位于%_pkgdocdir公司不得影响运行时打包软件的。软件必须正常工作功能不变如果这些文件被修改、删除或根本没有安装。

尽管许可文件是文档，他们受到特殊对待（包括使用不同的标签）。请参阅许可指南如何处理它们。

变更日志描述了对相关包的更改发送给包的用户。这包括新的上游版本对包的构建、重建方式的更改，以及其他影响结果的更改。仅与包装商相关的变更不应在更改日志。这包括规范文件清理、构建错误修复或解决方法，以及其他对二进制包的内容没有影响的更改。

变更日志应该从git提交日志自动生成使用%自动更改日志宏：

提交主题（提交消息的第一行）以及一些可选的附加行用于生成变更日志文本。提交作者姓名、电子邮件地址和提交时间戳在changelog条目中也使用。

提交消息中的文本将成为更改日志的一部分应提供与用户相关的更改的简要摘要。提交消息可能包含相关的其他信息分装商。

如果特定更改与Bugzilla错误相关，在变更日志条目中包含错误ID以便于参考，例如。

如果特定提交修复了CVE，则也应包含此信息。

其目的是向用户提示发生了什么变化在一个包更新中，而不会用技术细节压倒他们。它们决不能仅仅包含源CHANGELOG条目的完整副本。可以输入上游新闻文件或变更日志的链接对于那些想要更多信息的人。

请参见自动更改日志文档有关如何从git提交消息生成changelog的详细信息，以及如何为某些提交创建多行条目或跳过条目。

包装工可以或者使用手动更改日志，而不是%自动更改日志宏。这在中进行了描述手动更改日志.

由于手册页是获取Unix系统帮助的传统方法，包应该包含所有可执行文件的它们。如果缺少一些手册页，分装商应与上游合作进行添加。偶尔也可以找到其他发行版创建的页面，或使用帮助2man程序；这些通常是有用的起点。安装手册页时，请注意，RPM会将它们重新压缩为其首选格式。所以%文件章节必须参考手册采用考虑到这一点的模式：

还要注意，安装在中的文件%{手动}由RPM自动标记为文档。因此没有必要使用%文件.

对于本地化的手册页，请使用%find_lang—与man一起如中所述处理区域设置文件.

Fedora包应默认使用gcc作为编译器（适用于gcc支持的所有语言）如果上游不支持gcc建筑，则会发出叮当声。然而，如果有一个好的技术原因，打包程序可以选择不使用默认编译器。不使用默认编译器的有效技术原因的示例，包括但不限于：

打包程序选择使用非默认编译器应在规范文件的注释中记录此决定的原因。

如果使用clang构建包，打包程序必须将%toolchain宏设置为clang：

这样可以确保使用Fedora特定于clang的编译器标志编译时。

如果打包程序希望在规范文件中使用条件宏为了更容易在两个不同的编译器之间切换，则应使用以下宏名称：

打包程序也可以使用%build_cc、%buile_cxx或%build_cpp宏在spec文件中代替编译器名称的硬编码。通过设置%toolchain宏来控制这些变量的值要么是clang要么是gcc。

用于生成包的编译器必须遵守适用的编译器标志在系统rpm配置中设置。遵守意味着使用该变量的内容作为编译器实际使用的标志的基础在包构建期间。

对于C、C++和Fortran代码，这个%{optflags}宏包含这些标志。覆盖这些标志以进行性能优化（例如，-O3而不是-O2）通常不鼓励。如果您能够提供显示显著加速的基准对于此特定代码，可以根据具体情况重新审视这一点。允许添加、覆盖或筛选这些标志的部分如果有充分的理由这样做；这样做的理由必须记录在规范文件中。

通常允许使用某些与安全相关的标志。这些标志可能会略微降低性能但增加的安全性对于某些程序来说是值得的。

包装应产生有用的-调试信息包装，或者在无法生成有用的命令时显式禁用它们但rpmbuild无论如何都会这么做。每当-调试信息包被显式禁用，规范文件中需要解释为什么要这样做。Debuginfo包将在单独的文档中进行更详细的讨论，包装：Debuginfo.

Fedora包的设计必须具有文件的逻辑分隔。具体来说，-devel包必须用于包含文件仅用于开发或仅在构建时需要。这样做是为了最小化用户的安装占用空间。有一些类型的文件几乎总是属于-devel包：

版本控制的共享库文件（/usr/lib/libfoo.so.3.2.0和/usr/lib/libfoo.so.3）用户必须运行与libfoo链接的程序，所以它们属于基本包。另一个未版本化的共享库文件（/usr/lib/libfoo.so）仅用于将libfoo实际链接到正在编译的代码，并且不需要安装在用户系统上。这意味着它属于-devel包。请注意，在大多数情况下，只有完全版本化的共享库文件（/usr/lib/libfoo.so.3.2.0）是一个实际文件，所有其他文件都是指向它的符号链接。当共享库文件仅以未转换的格式提供时，包装商应询问上游考虑提供正确版本的库文件。但是，在这种情况下，如果需要共享库文件用户可以运行与其链接的程序，它必须进入基本包。如果上游在将来版本共享库文件，打包人员必须小心地移动到上面描述的版本化布局。

作为一个额外的复杂性，一些软件生成未转换的共享对象它们不打算用作系统库。这些文件通常是插件或模块化功能特定于应用程序，和不位于ld库路径或缓存中。这意味着它们不直接位于/usr/lib或/usr/lib64中，或在/etc/ld.so.conf中作为库路径列出的目录中（或/etc/ld.so.conf.d/config文件）。通常，可以找到这些未版本化的共享对象在/usr/lib或/usr/lib64下的专用子目录中（例如，/usr/lib/purple-2/是插件目录用于libpurple应用程序）。在这些情况下，未版本化的共享对象不需要放在-devel包中。

这种包装模式有一些明显的例外，具体如下：

当对文件是否属于基本包或in-devel有疑问时，包装人员应考虑文件是否必须存在用户正确使用或执行基本包中的功能，或者只是为了发展。如果它只是开发所必需的，那么它必须进入-devel包。

与所有Fedora包装指南一样，人们认识到有一些独特的情况超出了这个模型的界限。如果你遇到这样的情况，请用Fedora包装委员会并向我们解释，以便我们能够扩展《准则》来解决这一问题。

子包装通常是其基本包装的扩展在这种情况下，他们应该需要基本包。当子包需要基本包时，它必须使用完全版本化的特定于体系结构的（对于非noarch包）依赖性：

Devel包是包的一个示例这必须要求它们的基本包使用完全版本化的依赖项。-仅包含共享库的libs子包通常不需要显式依赖其基本包因为它们通常不需要将基本包作为函数库。

如果您最终遇到主包依赖于子包的情况和主包上的子包你应该仔细考虑关于为什么主包中没有所有内容。

只要可能（和可行），包含库的Fedora包应该将它们构建为共享库。没有必要打电话ldconfig（ldconfig）安装共享库时。

包含库的包应尽可能排除静态库（例如，通过配置--禁用静态).与库链接的应用程序应与共享库链接不是静态版本。

Libtool档案，食物.la文件，不应包括在内。默认情况下，使用libtool的包将安装这些即使使用配置--禁用静态,因此，可能需要在包装前将其移除。由于旧版本的libtool中的错误或使用它的程序中的错误，有时并不总是可以删除*.la文件不修改程序。在大多数情况下，与上游合作解决这些问题相当容易。请注意，如果您在稳定版本（而不是devel）中更新库并且该包已经包含*.la文件，删除*.la文件应该被视为API/ABI更改，即删除它们会更改库提供的接口因此，世界其他地区必须遵守Fedora政策用于潜在的不稳定更新。

Fedora包裹应尽一切努力避免多个独立的上游项目打包在一起。

其上游允许根据系统库构建的所有包必须根据系统库进行构建。在这种情况下，捆绑库（和/或其源代码）必须在%准备.可能需要修补构建脚本以处理这种情况。只要可能，该补丁应限制捆绑库的使用，以便可以将补丁发送到上游以供考虑。

上游没有针对系统库构建机制的所有包可能会选择捆绑图书馆，但如果他们这样做，他们必须包括一个他们捆绑的指示。这提供了一种使用捆绑代码定位库的机制，可以，例如，协助定位包裹可能具有特定的安全漏洞。

要指示捆绑的实例，首先确定捆绑库的名称和版本：

然后在规范中的适当位置，添加提供：捆绑（<libname>）=<version>哪里＜libname＞和<版本>是您在上面确定的名称和版本。如果无法确定版本，使用提供：捆绑（<libname>）而不是。

除了以这种方式指示捆绑外，其上游没有针对系统库构建的机制的包必须公开联系以获取支持系统库的路径。如果上游拒绝，则必须将其记录在规范文件中，在上面“提供：”旁边的注释中，或在签入SCM的附加文件中并由放置在提供：以上。

有时，链接二进制文件时，代码会硬编码特定的库路径（使用-rpath或-R标志）。这通常称为rpath。通常，动态链接器和加载程序（ld.so）解决可执行文件对共享库的依赖性并加载所需的内容。然而当使用-rpath或-R时，然后将位置信息硬编码到二进制文件中并在执行开始时由ld.so检查。由于Linux动态链接器通常比硬编码路径更智能，我们通常不允许在Fedora中使用rpath。

有一种工具叫做检查rpath其中包括在中rpmdevtools工具包裹。将其添加到%__arch_安装_主机宏在您的~/.rpmmacro公司配置文件：

什么时候？检查路径运行时，您可能会看到如下输出：

检查rpath标记的任何rpath必须被移除。

配置文件必须在包中进行标记。

根据经验，使用%配置（无位置）而不是普通的%配置除非你最好的、有根据的猜测是这样做会破坏一切。换句话说，在覆盖本地更改之前要仔细考虑在配置文件中有n个包升级。以下情况的示例不使用无位置包的配置文件更改时这样新的软件包修订版就不起作用了使用上一版本包中的配置文件。只要是普通的%配置使用，在spec文件中添加简短注释，解释原因。

不要在/usr下使用%config或%config（noreplace）。/usr被认为不包含Fedora中的配置文件。

在费多拉的下一个世界，我们将有一套精选的Fedora产品以及经典Fedora的可用性。从历史上看，我们维护了一组配置默认值对于所有Fedora安装，但不同的目标用户有不同的需求。请参阅产品配置指南有关如何创建包的说明需要在Fedora.next产品之间采取不同的行为。

Fedora中禁止使用SystemV样式的initscripts。必须使用系统装置。

包装系统单位的详细指南和系统管理服务在这里.

如果包中包含GUI应用程序，那么它还需要包含一个正确安装的.desktop文件。在本指南中，GUI应用程序定义为绘制窗口的任何应用程序从窗户里跑出来。已安装的.desktop文件必须遵循台式机-规格,特别注意验证名称，通用名称，类别,启动通知条目。

包含图形应用程序的包应包含AppData文件。请参见打包：AppData相关指南。

强烈建议包装人员使用宏而不是硬编码目录名（请参见RPM宏).然而，在宏比它所表示的路径长的情况下，或者包装商觉得使用实际路径更清洁的情况下，允许打包程序使用实际路径而不是宏。这种方法有几个注意事项：

名称以下划线开头的宏通常被认为是RPM内部的实现细节及其关联的宏包且不应在规范文件中引用除了设置它们的值以影响RPM行为。这意味着不应使用系统可执行文件的宏形式。例如，rm（毫米）应优先使用%{__rm}.然而，在某些情况下，根本没有提供所需的数据在没有下划线前缀的名称下。如果是这种情况，可以使用带前导下划线的宏。鼓励宏包的作者避免使用前导下划线命名要在规范文件中使用的宏时（与设置相反）。

在Source:或Patch:行中包含宏是一个风格问题。有些人喜欢没有宏的源代码行的可读性。其他人更喜欢在使用宏时轻松更新新版本。在所有情况下，请记住在规范文件中保持一致并验证您列出的URL是否有效。spectool（来自rpmdevtools包）可以帮助您检查URL是否包含宏。

如果需要确定包含宏的实际字符串，您可以使用rpm。例如，要确定实际Source:值，可以运行：

有时需要写一个简短的脚本（可能是一句话）在%准备,%建造，或%安装等级库文件的节以获取有关构建环境的一些信息。为了简化依赖关系图，为此，规范文件应仅使用以下语言：

此外，如果您的包在没有特定脚本语言的情况下无法构建（例如Ruby或Tcl），并且因此已经在该语言上具有BuildRequires，它也可以从spec文件中调用。

注意：如果在规范文件中调用Perl或Python（并且它还不是包的BuildRequires），您需要显式地为Perl或Python添加BuildRequires。

使用%全球而不是%定义,除非你真的只需要局部定义的子宏在其他宏定义中（这种情况非常罕见）。

理由：两个宏定义语句的行为相同当它们位于rpm嵌套级别的顶层时。

但当它们用于嵌套宏展开时（如中所示%{！？foo:…}构造，%定义理论上只持续到端撑（局部范围），虽然%全球定义具有全局范围。

请注意，%define和%global的区别不仅仅在于范围：%defined宏的主体被延迟扩展（即当使用时），但%global的主体在定义时被展开。可以使用%%-转义来强制%global的惰性扩展。

翻译文件可以由不同的程序处理针对不同的框架。确保为正确的包添加BuildRequires:否则，您的包可能无法在buildroot中生成翻译文件。

如果包使用gettext进行翻译，请添加

对于使用Linguist工具链的基于Qt的软件包，对于本地化实用程序，添加

如果你有足够少的区域设置文件，它们都可以放在一个包中，您可以使用%查找语言宏。（如果您需要将软件包拆分为单独的语言包，请看langpack指南.)此宏将定位属于您的包的所有文件（按名称），并将此列表放入文件中。然后可以使用该文件来包含所有区域设置。%查找语言应该在规范文件的%install部分运行，在所有文件都安装到buildroot中之后。的正确语法%查找语言通常是：

在某些情况下，应用程序可能会对其区域设置使用不同的“名称”。您可能需要查看区域设置文件并查看它们的名称。如果他们被命名我的app.mo,那么你需要通过我的应用程序到%查找语言而不是%{名称}.之后%查找语言正在运行，它将在活动目录中生成一个文件（默认情况下，是源目录的顶层）。此文件将根据您作为选项传递的内容进行命名到%查找语言宏。通常，它会被命名为%{name}.lang（名称）.然后，您应该在%文件列表包含检测到的区域设置%查找语言.为此，应该将其与-f参数一起包含到%文件.

请注意%查找语言默认情况下搜索gettext语言环境，但它也可以处理Qt翻译、本地化的手册页和帮助文件。

处理放入的GNOME帮助文件/usr/share/gnome/help/使用

处理放入的KDE帮助文件/usr/share/doc/HTML/使用

处理Qt.qm（平方米）二进制翻译文件使用

处理本地化的手册页（不包括默认的、非本地化的），使用

要查看所有选项，请运行/usr/lib/rpm/find-lang.sh在航站楼。

名称不同于%{名称}（例如，多个手册页）必须通过单独的呼叫来处理%查找语言.

下面是正确使用%查找语言,在里面foo.spec公司“foo”应用程序本地化使用名为“bar”而非“foo”的gettext和手册页：

生成日志文件的包应写出其日志文件在包特定（和包所有）目录中在%{localstatedir}/log下。除非正在打包的软件轮换自己的日志，它还必须提供一个logrotate配置文件来旋转其日志文件。

当在规范文件中添加文件复制命令时，考虑使用保留文件时间戳的命令，例如。，cp-p或安装-p.

当下载源、补丁等时。，考虑使用保留上游时间戳的客户端。例如wget-N（宽）或卷曲-R.要使wget的更改具有全局性，将此添加到您的~/.wgetrc:时间戳=开,对于卷发，添加到您的~/.curlrc:-R（右）.

只要可能，调用制作应按照

这通常会加快构建速度，尤其是在SMP机器上。

但是，请确保以这种方式干净地构建包因为有些make文件不支持并行构建。因此，您应该考虑添加

到您的~/.rpmmacro公司文件（甚至在UP机器上），因为这将暴露大多数错误。

在Fedora包中使用scriptlet时应格外小心。如果使用了scriptlet，那么这些scriptlet必须是健全的。记录了一些常见的scriptlet在这里.

在构建软件时，您尚未对其进行全面安全审计，保护敏感数据，如GPG私钥，在单独的用户帐户中。

这同样适用于评审员/测试人员。在单独的帐户中重建src.rpms其不能访问任何敏感数据。

使用RPM的设施生成可重定位的包强烈反对。很难正常工作，无法从安装程序或yum使用，如果遵循其他包装指南，则通常不需要。然而，在不太可能的情况下，你有一个很好的理由使包可重新定位，你必须在包裹审查请求中说明这一意图和理由。

您的包应该拥有所有文件作为%install过程的一部分安装的。

在大多数情况下，对于多个程序包，不需要包含同一文件的相同副本。然而，如果有必要，多个包可能包含同一文件的相同副本，只要满足以下要求：

或

此外，相同的文件被定义为在中始终相同的文件文件系统上的内容、校验和、权限和位置在每个包中。

一种值得注意的文件类型，通常在子包之间以相同的方式共享是许可证文本。在某些情况下，需要复制许可证文本跨包中的多个%files节。有关更多详细信息，请参阅子包许可.

目录所有权比文件所有权稍微复杂一些。程序包必须拥有其放置文件的所有目录，但以下目录除外：

在此上下文中，定义了包的“自然依赖链”作为该包正常运行所必需的包集。具体来说，你不需要为唯一的事实要求包装它碰巧拥有一个目录，您的包将文件放在其中。如果您的包裹因其他原因已经需要该包裹，那么您的包不应该也拥有该目录。

在所有情况下，我们都在防范无主目录存在于系统中。请参阅打包：未拥有的目录了解详细信息。

以下是描述如何处理大多数情况的示例目录所有权的。

一些软件包需要或受益于专用运行时用户和/或组帐户。处理这些情况的指南见单独文件.

请注意，为Fedora打包的系统服务不得作为没有人用户，但必须分配自己的系统用户。

Fedora中打包的Web应用程序应将其内容放入/usr/share/%{name}和NOT进入/var/www/。这样做是因为：

只要可能，Fedora包应该避免相互冲突。不幸的是，这并不总是可能的。有关Fedora冲突政策的详细信息，请参阅：冲突.

替代方案和环境模块等工具还可以帮助防止包冲突。

RPM支持一个名为“Epoch:”的字段，这是一个数字字段，如果设置，为RPM添加了另一个限定符，用于进行包比较。具体来说，如果设置了，包的纪元胜过所有其他比较（除了更大的纪元）。如果Epoch没有设置在封装中，RPM将其视为设置为0。

例子：

具有这些定义的包将被视为大于具有更高版本或更高版本的软件包。因为纪元让人困惑（一旦使用，就不能从包装中取出），只能在Fedora使用作为最后的手段解决包的升级订购，应尽可能避免。

此外，Epoch使正常的包装指南复杂化。如果软件包使用Epoch，必须在任何地方提及%{版本}-%{发布}使用。例如，如果所依赖的包有一个Epoch，添加版本依赖项时必须列出：

制作符号链接有两种方法，作为相对链接或绝对链接。在Fedora中，这两种方法都不需要。包装商应做出最佳判断当决定哪种符号链接创建方法合适时。

在某些情况下，替换目录的符号链接需要特殊处理。用任何类型的文件替换目录总是需要特殊处理。

请参见打包：目录替换获取有关执行此操作的信息。

如果包的源代码提供了测试套件，它应该在%检查第节，只要切实可行。

如果您安装了sysctl配置片段foobar.conf到%{_sysctldir}（/usr/lib/sysctl.d/）您必须在%post部分中调用%sysctl_apply：

如果安装binfmt配置片段waldo.conf到%{_binfmtdir}（/usr/lib/binfmt.d/）必须在%post节中调用%binfmt_apply：

这些具有进行适当更改的效果包装安装后立即而不需要重新启动或手动激活。

有处理tmpfiles.d的具体指南配置和目录（在/run和/run/lock中）：Tmp文件。d日.

如果需要重命名或替换现有包，新的包应该使更改对最终用户透明在适用的范围内。

如果在没有任何功能更改的情况下重命名包，或是现有软件包的兼容全面替代（其中“足够”意味着它只包括幅度的变化常见于版本升级更改中），提供干净的升级路径并与以下各项兼容：

$provEVR引用（Epoch-）版本释放元组原来没有改变的包裹如果它的版本或发布被取消。您通常在这里使用宏，因为提供的EVR应该继续上升随着重命名包在版本和发行版方面的进步。$obsEVR是（Epoch-）版本释放元组安排为有一个干净的升级路径但不会无端地向上污染版本空间。通常不使用宏进行此操作因为您只是试图超越上一个已知版本以旧名字命名。

如果包取代/替换现有包而不是上述定义的充分兼容的替代品，仅使用过时：行。

如果需要从最终用户计算机中删除失效的包因为它们会导致影响升级的依赖性问题或其他有害物质，包装商应要求过时：被添加到软呢帽过时包装.只需提交bugzilla罚单在这里.请包括需要废弃哪些软件包的信息，需要废弃的确切版本，以及不允许它们保持安装状态的原因。

如果过时的软件包有一个Epoch集合，它必须保存在提供：和过时：.例如，假设foo被重命名为bar，bar与foo兼容，最后一个foo包发布foo-1.0-3.fcNN具有时代：2.应在栏中添加以下内容（同样适用于所有子包）：

明确的提供：需要知道是否该包提供了可以在架构依赖项中使用的东西或特定于拱门的时尚。对于非noarch的软件包，提供：应使其特定于拱门通过应用%{？isa}宏添加到“提供”中文本字符串的末尾（例如。提供：foo%{？_isa}=2:%{版本}-%{发布}).明确提供可使用内容的包以拱门相关的方式（例如，那些家属不需要属于同一拱门的人）无需应用此宏。在某些情况下，一个包将提供多个元素，其中一些只能由同一拱门的家属使用还有一些可能被任何拱门的家属所消耗。在这种情况下，特定于体系结构和依赖于体系结构的Provides:都是有保证的。

应明确提供的包示例仅特定于拱门提供：包括本机代码库或插件及其相关的-devel包。应明确提供只有建筑独立提供：包括大多数独立程序（除所有noarch软件包外）。尽管这些程序本身可能是特定的，在大多数情况下，运行它们的客户不应该关心它们的arch。显式提供（例如），都是本机代码库以及该库的解释语言接口应同时具有特定于体系结构的（对于本机代码库的客户端）和arch-independent（用于解释语言接口的客户端）提供：。

如果包没有标准命名或与重命名相关的其他长期命名兼容性要求，应假定Provides已弃用且寿命短并在发行版的下一个版本中删除（即，如果在FC-X中引入，则保留在所有后续的包修订中对于发行版FC-X和FC-（X+1），FC中的下降-（X+2）），以及计划删除的发行版记录在规范文件的注释中。应通知受影响包裹的维护人员并鼓励改用新名称。向前兼容性提供：在较旧的发行版中，可以考虑分支为了使包维护人员能够在分支之间保持相同的简单规范文件但仍切换到较新的名称。

对于通常不拉入的包裹通过使用包名称作为依赖项例如仅库程序包（通过图书馆的soname dependencies拉入），通常不需要添加Provides。但是请注意，lib包的-devel子包使用包名称作为构建依赖项拉入，因此，在那里添加Provides通常是合适的。

存在一个过程，用于指示包已弃用并可能在未来离开分配。请参见正在弃用程序包.

如果应用程序包含对IPv4和IPv6二者的本地和稳定支持，并且对IPv6的支持不会对IPv4产生负面影响，则必须同时启用这两个功能在Fedora包中。

有关如何打包cron文件的详细信息，请参阅：Cron文件.

如果包的更新解决了已知的安全问题（更新时）具有分配给它的通用漏洞和暴露（CVE）编号，您应该在RPM更改日志条目中提及CVE编号。

Fedora构建系统中的包是在模拟chroot中构建的无法访问互联网。包不得依赖或使用任何网络资源他们自己不创建的（例如，用于测试）。在任何情况下，都不应从任何外部来源下载源代码，仅从lookaside缓存和/或Fedora-git存储库。

如果您的包引入了构建时循环依赖项，您应该使用此宏引导程序包：

如果您的包显式地提供：一些功能引导时会丢失，然后是那个提供：应如下所示：

请注意，预构建二进制文件的使用in-bootstrap仍然需要包装委员会的例外如中所述一般例外政策.

使用SSL或TLS加密协议的应用程序必须遵守加密策略.

打包脚本文件时，要使用的解释器在脚本的第一行中指定（shebang线）跟随#!,以下规则适用：

自动修改可执行脚本的Shebang行将调用转换为环境直接使用适当的可执行文件在里面/usr/bin（用户/二进制）.还进行了各种检查，以验证shebang线是否有效，因此，构建过程可能会失败。最后，还可以进行其他特定于语言的修改。因此，通常不需要手动修改可执行脚本修复环境只要启用此功能即可使用。

如果自动检查和修改破坏了包，有两个主要选项：

如果（且仅当）脚本需要保持可执行状态并且不能修改以通过检查，则维护人员可以选择禁用检查和修改。也可以禁用特定路径的功能或通过设置特定的shebang线%__brp_mangle_shebangs_exclude_from和%__brp_mangle_shebangs_exclude,分别使用与中描述的设置相同的语法包装：自动提供和要求筛选.也可以完全禁用该功能通过添加%取消定义__brp_mangle_shebangs在规范文件的开头附近。

BRP脚本在%安装（通过%__os安装后宏）并执行一些自动健全性检查或对其进行调整，安装在生成根目录中的文件。

所有包都应始终遵循所有BRP脚本，但有时包有必要选择退出某些包。可以禁用任何BRP脚本只需将相应的变量定义为%{无}.例如，要禁用brp-python字节编译脚本：

任何以这种方式禁用BRP脚本的程序包都必须注明原因在附带的评论中。对于默认运行的BRP脚本的列表，援引：

有关所有BRP脚本的列表，援引：

在大多数情况下，这些指南以及以下特定于应用程序的指导原则Fedora和EPEL的外包装。然而，必然存在一些差异。包装EPEL时，请同时咨询EPEL包装指南了解更多信息。

一些应用程序、语言和构建系统在他们自己的页面上为他们编写了具体的指导方针：