第 17 章 使用 USES 宏

USES 宏可以轻松声明端口的要求和设置。它们可以通过选择简单的预设值来添加依赖项、更改构建行为、向软件包添加元数据等等。

本章的每个部分都描述了 USES 的一个可能值，以及其可能的参数。参数在值后面以冒号 (:) 附加。多个参数用逗号 (,) 分隔。

可能的参数：(无)，p7zip，partial

使用 7z(1) 而不是 bsdtar(1) 进行解压，并设置 EXTRACT_SUFX=.7z。如果基础系统中的 7z 无法解压文件，则 p7zip 选项会强制依赖于 archivers/p7zip 中的 7z。如果使用了 partial 选项，则不会更改 EXTRACT_SUFX，如果主发行版文件没有 .7z 扩展名，则可以使用此选项。

可能的参数：(无)，6，12，(run)

依赖于支持 Ada 的编译器，并相应地设置 CC。默认为使用端口中的 gcc6-aux。

可能的参数：(无)，build

运行 autoreconf。它封装了 aclocal、autoconf、autoheader、automake、autopoint 和 libtoolize 命令。每个命令都应用于 ${AUTORECONF_WRKSRC}/configure.ac 或其旧名称 ${AUTORECONF_WRKSRC}/configure.in。如果 configure.ac 使用 AC_CONFIG_SUBDIRS 定义了带有其自身 configure.ac 的子目录，则 autoreconf 也会递归更新这些子目录。:build 参数仅向这些工具添加构建时依赖项，但不会运行 autoreconf。如果 WRKSRC 不包含 configure.ac 的路径，则端口可以设置 AUTORECONF_WRKSRC。

可能的参数：(无)，atlas，netlib（默认），gotoblas，openblas

添加对 Blas/Lapack 库的依赖项。

可能的参数：(无)，48，5（默认），6

添加对 Berkeley DB 库的依赖项。默认为 databases/db5。当使用 :48 参数时，它也可以依赖于 databases/db48，或者使用 :6 依赖于 databases/db6。可以声明一系列可接受的值，:48+ 查找安装的最高版本，如果未安装其他版本，则回退到 4.8。INVALID_BDB_VER 可用于指定与此端口不兼容的版本。框架向端口公开了以下变量

可能的参数：(无)，build，run，both

使用 devel/bison。默认情况下，如果没有参数或使用 build 参数，则表示 bison 是构建时依赖项，run 表示运行时依赖项，both 表示运行时和构建时依赖项。

可能的参数：(无)

提供对 Budgie 桌面环境的支持。使用 USE_BUDGIE 选择端口所需的组件。有关更多信息，请参阅 使用 Budgie。

可能的参数：(无)，hpack，nodefault

设置用于使用 Cabal 构建 Haskell 软件的默认值和目标。添加了对 Haskell 编译器端口 (lang/ghc) 的构建时依赖项。如果 BUILD_DEPENDS 变量中已列出其他版本的 GHC（例如，lang/ghc810），则将使用该版本。如果给出了 hpack 参数，则会添加对 devel/hs-hpack 的构建时依赖项，并在配置步骤中调用 hpack 以生成 .cabal 文件。如果给出了 nodefault 参数，则框架将不会尝试从 Hackage 中提取主发行版文件。如果存在 USE_GITHUB 或 USE_GITLAB，则会隐式添加此参数。

框架提供了以下变量

可能的参数：(无)

使用 Cargo 进行配置、构建和测试。它可用于移植使用 Cargo 构建系统的 Rust 应用程序。有关更多信息，请参阅 使用 cargo 构建 Rust 应用程序。

可能的参数：(无)

防止端口安装 charset.alias。这只能由 converters/libiconv 安装。如果 charset.alias 不是由 ${WRKSRC}/Makefile.in 安装的，则可以将 CHARSETFIX_MAKEFILEIN 设置为相对于 WRKSRC 的路径。

可能的参数：(无)，insource，noninja，run，testing

使用 CMake 配置端口并生成构建系统。

默认情况下，执行源外构建，使 WRKSRC 中的源代码免受构建工件的影响。使用 insource 参数，将改为执行源内构建。此参数应为例外情况，仅在常规源外构建不起作用时使用。

