Faire son premier thème

La marche à suivre — avec le studio, ou à la main.

Le résultat est le même : un dossier de thème. Deux chemins pour y arriver.

Avec le studio

1. Partez d’un modèle. La page blanche est le plus mauvais départ. Un modèle arrive avec ses composants déjà en place : vous les remplacez.
2. Choisissez vos définitions d’écran — HD 16/9, CRT 4/3, écran vertical (TATE). Ce qui tient sur un écran large ne tient pas sur un téléviseur cathodique. Commencez par une seule, ajoutez les autres ensuite.
3. Posez vos composants : faites-les glisser depuis la colonne de gauche, réglez-les dans celle de droite.
4. Changez de système dans Options de la vue et regardez : c’est l’erreur la plus fréquente, un thème réglé sur une seule machine et qui se casse ailleurs. Les logos n’ont pas tous la même forme, les noms pas tous la même longueur.
5. Exportez, copiez le dossier sur votre machine, essayez — voir Essayer son thème.

À la main

1. Partez d’un thème existant. Ouvrez-en un, lisez-le : c’est la façon la plus rapide de comprendre ce qui se fait. Le thème officiel de Recalbox est un bon départ.
2. Créez le dossier et son theme.xml — le seul fichier obligatoire. Voir Les dossiers et les fichiers.
3. Annoncez ce que vous visez dans la balise <theme> : compatibility pour les types d’écran, resolutions pour les définitions. Ce sont ces deux attributs qui allument les pictogrammes du gestionnaire de thèmes, et les annoncer faux, c’est promettre ce que le thème ne tient pas. Voir L’en-tête.
4. Écrivez vos vues, une par écran, et découpez en plusieurs fichiers dès que ça grossit — voir Le thème minimal qui fonctionne, puis Découper son thème.
5. Servez les autres écrans avec des conditions plutôt qu’en recopiant tout : <include if="crt">.
6. Copiez le dossier sur votre machine et essayez — et lisez themes.log au premier composant invisible.

Dans les deux cas, la même erreur guette : ne vérifier que sur SON écran et SON système.