استفاده آسان از مخازن GitHub در Android با JitPack

در GitHub تعداد زیادی کتابخانه (Library) جاوا وجود دارد که در مخازن عمومی منتشر نشده‌اند. معمولا در چنین شرایطی شما نیاز خواهید داشت تا کتابخانه را به صورت دستی دریافت و سپس به طرق مختلف در پروژه اضافه کنید.

بهتر نبود اگر خیلی ساده‌تر می‌توانستید به این کتابخانه‌ها دسترسی پیدا کرد؟ خوشبختانه سرویسی به نام JitPack، مراحل ذکر شده را برای شما انجام می‌دهد و دیگر نیازی نیست تا به صورت دستی اینکار را انجام دهید.

برای استفاده از این سرویس ابتدا می‌بایست پس از مراجعه به سایت، آدرس مخزن مورد نظر خود را به صورت کامل در فیلد وسط صفحه وارد و بر روی دکمه Look up کلیک کنید. به طور مثال، آدرس مخزن کتابخانه تاریخ جلالی را به صورت زیر وارد نمایید.

https://github.com/amirmehdizadeh/JalaliCalendar

سپس برای استفاده از کتابخانه در پروژه خود، ابتدا مخزن JitPack را به فایل بیلد پروژه خود اضافه کنید.

repositories {
    maven {
        url "https://jitpack.io"
    }
}

در مرحل بعد، کافیست کتابخانه مورد نظر را به پیش‌نیازهای (Dependencies) پروژه خود اضافه کنید.

dependencies {
        compile 'com.github.amirmehdizadeh:JalaliCalendar:1.0.2'
}

توجه داشته باشید که اگر صاحب مخزن نسخه‌ای را به صورت نسخه انتشار مشخص نکرده باشد، می‌بایست به جای نسخه از شناسه شش حرفی مربوط به آخرین کامیت پروژه استفاده نمایید.

لازم به ذکر است که این امکان وجود دارد که در هنگام Build کتابخانه مشکلی پیش آمده باشد که باعث عدم امکان دسترسی به آن از طریق این سرویس شود، برای اطمینان از صحت و درسی انجام پروسه Build کتابخانه مورد نظر در JitPack می‌توانید از آدرس مشابه آدرس زیر به گزارش این پروسه دسرسی پیدا کنید.

https://jitpack.io/com/github/amirmehdizadeh/JalaliCalendar/1.0.2/build.log