DOTNET-PKG-BASE.ECLASS

章节: eclass-manpages (5)
更新日期: 2024年11月
索引返回主内容

名称

dotnet-pkg-base.eclass - 使用 .NET SDK 构建的常用函数和变量

描述

此 eclass 旨在为 .NET 软件包提供所需的 ebuild 定义。请注意，除了 Gentoo 特定的概念之外，还使用了 .NET 生态系统熟悉的人员应该了解的术语，这些术语贯穿于此 eclass 和类似的 eclass。

对于仅使用 .NET SDK（无特殊情况）的软件的 ebuild，可能更适合使用“dotnet-pkg.eclass”。

此 eclass 不导出任何阶段函数，有关此内容，请参阅“dotnet-pkg”eclass。

支持的 EAPIS

传递提供的 ECLASSES

nuget

函数

dotnet-pkg-base_get-configuration

返回当前软件包的 .NET 配置类型。

建议在必要时参考“DOTNET_PKG_CONFIGURATION”变量，而不是调用此函数。

由“dotnet-pkg-base_setup”使用。

dotnet-pkg-base_get-output <name>

返回“dotnet build”工件输出目录的特殊构造名称（“--output”标志，参见“dotnet-pkg-base_build”）。

维护人员很少会在 ebuild 中使用此函数。

此函数在“dotnet-pkg-base_setup”内部使用。

dotnet-pkg-base_get-runtime

返回当前软件包使用的 .NET 运行时。

由“dotnet-pkg-base_setup”使用。

dotnet-pkg-base_setup

为以后在“edotnet”中使用设置“DOTNET_PKG_EXECUTABLE”变量。还为“dotnet-pkg_src_configure”和“dotnet-pkg_src_compile”设置“DOTNET_PKG_CONFIGURATION”和“DOTNET_PKG_OUTPUT”。

此函数应由“pkg_setup”调用。

由“dotnet-pkg”eclass 中的“dotnet-pkg_pkg_setup”使用。

dotnet-pkg-base_remove-global-json [directory]

如果存在，则删除“global.json”。有问题的文件可能会将目标软件包锁定到指定的 .NET 版本，这可能是多余的（在大多数情况下）。

可选的“directory”参数默认为当前目录路径。

由“dotnet-pkg”eclass 中的“dotnet-pkg_src_prepare”使用。

edotnet <command> [args...]

调用 dotnet，传递提供的参数。

efsi <command> [args...]

调用 dotnet fsi，传递提供的参数。FSI 是 .NET SDK 附带的 F# 解释器，它可用于运行 F# 维护脚本。

dotnet-pkg-base_info

显示有关正在使用的当前 .NET SDK 的信息。

依赖于“dev-dotnet/csharp-gentoodotnetinfo”软件包安装的“gentoo-dotnet-info”程序。

由“dotnet-pkg”eclass 中的“dotnet-pkg_src_configure”使用。

dotnet-pkg-base_sln-remove <solution> <project>

从给定的解决方案文件中删除一个项目。

由“dotnet-pkg”eclass 中的“dotnet-pkg_remove-bad”使用。

dotnet-pkg-base_foreach-solution <directory> <args> ...

对指定目录中的每个解决方案文件 (.sln) 执行一个函数。此函数可能不会产生任何实际结果，因为解决方案会自动发现。

由“dotnet-pkg”eclass 中的“dotnet-pkg_src_configure”和“dotnet-pkg_src_test”使用。

dotnet-pkg-base_restore [args] ...

使用“dotnet restore”恢复软件包。除非通过“args”传递了不同的目录，否则恢复将在当前目录中执行。

此外，可以给出任意数量的“args”，它们将附加到“dotnet”命令调用中。

由“dotnet-pkg”eclass 中的“dotnet-pkg_src_configure”使用。

dotnet-pkg-base_restore-tools [config-file] [args] ...

恢复当前目录中项目的 dotnet 工具。

可选的“config-file”参数用于为“--configfile”选项指定一个文件，该选项记录应恢复哪些工具。

此外，可以给出任意数量的“args”，它们将附加到“dotnet”命令调用中。

dotnet-pkg-base_restore_tools [config-file] [args] ...

已弃用，请改用“dotnet-pkg-base_restore-tools”。

dotnet-pkg-base_build [args] ...

使用“dotnet build”在指定的目录中构建软件包。除非通过“args”传递了不同的目录，否则构建将在当前目录中执行。

可以给出任意数量的“args”，它们将附加到“dotnet”命令调用中。

由“dotnet-pkg”eclass 中的“dotnet-pkg_src_compile”使用。

dotnet-pkg-base_test [args] ...

使用“dotnet test”在指定的目录中测试软件包。除非通过“args”传递了不同的目录，否则测试将在当前目录中执行。

