第15章 在 Port Makefile 中变量的顺序
最后更新于
最后更新于
FreeBSD 中文社区
Makefile 的第一个部分必须按相同顺序进行。这个标准使得每个人都可以很容易地阅读任何port，而不必按随机顺序搜索变量。
这个区块是最重要的。它定义了port名称、版本、分发文件位置和类别。变量必须按照这个顺序：
MASTER_SITE_SUBDIR (弃用)
这个区块是可选的。变量有:
此块是强制性的。变量包括：
此块是可选的，尽管强烈推荐。变量包括：
LICENSE_GROUPS 或 LICENSE_GROUPS_NAME
LICENSE_NAME 或 LICENSE_NAME_NAME
LICENSE_TEXT 或 LICENSE_TEXT_NAME
LICENSE_FILE 或 LICENSE_FILE_NAME
LICENSE_PERMS 或 LICENSE_PERMS_NAME_
LICENSE_DISTFILES 或 LICENSE_DISTFILES_NAME
If there are multiple licenses, sort the different LICENSE_VAR_NAME variables by license name.
BROKEN/IGNORE/DEPRECATED MessagesThis block is optional. The variables are:
这个区块是可选的。变量为：
TEST_DEPENDS
这个区块是可选的。
从定义 FLAVORS 开始这一部分。继续使用可能的 Flavors 助手。查看更多信息，请参阅 FLAVORS 。
构造设置变量，不能使用 .if ${FLAVOR:U} == foo 作为助手的应放在各自的下面部分。
从定义 USES 开始，然后可能是 USE_x
将相关变量放在一起。例如，如果使用 USE_GITHUB ，请紧接着放 GH_* 变量。
此部分块是 bsd.port.mk 中可以定义的变量，这些变量不属于任何先前的部分块。
顺序并不重要，但尽量将类似的变量放在一起。例如，uid 和 gid 变量 USERS 和 GROUPS 。配置变量 CONFIGURE_* 和 *_CONFIGURE 。文件和目录列表 PORTDOCS 和 PORTEXAMPLES 。
如果port使用选项框架，请先定义 OPTIONS_DEFINE 和 OPTIONS_DEFAULT ，然后先定义其他 OPTIONS_* 变量，然后是 *_DESC 描述，最后是选项助手。尝试按字母顺序对所有这些进行排序。
示例 1。选项变量顺序示例
FOO 和 BAR 选项没有标准描述，因此需要编写一个。其他选项已在 Mk/bsd.options.desc.mk 中有描述，因此不需要编写。 DOCS 和 EXAMPLES 使用目标助手安装它们的文件，尽管它们属于目标，但为了完整起见，这里显示它们，因此其他变量和目标可以在它们之前插入。
然后是前面未提及的其余变量。
在定义所有变量之后，可以定义可选的 make(1) 目标。在不同阶段运行时，保持 pre- ** 在 post- ** 之前，并按照相同顺序。
fetch
extract
patch
configure
build
install
test
每个后续区块必须与前一个区块用一个空行分隔。 在下面的区块中，只设置port所需的变量。按照这里显示的顺序定义这些变量。
BROKEN_* 和 IGNORE_* 可以是任意通用变量，例如， IGNORE_amd64 ， BROKEN_FreeBSD_10 等。除了依赖于 USES 的变量，将其放在 USES 和 USE_x 中。例如，只有当设置 php 时， IGNORE_WITH_PHP 才有效，只有当设置 ssl 时， BROKEN_SSL 才有效。 如果port在满足某些条件时标记为 BROKEN，并且只能在包含 bsd.port.options.mk 或 bsd.port.pre.mk 后才能测试这些条件，则应稍后设置这些变量，即其余变量。