NDK ve CMake'i yükleme ve yapılandırma

Uygulamanızın yerel kodunu derlemek ve hata ayıklamak için aşağıdaki bileşenlere ihtiyacınız vardır:

  • Android Native Development Kit (NDK): Android ile C ve C++ kodu kullanmanıza olanak tanıyan bir araç paketidir.
  • CMake: Yerleşik kitaplığınızı derlemek için Gradle ile birlikte çalışan harici bir derleme aracıdır. Yalnızca ndk-build'i kullanmayı planlıyorsanız bu bileşene ihtiyacınız yoktur.
  • LLDB: Android Studio'nun yerel kodda hata ayıklama için kullandığı hata ayıklayıcı. LLDB varsayılan olarak Android Studio ile birlikte yüklenir.

Bu sayfada, bu bileşenlerin otomatik olarak veya Android Studio'yu ya da sdkmanager aracını kullanarak manuel olarak indirilip yükleneceği açıklanmaktadır.

NDK ve CMake'i otomatik olarak yükleme

Android Gradle Eklentisi 4.2.0 ve sonraki sürümler, lisansları önceden kabul edilmişse projenizi ilk kez derlediğinizde gerekli NDK ve CMake'i otomatik olarak yükleyebilir. Lisans şartlarını okuyup kabul ettiyseniz aşağıdaki komutu kullanarak komut dosyalarındaki lisansları önceden kabul edebilirsiniz:

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

NDK ve CMake'i yükleme

NDK'yı yüklediğinizde Android Studio, mevcut en son NDK'yı seçer. Çoğu proje için NDK'nın bu varsayılan sürümünü yüklemek yeterlidir. Ancak projeniz için NDK'nın bir veya daha fazla belirli sürümüne ihtiyaç duyuyorsanız belirli sürümleri indirip yapılandırabilirsiniz. Bu sayede, her biri NDK'nın belirli bir sürümüne bağlı olan projelerde yeniden üretilebilir derlemeler oluşturabilirsiniz. Android Studio, NDK'nın tüm sürümlerini android-sdk/ndk/ dizinine yükler.

Android Studio'ya CMake ve varsayılan NDK'yi yüklemek için aşağıdakileri yapın:

  1. Bir proje açıkken Araçlar > SDK Yöneticisi'ni tıklayın.

  2. SDK Araçları sekmesini tıklayın.

  3. NDK (Yan yana) ve CMake onay kutularını işaretleyin.

    SDK Yöneticisi resmi Şekil 1. NDK (Yan yana) seçeneğini gösteren SDK Araçları penceresi

  4. Tamam'ı tıklayın.

    NDK paketinin diskte ne kadar alan kapladığı bir iletişim kutusunda gösterilir.

  5. Tamam'ı tıklayın.

  6. Yükleme tamamlandığında Bitir'i tıklayın.

  7. Projeniz, derleme dosyasını otomatik olarak senkronize eder ve derleme yapar. Ortaya çıkan hataları düzeltin.

CMake'in belirli bir sürümünü yapılandırma

SDK Yöneticisi, CMake'in 3.6.0 çatallanmış sürümünü ve 3.10.2 sürümünü içerir. Belirli bir CMake sürümü ayarlanmayan projeler CMake 3.10.2 ile derlenir. CMake sürümünü ayarlamak için modülünüzün build.gradle dosyasına aşağıdakileri ekleyin:

Groovy

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

Kotlin

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

SDK Yöneticisi tarafından dahil edilmeyen bir CMake sürümü kullanmak istiyorsanız aşağıdaki adımları uygulayın:

  1. Resmi CMake web sitesinden CMake'i indirip yükleyin.
  2. Gradle'ın modülünüzün build.gradle dosyasında kullanmasını istediğiniz CMake sürümünü belirtin.

  3. CMake kurulumunun yolunu PATH ortam değişkeninize ekleyin veya gösterildiği gibi projenizin local.properties dosyasına dahil edin. Gradle, build.gradle dosyanızda belirttiğiniz CMake sürümünü bulamıyorsa derleme hatası alırsınız.

    # If you set this property, Gradle no longer uses PATH to find CMake.
cmake.dir = "path-to-cmake"</pre>

  4. Ninja derleme sistemi iş istasyonunuzda yüklü değilse resmi Ninja web sitesine gidip işletim sisteminiz için kullanılabilen Ninja'nın en son sürümünü indirip yükleyin. Ninja kurulumunun yolunu da PATH ortam değişkeninize eklediğinizden emin olun.

NDK'nın belirli bir sürümünü yükleme

NDK'nın belirli bir sürümünü yüklemek için aşağıdakileri yapın:

  1. Bir proje açıkken Araçlar > SDK Yöneticisi'ni tıklayın.

  2. SDK Araçları sekmesini tıklayın.

  3. Paket Ayrıntılarını Göster onay kutusunu işaretleyin.

  4. NDK (Yan yana) onay kutusunu ve altındaki, yüklemek istediğiniz NDK sürümlerine karşılık gelen onay kutularını işaretleyin. Android Studio, NDK'nın tüm sürümlerini android-sdk/ndk/ dizinine yükler.

    SDK Tools penceresinin resmi Şekil 2. NDK (Yan yana) seçeneklerini gösteren SDK Araçları penceresi

  5. Tamam'ı tıklayın.

    NDK paketlerinin ne kadar alan kapladığı bir iletişim kutusunda gösterilir.

  6. Tamam'ı tıklayın.

  7. Yükleme tamamlandığında Bitir'i tıklayın.

  8. Projeniz, derleme dosyasını otomatik olarak senkronize eder ve derleme yapar. Ortaya çıkan hataları düzeltin.

  9. Her modülü, kullanmasını istediğiniz NDK sürümüyle yapılandırın. Android Studio 3.6 veya sonraki bir sürümü kullanıyorsanız sürümü belirtmezseniz Android Gradle eklentisi, uyumlu olduğu bilinen bir sürümü seçer.

Projenizde NDK'nın belirli sürümlerini yapılandırma

Aşağıdakilerden biri geçerliyse projenizde NDK sürümünü yapılandırmanız gerekebilir:

  • Projeniz devralınır ve NDK ile Android Gradle eklentisinin (AGP) belirli sürümlerini kullanmanız gerekir. Daha fazla bilgi için Android Gradle eklentisi için NDK'yi yapılandırma başlıklı makaleyi inceleyin.

  • NDK'nın birden fazla sürümü yüklüyse ve belirli bir sürümü kullanmak istiyorsanız Bu durumda, aşağıdaki kod örneğinde gösterildiği gibi modülün build.gradle dosyasında android.ndkVersion mülkünü kullanarak sürümü belirtin.

    Groovy

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

    Kotlin

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

AGP sürümü başına varsayılan NDK sürümü

Her AGP sürümü, yayınlanmadan önce o sıradaki en son kararlı NDK sürümüyle ayrıntılı olarak test edilir. build.gradle dosyasında bir NDK sürümü belirtmezseniz bu NDK sürümü, projelerinizi derlemek için kullanılır. AGP'nin farklı sürümleri için varsayılan NDK sürümü, AGP sürüm notlarında ve AGP geçmiş sürüm notlarında belirtilmiştir.