默认情况下，Ninja (devel/ninja) 用于构建。在某些情况下，这无法正常工作。使用 noninja 参数，构建将使用常规的 make 进行构建。仅当基于 Ninja 的构建不起作用时，才应使用此参数。

使用 run 参数，除了构建时依赖项之外，还会注册运行时依赖项。

使用 testing 参数，将添加一个使用 CTest 的测试目标。运行测试时，端口将重新配置以进行测试并重新构建。

有关更多信息，请参阅 使用 cmake。

可能的参数：(无)，env（默认，隐式），C++17-lang，C++14-lang，C++11-lang，gcc-C++11-lib，C++11-lib，C++0x，c11，nestedfct，features

根据任何给定的愿望确定要使用的编译器。如果端口需要支持 C++17 的编译器，则使用 C++17-lang；如果端口需要支持 C++14 的编译器，则使用 C++14-lang；如果端口需要支持 C++11 的编译器，则使用 C++11-lang；如果端口需要带有 C++11 库的 g++ 编译器，则使用 gcc-C++11-lib；如果端口需要支持 C++11 的标准库，则使用 C++11-lib。如果端口需要理解 C++0X、C11 或嵌套函数的编译器，则应使用相应的参数。

使用 features 请求默认编译器支持的功能列表。包含 bsd.port.pre.mk 后，端口可以使用以下变量检查结果

可能的参数：(无)

在软件包清单中包含通用平台枚举 (CPE) 信息，格式为 CPE 2.3 格式的字符串。有关详细信息，请参阅CPE 规范。要向端口添加 CPE 信息，请按照以下步骤操作

可能的参数：(无)、auto-plist、compiles

使用综合 R 档案网络。指定auto-plist来自动生成pkg-plist。如果端口具有需要编译的代码，请指定compiles。

可能的参数：(无)

使用来自devel/desktop-file-utils的 update-desktop-database。将运行一个额外的安装后步骤，而不会干扰端口Makefile中已有的任何安装后步骤。一行带有@desktop-file-utils将添加到 plist 中。仅当端口提供包含MimeType条目的.desktop文件时，才使用此宏。

可能的参数：(无)

更改 GNU configure 的行为，以便在原始软件不支持的情况下正确支持DESTDIR。

可能的参数：(无)、ARGS

设置虚拟显示环境。如果环境变量DISPLAY未设置，则 Xvfb 将作为构建依赖项添加，并且CONFIGURE_ENV将扩展为当前正在运行的 Xvfb 实例的端口号。ARGS参数默认为install，并控制围绕其启动和停止虚拟显示的阶段。

可能的参数：(无)

该端口具有行尾为 DOS 格式的文件，需要进行转换。可以设置多个变量来控制将转换哪些文件。默认情况下，将转换所有文件，包括二进制文件。有关示例，请参阅简单的自动替换。

可能的参数：7、module、theme

自动安装作为 Drupal 主题或模块的端口。与端口期望的 Drupal 版本一起使用。例如，USES=drupal:7,module表示此端口创建了一个 Drupal 7 模块。可以使用USES=drupal:7,theme指定 Drupal 7 主题。

可能的参数：(无)、build、lib、run、test

添加对audio/ebur128的依赖。它允许通过在make.conf中使用DEFAULT_VERSIONS来透明地依赖于rust或legacy变体。例如，要使用旧版本，请使用DEFAULT_VERSIONS+=ebur128=legacy

当未使用任何参数时，行为与提供lib参数时相同。其余参数提供相应的依赖项类别。

可能的参数：2、3、build（默认）、run

添加对math/eigen的依赖。

可能的参数：(无)

通过设置 ELF_FEATURES 更改 ELF 二进制文件的特征控制注释。

featurelist的格式在elfctl(1)中描述。文件路径相对于${BUILD_WRKSRC}。

可能的参数：(无)、enc、rebar、rebar3

添加对lang/erlang的构建和运行时依赖。根据参数的不同，它会添加其他构建依赖项。enc添加对devel/erlang-native-compiler的依赖，rebar添加对devel/rebar的依赖，而rebar3添加对devel/rebar3的依赖。

