يمكنك إضافة رمز C و++C إلى مشروع Android من خلال وضع الرمز في دليل
cpp في وحدة المشروع. عند إنشاء مشروعك، يتم تجميع هذا الرمز في مكتبة مجمّعة من رموز برمجية أصلية يمكن لـ Gradle تجميعها مع تطبيقك. يمكن بعد ذلك لرمز Java أو Kotlin استدعاء الدوال في المكتبة المجمّعة من رموز برمجية أصلية من خلال واجهة Java Native Interface (JNI). لمزيد من المعلومات حول استخدام إطار عمل JNI، يُرجى الاطّلاع على نصائح JNI لنظام التشغيل Android.
يتوافق "استوديو Android" مع CMake، وهو مفيد للمشاريع التي تعمل على عدّة منصات.
يتوافق "استوديو Android" أيضًا مع ndk-build، والذي يمكن أن يكون أسرع من CMake، ولكنه يتوافق مع Android فقط. لا يمكن حاليًا استخدام كل من CMake وndk-build في الوحدة نفسها.
لاستيراد مكتبة ndk-build حالية إلى مشروعك في "استوديو Android"، تعرَّف على كيفية ربط Gradle بمشروع المكتبة المجمّعة من رموز برمجية أصلية.
توضّح لك هذه الصفحة كيفية إعداد "استوديو Android" باستخدام أدوات الإنشاء اللازمة، وإنشاء مشروع جديد يتوافق مع C/C++، وإضافة ملفات C/C++ جديدة إلى مشروعك.
إذا أردت بدلاً من ذلك إضافة رموز برمجية أصلية إلى مشروع حالي، فاتّبِع الخطوات التالية:
-
أنشئ ملفات رموز مصدر أصلية جديدة وأضِف الملفات إلى مشروعك في "استوديو Android".
- يمكنك تخطّي هذه الخطوة إذا كان لديك رمز برمجي أصلي أو إذا أردت استيراد مكتبة مجمّعة من رموز برمجية أصلية تم إنشاؤها مسبقًا.
-
اضبط إعدادات CMake
لإنشاء رمز المصدر الأصلي في مكتبة. هذا النص البرمجي مطلوب
إذا كنت تستورد وتربط مكتبات مُعدّة مسبقًا أو مكتبات
منصة.
- إذا كانت لديك مكتبة مجمّعة من رموز برمجية أصلية حالية تحتوي على نص برمجي لعملية الإنشاء
CMakeLists.txtأو تستخدمndk-buildوتتضمّن نصًا برمجيًا لعملية الإنشاءAndroid.mk، يمكنك تخطّي هذه الخطوة.
- إذا كانت لديك مكتبة مجمّعة من رموز برمجية أصلية حالية تحتوي على نص برمجي لعملية الإنشاء
-
اضبط
Gradle من خلال توفير مسار إلى ملف نصي CMake أو
ndk-build. يستخدم Gradle نص التصميم البرمجي لاستيراد الرمز المصدري إلى مشروعك على "استوديو Android" وتجميع المكتبة المجمّعة من رموز برمجية أصلية في التطبيق.
بعد ضبط مشروعك، يمكنك الوصول إلى الدوال الأصلية من رمز Java أو Kotlin باستخدام إطار عمل JNI. لإنشاء تطبيقك وتشغيله،
انقر على تشغيل
.
ملاحظة: إذا كان مشروعك الحالي يستخدم أداة ndkCompile التي تم إيقافها نهائيًا، عليك الانتقال إلى استخدام CMake أو ndk-build.
تنزيل NDK وأدوات الإنشاء
لتجميع الرموز البرمجية الأصلية لتطبيقك وتصحيح أخطائها، تحتاج إلى المكوّنات التالية:
- حزمة Android Native Development Kit (NDK): هي مجموعة أدوات تتيح لك استخدام رمز C وC++ مع Android. توفّر مجموعة NDK مكتبات للنظام الأساسي تتيح لك إدارة الأنشطة الناتجة من رموز برمجية أصلية والوصول إلى مكوّنات الأجهزة الفعلية، مثل أدوات الاستشعار والإدخال باللمس.
-
CMake: أداة إنشاء خارجية تعمل مع Gradle لإنشاء مكتبة مجمّعة من رموز برمجية أصلية. لن تحتاج إلى هذا المكوّن إذا كنت تخطّط لاستخدام
ndk-buildفقط. - LLDB: هو برنامج تصحيح الأخطاء في "استوديو Android" الذي يصحّح أخطاء الرموز البرمجية الأصلية.
للحصول على معلومات حول تثبيت هذه المكوّنات، يُرجى الاطّلاع على تثبيت NDK وCMake وضبطهما.
إنشاء مشروع جديد يتوافق مع C/C++
لإنشاء مشروع جديد يتوافق مع الرموز البرمجية الأصلية، تتشابه العملية مع إنشاء أي مشروع آخر في "استوديو Android"، ولكن مع خطوة إضافية:
- في قسم اختيار مشروعك (Choose your project) من المعالج، اختَر نوع المشروع Native C++.
- انقر على التالي.
- أكمِل جميع الحقول الأخرى في القسم التالي من المعالج.
- انقر على التالي.
-
في قسم تخصيص دعم C++ في المعالج، يمكنك تخصيص
مشروعك باستخدام حقل معيار C++.
- استخدِم القائمة المنسدلة لاختيار معيار C++ الذي تريد استخدامه. يؤدي اختيار Toolchain Default إلى استخدام إعداد CMake التلقائي.
- انقر على إنهاء.
بعد أن ينتهي "استوديو Android" من إنشاء مشروعك الجديد، افتح لوحة المشروع من الجانب الأيمن لبيئة التطوير المتكاملة (IDE) واختَر عرض Android من القائمة. كما هو موضّح في الشكل 1، يضيف "استوديو Android" مجموعة cpp:
الشكل 1: مجموعات طرق العرض في Android لمصادرك الأصلية ونصوص الإنشاء البرمجية الخارجية
ملاحظة: لا تعكس طريقة العرض هذه التسلسل الهرمي الفعلي للملفات على القرص، ولكنها تجمع الملفات المتشابهة لتبسيط التنقّل في مشروعك.
تضم مجموعة cpp جميع ملفات المصدر الأصلية والعناوين والنصوص البرمجية لإنشاء CMake أو ndk-build والمكتبات المُنشأة مسبقًا والتي تشكّل جزءًا من مشروعك. بالنسبة إلى المشاريع الجديدة، ينشئ "استوديو Android" نموذجًا لملف مصدر C++، وهو native-lib.cpp، ويضعه في دليل src/main/cpp/ الخاص بوحدة تطبيقك. يوفّر هذا الرمز النموذجي دالة بسيطة بلغة C++، وهي stringFromJNI()، التي تعرض السلسلة "Hello from C++". تعرَّف على كيفية إضافة ملفات مصدر إضافية إلى مشروعك في القسم الذي يتناول كيفية إنشاء ملفات مصدر أصلية جديدة.
على غرار الطريقة التي توجّه بها ملفات build.gradle نظام Gradle حول كيفية إنشاء تطبيقك، يتطلّب كل من CMake وndk-build نصًا برمجيًا للإصدار لمعرفة كيفية إنشاء مكتبتك المجمّعة من رموز برمجية أصلية. بالنسبة إلى المشاريع الجديدة، ينشئ "استوديو Android" نصًا برمجيًا لإنشاء CMake، وهو CMakeLists.txt، ويضعه في الدليل الجذري للوحدة.
لمزيد من المعلومات حول محتوى نص الإنشاء البرمجي هذا، يُرجى الاطّلاع على ضبط CMake.
إنشاء نموذج التطبيق وتشغيله
عند النقر على تشغيل
، ينشئ استوديو Android تطبيقًا يعرض النص "Hello من C++" على جهاز Android أو المحاكي ويشغّله. توضّح النظرة العامة التالية الأحداث التي
تحدث لإنشاء نموذج التطبيق وتشغيله:
- يستدعي Gradle نص الإصدار الخارجي،
CMakeLists.txt. - يتّبع CMake الأوامر في نص الإنشاء البرمجي لتجميع ملف مصدر C++،
native-lib.cpp، في مكتبة عناصر مشتركة ويسمّيهاlibnative-lib.so. بعد ذلك، يحزم Gradle هذا الملف في التطبيق. - أثناء وقت التشغيل، يحمّل
MainActivityفي التطبيق المكتبة المجمّعة من رموز برمجية أصلية باستخدامSystem.loadLibrary(). أصبحت الدالة الأصلية للمكتبة،stringFromJNI()، متاحة الآن للتطبيق. -
يستدعي
MainActivity.onCreate()الدالةstringFromJNI()، التي تعرض"Hello from C++"وتستخدمها لتعديلTextView.
للتحقّق من أنّ Gradle يحزم المكتبة المجمّعة من رموز برمجية أصلية في التطبيق، استخدِم أداة تحليل ملفات APK:
- اختَر Build (إنشاء) > Build Bundles(s) / APK(s) (إنشاء حِزم/ملفات APK) > Build APK(s) (إنشاء ملفات APK).
- اختَر إنشاء > تحليل حزمة APK.
- اختَر ملف APK أو حزمة AAB من دليل
app/build/outputs/وانقر على حسنًا. - كما هو موضّح في الشكل 2، يمكنك الاطّلاع على
libnative-lib.soفي نافذة "أداة تحليل ملفات APK" ضمنlib/<ABI>/.
الشكل 2: حدِّد موقع مكتبة مجمّعة من رموز برمجية أصلية باستخدام "أداة تحليل ملفات APK".
ملاحظة: إذا أردت تجربة تطبيقات Android الأخرى التي تستخدم رموزًا برمجية أصلية، انقر على ملف (File) > جديد (New) > استيراد نموذج (Import Sample) واختَر نموذج مشروع من قائمة Ndk.
إنشاء ملفات مصدر C/C++ جديدة
لإضافة ملفات مصدر C/C++ جديدة إلى مشروع حالي، اتّبِع الخطوات التالية:
- إذا لم يكن لديك دليل
cpp/في مجموعة رموز المصدر الرئيسية لتطبيقك، يمكنك إنشاء دليل على النحو التالي: - افتح لوحة المشروع في الجانب الأيمن من بيئة التطوير المتكاملة واختَر عرض المشروع من القائمة.
- انتقِل إلى your-module > src.
- انقر بزر الماوس الأيمن على الدليل main واختَر New > Directory.
- أدخِل
cppكاسم الدليل وانقر على حسنًا. - انقر بزر الماوس الأيمن على الدليل
cpp/واختَر جديد > ملف مصدر C/C++. - أدخِل اسمًا لملف المصدر، مثل
native-lib. - من قائمة النوع، اختَر امتداد الملف لملف المصدر، مثل
.cpp.- انقر على تعديل أنواع الملفات
لإضافة أنواع ملفات أخرى إلى القائمة، مثل
.cxxأو.hxx. في مربّع الحوار امتدادات الملفات الجديدة الذي يظهر، اختَر امتداد ملف آخر من القائمتَين امتداد المصدر وامتداد العنوان وانقر على حسنًا.
- انقر على تعديل أنواع الملفات
- لإنشاء ملف عنوان، ضَع علامة في المربّع إنشاء عنوان مرتبط.
- انقر على موافق.
بعد إضافة ملفات C/C++ جديدة إلى مشروعك، عليك ضبط CMake لتضمين الملفات في مكتبتك المجمّعة من رموز برمجية أصلية.