الـ jitPack وطريقة رفع المكتبات عليه

تحدثنا في مقالة سابقة عن “كيف يتعامل الاندرويد مع المكتبات وماهو الـ maven و الـ jcenter” وفي هذه المقالة سنوضح ماهو الـ jitPack وكيف ترفع مكتبتك عليهم.

ماهو الـ jitPack؟

الـ jitPack هو من Github ويتعبر  repo مثله مثل الـ maven و الـ jcenter لاستضافة المكتبات الخاصة بالجافا والاندرويد ولكن الفرق بينهم ان الـ maven & jcenter يستضيف ملفات الـ jar & aar وعندما يطلبها المستخدم فإنه يقوم بتحميلها مباشرة بينما الـ jitPack فإنك تقوم برفع اكواد المشروع على الـ github ويقوم الـ jitPack بعمل build لملفات الـ jar or aar عندما يطلبها المستخدم.

لتحميل المكتبات من jitPack فانك بحاجة الى تضمينه في ملف الـ gradle عن طريق السطر التالي:

طريقة رفع مكتبك على الـ jitPack

كما تحدثنا في المقالة السابقة, فإن معظم المكتبات تحتوي على two moduels واحد لاكواد المكتبة وعادةً مايسمى library بينما الآخر لمثال على طريقة استخدام المكتبة وعادةً مايسمى app or example .

لذلك سنقوم باتباع نفس الخطوات السابقة وننشئ مشروع جديد ونضيف module جديد بإسم library.

  1.  من قائمة file – new – new module

  2. اختر Android library

  3. في حقل Library Name ادخل Library وقم بتعديل حقل Package name الى النمط التالي (yourDomain.ibraryname.library)

الان المشروع يحتوي على two modules واحد لاكواد المكتبة وهو ما سوف يضمنه المطورين في مشاريعهم والآخر قم بكتابة مثال لطريقة استخدام المكتبة .

 تضمین jitPack للمشروع

قم بإضافة السطر التالي إلى ملف build.gradle الأساسي للمشروع :

واخيرا قم بإضافة المكتبة التالية إلى ملف build.gradle الخاص بـ library module :

 إنشاء اصدار جديد للمكتبة

اولاً يجب ان تقوم برفع ملفات المشروع الى repo على الـ Github وان كنت لا تعرف طريقة التعامل مع الـ git فقم بمشاهدة السلسلة التالية (التعامل مع الـ Git)

  1. توجه الى رابط الـ repo الخاص بمشروعك واضغط على releases

  2. اضغط على Create a new relase لإنشاء اصدار جديد

  3. في خانة Tag Name و Realase title ادخل رقم الاصدار كالتالي “v1.0.0”
  4. واخيرا اضغط على زر Publish realse

يستطيع المطورون الان تضمين مكتبتك في مشاريعهم عن طريق السطر التالي:

وفي مثالنا السابق يصبح الرابط كالتالي:

نشر تحديث للمكتبة

في حالة قمت بعمل بعض التعديلات على مكتبك وتريد نشر اصدار جديد فكل ماعليك فعله هو رفع التعديلات الجديدة على الـ repo الخاص بمشروعك ومن ثم تكرار الخطوة السابقة لإصدار Realse جديد وبرقم اصدار مختلف عن السابق.

مثال المشروع

https://github.com/alhazmy13/example-jitpack

Share:
0 comments on الـ jitPack وطريقة رفع المكتبات عليه

Post a comment

لن يتم نشر عنوان بريدك الإلكتروني. الحقول الإلزامية مشار إليها بـ *