Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

Tags de funcionalidade

Introdução

Godot tem um sistema especial para marcar a disponibilidade de recursos. Cada recurso é representado como uma string, que pode se referir a muitos dos seguintes:

  • Nome da plataforma.

  • Arquitetura da plataforma (64-bits ou 32-bits, x86 ou ARM).

  • Tipo da plataforma (desktop, celular, Web).

  • Algoritmos de compressão de textura suportados na plataforma.

  • Se uma compilação é debug ou release (depuração inclui o editor).

  • Se o projeto está sendo executado pelo editor ou um binário "standalone".

  • Muitas outras coisas.

Os recursos podem ser consultados em tempo de execução da API singleton chamando:

OS.has_feature(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.

Recursos padrão

Aqui está uma lista da maioria das tags de funcionalidades em Godot. Tenha em mente que elas possuem sensibilidade de caixa:

Etiqueta de características

Descrição

android

Running on Android (but not within a Web browser)

bsd

Running on *BSD (but not within a Web browser)

linux

Running on Linux (but not within a Web browser)

macos

Running on macOS (but not within a Web browser)

ios

Running on iOS (but not within a Web browser)

windows

Executando no Windows

linuxbsd

Executando no Linux ou *BSD

debug

Executando uma compilação de debug (incluindo o editor)

release

Executando em uma compilação de release

editor

Executando em uma compilação de editor

template

Executando em uma compilação não-editor (modelo de exportação)

double

Running on a double-precision build

single

Running on a single-precision build

64

Executando em uma compilação de 64-bits (qualquer arquitetura)

32

Executando em uma compilação de 32-bits (qualquer arquitetura)

x86_64

Executando em uma compilação x86 de 64-bits

x86_32

Executando em uma compilação x86 de 32-bits

x86

Running on an x86 build (any bitness)

arm64

Executando uma compilação ARM de 64-bits

arm32

Executando uma compilação ARM de 32-bits

arm

Running on an ARM build (any bitness)

rv64

Running on a 64-bit RISC-V build

riscv

Running on a RISC-V build (any bitness)

ppc64

Running on a 64-bit PowerPC build

ppc32

Running on a 32-bit PowerPC build

ppc

Running on a PowerPC build (any bitness)

wasm64

Running on a 64-bit WebAssembly build (not yet possible)

wasm32

Running on a 32-bit WebAssembly build

wasm

Running on a WebAssembly build (any bitness)

mobile

SO hospedeiro é uma plataforma móvel

pc

SO hospedeiro é uma plataforma de PC (desktop/laptop)

web

SO hospedeiro é um navegador da 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

Texturas usando compactação ETC1 são suportadas

etc2

Texturas usando compactação ETC2 são suportadas

s3tc

Texturas usando compactação S3TC (DXT/BC) são suportadas

movie

Movie Maker mode is active

Aviso

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.

Para verificar se um projeto exportado para HTML5 está sendo executado em um dispositivo móvel, call JavaScript code que lê o agente de usuário do navegador.

Funções personalizadas

É possível adicionar funções personalizados a uma compilação; usar o campo relevante no conjunto prévio de exportação usado para gerá-lo:

../../_images/feature_tags1.png

Nota

Custom feature tags are only used when running the exported project (including with Implantação com um clique). They are not used when running the project from the editor, even if the export preset marked as Runnable for your current platform has custom feature tags defined.

Substituindo configurações do projeto

Funções podem ser usados para substituir valores específicos de configuração nas Configurações de Projeto. Isso permite que você personalize melhor qualquer configuração ao fazer uma compilação.

No exemplo a seguir, um ícone diferente é adicionado para a construção demo do jogo (que foi personalizado em um conjunto prévio especial de exportação, que, por sua vez, inclui apenas níveis para demonstração).

../../_images/feature_tags2.png

Depois da sobreposição, um novo campo é adicionado para esta configuração específica:

../../_images/feature_tags3.png

Nota

Ao usar a funcionalidade project settings "override.cfg" functionality (que não está relacionada às tags de recursos), lembre-se de que as tags de recursos ainda se aplicam. Portanto, certifique-se de também substituir a configuração com a(s) tag(s) de recurso desejada(s) se quiser que elas substituam as configurações base do projeto em todas as plataformas e configurações.

Substituições padrão

Já existem muitas configurações que vêm com substituições por padrão; eles podem ser encontrados em muitas seções das configurações do projeto.

../../_images/feature_tags4.png

Personalizando a compilação

As tags de funcionalidade também podem ser usadas para personalizar um processo de compilação, escrevendo um ExportPlugin personalizado. Elas também são usados para especificar qual biblioteca compartilhada é carregada e exportada em GDExtension.