تثبيت وإعدادي NDK وCMake

لتجميع وتصحيح أخطاء الرموز الأصلية لتطبيقك، ستحتاج إلى المكوّنات التالية:

  • مجموعة أدوات تطوير البرامج (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"، يمكنك إجراء ما يلي:

  1. بعد فتح مشروع، انقر على الأدوات >. مدير حِزم SDK:

  2. انقر على علامة التبويب أدوات حزمة تطوير البرامج (SDK).

  3. ضع علامة في مربّعَي الاختيار NDK (جنبًا إلى جنب) وCMake.

    صورة "أداة إدارة حِزم تطوير البرامج (SDK)" الشكل 1. نافذة أدوات حزمة تطوير البرامج (SDK) تعرض NDK (جنبًا إلى جنب) الخيار

  4. انقر على موافق.

    يخبرك مربع حوار مقدار المساحة التي تستهلكها حزمة NDK على القرص.

  5. انقر على موافق.

  6. عند اكتمال التثبيت، انقر على إنهاء.

  7. يعمل مشروعك على مزامنة ملف الإصدار تلقائيًا وتنفيذ عملية الإنشاء. وحلّ أي أخطاء تحدث.

ضبط إصدار محدّد من 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:

  1. نزِّل تطبيق CMake وثبِّته. من موقع CMake الرسمي.
  2. حدد إصدار CMake الذي تريد أن تستخدمه Gradle في الوحدات ملف build.gradle.
  3. أضِف المسار إلى 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>
    
  4. إذا لم يكن نظام إصدار Ninja مثبتًا على جهازك انتقل إلى موقع النينجا الرسمي، وقم بتنزيل أحدث إصدار من تطبيق Ninja وتثبيته لنظام التشغيل الذي تستخدمه. تأكد أيضًا من إضافة المسار إلى تثبيت Ninja إلى متغيّر بيئة واحد (PATH)

تثبيت إصدار معيّن من NDK

لتثبيت إصدار معيّن من NDK، يجب إجراء ما يلي:

  1. بعد فتح مشروع، انقر على الأدوات >. مدير حِزم SDK:

  2. انقر على علامة التبويب أدوات حزمة تطوير البرامج (SDK).

  3. ضَع علامة في مربّع الاختيار إظهار تفاصيل الحزمة.

  4. ضع علامة في مربّع الاختيار NDK (جنبًا إلى جنب) ومربّعات الاختيار أسفله التي مع إصدارات NDK التي تريد تثبيتها. عمليات تثبيت "استوديو Android" كل نُسخ NDK في android-sdk/ndk/ الدليل.

    صورة نافذة &quot;أدوات حزمة تطوير البرامج (SDK)&quot; الشكل 2. نافذة أدوات حزمة تطوير البرامج (SDK) تعرض NDK (جنبًا إلى جنب) الخيارات

  5. انقر على موافق.

    يخبرك مربع حوار مقدار المساحة التي تستهلكها حزمة(حزم) NDK.

  6. انقر على موافق.

  7. عند اكتمال التثبيت، انقر على إنهاء.

  8. يعمل مشروعك على مزامنة ملف الإصدار تلقائيًا وتنفيذ عملية الإنشاء. وحلّ أي أخطاء تحدث.

  9. تهيئة كل وحدة باستخدام إصدار 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