התקנה והגדרה של ה-NDK ו-CMake

כדי לקמפל ולנפות באגים בקוד מקורי של האפליקציה, צריך את הרכיבים הבאים:

• ‫Android Native Development Kit (NDK): ערכת כלים שמאפשרת להשתמש בקוד C ו-C++‎ עם Android.
• ‫CMake: כלי חיצוני לבנייה שפועל לצד Gradle כדי לבנות את הספרייה המקורית. הרכיב הזה לא נחוץ אם אתם מתכננים להשתמש רק ב-ndk-build.
• LLDB: כלי לניפוי באגים ש-Android Studio משתמש בו כדי לנפות באגים בקוד מקורי. כברירת מחדל, ‏ LLDB מותקן לצד Android Studio.

בדף הזה מוסבר איך להתקין את הרכיבים האלה באופן אוטומטי, או באמצעות Android Studio או הכלי sdkmanager כדי להוריד ולהתקין אותם באופן ידני.

התקנה אוטומטית של NDK ו-CMake

אם רישיונות ה-NDK וה-CMake התקבלו מראש, אפשר להשתמש ב-Android Gradle Plugin בגרסה 4.2.0 ואילך כדי להתקין אותם באופן אוטומטי בפעם הראשונה שיוצרים את הפרויקט. אם כבר קראתם את תנאי הרישיון ואתם מסכימים להם, אתם יכולים לאשר מראש את הרישיונות בסקריפטים באמצעות הפקודה הבאה:

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

התקנה של NDK ו-CMake

כשמתקינים את NDK, ‏ Android Studio בוחר את הגרסה האחרונה שזמינה של NDK. ברוב הפרויקטים, התקנת גרסת ברירת המחדל הזו של NDK מספיקה. אם אתם צריכים בפרויקט גרסה ספציפית אחת או יותר של NDK, תוכלו להוריד ולהגדיר גרסאות ספציפיות. כך תוכלו לוודא שתוכלו לשחזר את הבנייה בפרויקטים שכל אחד מהם תלוי בגרסה ספציפית של NDK. ‫Android Studio מתקין את כל הגרסאות של NDK בספרייה android-sdk/ndk/.

כדי להתקין את CMake ואת NDK שמוגדר כברירת מחדל ב-Android Studio:

1. בפרויקט פתוח, לוחצים על Tools > SDK Manager.

2. לוחצים על הכרטיסייה SDK Tools (כלי SDK).

3. מסמנים את תיבות הסימון NDK (Side by side) ו-CMake.

   איור 1. חלון SDK Tools שבו מוצגת האפשרות NDK (Side by side)

   הערה: אם יש לכם NDK מותקן בתיקייה ndk-bundle, הוא יופיע ברשימה עם התווית NDK. אם אתם משתמשים בפלאגין Android Gradle בגרסה 3.5.0 ואילך, אתם יכולים לסמן את התיבה הזו או לבטל את הסימון שלה. ביטול הסימון של תיבת הסימון יגרום להסרת ההתקנה של NDK, יפנה מקום בדיסק ויגרום לתיבת הסימון להיעלם מהרשימה. אם מסירים את NDK מדור קודם, צריך להסיר את הערך ndk.dir, שיצא משימוש, מהקבצים local.properties של הפרויקטים.

4. לוחצים על אישור.

   בתיבת דו-שיח מוצג נפח האחסון שהחבילה של NDK תופסת בדיסק.

5. לוחצים על אישור.

6. בסיום ההתקנה, לוחצים על סיום.

7. הפרויקט מסנכרן באופן אוטומטי את קובץ ה-build ומבצע build. פותרים את השגיאות שמתרחשות.

הגדרת גרסה ספציפית של CMake

‫SDK Manager כולל את גרסת 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 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. אם מערכת ה-build של Ninja עדיין לא מותקנת בתחנת העבודה, צריך להיכנס אל האתר הרשמי של Ninja, להוריד את הגרסה האחרונה של Ninja שזמינה למערכת ההפעלה שלכם ולהתקין אותה. חשוב להוסיף גם את הנתיב להתקנת Ninja למשתנה הסביבה PATH.

התקנה של גרסה ספציפית של NDK

כדי להתקין גרסה ספציפית של NDK:

1. בפרויקט פתוח, לוחצים על Tools > SDK Manager.

2. לוחצים על הכרטיסייה SDK Tools (כלי SDK).

3. מסמנים את תיבת הסימון הצגת פרטי החבילה.

4. מסמנים את התיבה NDK (Side by side) ואת התיבות שמתחתיה שמתאימות לגרסאות ה-NDK שרוצים להתקין. ב-Android Studio, כל הגרסאות של NDK מותקנות בספרייה android-sdk/ndk/.

   הערה: גרסאות טרום-הפצה (לדוגמה, canary ו-beta) של NDK לא מופיעות ברשימה הזו, אלא אם משנים את ערוץ העדכון של Android Studio. אפשר להתקין גרסת Preview של Android Studio לצד הגרסה היציבה.

   איור 2. חלון SDK Tools עם האפשרויות של NDK (Side by side)

   הערה: אם יש לכם NDK מותקן בתיקייה ndk-bundle, הוא יופיע ברשימה עם התווית NDK. אם אתם משתמשים ב-Gradle בגרסה 3.5 או בגרסה מתקדמת יותר, אתם יכולים לסמן את תיבת הסימון הזו או לבטל את הסימון שלה. אם מבטלים את הסימון, ה-NDK שהותקן יוסר, יתפנה מקום בדיסק ותיבת הסימון תיעלם מהרשימה. אם מסירים את NDK מדור קודם, צריך להסיר את הערך ndk.dir, שיצא משימוש, מקובצי local.properties של הפרויקטים.

5. לוחצים על אישור.

   בתיבת דו-שיח מוצג כמה מקום תופסות חבילות ה-NDK.

6. לוחצים על אישור.

7. בסיום ההתקנה, לוחצים על סיום.

8. הפרויקט מסנכרן באופן אוטומטי את קובץ ה-build ומבצע build. פותרים את השגיאות שמתרחשות.

9. מגדירים כל מודול עם גרסת ה-NDK שרוצים להשתמש בה. כשמשתמשים ב-Android Studio מגרסה 3.6 ואילך, אם לא מציינים את הגרסה, הפלאגין Android Gradle בוחר גרסה שידוע שהיא תואמת.

הגדרת גרסאות ספציפיות של NDK בפרויקט

יכול להיות שתצטרכו להגדיר את גרסת ה-NDK בפרויקט אם אחד מהתנאים הבאים מתקיים:

• הפרויקט שלכם הוא פרויקט שעבר בירושה, ואתם צריכים להשתמש בגרסאות ספציפיות של NDK ושל Android Gradle plugin ‏ (AGP). מידע נוסף זמין במאמר בנושא הגדרת NDK לפלאגין Android Gradle.

• יש לכם כמה גרסאות של 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.