第15章 在 Port Makefile 中变量的顺序
最后更新于
最后更新于
FreeBSD 中文社区 2024
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 后才能测试这些条件,则应稍后设置这些变量,即其余变量。