أضف مكتبة Android الشخصية إلى GitHub

Ad Blocker Detected

Our website is made possible by displaying online advertisements to our visitors. Please consider supporting us by disabling your ad blocker.

برنامج تعليمي خطوة بخطوة لإنشاء مكتبة Android ونشرها

يسأل بعض مطوري Android عن كيفية إنشاء مكتبة Android واستخدامها في مشاريع مختلفة ونشرها علنًا على GitHub. في هذه المقالة ، سنقدم لك لمحة موجزة عن كيفية القيام بذلك.

لماذا يجب علينا استخدام مكتبات Android؟

مكتبة Android متطابقة هيكليًا بطبيعتها مع تطبيق Android وتتضمن ملفات المصدر وكود المصدر وملفات البيان وأساسيات أخرى. الاختلاف الوحيد هو وقت التجميع. لديك امتدادات ملفات APK عند التجميع ، وامتدادات ARP عند إنشاء مكتبة. في الواقع ، أنت تقوم بإنشاء تبعية تسمح لأجهزة العرض المستقبلية وأجهزة العرض الأخرى باستخدام كود منظم بدلاً من كتابة نفس الرمز مرارًا وتكرارًا. استخدم مطورو Android مكتبة Android مرة واحدة على الأقل. إذا قمت بزيارة GitHub ، فسترى العديد من المكتبات مفتوحة المصدر المصممة للقيام بمهام متنوعة ، مثل تحميل الصور ، والعمل مع الكاميرات ، والجيروسكوبات ، والمزيد. أنشأ المطورون مكتبات بهدف إعادة استخدام الكود ووضعه في مستودعات البوابة ليستخدمها المستخدمون الآخرون. على سبيل المثال ، افترض أن لديك مشروعًا تم حذفه وتحتاج إلى إنشاء مكتبة لإضافتها إلى التطبيق الرئيسي كتطبيق صغير. هناك عدة حلول لهذا الغرض منها ما يلي:

1. صمم البرنامج كوحدة نمطية ووضح للمستخدمين أنه تطبيق ، لكن المشكلة في هذه الطريقة هي سهولة عرض الكود وتحريره.

2. قم بإنشاء ملفات JAR / AAR بها مشكلتين رئيسيتين. الأول هو أن المستخدمين قادرون على عرض الكود بمعلومات فنية موجزة ، والثاني أنهم لا يدعمون جميع تبعيات المكتبة عند إنشاء ملفات AAR.

3. أنشئ مكتبة وأضفها إلى البوابة كمستودع ، وأخيرًا أضف دعم مكتبة JitPack.

أنشئ مكتبة Android

اتبع الخطوات أدناه لإنشاء مكتبة Android. الخطوة الأولى هي إنشاء مشروع جديد. بعد التنفيذ الناجح للمشروع ، انتقل إلى ملف> جديد> وحدة جديدة> مكتبة Android.

انقر فوق الزر “التالي” ، واملأ الحقول ذات الصلة وانقر فوق الزر “إنهاء”. انتظر حتى يكمل Android Studio عملية المعالجة حتى تتمكن من رؤية مكتبة Android المدمجة في لوحة المشروع على الجانب الأيسر من الصورة. اضغط على Ctrl + Alt + Shfit + S للوصول إلى هيكل المشروع. انقر فوق خيار التبعيات على اليسار وحدد خيار تحديد التطبيق. بعد ذلك ، انقر فوق الزر + داخل التبعيات المعلنة وألق نظرة عليها.

بعد ذلك ، انقر فوق خيار Module Dependency في النافذة العلوية. هذا سيفتح النافذة التالية. الآن حدد مكتبتك وانقر على زر موافق.

انتظر حتى يكمل Android Studio عمله. عند الانتهاء ، من الممكن إضافة ملفات المصدر وميزات أخرى إلى مجلدات المكتبة.

بناء خزان فارغ في الغابة

بمجرد تنفيذ الأوامر والوظائف الأخرى في المكتبة ، فإن الخطوة التالية هي الانتقال إلى موقع Gates وإنشاء مستودع لمكتبتك. اتبع الخطوات أدناه لبناء الخزان.

1. أولاً ، قم بإنشاء حساب على موقع GitHub وقم بتسجيل الدخول.

2. انقر فوق الزر الجديد في اللوحة اليمنى لإنشاء مستودع جديد. إذا لم يظهر الزر الجديد ، فانقر فوق رمز GitHub في الجزء العلوي للانتقال إلى الصفحة الرئيسية. في هذه الصفحة سترى زر جديد لإنشاء مستودع جديد.

3. أدخل تفاصيل نموذج الخزان.

إذا كان الخزان الذي تريد بناءه خاصًا ، فسيتعين عليك دفع ثمنه.

