A ce jour les projets en leur version Bêta sont encore sur des forks et dans des repos personnels, cela sera bougé par la suite et cet article sera mis à jour.
Les projets
L’OS
La partie OS (pixL) est ici : https://gitlab.com/pixl-os/pixl
Sur gitlab, c’est un fork basé sur Recalbox, cela utilise d’autres projets comme le configgen, hardware…
Nous utilisons une branche spécifique: RETRO-X que l’on rebase sur la branche « master » de Recalbox surtout lors de release ou pre-release de Recalbox
Un CHANGELOG-RETRO-X.md à la racine du projet permet de suivre les évolutions du projets par branche, important à mettre à jour absoluement lors de merge sur notre branche principale RETRO-X
Le front-end
La partie front-end donc Pegasus est ici: https://github.com/pixl-os/pegasus-frontend
Sur github, c’est un fork du projet initial, cela utilise 3 sub-projects dont notre thème « gameOS » qui est embarqué dans Pegasus.
Nous utilisons une branche spécifique: recalbox-integration que l’on rebase rarement voir pas du tout maintenant parce que notre version pour buildroot et recalbox devient trop spécifique.
Un CHANGELOG.md à la racine du projet permet de suivre les évolutions du projets par branche, important à mettre à jour absolument lors de merge sur notre branche principale recalbox-integration
La traduction du front-end
La partie traduction du front-end Pegasus est ici: https://github.com/pixl-os/pegasus-frontend-translations
Le thème principal
La partie concernant le thème principal de notre Pegasus est ici: https://github.com/pixl-os/gameOS
Sur github, c’est un fork du projet gameOS initial, cela utilise 3 sub-projects dont notre thème « gameOS » qui est embarqué dans Pegasus.
Nous utilisons une branche spécifique: recalbox-integration que l’on rebase pas en ce moment parce que peut d’évolution du projet initial.
Un CHANGELOG.md à la racine du projet permet de suivre les évolutions du projets par branche, important à mettre à jour absolument lors de merge sur notre branche principale recalbox-integration
Crée un thème pour la communauté
Les documentations mis à disposition pour crée un thème sont ici : Le thème
Comment récupérer les sources codes pour vous ?
- Avoir un compte Gitlab : https://gitlab.com/
- Avoir un compte Github : https://github.com/
- Il est conseillé pour vos repos d’activer l’authentification renforcé pour éviter certaines attaques.
- Forker les projets dans un premier temps (pour certains nous avons des accès direct au repo pour l’administrer mais c’est jamais conseillé de travailler directement sur le projet où l’on merge les branches et où on va pointer pendant le build)
Voici ci-après comment forker sur Github notre projet « gameOS »:
Voici ci-après comment forker sur Gitlab notre projet « recalbox »:
- Pour récupérer le code sur vos PCs, nous conseillons un outil comme GitKraken surtout si vous débutez avec git et la gestion de configuration en général. Il est gratuit(pour les repo public) et il est ici: https://www.gitkraken.com/.
- Ensuite il faudra vous créer un compte aussi sur git kraken
- Puis lier vos comptes gitlab et github (il faurda lié avec une clé SSH), je vous laisse suivre les tutos pour cela que l’on trouve sur internet.
Comment soumettre des « merge request » à partir de vos repos ?
//TO DO 😉