此外，以下变量可用于端口

可能的参数：(无)

更改构建系统的一些默认行为，以允许作为用户安装。有关fakeroot的更多信息，请参阅https://wiki.debian.org/FakeRoot。

可能的参数：(无)、fam、gamin

使用文件更改监视器作为库依赖项，无论是devel/fam还是devel/gamin。最终用户可以设置 WITH_FAM_SYSTEM 来指定他们的偏好。

可能的参数：(无)、25

添加对 Firebird 数据库客户端库的依赖。

可能的参数：(无)、fc、fontsdir（默认）、none

添加对注册字体所需的工具的运行时依赖。根据参数的不同，添加@fc` ${FONTSDIR}` 行、@fontsdir` ${FONTSDIR}` 行，或者如果参数为none则不添加任何行，到 plist 中。FONTSDIR默认为${PREFIX}/share/fonts/${FONTNAME}，而FONTNAME默认为${PORTNAME}。将FONTSDIR添加到PLIST_SUB和SUB_LIST

可能的参数：gcc（默认）

使用 GNU Fortran 编译器。

可能的参数：2（默认）、3

该端口将依赖于 FUSE 库，并根据 FreeBSD 的版本处理对内核模块的依赖。

可能的参数：(无)、noautoplist

处理使用 RubyGems 进行构建。如果使用noautoplist，则不会自动生成打包列表。

这意味着USES=ruby。

可能的参数：(无)

已弃用。将同时包含gettext-runtime和gettext-tools。

可能的参数：(无)、lib（默认）、build、run

使用devel/gettext-runtime。默认情况下，在没有参数或使用lib参数时，意味着对libintl.so的库依赖。build和run分别意味着对gettext的构建时和运行时依赖。

可能的参数：(无)、build（默认）、run

使用devel/gettext-tools。默认情况下，在没有参数或使用build参数时，将注册对msgfmt的构建时依赖。使用run参数时，将注册运行时依赖。

可能的参数：X、build、run、nox11

可以使用特定的版本X。可能的版本为7、8、9和agpl（默认）。nox11表示需要端口的-nox11版本。build和run分别添加对 Ghostscript 的构建时和运行时依赖。默认情况下，同时存在构建时和运行时依赖。

可能的参数：(无)

提供了一种依赖于 GL 组件的简单方法。组件应列在USE_GL中。可用的组件为

可能的参数：(无)

使用devel/gmake作为构建时依赖项，并设置环境以使用gmake作为构建的默认make。

可能的参数：(无)

提供了一种简单的方法来依赖 GNOME 组件。这些组件应该列在 USE_GNOME 中。可用的组件包括：

默认依赖项是构建时和运行时，可以通过 :build 或 :run 进行更改。例如：

更多信息请参见 使用 GNOME。

可能的参数： (无)，N.NN，N.NN-devel，modules，no_targets，run

设置用于构建 Go 软件的默认值和目标。添加了对 Go 编译器端口的构建时依赖项，端口维护者可以设置所需版本。默认情况下，构建在 GOPATH 模式下执行。如果 Go 软件使用模块，则可以通过 modules 参数切换到模块感知模式。no_targets 将设置构建环境（如 GO_ENV、GO_BUILDFLAGS），但跳过创建提取和构建目标。run 还将添加对 Go 编译器端口的运行时依赖项。

构建过程由几个变量控制

有关用法示例，请参见 构建 Go 应用程序。

可能的参数：(无)

如果基本系统中不存在 gperf，则添加对 devel/gperf 的构建时依赖项。

可能的参数：5，selfbuild

处理对 Grantlee 的依赖关系。指定 5 以依赖于基于 Qt5 的版本，devel/grantlee5。selfbuild 由 devel/grantlee5 内部使用以获取其版本号。

可能的参数：build，run，both

如果基本系统中不存在，则注册对 textproc/groff 的依赖关系。

可能的参数： (无)，base (默认)，heimdal，mit，flags，bootstrap

处理 GSS-API 的使用者所需的依赖项。仅提供 Kerberos 机制的库可用。默认情况下，或设置为 base，将使用基本系统中的 GSS-API 库。也可以设置为 heimdal 以使用 security/heimdal，或设置为 mit 以使用 security/krb5。

