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 >