معرفی رابطه یک به یک (One To One) در لاراول
معرفی رابطه یک به یک (One To One) در لاراول
1398-03-13
ایمپورت کردن ماژول در اندروید استودیو
ایمپورت کردن ماژول در اندروید استودیو
1398-03-15
ساخت dependency برای کتابخانه اندروید در گیت هاب با jitpack

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

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

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

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

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

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

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

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

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

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

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

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

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

File/New/New Module

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

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

در مرحله بعد اسم کتابخانه رو مینویسیم که خودِ اندروید استودیو بصورت اتوماتیک براساس نام وارد شده برای 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 &amp;&amp; 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 &amp;&amp; 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 رو بزنید:

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

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

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

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

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

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

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

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

ساخت dependency با jitpack
ساخت dependency با jitpack

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

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

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

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

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

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

دیدگاهتان را بنویسید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *