Etiquetas de características

Introducción

Godot tiene un sistema especial para etiquetar la disponibilidad de las características. Cada característica se representa como una cadena, y puede referirse a muchas de las siguientes:

• Nombre de la plataforma.

• Arquitectura de la plataforma (64 o 32 bits, x86 o ARM).

• Tipo de plataforma (escritorio, móvil, web).

• Algoritmos de compresión de texturas soportados en la plataforma.

• Si la compilación es de depuración (debug, con editor) o final (release).

• Si el proyecto está corriendo desde el editor o como un binario 'independiente'.

• Muchas más cosas.

Las funciones pueden consultarse en tiempo de ejecución desde llamadas a la API del singleton haciendo:

OS.has_feature(name)

Características por defecto

Aquí hay una lista de la mayoría de las etiquetas de características en Godot. Tenga en cuenta que son sensibles a mayúsculas y minúsculas:

Etiquetas de características	Descripción
Android	Ejecución en Android
HTML5	Ejecución en HTML5
JavaScript	El singleton JavaScript está disponible
OSX	Ejecución en macOS
iOS	Ejecución en iOS
UWP	Ejecución en UWP
Windows	Ejecución en Windows
X11	Corriendo sobre X11 (Linux/BSD en escritorio)
Server	Ejecución en la plataforma de servidor sin interfaz gráfica
debug	Ejecutando en una versión de depuración (incluyendo el editor)
versión	Ejecución en una versión de lanzamiento
editor	Ejecutando en una compilación con editor
independiente	Ejecutando en una compilación sin editor
64	Ejecutando en una versión de 64 bits (cualquier arquitectura)
32	Ejecutando en una versión de 32 bits (cualquier arquitectura)
x86_64	Ejecutando en una compilación de 64 bits
x86	Ejecutando en una compilación de 32 bits x86
arm64	Ejecutando en una versión de 64 bits ARM
arm	Ejecutando en una versión de 32 bits ARM
móvil	El sistema operativo anfitrión es una plataforma móvil
pc	El sistema operativo anfitrión es una PC (escritorio/laptop)
web	El sistema operativo anfitrión es un navegador Web
etc	Las texturas que utilizan una compresión ETC1 son soportadas
etc2	Las texturas que utilizan una compresión ETC2 son soportadas
s3tc	Las texturas que utilizan una compresión S3TC (DXT/BC) son soportadas
pvrtc	Las texturas que utilizan una compresión PVRTC son soportadas

Advertencia

Con la excepción de las etiquetas de características de compresión de texturas, las etiquetas de características predeterminadas son inmutables. Esto significa que no cambiarán según las condiciones de tiempo de ejecución. Por ejemplo, OS.has_feature("mobile") devolverá false al ejecutar un proyecto exportado a HTML5 en un dispositivo móvil.

Para verificar si un proyecto exportado a HTML5 se está ejecutando en un dispositivo móvil, puedes llamar código JavaScript que lea el agente de usuario del navegador.

Funcionalidades personalizadas

Es posible añadir funciones personalizadas a una compilación, usa el campo correspondiente en el preset de exportación utilizado para generarla:

Nota

Las etiquetas de características personalizadas solo se utilizan al ejecutar el proyecto exportado (incluido con Despliegue con un solo clic). No se utilizan al ejecutar el proyecto desde el editor, incluso si el preset de exportación marcado como Runnable para tu plataforma actual tiene etiquetas de características personalizadas definidas.

Sobrescribir los ajustes del proyecto

Las características se pueden utilizar para sobrescribir valores de configuración específicos en los" Ajustes del proyecto". Esto permite personalizar mejor cualquier configuración al hacer una compilación.

En el siguiente ejemplo, se añade un icono diferente para la compilación de la demo del juego (que se personalizó en un preset de exportación especial que, a su vez, sólo incluye niveles de demo).

Después de sobrescribir, se añade un nuevo campo para esta configuración específica:

Nota

Cuando se utiliza la funcionalidad configuración del proyecto "override.cfg" (que no está relacionada con las etiquetas de características), recuerde que las etiquetas de características todavía se aplican. Por lo tanto, asegúrese de también anular la configuración con la(s) etiqueta(s) de características deseada(s) si desea que anulen la configuración del proyecto base en todas las plataformas y configuraciones.

Sobreescritura de valores por defecto

Ya hay muchos ajustes que vienen con sobreescrituras por defecto, se pueden encontrar en las secciones de los ajustes del proyecto.

Personalización de la Compilación

Las etiquetas de características pueden ser usadas para personalizar el proceso de compilación, escribiendo un ExportPlugin personalizado. También son usadas para especificar qué librerías serán cargadas y exportadas en GDNative.