当本地 Kerberos 安装不在 LOCALBASE 中时，请将 HEIMDAL_HOME（对于 heimdal）或 KRB5_HOME（对于 krb5）设置为 Kerberos 安装的位置。

这些变量导出供端口使用

flags 选项可以与 base、heimdal 或 mit 一起使用，以自动将 GSSAPICPPFLAGS、GSSAPILDFLAGS 和 GSSAPILIBS 分别添加到 CFLAGS、LDFLAGS 和 LDADD 中。例如，使用 base,flags。

bootstrap 选项是一个特殊的前缀，仅供 security/krb5 和 security/heimdal 使用。例如，使用 bootstrap,mit。

可能的参数：(无)

提供了一种简单的方法来依赖 GStreamer 组件。这些组件应该列在 USE_GSTREAMER 中。可用的组件包括：

可能的参数： (无)，X.Y，flavors，build，run，alias，conflicts

添加对 Guile 的依赖关系。默认情况下，这是一个对相应 libguile*.so 的库依赖关系，除非被 build 和/或 run 选项覆盖。alias 选项适当地配置 BINARY_ALIAS（参见 使用 BINARY_ALIAS）。

默认版本由通常的 DEFAULT_VERSIONS 机制设置；如果默认版本不是列出的版本之一，则使用最新的可用列出版本。

使用 Guile 的应用程序通常仅针对单个 Guile 版本构建。但是，扩展或库模块应使用 flavors 选项与多个版本一起构建。

更多信息请参见 使用 Guile。

可能的参数：(无)

添加对 devel/pear-channel-horde 的构建时和运行时依赖关系。其他 Horde 依赖项可以通过 USE_HORDE_BUILD 和 USE_HORDE_RUN 添加。更多信息请参见 Horde 模块。

可能的参数： (无)，lib，build，patch，translit，wchar_t

使用 iconv 函数，可以作为构建时和运行时依赖项来自端口 converters/libiconv，也可以来自基本系统。默认情况下，无参数或使用 lib 参数表示 iconv 具有构建时和运行时依赖项。build 表示构建时依赖项，patch 表示修补时依赖项。如果端口使用 WCHAR_T 或 //TRANSLIT iconv 扩展，请添加相关参数以使用正确的 iconv。更多信息请参见 使用 iconv。

可能的参数： (无)，env，notall，noman

添加 devel/imake 作为构建时依赖项，并在 configure 阶段运行 xmkmf -a。如果给定 env 参数，则不设置 configure 目标。如果 -a 标志对端口有影响，请添加 notall 参数。如果 xmkmf 未生成 install.man 目标，请添加 noman 参数。

可能的参数：5

添加对 KDE 组件的依赖关系。更多信息请参见 使用 KDE。

可能的参数： (无)，debug

填写内核模块端口的样板，目前

可能的参数：(无)，<版本>，client，server

注册对net/openldap的依赖关系。如果设置了，它使用特定的<version>（没有点符号）。否则，它会尝试查找当前安装的版本。如有必要，它将回退到bsd.default-versions.mk中找到的默认版本。client指定对客户端库的运行时依赖关系。这也是默认值。server指定对服务器的运行时依赖关系。

以下变量可供端口访问

可能的参数：(无)

将EXTRACT_SUFX设置为.lzh

可能的参数：(无)

注册对archivers/libarchive的依赖关系。任何依赖于libarchive的端口都必须包含USES=libarchive。

可能的参数：(无)

注册对devel/libedit的依赖关系。任何依赖于libedit的端口都必须包含USES=libedit。

可能的参数：(无)，keepla，build

修补libtool脚本。这必须添加到所有使用libtool的端口中。keepla参数可用于保留.la文件。某些端口不附带自己的libtool副本，并且需要对devel/libtool的构建时依赖关系，使用:build参数添加此类依赖关系。

可能的参数：c6，c7

端口Linux兼容性框架。指定c6以依赖于CentOS 6软件包。指定c7以依赖于CentOS 7软件包。可用的软件包是

可能的参数：(无)，XY，min=XY，max=XY，build，run，lib

