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ıklamak 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 komutla komut dosyalarındaki lisansları görürsünüz:

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

NDK ve CMake'i yükleme

NDK'yı yüklediğinizde Android Studio kullanılabilir en son NDK'yı seçer. Örneğin, çoğu projede NDK'nın varsayılan sürümünün yüklenmesi yeterlidir. Ancak projeniz için NDK'nın bir veya daha fazla belirli sürümüne ihtiyaç varsa belirli sürümleri indirip yapılandırabilirsiniz. Bunu yapmak, her biri belirli bir projeye bağlı olan projeler genelinde tekrarlanabilir derlemeler sağlarsınız. sürümünü kullandığınızdan emin olun. 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.

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

   Not: ndk-bundle klasöründe yüklü bir NDK'niz varsa NDK etiketine sahip listedir. Android Gradle eklentisi 3.5.0 veya sonraki bir sürümü kullanıyorsanız bu onay kutusunu seçebilir ya da işaretini kaldırabilirsiniz. Onay kutusunu temizlediğinizde NDK kaldırılır, disk alanı boşaltılır ve onay kutusunun listeden kaldırılmasına neden olur. Eski NDK'yı kaldırırsanız Projelerinizden artık desteği sonlandırılan ndk.dir değeri local.properties dosya.

4. Tamam'ı tıklayın.

   NDK paketinin diskte ne kadar alan kullandığını gösteren bir iletişim kutusu gösterilir.

5. Tamam'ı tıklayın.

6. Yükleme tamamlandığında Son'u tıklayın.

7. Projeniz, derleme dosyasını otomatik olarak senkronize eder ve bir derleme gerçekleştirir. Oluşan hataları düzeltin.

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

SDK Manager, uygulamanızın çatallı 3.6.0 sürümünü içerir CMake ve 3.10.2 sürümü. 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'ni kullanıyorsanız aşağıdaki adımları uygulayın:

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

3. CMake yüklemesinin yolunu PATH ortamınıza ekleyin veya projenizin local.properties dosyasına ekleyin. gösteriliyor. 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 oluşturma sistemi cihazınızda henüz kurulu değilse resmi Ninja web sitesine gidin, ve işletim sisteminiz için mevcut Ninja'nın en son sürümünü indirip yükleyin. Ninja kurulumunun yolunu da PATH ortam değişkeni.

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 (Side by side) (NDK (Yan yana)) onay kutusunu ve (yüklemek istediğiniz NDK sürümlerine karşılık gelir). Android Studio, NDK'nın tüm sürümlerini android-sdk/ndk/ dizinindeki

   Not: Android Studio'nun güncelleme kanalını değiştirmediğiniz sürece NDK'nın önizleme sürümleri (ör. canary ve beta) bu listede gösterilmez. Android Studio önizlemesini yükleyebilirsiniz karşılaştırabilirsiniz.

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

   Not: ndk-bundle klasöründe yüklü bir NDK varsa listede NDK etiketiyle görünür. Gradle 3.5 veya sonraki bir sürümü kullanıyorsanız bu onay kutusunu işaretleyebilir ya da işaretini kaldırabilirsiniz. Bu alanı temizlediğinizde yüklü NDK kaldırılır, disk alanı boşaltılır ve onay kutusunun listeden kaldırılmasına neden olur. Eski NDK'yı kaldırırsanız ndk.dir değerini kaldırın. Bu özellik artık desteği sonlandırılmıştır. local.properties dosya.

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 Son'u tıklayın.

8. Projeniz, derleme dosyasını otomatik olarak senkronize eder ve derleme yapar. Oluşan 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ünü belirtmezseniz Android Gradle eklentisi otomatik olarak uyumlu oldukları bilinmektedir.

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

Projenizdeki NDK sürümlerinden biri şu doğrudur:

• Projeniz devralınır ve NDK ile Android Gradle eklentisinin (AGP) belirli sürümlerini kullanmanız gerekir. Daha fazla bilgi için bkz. Android Gradle eklentisi için NDK'yı yapılandırın.

• Cihazınızda NDK'nın birden fazla sürümü yüklü ve cihazınızda belirli bir NDK sürümünü kullanmak istiyorsunuz bir. Bu durumda, android.ndkVersion öğesini kullanarak sürümü belirtin özelliğini, modülün build.gradle dosyasında gösterildiği gibi, aşağıdaki kodda gösterildiği gibi örneklem.

  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 kapsamlı bir şekilde test edilir. build.gradle dosyasında bir NDK sürümü belirtmezseniz bu NDK sürümü, projelerinizi derlemek için kullanılır. Varsayılan NDK sürümü aşağıdaki yönergelerde mevcuttur: AGP sürüm notları ve AGP geçmiş sürüm notları.