repository.example下载repository.example源码下载

repository.example

其他源码

1.0.0

下载

用于设置 GitHub 托管的 Kodi 存储库的教程和示例存储库。有关使用此方法创建的存储库（包括子模块）的示例，请参阅 https://www.github.com/jurialmunkey/repository.jurialmunkey/。

BASIC - 如何设置在 GitHub Pages 上托管

为了遵循本教程，首先使用此存储库作为新存储库的模板，然后在本地克隆新创建的存储库。对于最简单的文件管理器源 URL，建议将新创建的存储库命名为YOUR_USERNAME_HERE.github.io 。

创建您的存储库附加组件

首先，您需要编辑/repo/repository.example文件夹中的addon.xml文件，其中包含您选择的附加组件 ID、版本号和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 >

虽然不是必需的，但也建议将repository.example文件夹中的icon.png和fanart.jpg替换为与您的存储库或其中包含的附加组件相关的艺术作品。 icon.png应为 512x512 像素， fanart.jpg应为 1920x1080 像素或类似比例。

最后，重命名repository.example文件夹以匹配您之前选择的任何附加组件ID。

将附加组件添加到您的存储库

要构建存储库，首先将您想要包含在 Kodi 存储库中的任何附加组件的附加组件源文件夹放置在此存储库中。为了方便更新包含的附加组件，推荐的方法是通过 Git 子模块，许多 Git 客户端以及 Git 终端都支持这些子模块。如果您选择不使用子模块，则只需将源文件夹直接复制到此存储库中即可。

此存储库中包含的_repo_xml_generator.py脚本包含每个包含的附加组件的构建.zip文件，以及生成必要的addons.xml和addons.xml.md5文件，以便 Kodi 可以推断存储库的内容。它旨在处理 Kodi 的多个版本（例如，为 Leia 提供与 Matrix 不同的附加组件），以及为所有 Kodi 版本提供相同附加组件的单个存储库。

所有版本都有相同的附加组件（默认）

将您的附加源文件夹放入此存储库的repo文件夹中。

不同版本的不同附加组件（高级）

将您的附加源文件夹放入以您希望从中提供服务的 Kodi 版本命名的文件夹中，而不是/repo 。例如， /leia表示以 Leia 为中心的存储库，或/matrix表示以 Matrix 为中心的存储库。为了使您的存储库能够区分要提供哪些附加组件，您需要向addon.xml添加一个新的dir部分，该部分定义应提供哪些版本。

例如，仅服务 Leia：

< 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 ，并将它们与生成的addons.xml和addons.xml.md5一起放置在名为zips的子文件夹中。从版本 3 开始，此脚本可以为 Krypton、Leia、Matrix 和 Nexus 创建发行版，以及通用“repo”，旨在服务于任何版本（例如存储库本身或任何跨版本库）和依赖项）。

使您的存储库 zip 可安装在 Kodi 中

复制存储库的 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 Pages”部分，选择默认分支（或您在修改addon.xml时选择的分支）作为源，然后单击“保存”。

之后，你应该就完成了！

如果您将此存储库命名为YOUR_USERNAME_HERE.github.io （按照建议），您的文件管理器源将为：

https://YOUR_USERNAME_HERE.github.io/

如果您将其命名为其他名称，它将是：

https://YOUR_USERNAME_HERE.github.io/REPOSITORY_NAME_HERE/

高级 - 如何在没有 GitHub Pages 的情况下设置托管

如果您想将 Kodi 存储库托管在 GitHub Pages 之外的其他主机上，只需将此存储库下载为.zip并解压缩，而不是将其用作模板。继续执行其余的设置过程，但 GitHub Pages 的设置除外。唯一的区别在于你的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 >