费多拉

一般来说，这些指南适用于当前发布的、非生命周期结束的 费多拉和费多拉（生皮）的开发版本。 如果这些指南的特定部分仅与这些版本的子集相关，则会特别注明。 但是，请注意，生皮可能会快速变化，那里的变化是可见的，但这里尚未反映出来。

指南也在一定程度上涵盖了EPEL的软件包，但仅当与EPEL包装指南Fedora包装的变化远比EPEL包装快，因此随着时间的推移，这些指南将进一步偏离任何特定的EPEL版本，而对于较旧的受支持的EPEL版本，差异可能相当显著。这些指南中不适用于EPEL的部分通常不会显示。

由于这些指南永远无法涵盖所有可能的意外情况，因此总会有需要例外的包。包装商有责任尽可能严格遵守这些指南，并在包装规范文件中明确记录无法遵守的情况，作为注释。

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

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

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

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

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

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

许多特定于语言或域的指南都提到了“库”、“模块”、“插件”或其他特定于语言和域的术语。这对包命名特别重要。有些应用程序可能包括库，有些库可能包括应用程序，因此区别并不总是明确的。

在技术上可行的情况下，软件包应该可以独立安装，但如有必要，它们必须指定正确类型的依赖于其他软件包，请参阅依赖项类型如下所示。

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

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

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

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

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

虽然源文件中的校验和可以证明从lookaside缓存中检索的文件是打包程序上载的文件，但对于该文件是否是上游项目发布的文件，它是沉默的。上游开发人员的签名证明源代码与他们发布的代码相同。作为构建的一部分验证签名可以确保打包人员不会忘记验证它。

所有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参数到重建，构建要使用默认选项提交的源RPM，即，使这些参数都不存在于重建命令行。原因是这些需求被“序列化”到生成的源RPM中，即条件不再适用。

摘要应该是对文件包的简短描述。描述应在此基础上展开。

源发行版中包含的任何相关文档都应包含在相应文档目录中的包中。无关文档包括构建说明，无所不在安装包含非Linux系统的通用构建指令或示例以及文档的文件，例如。自述。MSDOS公司。还要注意您在哪个子包中包含文档。例如，API文档属于-开发子包，而不是主包。或者，如果有很多文档，可以考虑将其放在子包中。在这种情况下，建议使用*-文件作为子包名称。

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

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

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

尽管许可证文件是文档，但会对它们进行特殊处理（包括使用不同的标记）。请参阅许可指南如何处理它们。

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

变更日志应该使用%自动更改日志宏：

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

提交消息中的文本将成为更改日志的一部分，它应该提供与用户相关的更改的简要摘要。提交消息可能包含与打包程序相关的附加信息。

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

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

其目的是给用户一个提示，告诉他们软件包更新中发生了什么变化，而不会让他们被技术细节淹没。它们绝不能简单地包含源CHANGELOG条目的完整副本。对于需要更多信息的用户，可以输入上游新闻文件或变更日志的链接。

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

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

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

还请注意，安装在中的文件%｛mandir｝（_M）由RPM自动标记为文档。因此没有必要使用%文件.

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

如果上游不支持使用gcc构建，Fedora包应默认使用gcc作为编译器（对于gcc支持的所有语言）或clang。然而，如果有很好的技术原因，打包程序可能会选择不使用默认编译器。不使用默认编译器的有效技术原因示例包括但不限于：

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

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

这确保了在编译时使用Fedora的特定于clang的编译器标志。

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

打包程序还可以使用spec文件中的%build_cc、%build_cxx或%build-cpp宏来代替编译器名称的硬编码。通过将%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）才是实际文件，所有其他文件都是指向该文件的符号链接。当共享库文件仅以非版本化格式提供时，打包程序应要求上游考虑提供正确版本化的库文件。然而，在这种情况下，如果用户需要共享库文件来运行链接到它的程序，那么它必须进入基本包。如果上游在将来对共享库文件进行版本控制，则打包人员必须小心移动到上述版本控制布局。

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

Devel包是一个必须使用完全版本依赖项的基本包的包示例-仅包含共享库的libs子包通常不需要显式依赖于其基本包，因为它们通常不需要基本包成为功能库。

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

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

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

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。

有一种工具叫做检查路径包含在rpmdevtools工具包裹。将其添加到%__架构_安装_支柱宏~/.rpmmacro公司配置文件：

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

检查路径标记的任何rpath必须被删除。

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

根据经验，使用%配置（noreplace）而不是普通的%配置除非你最好的、有根据的猜测是，这样做会破坏一切。换言之，在升级包时覆盖配置文件中的本地更改之前，请仔细考虑。以下情况的示例不使用诺雷普莱斯是指包的配置文件发生更改，导致新的包版本无法与以前包版本的配置文件一起使用。只要是普通的%配置如果使用，请在规范文件中添加简短注释，解释原因。

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

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

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

打包系统单元和系统管理服务的详细指南如下在这里.

