Créer un thème demande des allers-retours rapides entre l'éditeur et l'écran. Recalbox fournit de quoi ne jamais avoir à redémarrer.
Branchez un clavier sur la Recalbox et appuyez sur ALT + F5. Toutes les textures sont libérées, puis le thème est entièrement rechargé et réinterprété, exactement comme au démarrage. Vous voyez immédiatement le résultat de vos modifications.
C'est le seul raccourci nécessaire au quotidien. Le thème étant relu de zéro, les variables, les conditions et les inclusions sont réévaluées à chaque fois.
Si vous éditez vos fichiers depuis un autre ordinateur via le partage réseau, assurez-vous que votre éditeur a bien écrit sur le disque avant d'appuyer sur
ALT+F5.
Toutes les erreurs de thème sont écrites dans un fichier dédié :
/recalbox/share/system/logs/themes.log
Ce fichier est votre premier réflexe quand quelque chose ne s'affiche pas. Il consigne notamment :
Unknown element of type "...") ;Unknown property type "...") ;if, avec la position du problème.Chaque message rappelle le fichier concerné et la chaîne d'inclusions qui y mène, ce qui permet de retrouver la ligne fautive même dans un thème découpé en dizaines de fichiers.
Le menu MENU PRINCIPAL > OPTIONS DE L'INTERFACE > THÈME affiche le nom, la version du thème, et la liste de vos <subset>. Si une option que vous avez déclarée n'apparaît pas ici, c'est que le <subset> ou les <include> associés ne sont pas lus — vérifiez themes.log.
Au moment d'activer un thème, Recalbox compare les attributs compatibility, resolutions et recalbox de votre theme.xml à la machine réelle, et affiche un avertissement détaillé en cas d'écart. C'est un bon moyen de vérifier que ces attributs sont corrects.
RRVVBBAA attendu par les thèmes.Pour toute question sur la création de thèmes, ou pour faire relire votre travail, rejoignez le Discord Recalbox.