repository.example
1.0.0
Руководство и репозиторий примеров для настройки репозитория Kodi, размещенного на GitHub. Пример репозитория, созданного с использованием этого метода (включая подмодули), см. на странице https://www.github.com/jurialmunkey/repository.jurialmunkey/.
Чтобы следовать этому руководству, сначала используйте этот репозиторий в качестве шаблона для нового репозитория, а затем клонируйте вновь созданный репозиторий локально. Для простейшего исходного URL-адреса файлового менеджера рекомендуется назвать вновь созданный репозиторий YOUR_USERNAME_HERE.github.io .
Во-первых, вам нужно будет отредактировать файл addon.xml в папке /repo/repository.example , указав выбранный вами идентификатор надстройки, номер версии и ваше имя пользователя (или любое другое) для provider , как показано на рисунке. в строке 2:
< addon id = " ADDON_ID_HERE " name = " REPO_NAME_HERE " version = " VERSION_NUMBER_HERE " provider-name = " YOUR_USERNAME_HERE " > Вам также необходимо заменить YOUR_USERNAME_HERE , REPOSITORY_NAME_HERE и BRANCH_NAME_HERE на свое имя пользователя GitHub, имя этого репозитория и имя ветки (рекомендуется использовать ветку по умолчанию, обычно master или main ) соответственно, как показано в строках 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 >Вам также следует изменить краткое описание и описание вашего репозитория, как показано в строках 11-12:
< summary >REPO_NAME_HEREsummary >
< description >DESCRIPTION OF YOUR REPO HEREdescription > Хотя это и не обязательно, также рекомендуется заменить icon.png и fanart.jpg в папке repository.example изображениями, соответствующими вашему репозиторию или содержащимся в нем надстройкам. icon.png должен иметь размер 512x512 пикселей, а fanart.jpg — 1920x1080 пикселей или аналогичное соотношение.
Наконец, переименуйте папку repository.example , чтобы она соответствовала выбранному вами ранее идентификатору надстройки.
Чтобы создать репозиторий, сначала поместите исходные папки надстроек для тех надстроек, которые вы хотите содержать в своем репозитории Kodi, внутри этого репозитория. Для упрощения обновления включенных надстроек рекомендуется делать это через подмодули Git, которые поддерживаются многими клиентами Git, а также терминалом Git. Если вы решите не использовать подмодули, вам нужно будет просто скопировать исходные папки непосредственно в этот репозиторий.
Сценарий _repo_xml_generator.py , включенный в этот репозиторий, содержит файлы сборки .zip для каждого включенного дополнения, а также генерирует необходимые файлы addons.xml и addons.xml.md5 , чтобы Kodi мог сделать вывод о содержимом репозитория. Он предназначен для работы с несколькими версиями Kodi (например, для обслуживания различных надстроек для Leia, чем для Matrix), а также для отдельных репозиториев, которые обслуживают одни и те же дополнения для всех версий Kodi.
Поместите исходные папки дополнений в папку repo этого репозитория.
Поместите исходные папки надстроек в папку, названную в честь версии Kodi, которую вы хотите использовать из нее, вместо /repo . Например, /leia для репозитория, ориентированного на Лею, или /matrix для репозитория, ориентированного на Матрицу. Чтобы ваш репозиторий мог различать, какие надстройки обслуживать, вам необходимо добавить новый раздел dir в ваш addon.xml , который определяет, какие версии должны обслуживаться.
Например, чтобы служить только Лее:
< 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 >И для Matrix и выше:
< 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 > После добавления исходных папок просто запустите _repo_generator.py . Это создаст .zip архивы всех нужных надстроек и поместит их в подпапки, называемые zips , вместе с созданными addons.xml и addons.xml.md5 . Начиная с версии 3, этот скрипт может создавать дистрибутивы для Krypton, Leia, Matrix и Nexus, а также общий «репозиторий», который предназначен для обслуживания любой версии (например, для самого репозитория или любых библиотек кросс-версий). и зависимости).
Скопируйте zip-файл вашего репозитория, расположенный по адресу REPO_FOLDER/zips/ADDON_ID_HERE/ADDON_ID_HERE-VERSION_NUMBER_HERE.zip , и вставьте его в корневую папку.
Отредактируйте ссылку внутри index.html , чтобы она отражала имя файла вашего дополнения, как показано в строке 1:
< a href =" ADDON_ID_HERE-VERSION_NUMBER_HERE.zip " > ADDON_ID_HERE-VERSION_NUMBER_HERE.zip a > После фиксации и отправки этих изменений в ваш репозиторий перейдите в раздел «Настройки» для этого репозитория на GitHub. В первом поле с надписью «Имя репозитория» измените имя вашего репозитория. Обычно репозитории GitHub Pages называются YOUR_USERNAME_HERE.github.io , но это может быть что угодно. Затем прокрутите вниз до раздела «Страницы GitHub», выберите ветку по умолчанию (или ту, которую вы выбрали при изменении файла addon.xml ) в качестве источника и нажмите «Сохранить».
После этого все должно быть готово!
Если вы назвали этот репозиторий YOUR_USERNAME_HERE.github.io (как рекомендовано), источником вашего файлового менеджера будет:
https://YOUR_USERNAME_HERE.github.io/
Если вы назвали его как-нибудь по-другому, это будет:
https://YOUR_USERNAME_HERE.github.io/REPOSITORY_NAME_HERE/
Если вы хотите разместить свой репозиторий Kodi на другом хосте, кроме страниц GitHub, просто загрузите этот репозиторий в формате .zip и разархивируйте его, а не используйте в качестве шаблона. Продолжайте выполнять остальную часть процедуры установки, за исключением настройки страниц GitHub. Единственные различия будут в вашем файле addon.xml , поскольку он должен будет ссылаться на ваш хост, а не на 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 > И загрузите содержимое этого репозитория на свой хост. Очень важно , чтобы YOUR_HOST_URL_HERE был URL-адресом корневой папки этого репозитория.
После этого исходный код вашего файлового менеджера будет:
https://YOUR_HOST_URL_HERE/
