تثبيت وإعدادي 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. يُثبِّت "استوديو Android" جميع إصدارات حزمة NDK في الدليل android-sdk/ndk/.

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

1. مع فتح مشروع، انقر على الأدوات > أداة إدارة حِزم تطوير البرامج (SDK).

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

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

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

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

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

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

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

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

ضبط إصدار معيّن من CMake

يتضمّن "مدير حِزم تطوير البرامج (SDK)" الإصدار المشتق 3.6.0 من IDE 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. ضَع علامة في مربّع الاختيار إظهار تفاصيل الحزمة.

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

   الشكل 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.