Up to date
This page is up to date for Godot 4.2.
If you still find outdated information, please open an issue.
功能标签¶
前言¶
Godot 有一个特殊的系统来标记功能的可用性。每个功能均表示为一个字符串，可以引用以下各项：
平台名称。
平台架构（64 位或 32 位，x86 或 ARM）。
平台类型（桌面、移动、Web）。
平台上支持的纹理压缩算法。
构建是
debug还是release（debug包括编辑器）。项目是从编辑器运行还是从“独立”二进制文件运行。
其他更多的东西。
可以在运行时通过调用以下功能从单例 API 查询功能：
OS.has_feature(name)
OS.HasFeature(name);
OS feature tags are used by GDExtension to determine which libraries to load.
For example, a library for linux.debug.editor.x86_64 will be
loaded only on a debug editor build for Linux x86_64.
默认功能¶
这是 Godot 中大多数功能标签的列表。请记住它们区分大小写：
功能标签 |
描述 |
|---|---|
android |
在 Android 上运行（非 Web 浏览器） |
bsd |
在 *BSD 上运行（非 Web 浏览器） |
linux |
在 Linux 上运行（非 Web 浏览器） |
macos |
在 macOS 上运行（非 Web 浏览器） |
ios |
在 iOS 上运行（非 Web 浏览器） |
windows |
在 Windows 上运行 |
linuxbsd |
在 Linux 或 *BSD 上运行 |
debug |
在调试版本上运行（包括编辑器） |
release |
在发布版本上运行 |
editor |
在编辑器构建上运行 |
template |
在非编辑器（导出模板）构建上运行 |
double |
在双精度构建上运行 |
single |
在单精度构建上运行 |
64 |
在 64 位构建上运行（不限架构） |
32 |
在 32 位构建上运行（不限架构） |
x86_64 |
在 64 位 x86 架构构建上运行 |
x86_32 |
在 32 位 x86 架构构建上运行 |
x86 |
在 x86 构建上运行（不限位数） |
arm64 |
在 64 位 ARM 架构构建上运行 |
arm32 |
在 32 位 ARM 架构构建上运行 |
arm |
在 ARM 架构构建上运行（不限位数） |
rv64 |
在 64 位 RISC-V 构建上运行 |
riscv |
在 RISC-V 构建上运行（不限位数） |
ppc64 |
在 64 位 PowerPC 构建上运行 |
ppc32 |
在 32 位 PowerPC 构建上运行 |
ppc |
在 PowerPC 构建上运行（不限位数） |
wasm64 |
在 64 位 WebAssembly 构建上运行（尚不支持） |
wasm32 |
在 32 位 WebAssembly 构建上运行 |
wasm |
在 WebAssembly 构建上运行（不限位数） |
mobile |
宿主操作系统是移动平台 |
pc |
宿主操作系统是 PC 平台（台式机/笔记本电脑） |
web |
宿主操作系统是网页浏览器 |
web_android |
Host OS is a Web browser running on Android |
web_ios |
Host OS is a Web browser running on iOS |
web_linuxbsd |
Host OS is a Web browser running on Linux or *BSD |
web_macos |
Host OS is a Web browser running on macOS |
web_windows |
Host OS is a Web browser running on Windows |
etc |
支持使用 ETC1 压缩的纹理 |
etc2 |
支持使用 ETC2 压缩的纹理 |
s3tc |
支持使用 S3TC（DXT/BC）压缩的纹理 |
movie |
Movie Maker mode is active |
警告
With the exception of texture compression and movie feature tags,
default feature tags are immutable. This means that they will not
change depending on run-time conditions. For example,
OS.has_feature("mobile") will return false when running a project
exported to HTML5 on a mobile device.
要检查导出为 HTML5 的项目是否是在移动设备上运行，请调用 JavaScript 代码读取浏览器的用户代理。
自定义功能¶
可以向构建添加自定义功能；使用导出预设中用于生成它的相关字段：
备注
自定义特性标签只会在运行导出后的项目中使用（包括 一键部署）。从编辑器中运行项目时不会使用，即便标记为可执行的导出预设对应的平台上存在自定义特性标签。
覆盖项目设置¶
功能可用于覆盖项目设置中的特定配置值。这样可以在构建时更好地定制任意配置。
在下面的示例中，为游戏的演示版本添加了一个不同的图标（在特定的导出预设中进行了自定义，而该预设仅包含演示关卡）。
覆盖后, 将为此特定配置添加一个新字段:
备注
当使用项目设置的“override.cfg”功能时（与功能标签无关），记住功能标签仍然适用。因此，如果你想让它们覆盖所有平台和配置上的基本项目设置，请确保同时用所需的功能标签覆盖设置。
默认覆盖¶
默认情况下, 已有很多覆盖的设置；它们可以在项目设置的许多地方中找到.
自定义构建¶
Feature tags can be used to customize a build process too, by writing a custom ExportPlugin. They are also used to specify which shared library is loaded and exported in GDExtension.