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

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

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

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

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

يمكن للمكوّن الإضافي لنظام Gradle المتوافق مع Android الإصدار 4.2.0 والإصدارات الأحدث تثبيت 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 Studio، اتّبِع الخطوات التالية:

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

2. انقر على علامة التبويب أدوات SDK.

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

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

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

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

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

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

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

إعداد إصدار معيّن من CMake

يتضمن مدير SDK الإصدار 3.6.0 المتشعّب من CMake والإصدار 3.10.2. يتم تصميم المشروعات التي لا تعين إصدار CMake معيّنًا باستخدام CMake 3.10.2. لضبط إصدار CMake، أضِف ما يلي إلى ملف build.gradle في الوحدة:

android {
    ...
    externalNativeBuild {
        cmake {
            ...
            version "cmake-version"
        }
    }
}

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 وثبِّته. احرص أيضًا على إضافة المسار إلى تثبيت Ninja إلى متغير بيئة PATH.

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

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

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

2. انقر على علامة التبويب أدوات SDK.

3. ضَع علامة في مربّع الاختيار Show Package Details (عرض تفاصيل الحزمة).

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

   الشكل 2. نافذة أدوات SDK التي تعرض خيارات NDK (جنبًا إلى جنب)

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

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

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

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

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

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

إعداد إصدارات معيّنة من 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.