如果一个包包含GUI应用程序，那么它还需要包含一个正确安装的.desktop文件。出于这些准则的目的，GUI应用程序被定义为绘制窗口并从该窗口中运行的任何应用程序。已安装。桌面文件必须遵循台式机-规格，特别注意验证Name、GenericName的正确用法，类别,启动通知条目。

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

强烈建议打包程序使用宏而不是硬编码目录名（请参阅RPM宏). 然而，在宏比它所代表的路径长的情况下，或者在打包程序觉得使用实际路径更干净的情况下。打包程序可以使用实际路径而不是宏。这种方法有几个注意事项：

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

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

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

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

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

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

使用%全球而不是%定义，除非在其他宏定义中确实只需要本地定义的子宏（这种情况非常罕见）。

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

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

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

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

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

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

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

在某些情况下，应用程序可能会对其区域设置使用不同的“名称”。您可能需要查看区域设置文件并查看它们的名称。如果他们被命名我的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在航站楼。

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

下面是正确使用%查找语言，英寸食品规格使用gettext和名为“bar”而不是“foo”的手册页本地化“foo“应用程序：

生成日志文件的包应在%{_localstatedir}/log下的包特定（和包拥有的）目录中写出其日志文件。除非要打包的软件旋转其自己的日志，否则它还必须附带一个logrotate配置文件来旋转其日志文件。

在spec文件中添加文件复制命令时，请考虑使用保留文件时间戳的命令，例如。，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}中，而不是放在/var/www/中。这样做是因为：

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

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

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

例子：

具有这些定义的包将被视为大于具有更高版本或更高版本的包。由于Epoch让人困惑（并且一旦使用就无法从包装中移除），因此它只能在Fedora中使用作为最后的手段解决软件包的升级顺序问题，应尽可能避免。

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

有两种制作符号链接的方法，一种是相对链接，另一种是绝对链接。在Fedora中，这两种方法都不需要。在决定哪种符号链接创建方法合适时，打包者应该使用他们的最佳判断。

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

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

如果包的源代码提供了测试套件，则应在%检查部分，只要可行。

有处理tmpfiles.d配置和目录（在/run和/run/lock中）的特定准则：Tmp文件。d日.

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

如果在没有任何功能更改的情况下重命名软件包，或者是对现有软件包的兼容-彻底替换（其中“足够”意味着它只包括版本升级更改中常见的重大更改），请提供干净的升级路径并与以下内容兼容：

$provEVR引用了一个（Epoch-）Version-Release元组，该元组是原始未更改的包在版本或发布被中断时所具有的元组。您通常在这里使用宏，因为提供的EVR应该随着重命名包的版本和发行版的进展而继续升级$obsEVR是一个（Epoch-）版本释放元组，它的安排使得有一个干净的升级路径，但不会无端地污染向上的版本空间。您通常不会使用宏来实现这一点，因为您只是试图超越以旧名称命名的上一个已知版本。

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

如果退役的软件包需要从最终用户机器中删除，因为它们会导致影响升级或其他有害的依赖性问题，则软件包管理员应要求过时：被添加到软呢帽过时包装。只需提交bugzilla票据在这里。请包括需要淘汰哪些软件包的信息，需要淘汰的确切版本，以及不允许继续安装的原因。

如果过时的软件包有一个Epoch集合，则必须将其保存在提供：和过时：例如，假设foo被重命名为bar，bar与foo兼容，最后一个foo包版本是foo-1.0-3.fcNN具有时代：2。应将以下内容添加到条形图中（如适用，所有子包装也应如此）：

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

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

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

对于通常不通过使用包名称作为依赖项来拉入的包，例如仅库包（通过库名称依赖项拉入），通常不需要添加Provides。但是请注意，lib包的-devel子包是使用包名称作为构建依赖项拉入的，因此在其中添加Provides通常是合适的。

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

如果应用程序包含对IPv4和IPv6的本机和稳定支持，并且对IPv6的支持不会对IPv4产生负面影响，则必须在Fedora包中启用这两种支持。

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

如果包的更新解决了已知的安全问题（在更新时），并为其分配了常见漏洞和暴露（CVE）编号，则应在RPM更改日志条目中提及CVE编号。

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

如果包引入了构建时循环依赖项，则应使用此宏引导包：

如果您的包显式地提供：引导时缺少的一些功能提供：应如下所示：

请注意，如中所述，在引导程序中使用预先构建的二进制文件仍然需要包装委员会的例外一般例外政策.

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

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

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

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

如果（并且仅当）脚本需要保持可执行状态并且无法修改以通过检查，则维护人员可以选择禁用检查和修改。也可以通过设置%__brp_mangle_shebangs_exclude_from和%__brp_mangle_shebangs_exclude分别使用与中描述的设置相同的语法打包：AutoProvidesAndRequiresFiltering。也可以通过添加%取消定义__brp_mangle_shebangs靠近规范文件的开头。

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

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

任何以这种方式禁用BRP脚本的程序包都必须在附带的注释中注明原因。要查看默认运行的BRP脚本列表，请调用：

要查看所有BRP脚本的列表，请调用：

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

一些应用程序、语言和构建系统在其自己的页面上为其编写了特定的指南：