添加对LLVM的依赖关系。默认情况下，这是构建时依赖关系，除非被run或lib选项覆盖。默认版本是在LLVM_DEFAULT中设置的。也可以指定特定版本。最小和最大版本可以通过min和max参数分别指定。端口框架将以下变量导出到端口

可能的参数：(无)，ldflags

确保使用LOCALBASE中依赖项的库，而不是基础系统中的库。指定ldflags以将-L${LOCALBASE}/lib添加到LDFLAGS而不是LIBS。依赖于基础系统中也存在的库的端口应该使用此功能。它也由其他一些USES内部使用。

可能的参数：(无)，XY，XY+，-XY，XY-ZA，module，flavors，build，run，env

添加对Lua的依赖关系。默认情况下，这是库依赖关系，除非被build和/或run选项覆盖。env选项阻止添加任何依赖关系，同时仍然定义所有常用的变量。

默认版本由通常的DEFAULT_VERSIONS机制设置，除非指定了版本或版本范围作为参数，例如，51或51-54。

使用Lua的应用程序通常仅针对单个Lua版本构建。但是，旨在由Lua代码加载的库模块应使用module选项与多个风格一起构建。

有关更多信息，请参阅使用Lua。

可能的参数：(无)，X

添加对luajit运行时的依赖关系。可以使用特定版本X。可能的版本是luajit，luajit-devel，luajit-openresty

在包含bsd.port.options.mk或bsd.port.pre.mk之后，端口可以检查这些变量

有关更多信息，请参阅使用Lua。

可能的参数：(无)

处理LXQt桌面环境的依赖关系。使用USE_LXQT选择端口所需的组件。有关更多信息，请参阅使用LXQt。

可能的参数：(无)，X，build，nox11，run，test

添加对ImageMagick的库依赖关系。可以使用特定版本X。可能的版本是6和7（默认值）。nox11表示需要端口的-nox11版本。build、run和test添加对ImageMagick的构建时、运行时和测试时依赖关系。

可能的参数：(无)

如果基础系统中不存在makeinfo，则添加对它的构建时依赖关系。

可能的参数：(无)

表示分发文件是makeself归档文件，并设置相应的依赖关系。

可能的参数：(无)

提供了一种简单的方法来依赖MATE组件。组件应列在USE_MATE中。可用的组件是

默认依赖项是构建时和运行时，可以通过 :build 或 :run 进行更改。例如：

可能的参数：(无)

提供对基于Meson的项目的支持。有关更多信息，请参阅使用meson。

可能的参数：(无)

设置以下变量，以便于创建元端口：MASTER_SITES，DISTFILES，EXTRACT_ONLY，NO_BUILD，NO_INSTALL，NO_MTREE，NO_ARCH。

可能的参数：(无)，ng

分别添加对archivers/minizip或archivers/minizip-ng的库依赖关系。

可能的参数：(无)，version，client（默认值），server，embedded

提供对MySQL的支持如果未给出版本，则尝试查找当前安装的版本。回退到默认版本MySQL-5.6。可能的版本是55、55m、55p、56、56p、56w、57、57p、80、100m、101m和102m。m和p后缀分别用于MariaDB和Percona版本的MySQL。server和embedded添加对MySQL服务器的构建时和运行时依赖关系。当使用server或embedded时，添加client以也添加对libmysqlclient.so的依赖关系。如果某些版本不受支持，则端口可以设置IGNORE_WITH_MYSQL。

框架将MYSQL_VER设置为检测到的MySQL版本。

可能的参数：(无)，nuget

通过设置相应的依赖关系，添加对Mono（目前仅限C#）框架的依赖关系。

当端口使用nuget包时，指定nuget。NUGET_DEPENDS需要使用nuget包的名称和版本以name=version的格式设置。可以使用name=version:_origin_添加可选的包来源。

辅助目标buildnuget将根据提供的packages.config输出NUGET_DEPENDS的内容。

可能的参数：(无)

使用 x11-toolkits/open-motif 作为库依赖项。最终用户可以在 make.conf 中设置 WANT_LESSTIF 以使用 x11-toolkits/lesstif 作为依赖项，而不是 x11-toolkits/open-motif。类似地，在 make.conf 中设置 WANT_OPEN_MOTIF_DEVEL 将添加对 x11-toolkits/open-motif-devel 的依赖。

