5.14.Makefile 参数
许多应用程序可以通过可选或不同的配置进行构建。示例包括选择自然（人类）语言、图形界面与命令行界面，或支持的数据库类型。用户可能需要不同于默认配置的版本，因此 Ports 系统提供了 hook，port 作者可以使用这些 hook 来控制将构建哪种变体。正确支持这些选项将使用户满意，并有效地提供多个 port，而收费仅为一个。
5.14.1. OPTIONS
OPTIONS5.14.1.1. 背景
OPTIONS_* 向安装 port 的用户提供一个对话框，显示可用的选项，然后将这些选项保存到 ${PORT_DBDIR}/${OPTIONS_NAME}/options。下一次构建该 port 时，将重用这些选项。PORT_DBDIR 默认值为 /var/db/ports。OPTIONS_NAME 是 port 来源的名称，使用下划线作为空格分隔符，例如，对于 dns/bind99 来说，它将是 dns_bind99。
当用户运行 make config（或首次运行 make build）时，框架会检查 ${PORT_DBDIR}/${OPTIONS_NAME}/options。如果该文件不存在，将使用 OPTIONS_* 的值，并显示一个对话框，用户可以在其中启用或禁用选项。然后，options 被保存，配置的变量将在构建 port 时使用。
如果新版本的 port 添加了新的 OPTIONS，该对话框将展示用户保存的旧 OPTIONS 值，并预填新选项。
make showconfig 显示保存的配置。使用 make rmconfig 可以移除保存的配置。
5.14.1.2. 语法
OPTIONS_DEFINE 包含要使用的 OPTIONS 列表。这些选项是独立的，彼此之间没有分组：
OPTIONS_DEFINE= OPT1 OPT2定义后，OPTIONS 应该进行描述（可选，但强烈推荐）：
OPT1_DESC= 描述 OPT1
OPT2_DESC= 描述 OPT2
OPT3_DESC= 描述 OPT3
OPT4_DESC= 描述 OPT4
OPT5_DESC= 描述 OPT5
OPT6_DESC= 描述 OPT6ports/Mk/bsd.options.desc.mk 包含许多常见 OPTIONS 的描述。虽然通常有用，但如果描述不充分，可以覆盖这些描述。
技巧
在描述选项时，要从用户的角度来看待：“它改变了什么功能？”和“为什么我要启用这个？”不要只是重复名称。例如，描述
NLS选项为“包含 NLS 支持”并不能帮助用户，用户已经可以看到选项名称，但可能不知道它是什么意思。描述为“通过 gettext 工具提供本地语言支持”则更加有用。
重要
选项名称始终使用全大写字母，不能使用混合大小写或小写字母。
OPTIONS 可以作为单选组进行分组，每组只能选择一个选项：
警告
每次选项有效时，必须选择每个
OPTIONS_SINGLE组中的一个选项。每个组的一个选项 必须 被添加到OPTIONS_DEFAULT。
OPTIONS 也可以作为单选组进行分组，每组可以选择零个或一个选项：
OPTIONS 还可以作为“多选”列表进行分组，至少一个 选项必须启用：
OPTIONS 还可以作为“多选”列表进行分组，零个或任意数量的选项可以启用：
默认情况下，OPTIONS 是未设置的，除非它们列在 OPTIONS_DEFAULT 中：
OPTIONS 定义必须出现在包含 bsd.port.options.mk 之前。PORT_OPTIONS 的值只有在包含 bsd.port.options.mk 后才能进行测试。也可以使用 bsd.port.pre.mk 进行包含，且在 bsd.port.options.mk 引入之前写的 ports 中仍广泛使用。但要注意，某些变量在包含 bsd.port.pre.mk 后可能无法按预期工作，通常是某些 USE_* 标志。
示例 39. OPTIONS 的简单使用
示例 40. 检查未设置的 Port OPTIONS
上述形式不推荐使用。推荐的方法是使用一个配置选项来真正启用和禁用特性，以匹配选项：
示例 41. OPTIONS 的实际使用
5.14.1.3. 默认选项
以下选项默认始终开启：
DOCS- 构建并安装文档。NLS- 本地语言支持。EXAMPLES- 构建并安装示例。IPV6- IPv6 协议支持。
注意
不需要将这些选项添加到
OPTIONS_DEFAULT中。然而，为了使它们生效并在选项选择对话框中显示，它们必须添加到OPTIONS_DEFINE中。
5.14.2. 功能自动激活
在使用 GNU 配置脚本时，注意哪些可选功能是通过自动检测激活的。通过在 CONFIGURE_ARGS 中显式禁用不需要的可选功能，使用 --without-xxx 或 --disable-xxx。
示例 42. 错误的选项处理
在上面的示例中，假设系统上安装了 libfoo 库。用户不希望此应用程序使用 libfoo，因此在 make config 对话框中关闭了该选项。但应用程序的配置脚本检测到系统中存在该库，并将其支持包含到生成的可执行文件中。现在，当用户决定从系统中删除 libfoo 时，Ports 系统不会发出警告（因为没有记录对 libfoo 的依赖），但是应用程序会崩溃。
示例 43. 正确的选项处理
注意
在某些情况下，简写的条件语法可能会导致复杂构造的问题。通常会出现
Malformed conditional错误，可以使用替代语法作为
的替代。
5.14.3. 选项帮助工具
有一些宏可以帮助简化基于选项设置的条件值。为了便于访问，提供了一个全面的列表：
PLIST_SUB,SUB_LIST有关自动生成%%OPT%%和%%NOOPT%%，请参见OPTIONS_SUB。对于更复杂的用法，请参见 通用变量替换。
CONFIGURE_ARGS对于--enable-x和--disable-x，请参见OPT_CONFIGURE_ENABLE。对于
--with-x和--without-x，请参见OPT_CONFIGURE_WITH。对于所有其他情况，请参见
OPT_CONFIGURE_ON和OPT_CONFIGURE_OFF。CMAKE_ARGS对于布尔类型的参数（on、off、true、false、0、1），请参见OPT_CMAKE_BOOL和OPT_CMAKE_BOOL_OFF。对于所有其他情况，请参见
OPT_CMAKE_ON和OPT_CMAKE_OFF。MESON_ARGS对于接受true或false的参数，参见OPT_MESON_TRUE和OPT_MESON_FALSE。对于接受
yes或no的参数，使用OPT_MESON_YES和OPT_MESON_NO。对于接受
enabled或disabled的参数，参见OPT_MESON_ENABLED和OPT_MESON_DISABLED。对于所有其他情况，请使用
OPT_MESON_ON和OPT_MESON_OFF。QMAKE_ARGS参见OPT_QMAKE_ON和OPT_QMAKE_OFF。USE_*参见OPT_USE和OPT_USE_OFF。*_DEPENDS参见 依赖项。*(任何变量) 最常用的变量有直接的帮助工具，参见 通用变量替换。对于没有特定帮助工具的任何变量，请参见
OPT_VARS和OPT_VARS_OFF。
5.14.3.1. OPTIONS_SUB
OPTIONS_SUB如果将 OPTIONS_SUB 设置为 yes，则会将所有添加到 OPTIONS_DEFINE 中的选项添加到 PLIST_SUB 和 SUB_LIST 中，例如：
等同于：
注意
OPTIONS_SUB的值会被忽略。将其设置为任何值都会为 所有 选项添加PLIST_SUB和SUB_LIST条目。
5.14.3.2. OPT_USE 和 OPT_USE_OFF
OPT_USE 和 OPT_USE_OFF当选中选项 OPT 时，对于 OPT_USE 中的每个 key=value 配对，value 会被附加到相应的 USE_KEY 上。如果 value 包含空格，则用逗号替换空格，处理时这些逗号会变回空格。OPT_USE_OFF 的工作方式相同，但当 OPT 未被选中时。示例：
等同于：
5.14.3.3. CONFIGURE_ARGS 帮助工具
CONFIGURE_ARGS 帮助工具5.14.3.3.1. OPT_CONFIGURE_ENABLE
OPT_CONFIGURE_ENABLE当选中选项 OPT 时，对于 OPT_CONFIGURE_ENABLE 中的每个 entry，--enable-entry 会被附加到 CONFIGURE_ARGS。当选项 OPT 未被选中时，--disable-entry 会被附加到 CONFIGURE_ARGS。可以用 = 符号指定可选参数，该参数仅会附加到 --enable-entry 配置选项。例如：
等同于：
5.14.3.3.2. OPT_CONFIGURE_WITH
OPT_CONFIGURE_WITH当选中选项 OPT 时，对于 OPT_CONFIGURE_WITH 中的每个 entry，--with-entry 会被附加到 CONFIGURE_ARGS。当选项 OPT 未被选中时，--without-entry 会被附加到 CONFIGURE_ARGS。可以用 = 符号指定可选参数，该参数仅会附加到 --with-entry 配置选项。例如：
等同于：
5.14.3.3.3. OPT_CONFIGURE_ON 和 OPT_CONFIGURE_OFF
OPT_CONFIGURE_ON 和 OPT_CONFIGURE_OFF当选中选项 OPT 时，OPT_CONFIGURE_ON 的值（如果已定义）会附加到 CONFIGURE_ARGS。OPT_CONFIGURE_OFF 的工作方式相同，但当 OPT 未被选中时。示例：
等同于：
技巧
大多数情况下，
OPT_CONFIGURE_ENABLE和OPT_CONFIGURE_WITH中的帮助工具提供了更简洁和全面的功能。
5.14.3.4. CMAKE_ARGS Helpers
CMAKE_ARGS Helpers5.14.3.4.1. OPT_CMAKE_ON 和 OPT_CMAKE_OFF
OPT_CMAKE_ON 和 OPT_CMAKE_OFF当选中选项 OPT 时，如果定义了 OPT_CMAKE_ON，则该值会附加到 CMAKE_ARGS。OPT_CMAKE_OFF 的工作方式相同，但当 OPT 未被选中时。例如：
等同于：
技巧
当值为布尔型时，请参考
OPT_CMAKE_BOOL和OPT_CMAKE_BOOL_OFF以获取更简洁的帮助工具。
5.14.3.4.2. OPT_CMAKE_BOOL 和 OPT_CMAKE_BOOL_OFF
OPT_CMAKE_BOOL 和 OPT_CMAKE_BOOL_OFF当选中选项 OPT 时，对于 OPT_CMAKE_BOOL 中的每个 entry，-D_entry_:BOOL=true 会附加到 CMAKE_ARGS。当选项 OPT 未被选中时，-D_entry_:BOOL=false 会附加到 CMAKE_ARGS。OPT_CMAKE_BOOL_OFF 是相反的，当选中选项时，-D_entry_:BOOL=false 会附加到 CMAKE_ARGS，而当未选中时，-D_entry_:BOOL=true 会附加到 CMAKE_ARGS。例如：
等同于：
5.14.3.5. MESON_ARGS Helpers
MESON_ARGS Helpers5.14.3.5.1. OPT_MESON_ON 和 OPT_MESON_OFF
OPT_MESON_ON 和 OPT_MESON_OFF当选中选项 OPT 时，如果定义了 OPT_MESON_ON，则该值会附加到 MESON_ARGS。OPT_MESON_OFF 的工作方式相同，但当 OPT 未被选中时。例如：
等同于：
5.14.3.5.2. OPT_MESON_TRUE 和 OPT_MESON_FALSE
OPT_MESON_TRUE 和 OPT_MESON_FALSE当选中选项 OPT 时，对于 OPT_MESON_TRUE 中的每个 entry，-D_entry_=true 会附加到 MESON_ARGS。当选项 OPT 未被选中时，-D_entry_=false 会附加到 MESON_ARGS。OPT_MESON_FALSE 是相反的，当选中选项时，-D_entry_=false 会附加到 MESON_ARGS，而当未选中时，-D_entry_=true 会附加到 MESON_ARGS。例如：
等同于：
5.14.3.5.3. OPT_MESON_YES 和 OPT_MESON_NO
OPT_MESON_YES 和 OPT_MESON_NO当选中选项 OPT 时，对于 OPT_MESON_YES 中的每个 entry，-D_entry_=yes 会附加到 MESON_ARGS。当选项 OPT 未被选中时，-D_entry_=no 会附加到 MESON_ARGS。OPT_MESON_NO 是相反的，当选中选项时，-D_entry_=no 会附加到 MESON_ARGS，而当未选中时，-D_entry_=yes 会附加到 MESON_ARGS。例如：
等同于：
5.14.3.5.4. OPT_MESON_ENABLED 和 OPT_MESON_DISABLED
OPT_MESON_ENABLED 和 OPT_MESON_DISABLED当选中选项 OPT 时，对于 OPT_MESON_ENABLED 中的每个 entry，-D_entry_=enabled 会附加到 MESON_ARGS。当选项 OPT 未被选中时，-D_entry_=disabled 会附加到 MESON_ARGS。OPT_MESON_DISABLED 是相反的，当选中选项时，-D_entry_=disabled 会附加到 MESON_ARGS，而当未选中时，-D_entry_=enabled 会附加到 MESON_ARGS。例如：
等同于：
5.14.3.6. OPT_QMAKE_ON 和 OPT_QMAKE_OFF
OPT_QMAKE_ON 和 OPT_QMAKE_OFF当选中选项 OPT 时，如果定义了 OPT_QMAKE_ON，则该值会附加到 QMAKE_ARGS。OPT_QMAKE_OFF 的工作方式相同，但当 OPT 未被选中时。例如：
等同于：
5.14.3.7. OPT_IMPLIES
OPT_IMPLIES提供了一种在选项之间添加依赖关系的方式。
当选中选项 OPT 时，此变量中列出的所有选项也将被选中。以下是使用之前描述的 OPT_CONFIGURE_ENABLE 来举例说明：
等同于：
示例 44. OPT_IMPLIES 的简单使用
这个 Port 有一个 X11 选项和一个需要选中 X11 选项才能构建的 GNOME 选项。
5.14.3.8. OPT_PREVENTS 和 OPT_PREVENTS_MSG
OPT_PREVENTS 和 OPT_PREVENTS_MSG提供了一种在选项之间添加冲突的方式。
当选中选项 OPT 时，OPT_PREVENTS 中列出的所有选项必须取消选择。如果设置了 OPT_PREVENTS_MSG 且触发了冲突，则其内容将显示，解释为什么它们会冲突。例如：
大致等同于：
唯一的区别是，第一个会在运行 make config 后输出错误，提示更改所选的选项。
示例 45. OPT_PREVENTS 的简单使用
这个 Port 有 X509 和 SCTP 选项。两个选项都添加补丁，但这些补丁彼此冲突，因此不能同时选择。
5.14.3.9. OPT_VARS 和 OPT_VARS_OFF
OPT_VARS 和 OPT_VARS_OFF提供了一种通用的方式来设置并追加到变量。
警告
在使用
OPT_VARS和OPT_VARS_OFF之前，看看是否已经有更具体的助手可用，详情请见 通用变量替换。
当选项 OPT 被选中，并且定义了 OPT_VARS 时，key=value 和 key+=value 对将会从 OPT_VARS 中进行评估。= 会覆盖 KEY 的现有值，而 += 会追加到该值。OPT_VARS_OFF 以相同的方式工作，但在选项 OPT 未被选中时。
等同于：
重要
包含空格的值必须用引号括起来：
这是因为 make(1) 变量展开处理空格的方式。当
OPT_VARS= foo=bar baz被展开时，变量会包含两个字符串，foo=bar和baz。但提交者可能只希望有一个字符串foo=bar baz。通过引用该值，可以防止空格被当作分隔符使用。另外，不要 在
var=符号和值之间添加额外的空格，这样也会将其分割成两个字符串。这将不起作用：
5.14.3.10. 依赖关系，OPT_DEPTYPE 和 OPT_DEPTYPE_OFF
OPT_DEPTYPE 和 OPT_DEPTYPE_OFF对于以下任何依赖类型：
PKG_DEPENDSEXTRACT_DEPENDSPATCH_DEPENDSFETCH_DEPENDSBUILD_DEPENDSLIB_DEPENDSRUN_DEPENDS
当选项 OPT 被选中时，如果定义了 OPT_DEPTYPE，则其值将被追加到 DEPTYPE。OPT_DEPTYPE_OFF 在选项 OPT 未被选中时以相同的方式工作。例如：
等同于：
5.14.3.11. 通用变量替换，OPT_VARIABLE 和 OPT_VARIABLE_OFF
OPT_VARIABLE 和 OPT_VARIABLE_OFF对于以下任意变量：
ALL_TARGETBINARY_ALIASBROKENCATEGORIESCFLAGSCONFIGURE_ENVCONFLICTSCONFLICTS_BUILDCONFLICTS_INSTALLCPPFLAGSCXXFLAGSDESKTOP_ENTRIESDISTFILESEXTRACT_ONLYEXTRA_PATCHESGH_ACCOUNTGH_PROJECTGH_SUBDIRGH_TAGNAMEGH_TUPLEGL_ACCOUNTGL_COMMITGL_PROJECTGL_SITEGL_SUBDIRGL_TUPLEIGNOREINFOINSTALL_TARGETLDFLAGSLIBSMAKE_ARGSMAKE_ENVMASTER_SITESPATCHFILESPATCH_SITESPLIST_DIRSPLIST_FILESPLIST_SUBPORTDOCSPORTEXAMPLESSUB_FILESSUB_LISTTEST_TARGETUSES
当选项 OPT 被选中时，如果定义了 OPT_ABOVEVARIABLE，则其值将追加到 ABOVEVARIABLE。OPT_ABOVEVARIABLE_OFF 在选项 OPT 未选中时以相同的方式工作。例如：
等同于：
注意
某些变量不在此列表中，特别是
PKGNAMEPREFIX和PKGNAMESUFFIX。这是故意的。一个 Port 不得 在选项集更改时更改其名称。
警告
其中一些变量，至少
ALL_TARGET、DISTFILES和INSTALL_TARGET，它们的默认值是在选项处理后设置的。使用以下行在 Makefile 中：如果启用了
DOCS选项，ALL_TARGET最终值将为all doc；如果该选项被禁用，则为all。仅使用选项帮助行在 Makefile 中：
如果启用了 DOCS 选项，ALL_TARGET 最终值将为 doc；如果该选项被禁用，则为 all。
5.14.3.12. 额外构建目标，target-OPT-on 和 target-OPT-off
target-OPT-on 和 target-OPT-off这些 Makefile 目标可以接受额外的可选构建目标：
pre-fetchdo-fetchpost-fetchpre-extractdo-extractpost-extractpre-patchdo-patchpost-patchpre-configuredo-configurepost-configurepre-builddo-buildpost-buildpre-installdo-installpost-installpost-stagepre-packagedo-packagepost-package
当选项 OPT 被选中时，如果定义了目标 TARGET-OPT-on，则在 TARGET 之后执行该目标。TARGET-OPT-off 在选项 OPT 未选中时以相同的方式工作。例如：
等同于：
最后更新于
这有帮助吗？