repository.example
1.0.0
Tutorial und Beispiel-Repository zum Einrichten eines auf GitHub gehosteten Kodi-Repositorys. Ein Beispiel für ein mit dieser Methode erstelltes Repo (einschließlich Submodulen) finden Sie unter https://www.github.com/jurialmunkey/repository.jurialmunkey/.
Um diesem Tutorial zu folgen, verwenden Sie dieses Repository zunächst als Vorlage für ein neues Repository und klonen Sie dann Ihr neu erstelltes Repository lokal. Für die einfachste Dateimanager-Quell-URL wird empfohlen, Ihr neu erstelltes Repository als YOUR_USERNAME_HERE.github.io zu benennen.
Zuerst müssen Sie die Datei addon.xml im Ordner /repo/repository.example mit der von Ihnen gewählten Add-on-ID, einer Versionsnummer und Ihrem Benutzernamen (oder was auch immer Sie möchten) für provider bearbeiten (siehe Abbildung). in Zeile 2:
< addon id = " ADDON_ID_HERE " name = " REPO_NAME_HERE " version = " VERSION_NUMBER_HERE " provider-name = " YOUR_USERNAME_HERE " > Sie müssen auch YOUR_USERNAME_HERE , REPOSITORY_NAME_HERE und BRANCH_NAME_HERE durch Ihren GitHub-Benutzernamen, den Namen dieses Repositorys und den Namen des Zweigs ersetzen (es wird empfohlen, den Standardzweig zu verwenden, normalerweise master oder main ), wie in den Zeilen 4–8 zu sehen:
< 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 >Sie sollten auch die Zusammenfassung und Beschreibung Ihres Repositorys ändern, wie in den Zeilen 11-12 zu sehen ist:
< summary >REPO_NAME_HEREsummary >
< description >DESCRIPTION OF YOUR REPO HEREdescription > Obwohl dies nicht erforderlich ist, wird außerdem empfohlen, icon.png und fanart.jpg im Ordner repository.example durch Grafiken zu ersetzen, die für Ihr Repository oder die darin enthaltenen Add-ons relevant sind. icon.png sollte 512 x 512 Pixel groß sein und fanart.jpg sollte 1920 x 1080 Pixel oder ein ähnliches Verhältnis haben.
Benennen Sie schließlich den Ordner repository.example so um, dass er mit der zuvor gewählten Add-on-ID übereinstimmt.
Um das Repository zu erstellen, platzieren Sie zunächst die Add-on-Quellordner für die Add-ons, die in Ihrem Kodi-Repository enthalten sein sollen, in diesem Repository. Um die Aktualisierung enthaltener Add-ons zu vereinfachen, empfiehlt sich hierfür die Verwendung von Git-Submodulen, die von vielen Git-Clients sowie dem Git-Terminal unterstützt werden. Wenn Sie keine Submodule verwenden möchten, müssen Sie die Quellordner einfach direkt in dieses Repository kopieren.
Das in diesem Repository enthaltene Skript _repo_xml_generator.py enthält Build .zip Dateien für jedes enthaltene Add-on und generiert außerdem die erforderlichen Dateien addons.xml und addons.xml.md5 , damit Kodi auf den Inhalt des Repos schließen kann. Es ist darauf ausgelegt, mehrere Kodi-Versionen zu verwalten (z. B. um Leia andere Add-Ons als Matrix bereitzustellen) und einzelne Repositorys, die allen Kodi-Versionen dieselben Add-Ons bereitstellen.
Platzieren Sie Ihre Add-on-Quellordner im repo Ordner dieses Repositorys.
Platzieren Sie die Quellordner Ihres Add-ons in einem Ordner, der nach der Version von Kodi benannt ist, die Sie daraus bereitstellen möchten, und nicht nach /repo . Zum Beispiel /leia für ein Leia-fokussiertes Repo oder /matrix für ein Matrix-fokussiertes Repo. Damit Ihr Repository unterscheiden kann, welche Add-ons bereitgestellt werden sollen, müssen Sie Ihrer addon.xml einen neuen dir Abschnitt hinzufügen, der definiert, welche Versionen bereitgestellt werden sollen.
Um beispielsweise nur Leia zu bedienen:
< 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 >Und für Matrix und höher:
< 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 > Nachdem Sie Ihre Quellordner hinzugefügt haben, führen Sie einfach _repo_generator.py aus. Dadurch werden .zip Dateien aller gewünschten Add-ons erstellt und zusammen mit den generierten addons.xml und addons.xml.md5 in Unterordnern mit der Bezeichnung zips abgelegt. Ab Version 3 kann dieses Skript Distributionen für Krypton, Leia, Matrix und Nexus sowie das generische „Repo“ erstellen, das für jede Version gedacht ist (z. B. für das Repository selbst oder alle versionierungsübergreifenden Bibliotheken). und Abhängigkeiten).
Kopieren Sie die ZIP-Datei Ihres Repositorys, die sich unter REPO_FOLDER/zips/ADDON_ID_HERE/ADDON_ID_HERE-VERSION_NUMBER_HERE.zip befindet, und fügen Sie sie in den Stammordner ein.
Bearbeiten Sie den Link in index.html so, dass er den Dateinamen Ihres Add-ons wiedergibt, wie in Zeile 1 zu sehen:
< a href =" ADDON_ID_HERE-VERSION_NUMBER_HERE.zip " > ADDON_ID_HERE-VERSION_NUMBER_HERE.zip a > Nachdem Sie diese Änderungen festgeschrieben und in Ihr Repo übertragen haben, gehen Sie zum Abschnitt „Einstellungen“ für dieses Repository auf GitHub. Ändern Sie im ersten Feld mit der Bezeichnung „Repository-Name“ den Namen Ihres Repositorys. Im Allgemeinen heißen GitHub Pages-Repositorys YOUR_USERNAME_HERE.github.io , es kann aber auch ein beliebiger Name sein. Scrollen Sie als Nächstes nach unten zum Abschnitt „GitHub-Seiten“, wählen Sie den Standardzweig (oder den, den Sie beim Ändern Ihrer addon.xml ausgewählt haben) als Quelle aus und klicken Sie auf „Speichern“.
Danach sollten Sie fertig sein!
Wenn Sie dieses Repository YOUR_USERNAME_HERE.github.io benannt haben (wie empfohlen), lautet Ihre Dateimanagerquelle:
https://YOUR_USERNAME_HERE.github.io/
Wenn Sie es anders benannt haben, lautet es:
https://YOUR_USERNAME_HERE.github.io/REPOSITORY_NAME_HERE/
Wenn Sie Ihr Kodi-Repository auf einem anderen Host als GitHub Pages hosten möchten, laden Sie dieses Repository einfach als .zip herunter und entpacken Sie es, anstatt es als Vorlage zu verwenden. Befolgen Sie weiterhin den Rest des Einrichtungsvorgangs, mit Ausnahme der Einrichtung von GitHub-Seiten. Die einzigen Unterschiede bestehen in Ihrer addon.xml -Datei, da diese auf Ihren Host und nicht auf GitHub verweisen muss:
< 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 > Und laden Sie den Inhalt dieses Repositorys auf Ihren Host hoch. Es ist sehr wichtig , dass YOUR_HOST_URL_HERE die URL zum Stammordner dieses Repositorys ist.
Danach lautet Ihre Dateimanager-Quelle:
https://YOUR_HOST_URL_HERE/
