الأجهزة التابعة الأصلية باستخدام المكوّن الإضافي لنظام Gradle المتوافق مع Android

يمكن أن تحتوي مكتبات AAR على تبعيات أصلية يمكن أن يستخدمها "المكوّن الإضافي لنظام Gradle المتوافق مع Android". بإمكان AGP أيضًا إنشاء ملفات AAR التي تعرض المكتبات المجمّعة من رموز برمجية أصلية للمستهلكين.

استخدام التبعيات الأصلية

اعتبارًا من الإصدار 4.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android، يمكن استيراد تبعيات C/C++‎ من ملفات AAR المرتبطة في ملف build.gradle. ستجعل أداة Gradle هذه المكتبات متاحة تلقائيًا لنظام الإصدار الأصلي، ولكن يجب ضبط نظام الإصدار للاستفادة من المكتبات والعناوين التي تم استيرادها. بما أنّ تبعيات C/C++‎ يتم توزيعها كملفات AAR، قد تكون الروابط التالية حول ملفات AAR العامة مفيدة:

  • إنشاء مكتبة Android للحصول على مستندات AAR العامة وكيفية دمجها في مشروعك، خاصةً عندما تريد استخدام ملفات AAR كاعتمادية محلية للغة C/C++‎
  • إضافة اعتماديات الإصدار للحصول على معلومات حول إضافة الاعتماديات إلى ملف build.gradle، خاصةً الاعتماديات البعيدة

يركّز هذا المستند على كيفية ضبط نظام الإصدار الأصلي ويفترض أنّك أضفت تبعية C/C++‎ من نوع AAR إلى بيئة إصدار Gradle في مشروعك.

التبعيات الأصلية في ملفات AAR

يمكن أن تعرض تبعيات AAR لوحدات Gradle مكتبات مجمّعة من رموز برمجية أصلية ليستخدمها تطبيقك. داخل ملف AAR، يحتوي الدليل prefab على حزمة Prefab، والتي تتضمّن العناوين والمكتبات الخاصة بالتبعية الأصلية.

يمكن أن تعرض كل تبعية حزمة Prefab واحدة كحد أقصى، وتتألف من وحدة واحدة أو أكثر. وحدة Prefab هي مكتبة واحدة، ويمكن أن تكون مكتبة مشتركة أو ثابتة أو مكتبة عناوين فقط.

يجب معرفة أسماء الحزم والوحدات للاستفادة من المكتبات. وفقًا للاصطلاح، سيتطابق اسم الحزمة مع اسم عنصر Maven وسيتطابق اسم الوحدة مع اسم مكتبة C/C++‎، ولكن هذا ليس مطلوبًا. يمكنك الرجوع إلى مستندات التبعية لتحديد الأسماء التي تستخدمها.

إعدادات نظام الإنشاء

يجب تفعيل ميزة prefab في وحدة Gradle المتوافقة مع Android.

لإجراء ذلك، أضِف ما يلي إلى ملف gradle.properties الخاص بمشروعك:

android.enablePrefab=true

يمكنك اختياريًا ضبط إصدار في ملف gradle.properties الخاص بمشروعك:

android.prefabVersion=2.0.0

عادةً ما يكون الإصدار التلقائي المحدّد من AGP مناسبًا لاحتياجاتك. يجب أن تحتاج فقط إلى تحديد إصدار مختلف إذا كان هناك خطأ تحتاج إلى حله أو ميزة جديدة تريدها.

يتم عرض التبعيات التي تم استيرادها من ملف AAR إلى CMake من خلال CMAKE_FIND_ROOT_PATH. سيتم ضبط هذه القيمة تلقائيًا من خلال Gradle عند استدعاء CMake، لذا إذا كان الإصدار يعدّل هذا المتغيّر، تأكَّد من إلحاقه بدلاً من تخصيصه.

توفّر كل تبعية حزمة ملف إعداد لعملية الإنشاء. ويتم استيرادها باستخدام الأمر find_package. يبحث هذا الأمر عن حزم ملفات الإعداد التي تطابق اسم الحزمة المحدّد وإصدارها، ويعرض الأهداف التي تحدّدها لاستخدامها في عملية الإنشاء. على سبيل المثال، إذا كان تطبيقك يحدّد libapp.so ويستخدم curl، يجب أن يتضمّن CMakeLists.txt ما يلي:

add_library(app SHARED app.cpp)

# Add these two lines.
find_package(curl REQUIRED CONFIG)
target_link_libraries(app curl::curl)

أصبح بإمكان "app.cpp" الآن #include "curl/curl.h"، وسيتم ربط "libapp.so" تلقائيًا بـ "libcurl.so" عند الإنشاء، وسيتم تضمين "libcurl.so" في التطبيق.

نشر المكتبات المجمّعة من رموز برمجية أصلية في ملفات AAR

تمت إضافة إمكانية إنشاء ملفات AAR الأصلية لأول مرة في الإصدار 4.1 من "مكوّن Android الإضافي في Gradle".

لتصدير المكتبات المجمّعة من رموز برمجية أصلية، أضِف ما يلي إلى قسم android في ملف build.gradle.kts الخاص بمشروع المكتبة:

Kotlin

buildFeatures {
    prefabPublishing = true
}

prefab {
    create("mylibrary") {
      headers = "src/main/cpp/mylibrary/include"
    }

    create("myotherlibrary") {
        headers = "src/main/cpp/myotherlibrary/include"
    }
}

أنيق

buildFeatures {
    prefabPublishing true
}

prefab {
    mylibrary {
      headers "src/main/cpp/mylibrary/include"
    }

    myotherlibrary {
        headers "src/main/cpp/myotherlibrary/include"
    }
}

في هذا المثال، سيتم تجميع مكتبتَي mylibrary وmyotherlibrary من إصدار ndk-build أو إصدار CMake الأصلي الخارجي في ملف AAR الذي تم إنشاؤه من خلال الإصدار الخاص بك، وسيتم تصدير العناوين من الدليل المحدّد إلى العناصر التابعة لهما.