الاعتماد المتبادل بين الأدوات والمكتبات

تبعيات التصميم هي مكوّنات خارجية مطلوبة لإنشاء مشروعك بنجاح. يمكن أن يعتمد التصميم على المكتبات والمكوّنات الإضافية والمشاريع الفرعية و حزمة تطوير البرامج (SDK) لنظام Android والأدوات، مثل مجمعي Kotlin وJava وبيئة التطوير، مثل استوديو Android و Gradle نفسه.

يمكن أن تتطلّب كل تبعية تبعيات أخرى. ونُطلق على هذه التبعيات اسم التبعيات الانتقالية، ويمكن أن تزيد بسرعة من إجمالي التبعيات المستخدَمة في تطبيقك. عندما تريد ترقية أحد العناصر المُستخدَمة، سواء كانت مكتبة أو أداة أو حزمة تطوير برامج (SDK) لنظام التشغيل Android، يمكن أن تؤدي هذه الترقية إلى ترقية العديد من العناصر المُستخدَمة الأخرى.

لن يتسبب ذلك في أي مشكلة في أغلب الأحيان، لأنّ العديد من المكتبات تتّبع مخطّطًا يُعرف باسم Semantic Versioning. تحدّ هذه المكتبات من أنواع التغييرات التي تجريها لتوفير التوافق مع الإصدارات الأقدم.

يتّبع التنسيق الدلالي للإصدار تنسيق major.minor.patch. على سبيل المثال، في رقم الإصدار 4.8.3، يشير الرقم 4 إلى الإصدار major، ويشير الرقم 8 إلى الإصدار minor، ويشير الرقم 3 إلى الإصدار patch. عند تغيير الجزء major، قد تتضمن المكتبة تغييرات جذرية في واجهة برمجة التطبيقات أو السلوك. ويمكن أن يؤثر ذلك في سلوك الإصدار أو التطبيق.

عندما تتغيّر أجزاء minor (الميزات الجديدة) أو patch (إصلاحات الأخطاء)، يُعلمك مطوّرو المكتبة بأنّ المكتبة لا تزال متوافقة مع تطبيقك وأنّها لن تؤثر فيه.

العلاقات في إصدارك

تحتوي إصدارات Android على علاقات بين ما يلي:

• رمز المصدر: التعليمات البرمجية والموارد التي يمكنك التحكّم فيها
• مكتبات أو وحدات خارجية يتضمنها مشروعك ومشاريعك الفرعية عند الإنشاء
• الأدوات: برامج التحويل البرمجي والمكونات الإضافية وحِزم SDK التي تُحوّل المصدر إلى تطبيق أو مكتبة

رمز مصدر

الرمز المصدر هو رمز Kotlin أو Java الذي تكتبه في تطبيقك أو مكتبتك. (للاطّلاع على تفاصيل عن استخدام C++، يُرجى الاطّلاع على Android NDK).

يعتمد الرمز المصدر على المكتبات (بما في ذلك مكتبات وقت التشغيل لكل من Kotlin وJava) وحزمة تطوير البرامج (SDK) لنظام التشغيل Android، ويتطلّب استخدام مُجمِّع Kotlin أو Java المقابل.

يتضمّن بعض الرموز البرمجية المصدرية تعليقات توضيحية تتطلّب معالجة إضافية. على سبيل المثال، إذا كنت تكتب رمز Jetpack Compose، يمكنك إضافة تعليقات توضيحية مثل @Composable التي يجب معالجتها بواسطة مكوّن Compose Kotlin compiler المكوّن. يمكن معالجة التعليقات التوضيحية الأخرى باستخدام معالج رمز Kotlin (KSP) أو أدوات معالجة التعليقات التوضيحية منفصلة.

العناصر التابعة للمكتبة

تحتوي المكتبات على رمز برمجي ثنائي يتم استرجاعه كجزء من تطبيقك. يمكن أن يكون ذلك ملف JAR لبرنامج Java أو مكتبة Android (AAR) أو مشروعًا فرعيًا في حِزمك. تلتزم العديد من المكتبات بنظام الإصدارات الدلالية، ما يمكن أن يساعدك في معرفة متى تظل متوافقة (أو لا) عند الترقية.

