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

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

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

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

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

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

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

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

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

رمز مصدر

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

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

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

الاعتماديات الخاصة بالمكتبات

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

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

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

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

الأدوات

Gradle

‫Gradle هي أداة إنشاء تقرأ ملفات الإنشاء وتنشئ تطبيقك أو مكتبتك، كما تتيح واجهة برمجة تطبيقات للمكوّنات الإضافية لتوسيع إمكاناتها. يُشغّل Gradle عمليات متعددة على جهاز Java افتراضي واحد أو أكثر، وتستدعي مكوّنات Java الإضافية أدوات Java داخل حزمة تطوير البرامج في Java.

المكوّنات الإضافية لـ Gradle

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

محولات برمجية

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

المكوّنات الإضافية لبرنامج التجميع

تُجري المكوّنات الإضافية لبرنامج التجميع عمليات التحليل وإنشاء الرموز البرمجية داخل برنامج تجميع Kotlin أثناء تحليل برنامج تجميع Kotlin للرمز البرمجي، ويتم تثبيتها عند تطبيق المكوّنات الإضافية لـ Gradle على الإصدار.

Android SDK

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

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

JDK

حزمة تطوير Java التي تحتوي على مكتبات Java وملفات قابلة للتنفيذ لتجميع مصدر Java وتشغيل تطبيقات Java. هناك العديد من حِزم JDK التي يتم استخدامها في إصدار Android. لمزيد من التفاصيل، يُرجى الاطّلاع على إصدارات Java في إصدارات Android.

نطاقات Gradle

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

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

أضِف تبعيات المكتبة في قسم dependencies في ملفات الإصدار، إما كسلاسل group:artifact:version:

Kotlin

// 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" }

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

Kotlin

// 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
}