可能的参数：(无)，base，port

使用 ncurses，并导致设置一些有用的变量。

可能的参数：(无)

通过添加对 www/nextcloud 的运行时依赖，添加对 Nextcloud 应用程序的支持。

可能的参数：(无)，build，make（默认），run

如果指定了 build 或 run 参数，则分别添加对 devel/ninja 的构建或运行时依赖。如果提供 make 或无参数，则使用 ninja 构建端口而不是 make。make 隐含 build。如果变量 NINJA_DEFAULT 设置为 samurai，则依赖项将设置为 devel/samurai。

可能的参数：(无)，build，run，current，lts，10，14，16，17。

使用 nodejs。添加对 www/node* 的依赖。如果指定了受支持的版本，则也必须指定 run 和/或 build。

可能的参数：(无)

如果基础系统不支持，则添加 Objective C 依赖项（编译器、运行时库）。

可能的参数：(无)，env

使用 math/octave。env 仅加载一个 OCTAVE_VERSION 环境变量。

可能的参数：al，soft（默认），si，alut

使用 OpenAL。可以指定后端，软件实现为默认值。用户可以使用 WANT_OPENAL 指定首选后端。此旋钮的有效值为 soft（默认值）和 si。

可能的参数：(无)

在 PATHFIX_WRKSRC（默认为 WRKSRC）中查找 Makefile.in 和 configure，并修复常见路径以确保它们符合 FreeBSD 层次结构。例如，它修复了 pkgconfig 的 .pc 文件的安装目录到 ${PREFIX}/libdata/pkgconfig。如果端口使用 USES=autoreconf，则 Makefile.am 将自动添加到 PATHFIX_MAKEFILEIN 中。

如果端口 USES=cmake，它将在 PATHFIX_WRKSRC 中查找 CMakeLists.txt。如果需要，可以使用 PATHFIX_CMAKELISTSTXT 更改此默认文件名。

可能的参数：env

添加对 devel/pear 的依赖。它将为使用 PHP 扩展和应用程序存储库的软件设置默认行为。使用 env 参数仅设置 PEAR 环境变量。有关更多信息，请参见 PEAR 模块。

可能的参数：(无)

依赖于 Perl。配置是使用 USE_PERL5 完成的。

USE_PERL5 可以包含使用 Perl 的阶段，可以是 extract、patch、build、run 或 test。

当需要 Makefile.PL、Build.PL 或 Module::Build::Tiny 的 Build.PL 版本时，USE_PERL5 还可以包含 configure、modbuild 或 modbuildtiny。

USE_PERL5 默认为 build run。当使用 configure、modbuild 或 modbuildtiny 时，build 和 run 是隐含的。

有关更多信息，请参见 使用 Perl。

可能的参数：(无)，X.Y，X.Y+，X.Y-，X.Y-Z.A

提供对 PostgreSQL 的支持。端口维护者可以设置所需的版本。可以指定最小和最大版本或范围；例如，9.0-、8.4+、8.4-9.2。

默认情况下，添加的依赖项将是客户端，但如果端口需要其他组件，则可以使用 WANT_PGSQL=component[:target] 完成；例如，WANT_PGSQL=server:configure pltcl plperl。可用的组件是

可能的参数：(无)，phpize，ext，zend，build，cli，cgi，mod，web，embed，pecl，flavors，noflavors

提供对 PHP 的支持。添加对默认 PHP 版本 lang/php81 的运行时依赖。

变量用于指定需要哪些 PHP 模块，以及支持哪些版本的 PHP。

使用 :ext 或 :zend 构建 PHP 或 Zend 扩展时，可以设置这些变量

这些变量可用于 PKGNAMEPREFIX 或 PKGNAMESUFFIX 中

可能的参数：(无)，build（默认），run，both

使用 devel/pkgconf。在没有参数或使用 build 参数的情况下，它表示 pkg-config 作为构建时依赖项。run 表示运行时依赖项，both 表示运行时和构建时依赖项。

可能的参数：(无)，ffi

