ساخت dependency برای کتابخانه اندروید در گیت هاب با jitpack

ساخت dependency برای کتابخانه اندروید در گیت هاب با jitpack ، گیت هاب رو که (تقریبا) همه برنامه نویس های فعال (حتی غیرفعال) میشناسن و بطور مداوم بهش سر میزنن.اما برای کسانی که تازه به دنیای برنامه نویسی پیوستن باید بگم که گیت هاب انباری از کدهای خوب و بد (کد بد برای اونایی که فقط کپی پیست میکنن 😀 ) است که بصورت کاملا رایگان در اختیار ما قرار داده شده.و الان در چنگال مایکروسافت اسیره 😀

ساخت dependency برای کتابخانه اندروید در گیت هاب با jitpack

توجه:
گیت هاب از گیت میاد و گیت خودش یه دنیاییه ! و احتمالا امکان نداره کسی که داره این مقاله رو میخونه اسم گیت به گوشش نخورده باشه 😀 اما اگر دوست دارید درباره گیت بطور کاملتری بدونید اینکه چی هست و چی بود و چرا اینقدر غوله !! حتما این مقاله از تجاری اپ رو بخونید
همچنین پیشنهاد میکنم بعد از اینکه کامل با گیت آشنا شدید اقدام به یادگیری الفبای گیت بصورت کاربردی کنید تا از جامعه گیت ی ها عقب نمونید ! برای مطالعه کاربردی گیت هم پیشنهاد میشه این مقاله از تجاری اپ رو مطالعه و تمرین کنید و منتظر مقالات تخصصی تر از گیت در تجاری اپ باشید 🙂

کتابخانه های اندروید

خب طبیعتا کتابخانه هایی زیادی در گیت دیدید که برای استفاده از اونها باید وابستگی یا dependency شون رو به پروژه خودتون اضافه کنید.برای مثال کتابخانه ButterKnif , Gson , Retrofit , Rxjava و یا Volley ( آموزش همه این کتابخانه ها رو سایت تجاری اپ میتونید کاملا رایگان مطالعه کنید :)‌ )

برای استفاده از این کتابخانه ها ما دوراه داریم
۱- ماژول کتابخانه ها را به پروژه ایمپورت کنیم
۲- از وابستگی یا dependency کتابخانه ها استفاده کنیم

نحوه ساخت dependency برای کتابخانه اندروید

خب موضوع این مقاله وابستگی یا dependency هاست و ایمپورت ماژول رو هم بصورت کامل و کاربردی در این پست آموزش دادیم .

برای ایجاد وابستگی باید چیکار کنیم؟!
مشخصا باید ابتدا یک پروژه اندروید ایجاد کنیم

حالا باید یک ماژول به پروژه اضافه کنیم.
(بخوام درباره ماژول یه توضیح کوتاه بدم میتونم بگم که ماژول یک شبه پروژه کامله که به یک پروژه روت ایمپورت میشه. میتونیم داخلش resource و سورس کد و… اضافه کنیم و از اون داخل پروژه اصلی استفاده کنیم)

خب برای ساخت یک ماژول کافیه که مسیر زیر رو بریم

File/New/New Module

و در کادر باز شده آیتم Android Library مطابق تصویر زیر انتخاب کنیم و درنهایت هم Next

در مرحله بعد اسم کتابخانه رو مینویسیم که خودِ اندروید استودیو بصورت اتوماتیک براساس نام وارد شده برای Application/Library Name نامی رو با حروف کوچک برای Module name ایجاد میکنه

همچنین package name هم بصورت اتوماتیک تولید میشه ، همچنین میتونیم Minimum SDK رو هم برای ماژول اندروید تعیین کنیم و در نهایت Finish رو میزنیم و ماژول ایجاد میشه .خب حالا داخل ماژول ایجاد شده میتونیم هر منابع یا کدی که میخوایم رو بنویسیم.

برای مثال من کلاسی نوشتم که اعداد رو به فارسی یا انگلیسی تبدیل میکنه با سورس زیر:

package dnejad.marjan.convertnumberstopersian;

public class ConvertNumber {

    private static String[] persianNumbers = new String[]{"۰", "۱", "۲", "۳", "۴", "۵", "۶", "۷", "۸", "۹"};
    private static String[] engNumbers = new String[]{"0", "1", "2", "3", "4", "5", "6", "7", "8", "9"};


    public static String toPersianNumber(String text) {
        if (text.length() == 0) {
            return "";
        }
        String out = "";
        int length = text.length();
        for (int i = 0; i < length; i++) {
            char c = text.charAt(i);
            if ('0' <= c && c <= '9') {
                int number = Integer.parseInt(String.valueOf(c));
                out += persianNumbers[number];
            } else if (c == '٫') {
                out += '،';
            } else {
                out += c;
            }
        }

        return out;
    }

    public static String toEnglishNumber(String text) {
        if (text.length() == 0) {
            return "";
        }
        String out = "";
        int length = text.length();
        for (int i = 0; i < length; i++) {
            char c = text.charAt(i);
            if ('0' <= c && c <= '9') {
                int number = Integer.parseInt(String.valueOf(c));
                out += engNumbers[number];
            } else if (c == '٫') {
                out += '،';
            } else {
                out += c;
            }
        }
        return out;
    }

}

حالا میتونیم پروژه رو به گیت هاب متصل کنیم ، برای اتصال پروژه به گیت هاب باید مسیر زیر رو بریم:

VCS/Import into Version Control/Share Project in Github

در کادری که باز میشه باید به گیت هابتون لاگین کنید با نام کاربری و رمز عبور.بعد از لاگین موفق میتونید یک Repository یا مخزن با نام دلخواه برای نگهداری سورس ایجاد کنید و دکمه share رو بزنید:

در نهایت پس از آپلود فایل هایی که میخواید (ترجیحا همه فایل ها) مطابق عکس زیر:

یک پاپ آپ کوچک در پایین سمت راست اندروید استودیو نمایان میشود که مشخص میکند سورس با موفقیت آپلود شده و با کلیک برروی لینک میتونید به صفحه سورس برید ، خواهید دید که سورس تمام و کمال آپلود شده و میتونید توضیحات یا فایل Readme رو بهش اضافه کنید

حالا میریم تب Release در صفحه گیت هاب پروژه و یک Release براش ایجاد میکنیم که بتونیم در dependency ازش استفاده کنیم:

حالا میریم سایت jitpack که این امکان رو به ما میده که با وارد کردن لینک گیت هاب بتونیم dependency یا وابستگی کتابخانه رو بگیریم.
خیلی ساده لینک پروژه گیت هاب رو کپی کنید و داخل فیلد ورودی که داخل سایت هست قرار بدید و دکمه Look up رو بزنید

خواهید دید که Release ی که برای پروژه ساختید نمایش داده میشود

حالا دکمه Get it رو بزنید تا dependency هایی که باید برای استفاده از کتابخانه داخل پروژه اندروید بذارید به شما نمایش داده شود

این اطلاعات رو میتونید داخل Readme مخزن گیت هاب اضافه کنید تا بقیه هم بتونن از کتابخانه شما استفاده کنند

برای مشاهده نمونه پروژه ای که کار کردیم اینجا کلیک کنید