ดาวน์โหลด repository.example - repository.example ดาวน์โหลดซอร์สโค้ด

repository.example

ซอร์สโค้ดอื่น ๆ

1.0.0

ดาวน์โหลด

บทช่วยสอนและที่เก็บตัวอย่างสำหรับการตั้งค่า repo Kodi ที่โฮสต์โดย GitHub สำหรับตัวอย่าง repo ที่สร้างขึ้นโดยใช้วิธีนี้ (รวมถึงโมดูลย่อย) โปรดดู https://www.github.com/jurialmunkey/repository.jurialmunkey/

พื้นฐาน - วิธีการตั้งค่าสำหรับการโฮสต์บนเพจ GitHub

เพื่อปฏิบัติตามบทช่วยสอนนี้ ขั้นแรกให้ใช้พื้นที่เก็บข้อมูลนี้เป็นเทมเพลตสำหรับพื้นที่เก็บข้อมูลใหม่ จากนั้นจึงโคลนพื้นที่เก็บข้อมูลที่คุณสร้างขึ้นใหม่ภายในเครื่อง สำหรับ URL แหล่งที่มาของตัวจัดการไฟล์ที่ง่ายที่สุด ขอแนะนำให้ตั้งชื่อที่เก็บที่สร้างขึ้นใหม่เป็น YOUR_USERNAME_HERE.github.io

การสร้างส่วนเสริมที่เก็บของคุณ

ขั้นแรก คุณจะต้องแก้ไขไฟล์ addon.xml ภายในโฟลเดอร์ /repo/repository.example ด้วย 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 >

แม้จะไม่จำเป็น แต่ก็แนะนำให้แทนที่ icon.png และ fanart.jpg ในโฟลเดอร์ repository.example ด้วยภาพศิลป์ที่เกี่ยวข้องกับพื้นที่เก็บข้อมูลของคุณหรือส่วนเสริมที่อยู่ภายใน icon.png ควรมีขนาด 512x512 พิกเซล และ fanart.jpg ควรมีขนาด 1920x1080 พิกเซล หรืออัตราส่วนที่ใกล้เคียงกัน

สุดท้าย เปลี่ยนชื่อโฟลเดอร์ repository.example เพื่อให้ตรงกับรหัส Add-on ที่คุณเลือกไว้ก่อนหน้านี้

การเพิ่มส่วนเสริมไปยังพื้นที่เก็บข้อมูลของคุณ

ในการสร้างพื้นที่เก็บข้อมูล ขั้นแรกให้วางโฟลเดอร์ซอร์สของ Add-on สำหรับส่วนเสริมใดก็ตามที่คุณต้องการเก็บไว้ใน Kodi repo ของคุณภายในที่เก็บนี้ เพื่อความสะดวกในการอัปเดตส่วนเสริมที่รวมอยู่ วิธีการที่แนะนำคือผ่าน Git Submodules ซึ่งได้รับการสนับสนุนโดยไคลเอนต์ Git จำนวนมาก รวมถึงเทอร์มินัล Git หากคุณเลือกที่จะไม่ใช้โมดูลย่อย คุณจะต้องคัดลอกโฟลเดอร์ต้นทางไปยังที่เก็บนี้โดยตรง

สคริปต์ _repo_xml_generator.py ที่รวมอยู่ในพื้นที่เก็บข้อมูลนี้พร้อมด้วยไฟล์ build .zip สำหรับ Add-on ที่รวมไว้แต่ละรายการ รวมถึงการสร้างไฟล์ addons.xml และ addons.xml.md5 ที่จำเป็น เพื่อให้ Kodi สามารถอนุมานเนื้อหาของ repo ได้ ได้รับการออกแบบมาเพื่อรองรับ Kodi หลายเวอร์ชัน (เช่น เพื่อให้บริการส่วนเสริมที่แตกต่างกันกับ Leia มากกว่าที่ให้บริการกับ Matrix) และที่เก็บข้อมูลเดี่ยวที่ให้บริการส่วนเสริมเดียวกันกับ Kodi ทุกรุ่น

ส่วนเสริมเดียวกันในทุกเวอร์ชัน (ค่าเริ่มต้น)

วางโฟลเดอร์ซอร์ส Add-on ของคุณในโฟลเดอร์ repo ของที่เก็บนี้

ส่วนเสริมที่แตกต่างกันสำหรับเวอร์ชันต่างๆ (ขั้นสูง)

วางโฟลเดอร์ต้นทางของ Add-on ลงในโฟลเดอร์ที่ตั้งชื่อตามเวอร์ชันของ Kodi ที่คุณต้องการให้บริการ แทนที่จะเป็น /repo ตัวอย่างเช่น /leia สำหรับ repo ที่เน้น Leia หรือ /matrix สำหรับ repo ที่เน้น 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 >

และสำหรับเมทริกซ์ขึ้นไป:

< 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 รวมถึง "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 >

หลังจากยืนยันและผลักดันการเปลี่ยนแปลงเหล่านี้ไปยัง repo ของคุณแล้ว ให้ไปที่ส่วน "การตั้งค่า" สำหรับพื้นที่เก็บข้อมูลนี้บน 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/

ขั้นสูง - วิธีการตั้งค่าสำหรับการโฮสต์โดยไม่มีหน้า GitHub

หากคุณต้องการโฮสต์ repo Kodi ของคุณบนโฮสต์อื่นนอกเหนือจาก GitHub Pages เพียงดาวน์โหลดที่เก็บนี้เป็น .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 >