تثبيت وإعدادي 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/.

لتثبيت 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 في وحدتك:

رائع

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 المتاح لنظام التشغيل الذي تستخدمه وثبِّته. احرص أيضًا على إضافة مسار تثبيت 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 Studio أو إصدار أحدث، إذا لم يتم تحديد الإصدار، سيختار المكوّن الإضافي لـ Android Gradle إصدارًا معروفًا بأنّه متوافق.

تهيئة إصدارات معينة من NDK في مشروعك

وقد تحتاج إلى تهيئة إصدار NDK في مشروعك إذا كانت إحدى ينطبق ما يلي:

  • مشروعك موروث وتحتاج إلى استخدام إصدارات معينة من NDK والمكون الإضافي لنظام Gradle المتوافق مع Android (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