使用 lang/pure。主要用于构建相关的 pure 端口。使用 ffi 参数，它表示 devel/pure-ffi 作为运行时依赖项。

可能的参数：(无)，4，5

使用 PyQt。如果端口是 PyQT 本身的一部分，请设置 PYQT_DIST。使用 USE_PYQT 选择端口需要的组件。可用的组件是

这些组件仅在 PyQT4 中可用

这些组件仅在 PyQT5 中可用。

每个组件的默认依赖项是构建时和运行时，要仅选择构建或运行，请在组件名称中添加_build或_run。例如

可能的参数：(无)，4

引入对devel/pytest的新依赖关系。它定义了一个do-test目标，该目标将正确运行测试。使用参数依赖于特定的devel/pytest版本。对于使用devel/pytest的端口，请考虑使用此方法代替特定的do-test目标。该框架向端口公开以下变量

此外，用户可以设置以下变量

可能的参数：(无)，X.Y，X.Y+，-X.Y，X.Y-Z.A，patch，build，run，test

使用 Python。可以指定受支持的版本或版本范围。如果 Python 只在构建时、运行时或测试时需要，则可以将其设置为构建、运行或测试依赖项，使用build、run或test。如果在修补阶段也需要 Python，请使用patch。有关更多信息，请参阅使用 Python。

当需要框架导出的变量但不需要对 Python 的依赖关系时，可以使用USES=python:env。当与USES=shebangfix一起使用时，可能会发生这种情况，并且目标只是修复 Shebang，而不是添加对 Python 的依赖关系。

可能的参数：(无)，build，run，both，vars

使用mail/qmail。使用build参数，意味着qmail作为构建时依赖项。run意味着运行时依赖项。不使用参数或使用both参数意味着运行时和构建时依赖项。vars将仅为端口设置 QMAIL 变量以供使用。

可能的参数：(无)，norecursive，outsource，no_env，no_configure

使用 QMake 进行配置。有关更多信息，请参阅使用qmake。

可能的参数：5，6，no_env

添加对 Qt 组件的依赖关系。no_env直接传递到USES= qmake。有关更多信息，请参阅使用 Qt。

可能的参数：(无) 或 5 和 (无) 或 6 和 (无) 或 3d、5compat、base、charts、connectivity、datavis3d、declarative、doc languageserver、gamepad、graphicaleffects、imageformats、locat ion、lottie、multimedia、networkauth、positioning、quick3d、quickcontrols2、quickcontrols、quicktimeline、remoteobjects、script、scxml、sensors、serialbus、serialport、shadertools、speech、svg、tools、translations、virtualkeyboard、wayland、webchannel、webengine、webglplugin、websockets、webview、x11extras、xmlpatterns 中的一个。

提供对构建 Qt 5 和 Qt 6 组件的支持。它负责为端口设置适当的配置环境以进行构建。

如果PORTNAME与组件名称不匹配，则可以将其作为参数传递给qt-dist。

可能的参数：(无)，port

使用 readline 作为库依赖项，并根据需要设置CPPFLAGS和LDFLAGS。如果使用port参数或如果基本系统中不存在 readline，则添加对devel/readline的依赖关系。

可能的参数：(无)，build，extconf，run，setup

为 Ruby 相关的端口提供支持。不带参数的(none)添加对lang/ruby的运行时依赖关系。build添加对lang/ruby的构建时依赖关系。extconf表示该端口使用 extconf.rb 进行配置。run添加对lang/ruby的运行时依赖关系。这也是默认值。setup表示该端口使用 setup.rb 进行配置和构建。

用户可能已定义以下变量

以下变量导出供端口使用

可能的参数：build，env，lib，run

处理对 Samba 的依赖关系。env不会添加任何依赖关系，只会设置变量。build和run将添加对smbd的构建时和运行时依赖关系。lib将添加对libsmbclient.so的依赖关系。导出的变量为

可能的参数：(无)

提供对使用devel/scons的支持。有关更多信息，请参阅使用scons。

可能的参数：(无)

使用来自misc/shared-mime-info的 update-mime-database。此用途将自动添加一个安装后步骤，以便端口本身仍然可以在需要时指定自己的安装后步骤。它还会在 plist 中添加一个@shared-mime-info条目。