تحميل الكود في جيثب

بعد إنشاء المستودع ، يجب تحميل الكود في المستودع المدمج وفقًا للإرشادات الموضحة في GitHub.

في هذه المقالة ، نقوم ببناء مستودع جديد ونحتاج إلى اتباع إرشادات GitHub لإنجاز عملية التحميل بشكل صحيح. نقترح عليك إدخال الأوامر في لوحة المحطة الطرفية في Android Studio.

لاحظ أنه يجب عليك إدخال معلومات مصادقة البوابة عند تنفيذ الأوامر. الأمر المستخدم لربط الكود المحلي بمستودع فارغ كالتالي:

بوابة عن بعد إضافة أصل https://github.com/SG-K/FirstLibrary.git

إذا تم كل شيء بشكل صحيح ، فسيتم تحميل الكود على مستودع GitHub ، وإذا قمت بتحديث صفحة المستودع ، فسترى الملفات.

يمكنك الآن إجراء التغييرات التي تريدها. تُستخدم الأوامر التالية لتحديث المستودع في GitHub:

إضافة بوابة.
git الالتزام -m “message”
git pull
git push

إجراء إصدار في GitHub

بمجرد تحميل المكتبة بنجاح في المستودع ، فإن الخطوة التالية هي تحريرها. يتيح الإصدار للمطورين معرفة أن المكتبة قد تم اختبارها وأنها آمنة للاستخدام. يمكن استخدام الإصدار لإضافة ميزة جديدة إلى المشروع. يحتوي كل إصدار على رقم نسخة يسمح للمطورين بتحديث المكتبة في تطبيقاتهم. لإنشاء إصدار ، يجب النقر فوق علامة التبويب “الإصدار” في الصفحة الرئيسية للمستودع.

في الخطوة التالية ، أدخل تفاصيل الإصدار ، والتي تتضمن رقم الإصدار والوصف والمعلومات الأخرى ذات الصلة ، وانقر فوق مسودة إصدار جديد. بمجرد اكتمال هذه العملية ، من الممكن تحرير الإصدار.

افتح مستودع البوابة في JitPack

JitPack هو مستودع لمشاريع Android و JVM يتضمن aar و jar المتعلقين بالمكتبات. لربط مستودع GitHub بالمشاريع ، يجب عليك نسخ عنوان URL للمستودع.

ثم افتح JitPack وأدخل عنوان URL فيه وانقر على زر بحث للسماح لـ JitPack بالقيام بعمل توصيل المستودع.

أنشئ مكتبة JitPack

حتى الآن وضعنا مستودعنا في JitPack. يؤدي النقر فوق الزر بحث إلى عرض قائمة بإصدارات المستودعات ، مما يؤدي إلى إنشاء مكتبة JitPack بالنقر فوق الزر الحصول عليها بجوار كل إصدار.

بعد النقر فوق الزر Get It ، يقوم JitPack بمعالجة الطلب ويبدأ عملية إنشاء ارتباط تنفيذ Gradle. عند النقر فوق حسنًا ، يعالج JitPack المستودع ، وعند اكتمال العملية ، يعرض ملفًا أخضر كما هو موضح أدناه ، وملف أحمر في حالة حدوث خطأ. إذا فشلت عملية البناء ، فلا يمكن استيراد المكتبة إلى مشروعات المستخدمين.

قم باستيراد مكتبة JitPack إلى مشروع

لاستيراد المكتبة ، كل ما عليك فعله هو إضافة دعم JitPack على مستوى المشروع إلى ملف Gradle. يتم ذلك من خلال الكود التالي:

allprojects {
repositories {
… maven {
url ‘ https://jitpack.io ‘}
}
}

بعد ذلك ، تحتاج إلى إدخال الكود التالي في ملف build.gradle:

التبعيات {
application ‘com.github.SG-K: New-Sample-Library: 0.0.1’
}

قم بتحديث مستودع GitHub ومكتبة JitPack

بمجرد إصدار الإصدار ، سوف يحتاج إلى التحديث في المستقبل. عندما تريد تنفيذ تحديث ، فأنت بحاجة إلى إنشاء إصدار واستخدام التحديث الذي تم إنشاؤه في JitPack لإنشاء المكتبة. في هذه الحالة ، عندما يقوم المطورون بتعيين رقم الإصدار لآخر تحديث ، يتم إدخال وظيفة المكتبة الجديدة في مشروعهم تلقائيًا.

من الآن فصاعدًا ، يمكنك إنشاء مكتبات تطبيقات بأمان ومشاركتها مع المستخدمين حول العالم.

شاهد أيضًا خمسة مبادئ مهمة في إدارة ذاكرة هواتف Android

 

Leave a Reply