La cabecera: la etiqueta <theme>
Lo que identifica tu tema — y va SOLO en theme.xml.
<theme> es la raíz de todo archivo XML de un tema. Pero sus atributos de identidad solo tienen sentido en theme.xml: ese es el archivo que lee el gestor de temas para saber de qué se trata.
Para recordar En
theme.xml, rellénalos todos: sin ellos, tu tema aparece sin nombre, sin versión, y el gestor no sabe en qué pantallas funciona. En los demás archivos, escribe<theme>desnudo: repetirlos no aporta nada y puede sembrar confusión.
Los atributos
| Atributo | Función | Ejemplo | Si falta |
|---|---|---|---|
name | Nombre mostrado en la lista de temas | name="Mi Tema" | el nombre de la carpeta |
version | Versión del tema | version="1.2" | no se muestra |
author | El autor | author="Benoît" | no se muestra |
recalbox | Versión mínima de Recalbox exigida | recalbox="10.0" | todas las versiones |
compatibility | Tipos de pantalla cubiertos: hdmi, crt, jamma, tate | compatibility="hdmi,crt" | hdmi |
resolutions | Resoluciones cubiertas: qvga, vga, hd, fhd | resolutions="hd,fhd" | fhd,hd |
compatibility y resolutions son exactamente los pictogramas que muestra el gestor de temas: HDMI / CRT / JAMMA / TATE por un lado, SD 240p / SD+ 480p / HD 720p / FULLHD 1080p por el otro. Anunciarlos mal es prometer lo que el tema no cumple.
⚠️ Sin ellos, tu tema no puede publicarse en el gestor de temas: el repositorio oficial exige un nombre, una versión y un autor. Ver Compartir el tema.
Los dos casos
En theme.xml — la etiqueta completa:
<theme name="Mi Tema" version="1.2" author="Benoît"
recalbox="10.0" compatibility="hdmi,crt" resolutions="hd,fhd">
…
</theme>En todos los demás archivos del tema — la etiqueta desnuda:
<theme>
<view name="system"> … </view>
</theme>