变量

预定义只读变量

以下变量已为您定义。您不得尝试设置它们。开发人员在编写 ebuild 时不应依赖这些变量的包管理器特定值。

pkg_postinst() {
	if [[ -e ${ROOT}/etc/oldconfig ]]; then
		ewarn "You still have the obsolete config file"
		ewarn "    ${ROOT}/etc/oldconfig."
		ewarn "Please migrate your settings to ${ROOT}/etc/newconfig"
		ewarn "and remove ${ROOT}/etc/oldconfig."
	fi
}

Ebuild 定义的变量

以下变量可能或必须由每个 ebuild 定义。

SRC_URI="https://example.com/files/${P}-core.tar.bz2
	x86?   ( https://example.com/files/${P}/${P}-sse-asm.tar.bz2 )
	ppc?   ( https://example.com/files/${P}/${P}-vmx-asm.tar.bz2 )
	sparc? ( https://example.com/files/${P}/${P}-vis-asm.tar.bz2 )
	doc?   ( https://example.com/files/${P}/${P}-docs.tar.bz2 )"

SRC_URI="https://example.com/files/${PV}.tar.gz -> ${P}.tar.gz"

example https://download.example.com https://mirror1.example.org/example

SRC_URI="mirror://example/${PN}/${P}.tar.gz"

EAPI="8"

SRC_URI="${P}.tar.gz
	mirror+https://dev.gentoo.org/~larry/distfiles/${P}-addons.tar.gz"

RESTRICT="fetch"

REQUIRED_USE="foo? ( !bar )"

REQUIRED_USE="foo? ( || ( bar baz quux ) )"

REQUIRED_USE="^^ ( foo bar baz )"

REQUIRED_USE="|| ( foo bar baz )"

REQUIRED_USE="?? ( foo bar baz )"

REQUIRED_USE="foo? ( !bar !baz ) bar? ( !foo !baz ) baz? ( !foo !bar )"

为包管理器保留的变量

以以下任何字符串开头的变量和函数（不区分大小写）都为包管理器使用保留。Ebuild 不得使用它们或依赖它们。

• __（两个下划线）
• abort
• dyn
• prep

同样适用于包含以下任何字符串（不区分大小写）的函数和变量：

• ebuild（除非紧接在另一个字母之前，并且除了 EBUILD_PHASE 和 EBUILD_PHASE_FUNC 变量）
• hook
• paludis
• portage

版本和名称格式问题

通常，上游的 tarball 版本控制或命名格式并不完全遵循 Gentoo 约定。在名称中使用大写字母或在版本中使用下划线和连字符的方式存在差异尤其常见。例如，Gentoo 称为 foo-1.2.3b 的内容可能期望一个名为 Foo-1.2-3b.tar.bz2 的 tarball。最好不要硬编码包字符串，而是创建 MY_PN、MY_PV 和 MY_P 变量并使用它们来定义上游命名。EAPI=7 推出了新的一组函数，ver_cut、ver_rs 和 ver_test。除非您确定自己知道自己在做什么，否则应使用这些函数重新定义版本，这是简单的方法。

MY_PN="Foo"
# Replace the second period separator in PV with -
MY_PV=$(ver_rs 2 '-')
MY_P="${MY_PN}-${MY_PV}"

此代码的优点是即使上游切换到 Foo-1.3-4.5.tar.bz2 这样的格式（是的，这种情况确实会发生），它也将继续工作。

也可以使用 bash 替换来实现相同的效果，但这很复杂、容易出错且难以阅读。

一些 ebuild 使用对 sed、awk 和/或 cut 的调用来执行此操作。对于任何新代码都不能这样做，并且应该修复为使用内置的版本操作命令或 Bash 替换。强烈不建议使用全局范围的非 Bash 代码。

ver_ 函数用于从版本字符串中提取特定组件。有关进一步的文档和示例，请参阅 版本函数参考。以下是这些函数的简要总结。

变量中的尾部斜杠

在 EAPI 7 中，以下变量从不以尾部斜杠结尾：D、ED、ROOT、EROOT。相反，在 EAPI 7 之前的 EAPI 中，这些变量保证以尾部斜杠结尾。在使用 EAPI 7 之前的 EAPI 时，鼓励开发人员使用 bash 后缀删除尾部斜杠，并在连接路径时添加显式的 /。例如：${D%/}/、${ED%/}/、${ROOT%/}/、${EROOT%/}/。

在 ebuild 中使用常量值变量

变量在ebuild中具有重要的价值，可以避免不必要的重复，并简化维护。但是，对常量值变量的引用应该谨慎使用，因为过度使用会影响可读性并增加维护负担（例如，当重命名包时）。特别是，应避免使用其值与预期字符串没有直接关联的变量。

有益的常量值变量引用的示例包括：

• 在SRC_URI和S中使用${PV}及其派生变量（${P}、${MY_P}等），以避免在每次版本更新时都需要更新这些变量（假设${PV}用于指示上游版本）；
• 在--docdir路径中使用${PF}——这是一个规范的Gentoo路径，始终需要与${PF}匹配。

错误的常量值变量引用的示例包括：

• 在HOMEPAGE、EGIT_REPO_URI或SRC_URI的域名中使用${PN}——这会破坏编辑器和终端中的URL解析，并且难以复制链接以供外部使用（例如，通过gitweb进行审查），
• 在SRC_URI中使用${HOMEPAGE}——当主页更改或添加其他条目时，这会导致问题，
• 在src_install()中过度使用${PN}（或其他不必要的辅助变量）——这会降低可读性，而收益甚微，并且当需要重命名包时会造成很多麻烦。

用户环境

以下变量可以在用户的环境中设置，并且所有ebuild都应尊重这些变量。每个变量在Gentoo中的用途与有效值的示例一起列出。上游用法可能会有所不同，但ebuild应确保在Gentoo中一致地解释这些变量。所选含义受到一些真实和事实上的标准的启发

• POSIX（2018）make规范
• GNU make（v4.3）实现
• GNU libtool（v2.4.6）包

许多这些变量只有在直接调用时才有效。例如，您的编译器驱动程序通常负责组装目标文件，而不是直接调用${AS}。在这种情况下，设置ASFLAGS对构建过程没有影响；相反，您将设置类似CFLAGS="-Wa,-alh,-L"的内容来告诉C编译器将这些标志传递给汇编器。LDFLAGS变量是此规则的例外，因为它旨在传递给编译器驱动程序，而不是${LD}。