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

لتجميع الرمز البرمجي الأصلي وتصحيحه في تطبيقك، يجب توفُّر المكوّنات التالية:

• حزمة تطوير البرامج الأصلية لنظام التشغيل Android (NDK): هي مجموعة من الأدوات التي تتيح لك استخدام رموز 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. يثبِّت "استوديو Android" جميع إصدارات NDK في الدليل android-sdk/ndk/.

لتثبيت CMake وNDK التلقائية في "استوديو Android"، اتّبِع الخطوات التالية:

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

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

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

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

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

إذا أردت استخدام إصدار CMake غير مضمّن في SDK Manager، اتّبِع الخطوات التالية:

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 Manager.

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

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

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

   الشكل 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 الخاص بالوحدة، كما هو موضّح في نموذج الرمز البرمجي التالي.

  أنيق

  android {
      ndkVersion "major.minor.build" // e.g.,  ndkVersion "21.3.6528147"
  }

  Kotlin

  android {
      ndkVersion = "major.minor.build" // e.g.,  ndkVersion "21.3.6528147"
  }

إصدار NDK التلقائي لكل إصدار من "المكوّن الإضافي لنظام Gradle المتوافق مع Android"

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