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

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

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

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

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

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

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

تثبيت NDK وCMake

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

لتثبيت CMake ومعرّف NDK التلقائي في "استوديو Android"، يمكنك إجراء ما يلي:

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

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، اتبع الخطوات التالية:

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 إلى متغيّر بيئة 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" أو الإصدارات الأحدث، إذا لم تحدّد الإصدار، يختار المكوّن الإضافي لنظام 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 هذه لإنشاء مشاريعك إذا لم تحدّد نسخة منها في ملف build.gradle. يتم توثيق إصدار NDK التلقائي للإصدارات المختلفة من AGP في ملاحظات إصدار AGP وملاحظات الإصدار السابقة في AGP.