لتجميع وتصحيح أخطاء الرموز الأصلية لتطبيقك، ستحتاج إلى المكوّنات التالية:
- مجموعة أدوات تطوير البرامج (NDK) الأصلية لنظام التشغيل Android: مجموعة من الأدوات التي تتيح لك استخدام رمزي C وC++ مع Android.
- CMake: أداة تصميم خارجية تعمل جنبًا إلى جنب مع Gradle لإنشاء واجهات برمجة تطبيقات المكتبة. ولا تحتاج إلى هذا المكون إذا كنت تخطط لاستخدام ndk-build فقط.
- LLDB: برنامج تصحيح الأخطاء الذي يستخدمه "استوديو Android" لتصحيح أخطاء الرمز البرمجي الأصلي. يتم استخدام LLDB بشكل تلقائي سيتم تثبيته جنبًا إلى جنب مع "استوديو Android".
توضح هذه الصفحة كيفية تثبيت هذه المكونات تلقائيًا أو باستخدام
لتنزيل التطبيقات وتثبيتها يدويًا من خلال "استوديو Android" أو أداة sdkmanager
.
تثبيت NDK وCMake تلقائيًا
الإصدار 4.2.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android أو الإصدارات الأحدث يمكن أن يثبت تلقائيًا كلاً من NDK وCMake المطلوبين في المرة الأولى التي تنشئ فيها مشروعك إذا تم قبول تراخيصهم مسبقًا. إذا سبق أن قرأت أحكام الترخيص ووافقت عليها، يمكنك قبولها مسبقًا. التراخيص في النصوص البرمجية باستخدام الأمر التالي:
yes | ${sdk}/cmdline-tools/latest/bin/sdkmanager --licenses
تثبيت NDK وCMake
عند تثبيت NDK، يختار "استوديو Android" أحدث NDK متاح. بالنسبة
لمعظم المشروعات، يكفي تثبيت هذا الإصدار الافتراضي من NDK.
وإذا كان مشروعك يحتاج إلى نسخة واحدة أو أكثر من NDK، فيمكنك
تنزيل إصدارات معيّنة وضبطها يساعد ذلك في تحسين طريقة أداء موقعك الإلكتروني.
فإنك تضمن عمليات إنشاء قابلة للتكرار عبر المشروعات التي يعتمد كل منها على
نسخة من NDK. ويثبِّت "استوديو Android" جميع إصدارات NDK في
دليل android-sdk/ndk/
.
لتثبيت CMake ومعرّف NDK التلقائي في "استوديو Android"، يمكنك إجراء ما يلي:
بعد فتح مشروع، انقر على الأدوات >. مدير حِزم SDK:
انقر على علامة التبويب أدوات حزمة تطوير البرامج (SDK).
ضع علامة في مربّعَي الاختيار NDK (جنبًا إلى جنب) وCMake.
الشكل 1. نافذة أدوات حزمة تطوير البرامج (SDK) تعرض NDK (جنبًا إلى جنب) الخيار
انقر على موافق.
يخبرك مربع حوار مقدار المساحة التي تستهلكها حزمة NDK على القرص.
انقر على موافق.
عند اكتمال التثبيت، انقر على إنهاء.
يعمل مشروعك على مزامنة ملف الإصدار تلقائيًا وتنفيذ عملية الإنشاء. وحلّ أي أخطاء تحدث.
ضبط إصدار محدّد من CMake
يحتوي "مدير SDK" على الإصدار 3.6.0 متشعّب من
CMake والإصدار 3.10.2. تُعد المشروعات التي لا تحدد
صممت نسخة CMake محددة باستخدام CMake 3.10.2. إلى
اضبط إصدار CMake، وأضف ما يلي إلى ملف build.gradle
في وحدتك:
Groovy
android { ... externalNativeBuild { cmake { ... version "cmake-version" } } }
Kotlin
android { ... externalNativeBuild { cmake { ... version = "cmake-version" } } }
إذا كنت ترغب في استخدام إصدار CMake غير مضمن في يُرجى اتّباع الخطوات التالية في مدير حِزم SDK:
- نزِّل تطبيق CMake وثبِّته. من موقع CMake الرسمي.
- حدد إصدار CMake الذي تريد أن تستخدمه Gradle في الوحدة
ملف
build.gradle
. أضِف المسار إلى CMake install إلى بيئة
PATH
. أو تضمينها في ملفlocal.properties
الخاص بمشروعك، كما هو موضح. إذا لم يتمكن Gradle من العثور على إصدار CMake الذي حددته في في ملفbuild.gradle
، ستحصل على خطأ في الإصدار.# If you set this property, Gradle no longer uses PATH to find CMake. cmake.dir = "path-to-cmake"</pre>
إذا لم يكن نظام إصدار Ninja مثبتًا على جهازك انتقل إلى موقع النينجا الرسمي، وقم بتنزيل أحدث إصدار من تطبيق Ninja وتثبيته لنظام التشغيل الذي تستخدمه. تأكد أيضًا من إضافة المسار إلى تثبيت Ninja إلى متغيّر بيئة واحد (
PATH
)
تثبيت إصدار معيّن من NDK
لتثبيت إصدار معيّن من NDK، يجب إجراء ما يلي:
بعد فتح مشروع، انقر على الأدوات >. مدير حِزم SDK:
انقر على علامة التبويب أدوات حزمة تطوير البرامج (SDK).
ضَع علامة في مربّع الاختيار إظهار تفاصيل الحزمة.
ضع علامة في مربّع الاختيار NDK (جنبًا إلى جنب) ومربّعات الاختيار أسفله التي مع إصدارات NDK التي تريد تثبيتها. عمليات تثبيت "استوديو Android" كل إصدارات NDK في
android-sdk/ndk/
الدليل.الشكل 2. نافذة أدوات حزمة تطوير البرامج (SDK) تعرض NDK (جنبًا إلى جنب) الخيارات
انقر على موافق.
يخبرك مربع حوار مقدار المساحة التي تستهلكها حزمة(حزم) NDK.
انقر على موافق.
عند اكتمال التثبيت، انقر على إنهاء.
يعمل مشروعك على مزامنة ملف الإصدار تلقائيًا وتنفيذ عملية الإنشاء. وحلّ أي أخطاء تحدث.
تهيئة كل وحدة باستخدام إصدار NDK الذي تريد استخدامه. عند استخدام الإصدار 3.6 من "استوديو Android" أو إصدار أحدث، ما لم سيختار المكوّن الإضافي لنظام Gradle المتوافق مع Android الإصدار المعروفة أنها متوافقة معها.
تهيئة إصدارات معينة من NDK في مشروعك
وقد تحتاج إلى تهيئة إصدار NDK في مشروعك إذا كانت إحدى ينطبق ما يلي:
- مشروعك موروث وتحتاج إلى استخدام إصدارات معينة من NDK والمكون الإضافي لنظام Gradle المتوافق مع Android (AGP). لمزيد من المعلومات، يُرجى مراجعة ضبط NDK للمكوّن الإضافي لنظام Gradle المتوافق مع Android
لديك إصدارات متعددة من NDK مثبتة وترغب في استخدام إصدار واحد. في هذه الحالة، حدِّد الإصدار باستخدام السمة
android.ndkVersion
. في ملفbuild.gradle
بالوحدة كما هو موضح في الكود التالي كعينة.Groovy
android { ndkVersion "major.minor.build" // e.g., ndkVersion "21.3.6528147" }
Kotlin
android { ndkVersion = "major.minor.build" // e.g., ndkVersion "21.3.6528147" }
نسخة NDK التلقائية لكل إصدار AGP
قبل طرح الإصدار، يتم اختبار كل إصدار من إصدارات AGP بشكل كامل باستخدام أحدث إصدار ثابت من NDK.
الإصدار في ذلك الوقت. تُستخدم نسخة NDK هذه لإنشاء مشروعاتك إذا
نسخة NDK في ملف build.gradle
. إصدار NDK التلقائي
لإصدارات مختلفة من AGP يتم توثيقها في
ملاحظات إصدار AGP
ملاحظات الإصدار السابقة في AGP