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

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

  • حزمة تطوير البرامج الأصلية لنظام التشغيل Android (NDK): هي مجموعة من الأدوات التي تتيح لك استخدام رمز C وC++ مع Android.
  • CMake: أداة إنشاء خارجية تعمل إلى جانب Gradle لإنشاء مكتبتك الأصلية. لست بحاجة إلى هذا المكوّن إذا كنت تنوي استخدام ndk-build فقط.
  • LLDB: أداة تصحيح الأخطاء التي يستخدمها "استوديو Android" لتصحيح أخطاء الرموز البرمجية الأصلية سيتم تثبيت LLDB تلقائيًا مع Android Studio.

توضّح هذه الصفحة كيفية تثبيت هذه المكوّنات تلقائيًا أو باستخدام IDE Android Studio أو أداة sdkmanager لتنزيلها وتثبيتها يدويًا.

تثبيت NDK وCMake تلقائيًا

يمكن أن يُثبِّت الإصدار 4.2.0 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android" أو الإصدارات الأحدث حِزم NDK وCMake المطلوبة تلقائيًا عند إنشاء مشروعك لأول مرة إذا تم قبول تراخيصها مسبقًا. إذا سبق لك قراءة بنود الترخيص والموافقة عليها، يمكنك قبول الترخيصات في النصوص البرمجية مسبقًا باستخدام الأمر التالي:

   yes | ${sdk}/cmdline-tools/latest/bin/sdkmanager --licenses

تثبيت حِزم NDK وCMake

عند تثبيت حزمة NDK، يختار Android Studio أحدث إصدار متاح من حزمة NDK. بالنسبة لمعظم المشروعات، يكفي تثبيت هذا الإصدار الافتراضي من NDK. إذا كان مشروعك بحاجة إلى إصدار واحد أو أكثر من الإصدارات المحدّدة من حزمة NDK، يمكنك تنزيل إصدارات محدّدة وضبطها. يساعدك ذلك في ضمان إنشاءات قابلة للتكرار في جميع المشاريع التي تعتمد كلٌّ منها على إصدار محدّد من حزمة NDK. يتم تثبيت جميع إصدارات NDK في دليل android-sdk/ndk/ من "استوديو Android".

لتثبيت CMake ومجموعة تطوير البرامج (NDK) التلقائية في Android Studio، اتّبِع الخطوات التالية:

  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 الخاص بالوحدة:

رائع

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 إلى متغيّر 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/.

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

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

    يعرض لك مربّع حوار مقدار المساحة التي تستهلكها حِزم NDK.

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

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

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

  9. ضبط كل وحدة باستخدام إصدار NDK الذي تريد استخدامه عند استخدام الإصدار 3.6 من Android Studio أو إصدار أحدث، إذا لم يتم تحديد الإصدار، سيختار المكوّن الإضافي لـ Android Gradle إصدارًا معروفًا بأنّه متوافق.

ضبط إصدارات محدّدة من حزمة NDK في مشروعك

قد تحتاج إلى ضبط إصدار NDK في مشروعك في حال كان أي مما يلي صحيحًا:

  • تم اكتساب مشروعك ويجب استخدام إصدارات معيّنة من NDK ومكوّن إضافي لـ Android Gradle (AGP). لمزيد من المعلومات، يُرجى الاطّلاع على مقالة ضبط حِزم NDK للمكوّن الإضافي لنظام Gradle المتوافق مع Android.

  • إذا كان لديك إصدارات متعددة من NDK مثبّتة وتريد استخدام إصدار معيّن في هذه الحالة، حدِّد الإصدار باستخدام السمة android.ndkVersion في ملف build.gradle الخاص بالوحدة، كما هو موضّح في رمز البدء التالي.

    رائع

    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.