可能的参数：(无)

许多软件对脚本解释器使用了不正确的位置，最显著的是/usr/bin/perl和/bin/bash。shebangfix 宏修复了SHEBANG_REGEX、SHEBANG_GLOB或SHEBANG_FILES中列出的脚本中的 Shebang 行。

目前，Bash、Java、Ksh、Lua、Perl、PHP、Python、Ruby、Tcl 和 Tk 默认受支持。

有三个配置变量

可能的参数：(无)、2、3

添加对 SQLite 的依赖关系。使用的默认版本为 3，但也可以使用:2修饰符使用版本 2。

可能的参数：(无)、build、run

提供对 OpenSSL 的支持。可以使用build或run指定仅构建或运行时的依赖关系。这些变量可供端口使用，它们也会添加到MAKE_ENV中

可能的参数：(无)、Z、bz2、bzip2、lzma、tbz、tbz2、tgz、txz、xz、zst、zstd

分别将EXTRACT_SUFX设置为.tar、.tar.Z、.tar.bz2、.tar.bz2、.tar.lzma、.tbz、.tbz2、.tgz、.txz、.tar.xz、.tar.zst或.tar.zstd。

可能的参数：version、wrapper、build、run、tea

添加对 Tcl 的依赖关系。可以使用version请求特定的版本。版本可以为空，一个或多个精确版本号（当前为84、85或86），或最小版本号（当前为84+、85+或86+）。要仅请求非特定版本的包装器，请使用wrapper。可以使用build或run指定仅构建或运行时的依赖关系。要使用 Tcl Extension Architecture 构建端口，请使用tea。包含bsd.port.pre.mk后，端口可以使用以下变量检查结果

可能的参数：(无)

将@terminfo添加到plist中。当端口在${PREFIX}/share/misc中安装*.terminfo文件时使用。

可能的参数：(无)

提供对 tex 的支持。加载与 TEX 相关的端口的所有默认变量，并且不添加对任何端口的依赖关系。

变量用于指定需要哪些 TEX 模块。

当前可能的参数如下

与tcl的参数相同

同时使用 Tcl 和 Tk 时的一个小包装器。返回的变量与使用 Tcl 时相同。

可能的参数：(无)

更改构建系统的一些默认行为（主要是变量），以允许将此端口作为普通用户安装。在使用USES=fakeroot或修补之前，请在端口中尝试此操作。

可能的参数：(无)、dirs

通过添加前缀或后缀使文件或目录“唯一”。如果使用dirs参数，则端口需要基于UNIQUE_PREFIX的前缀（并且仅为前缀），用于标准目录DOCSDIR、EXAMPLESDIR、DATADIR、WWWDIR、ETCDIR。这些变量可供端口使用

可能的参数：build、lib、no_depend

添加对lang/vala的构建或库依赖关系。no_depend参数保留用于lang/vala本身。

可能的参数：4（默认）、6、7

处理对 Varnish Cache 的依赖关系。添加对www/varnish*的依赖关系。

可能的参数：(无)、ARGS

自动创建和删除每个支持 webplugin 框架的应用程序的符号链接。ARGS可以是以下之一

这些变量可以调整

可能的参数：(无)、gtk2

提供对 Xfce 相关端口的支持。有关详细信息，请参阅使用 Xfce。

gtk2参数指定端口需要 GTK2 支持。它添加了某些核心组件提供的其他功能，例如，x11/libxfce4menu和x11-wm/xfce4-panel。

可能的参数：(无)

提供了一种简单的方法来依赖 X.org 组件。组件应列在USE_XORG中。可用的组件有

可能的参数：app、data、doc、driver、font、lib、proto、util、xserver 和（无）或 autotools（默认）、meson 中的一个。

提供构建 Xorg 组件的支持。它负责设置常见的依赖项和所需的适当配置环境。这仅适用于 Xorg 组件。

类别必须与上游类别匹配。

第二个参数是要使用的构建系统。autotools 是默认值，但 meson 也受支持。

可能的参数：（无）、infozip

指示发行版文件使用 ZIP 压缩算法。对于使用 InfoZip 算法的文件，必须传递 infozip 参数以设置相应的依赖项。