repository.example
1.0.0
Tutoriel et exemple de référentiel pour configurer un dépôt Kodi hébergé sur GitHub. Pour un exemple de dépôt créé à l'aide de cette méthode (y compris les sous-modules), voir https://www.github.com/jurialmunkey/repository.jurialmunkey/.
Pour suivre ce didacticiel, utilisez d'abord ce référentiel comme modèle pour un nouveau référentiel, puis clonez localement votre référentiel nouvellement créé. Pour l'URL source du gestionnaire de fichiers la plus simple, il est recommandé de nommer votre référentiel nouvellement créé comme YOUR_USERNAME_HERE.github.io .
Tout d'abord, vous devrez modifier le fichier addon.xml dans le dossier /repo/repository.example avec l'ID du module complémentaire que vous avez choisi, un numéro de version et votre nom d'utilisateur (ou ce que vous souhaitez) pour provider , comme indiqué. à la ligne 2 :
< addon id = " ADDON_ID_HERE " name = " REPO_NAME_HERE " version = " VERSION_NUMBER_HERE " provider-name = " YOUR_USERNAME_HERE " > Vous devez également remplacer YOUR_USERNAME_HERE , REPOSITORY_NAME_HERE et BRANCH_NAME_HERE par votre nom d'utilisateur GitHub, le nom de ce référentiel et le nom de la branche (il est recommandé d'utiliser la branche par défaut, généralement master ou main ) respectivement, comme indiqué aux lignes 4 à 8 :
< dir >
< info compressed = " false " >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/BRANCH_NAME_HERE/repo/zips/addons.xmlinfo >
< checksum >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/BRANCH_NAME_HERE/repo/zips/addons.xml.md5checksum >
< datadir zip = " true " >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/BRANCH_NAME_HERE/repo/zips/datadir >
dir >Vous devez également modifier le résumé et la description de votre référentiel, comme indiqué aux lignes 11 et 12 :
< summary >REPO_NAME_HEREsummary >
< description >DESCRIPTION OF YOUR REPO HEREdescription > Bien que cela ne soit pas obligatoire, il est également recommandé de remplacer icon.png et fanart.jpg dans le dossier repository.example par des illustrations pertinentes pour votre référentiel ou les modules complémentaires qu'il contient. icon.png doit mesurer 512 x 512 px et fanart.jpg doit mesurer 1 920 x 1 080 px, ou un rapport similaire.
Enfin, renommez le dossier repository.example pour qu'il corresponde à l'ID de module complémentaire que vous avez choisi précédemment.
Pour créer le référentiel, placez d'abord les dossiers sources des modules complémentaires pour les modules complémentaires que vous souhaitez contenir dans votre dépôt Kodi à l'intérieur de ce référentiel. Pour faciliter la mise à jour des modules complémentaires inclus, la méthode recommandée pour ce faire consiste à utiliser les sous-modules Git, qui sont pris en charge par de nombreux clients Git, ainsi que le terminal Git. Si vous choisissez de ne pas utiliser de sous-modules, vous devrez simplement copier les dossiers sources directement dans ce référentiel.
Le script _repo_xml_generator.py inclus dans ce référentiel avec les fichiers build .zip pour chaque module complémentaire inclus, ainsi que la génération des fichiers addons.xml et addons.xml.md5 nécessaires, afin que Kodi puisse déduire le contenu du référentiel. Il est conçu pour gérer plusieurs versions de Kodi (par exemple, pour servir des modules complémentaires différents à Leia par rapport à Matrix) et des référentiels uniques qui servent les mêmes modules complémentaires à toutes les versions de Kodi.
Placez les dossiers sources de votre module complémentaire dans le dossier repo de ce référentiel.
Placez les dossiers sources de votre module complémentaire dans un dossier nommé d'après la version de Kodi que vous souhaitez utiliser, au lieu de /repo . Par exemple, /leia pour un dépôt axé sur Leia, ou /matrix pour un dépôt axé sur Matrix. Pour que votre référentiel puisse différencier les modules complémentaires à servir, vous devrez ajouter une nouvelle section dir à votre addon.xml , qui définit les versions à servir.
Par exemple, pour servir Leia uniquement :
< dir minversion = " 18.0.0 " maxversion = " 18.9.9 " >
< info compressed = " false " >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/DEFAULT_BRANCH_NAME_HERE/leia/zips/addons.xmlinfo >
< checksum >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/DEFAULT_BRANCH_NAME_HERE/leia/zips/addons.xml.md5checksum >
< datadir zip = " true " >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/DEFAULT_BRANCH_NAME_HERE/leia/zips/datadir >
dir >Et pour Matrix et plus :
< dir minversion = " 19.0.0 " >
< info compressed = " false " >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/DEFAULT_BRANCH_NAME_HERE/matrix/zips/addons.xmlinfo >
< checksum >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/DEFAULT_BRANCH_NAME_HERE/matrix/zips/addons.xml.md5checksum >
< datadir zip = " true " >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/DEFAULT_BRANCH_NAME_HERE/matrix/zips/datadir >
dir > Après avoir ajouté vos dossiers sources, exécutez simplement _repo_generator.py . Cela créera des .zip de tous les modules complémentaires souhaités et les placera dans des sous-dossiers appelés zips , avec les addons.xml et addons.xml.md5 générés. À partir de la version 3, ce script peut créer des distributions pour Krypton, Leia, Matrix et Nexus, ainsi que le "repo" générique, destiné à servir n'importe quelle version (comme pour le référentiel lui-même ou pour toute bibliothèque multi-versions). et dépendances).
Copiez le fichier zip de votre référentiel, situé dans REPO_FOLDER/zips/ADDON_ID_HERE/ADDON_ID_HERE-VERSION_NUMBER_HERE.zip , et collez-le dans le dossier racine.
Modifiez le lien dans index.html pour refléter le nom de fichier de votre module complémentaire, comme indiqué sur la ligne 1 :
< a href =" ADDON_ID_HERE-VERSION_NUMBER_HERE.zip " > ADDON_ID_HERE-VERSION_NUMBER_HERE.zip a > Après avoir validé et appliqué ces modifications à votre référentiel, accédez à la section « Paramètres » de ce référentiel sur GitHub. Dans la première case, intitulée « Nom du référentiel », modifiez le nom de votre référentiel. Généralement, les référentiels GitHub Pages sont nommés YOUR_USERNAME_HERE.github.io , mais cela peut être ce que vous souhaitez. Ensuite, faites défiler jusqu'à la section « Pages GitHub », choisissez la branche par défaut (ou celle que vous avez choisie lors de la modification de votre addon.xml ) comme source, puis cliquez sur « Enregistrer ».
Après cela, vous devriez avoir terminé !
Si vous avez nommé ce référentiel YOUR_USERNAME_HERE.github.io (comme recommandé), la source de votre gestionnaire de fichiers sera :
https://YOUR_USERNAME_HERE.github.io/
Si vous lui donnez un autre nom, ce sera :
https://YOUR_USERNAME_HERE.github.io/REPOSITORY_NAME_HERE/
Si vous souhaitez héberger votre dépôt Kodi sur un hôte autre que GitHub Pages, téléchargez simplement ce référentiel au format .zip et décompressez-le, plutôt que de l'utiliser comme modèle. Continuez à suivre le reste de la procédure de configuration, à l'exception de la configuration des pages GitHub. Les seules différences résideront dans votre fichier addon.xml , car il devra référencer votre hôte, plutôt que GitHub :
< dir >
< info compressed = " false " >https://YOUR_HOST_URL_HERE/repo/zips/addons.xmlinfo >
< checksum >https://YOUR_HOST_URL_HERE/repo/zips/addons.xml.md5checksum >
< datadir zip = " true " >https://YOUR_HOST_URL_HERE/repo/zips/datadir >
dir > Et téléchargez le contenu de ce référentiel sur votre hébergeur. Il est très important que YOUR_HOST_URL_HERE soit l'URL du dossier racine de ce référentiel.
Après cela, la source de votre gestionnaire de fichiers sera :
https://YOUR_HOST_URL_HERE/