可以给出任意数量的“args”，它们将附加到“dotnet”命令调用中。

由“dotnet-pkg”eclass 中的“dotnet-pkg_src_test”使用。

dotnet-pkg-base_install [directory]

将“DOTNET_PKG_OUTPUT”的内容安装到一个目录中，默认为“/usr/share/${P}”。

安装目录相对于“ED”。

dotnet-pkg-base_launcherinto <directory>

更改 .NET 启动器通过后续“dotnet-pkg-base_dolauncher”调用安装到的路径。

有关更多信息，请参阅“_DOTNET_PKG_LAUNCHERDEST”变量。

dotnet-pkg-base_append-launchervar <variable-setting>

将给定的变量设置追加到“_DOTNET_PKG_LAUNCHERVARS”。

警告：此函数永久修改全局变量！这意味着给定软件包后续“dotnet-pkg-base_dolauncher”调用的所有启动器都将设置给定的变量。

示例

dotnet-pkg-base_append_launchervar "DOTNET_EnableAlternateStackCheck=1"

有关更多信息，请参阅“_DOTNET_PKG_LAUNCHERVARS”变量。

dotnet-pkg-base_append_launchervar <variable-setting>

已弃用，请改用“dotnet-pkg-base_append-launchervar”。

dotnet-pkg-base_dolauncher <executable-path> [filename]

制作一个包装脚本以启动从 .NET 软件包构建的可执行文件。

如果未给出文件名，则使用可执行文件的`basename`。

参数：${1} - 要启动的可执行文件的路径，${2} - 要创建的启动器文件名（可选）。

示例

dotnet-pkg-base_install
dotnet-pkg-base_dolauncher /usr/share/${P}/${PN^}

路径前缀为“EPREFIX”。

dotnet-pkg-base_dolauncher-portable <dll-path> <filename>

制作一个包装脚本以启动从 .NET 软件包构建的 .NET DLL 文件。

参数：${1} - 要启动的 DLL 的路径，${2} - 要创建的启动器文件名。

示例

dotnet-pkg-base_dolauncher-portable \
    /usr/share/${P}/GentooDotnetInfo.dll gentoo-dotnet-info

路径前缀为“EPREFIX”。

dotnet-pkg-base_dolauncher_portable <dll-path> <filename>

已弃用，请改用“dotnet-pkg-base_dolauncher-portable”。

ECLASS 变量

DOTNET_PKG_COMPAT (必需) (在继承之前设置): 允许为 dotnet 选择一个槽。
大多数 .NET 软件包将锁定到一个受支持的 .NET 主版本。DOTNET_PKG_COMPAT 应指定软件包上游选择的版本。如果项目中指定了多个 .NET 版本，则维护人员应选择最高的版本。
DOTNET_PKG_RDEPS = "" (由 ECLASS 生成): 填充运行 .NET 软件包的重要 .NET 生态系统软件包依赖项。
“DOTNET_PKG_RDEPS”应出现在“RDEPEND”（或有条件地出现在“RDEPEND”中）。
DOTNET_PKG_BDEPS = "" (由 ECLASS 生成): 填充构建 .NET 软件包的重要 .NET 生态系统软件包依赖项。
“DOTNET_PKG_BDEPS”应出现在“BDEPEND”（或有条件地出现在“BDEPEND”中）。
DOTNET_PKG_RUNTIME (由 ECLASS 生成): 设置用于构建软件包的运行时。
此变量由“dotnet-pkg-base_setup”函数自动设置。
DOTNET_PKG_EXECUTABLE (由 ECLASS 生成): 设置“dotnet”可执行文件的路径。
此变量由“dotnet-pkg-base_setup”函数自动设置。
DOTNET_PKG_CONFIGURATION (由 ECLASS 生成): 传递给编译阶段“dotnet”的配置值。是 Debug 还是 Release，具体取决于“debug”USE 标志。
此变量由“dotnet-pkg-base_setup”函数自动设置。
DOTNET_PKG_OUTPUT (由 ECLASS 生成): 输出目录的路径，在使用“dotnet-pkg-base_build”函数构建软件包期间，软件包工件将放置在此目录中。
此变量由“dotnet-pkg-base_setup”函数自动设置。

作者

Anna Figueiredo Gomes <[email protected]>
Maciej Barć <[email protected]>

维护人员

Gentoo Dotnet 项目 <[email protected]>

报告 Bug

请通过 https://bugs.gentoo.org/ 报告 Bug

文件

dotnet-pkg-base.eclass

参见

ebuild(5)
https://gitweb.gentoo.org/repo/gentoo.git/log/eclass/dotnet-pkg-base.eclass

此文档由 man2html 使用手册页创建。
时间：2024年11月12日，格林威治标准时间03:27:01