قد تعتمد المكتبات على مكتبات أخرى لإعادة استخدامها، ما يُعرف باسم التبعية غير المباشرة. ويؤدي ذلك إلى تقليل الموارد الاعتمادية التي يجب إدارتها بشكل صريح، حيث يمكنك تحديد الموارد الاعتمادية التي تستخدمها مباشرةً، ويقوم Gradle بسحبها مع هذه الموارد الاعتمادية غير المباشرة. يُرجى العِلم أنّه أثناء ترقية التبعيات المباشرة، قد تؤدي هذه العملية إلى ترقية التبعيات المتعدّدة.

في بعض الأحيان، قد تتطلّب المكتبة الحد الأدنى من إصدارات حزمة تطوير البرامج (SDK) لنظام التشغيل Android في وقت التشغيل (minSdk) أو وقت الترجمة (compileSdk). ويُعدّ ذلك ضروريًا عندما تستخدم مكتبة وظائف مضمّنة في حزمة تطوير البرامج (SDK) لنظام التشغيل Android أو واجهات برمجة تطبيقات JDK المقدَّمة. minSdk الفعّال لتطبيقك هو أعلى minSdk يطلبها تطبيقك وجميع مكتباته المباشرة وغير المباشرة.

قد يتطلّب استخدام بعض المكتبات استخدام مكوّن إضافي محدّد من Gradle. غالبًا ما تُثبِّت هذه المكونات الإضافية المساعِدة معالجات رموز Kotlin أو معالجات التعليقات التوضيحية الأخرى التي تُنشئ رمزًا أو تعدِّل عملية تجميع المصدر لتسهيل استخدامك لميزات المكتبة. على سبيل المثال، يتضمّن Jetpack Room تعليقات توضيحية ومكتبة KSP تحوّلها إلى رمز تم إنشاؤه لاسترداد البيانات وتعديلها في قاعدة بيانات. يتطلّب Jetpack Compose استخدام المكوّن الإضافي لمجمّع Compose من أجل تعديل الدوال المُشارَك عليها تعليقات توضيحية لإدارة كيفية إعادة تشغيل هذه الدالة ووقت إعادة تشغيلها.

الأدوات

نطاقات Gradle

يجمع Gradle العناصر الاعتمادية للمكتبات في نطاقات مختلفة (يُطلق عليها اسم الإعدادات في Gradle API)، ما يتيح لك تحديد مجموعات مختلفة من العناصر الاعتمادية للمكتبات لاستخدامها في أجزاء مختلفة من الإنشاء. على سبيل المثال، قد لا تريد تضمين مكتبات اختبار مثل JUnit في تطبيقك أو مكتبتك المنشورة، ولكنك تريد تضمينها عند إنشاء اختبارات الوحدة وتنفيذها. يمكنك أيضًا استخدام النطاقات لإضافة معالجات للرمز أو التعليقات التوضيحية لتحليل الرمز البرمجي.

على سبيل المثال، تحدِّد AGP نطاقَي implementation وapi، وهما طريقتك في تحديد ما إذا كان يجب عرض أحد التبعيات لمستخدمي مشروعك الفرعي. اطّلِع على ضبط التبعيات للحصول على أوصاف لهذه النطاقات وغيرها من النطاقات المستخدَمة في إصدار Android.

أضِف تبعيات المكتبة في العنصر dependencies في ملفات الإنشاء، إما على شكل سلاسل group:artifact:version:

// In a module-level build script
// explicit dependency strings ("group:artifact:version")
dependencies {
    implementation("com.example:library1:1.2.3")
    api("com.example:library2:1.1.1")
}

// In a module-level build script
// explicit dependency strings ("group:artifact:version")
dependencies {
    implementation 'com.example:library1:1.2.3'
    api 'com.example:library2:1.1.1'
}

أو في قائمة الإصدارات:

# Version catalog - gradle/libs.versions.toml
[versions]
exampleLib = "1.2.3"
examplePlugin = "2.3.4"

[libraries]
example-library = { group = "com.example", name = "library", version.ref = "exampleLib" }

[plugins]
example-plugin = { id = "com.example.plugin", version.ref = "examplePlugin" }

وحدِّد المتغيّرات التي تم إنشاؤها في ملفات الإنشاء:

// In a module-level build script
// Using a version catalog
plugins {
    alias(libs.plugins.example.plugin)
}

dependencies {
    implementation(libs.example.library)
}

// In a module-level build script
// Using a version catalog
plugins {
    alias(libs.plugins.example.plugin)
}

dependencies {
    implementation libs.example.library
}