repository.example تنزيل - repository.example تنزيل كود المصدر

repository.example

شفرة المصدر الأخرى

1.0.0

تنزيل

مستودع البرنامج التعليمي والأمثلة لإعداد مستودع Kodi المستضاف على GitHub. للحصول على مثال على الريبو الذي تم إنشاؤه باستخدام هذه الطريقة (بما في ذلك الوحدات الفرعية)، راجع https://www.github.com/jurialmunkey/repository.jurialmunkey/.

BASIC - كيفية الإعداد للاستضافة على صفحات GitHub

لمتابعة هذا البرنامج التعليمي، استخدم أولاً هذا المستودع كقالب لمستودع جديد، ثم قم باستنساخ المستودع الذي تم إنشاؤه حديثًا محليًا. للحصول على أبسط عنوان 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 للريبو الذي يركز على Leia، أو /matrix للمستودع الذي يركز على 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" العام، والذي يهدف إلى العمل على أي إصدار (مثل المستودع نفسه، أو أي مكتبات مشتركة بين الإصدارات). والتبعيات).

اجعل مستودعك المضغوط قابلاً للتثبيت داخل Kodi

انسخ الملف المضغوط الخاص بمستودعك، الموجود في 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 باسم 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

إذا كنت تريد استضافة Kodi repo على مضيف مختلف إلى جانب صفحات 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 >