NDK'yı kullanmaya başlama

Yerel Geliştirme Kiti (NDK), C ve C++ kodunu Android ile kullanmanıza olanak tanıyan ve yerel etkinlikleri yönetmek, sensörler ve dokunmatik giriş gibi fiziksel cihaz bileşenlerine erişmek için kullanabileceğiniz platform kitaplıkları sağlayan bir araç setidir. NDK, uygulamalarını geliştirmek için yalnızca Java kodu ve çerçeve API'leri kullanması gereken yeni başlayan çoğu Android programcısı için uygun olmayabilir. Bununla birlikte, NDK, aşağıdakilerden birini veya daha fazlasını yapmanız gereken durumlarda faydalı olabilir:

• Düşük gecikme süresi elde etmek veya oyunlar ya da fizik simülasyonları gibi bilgi işlem açısından yoğun uygulamaları çalıştırmak için bir cihazdaki ekstra performansı sıkın.
• Kendi veya diğer geliştiricilerin C veya C++ kitaplıklarını yeniden kullanma.

Android Studio 2.2 ve sonraki sürümleri ile NDK'yı kullanarak C ve C++ kodunu yerel bir kitaplıkta derleyebilir ve IDE'nin entegre derleme sistemi olan Gradle'ı kullanarak APK'nıza paket olarak ekleyebilirsiniz. Daha sonra Java kodunuz, Java Yerel Arayüzü (JNI) çerçevesi aracılığıyla yerel kitaplığınızdaki işlevleri çağırabilir. Gradle ve Android derleme sistemi hakkında daha fazla bilgi edinmek için Derlemenizi Yapılandırın başlıklı makaleyi okuyun.

Android Studio'nun yerel kitaplıkları derleyen varsayılan derleme aracı CMake'dir. Ayrıca Android Studio, derleme araç setini kullanan çok sayıda mevcut proje nedeniyle ndk-build özelliğini de destekler. Ancak yeni bir yerel kitaplık oluşturuyorsanız CMake kullanmalısınız.

Bu kılavuz, Android Studio'da NDK'yi kullanmaya başlamak için ihtiyaç duyduğunuz bilgileri sağlar. Android Studio'nun en son sürümüne sahip değilseniz şimdi indirin ve yükleyin.

Deneysel Gradle kullanıcılarına dikkat edin: Eklentilerin 2.2.0 veya sonraki bir sürümüne geçiş yapmayı ve yerel kitaplıklarınızı oluşturmak için CMake ya da ndk-build platformunu kullanmayı düşünün. Yerel projeniz zaten CMake veya ndk-build derlemesini kullanıyor, Gradle derleme sisteminin kararlı bir sürümünü kullanmayı tercih ediyor veya C gibi eklenti araçları için destek almak istiyorsunuz. Aksi takdirde, Gradle'ın deneysel sürümünü ve Android eklentisini kullanmaya devam edebilirsiniz.

NDK ve araçları indirin

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

• Android Yerel Geliştirme Kiti (NDK): C ve C++ kodunu Android ile kullanmanıza olanak tanıyan bir dizi araç.
• CMake: Yerel kitaplığınızı oluşturmak için Gradle ile birlikte çalışan harici bir derleme aracı. Yalnızca ndk-build 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ı.

Bu bileşenleri yükleme hakkında bilgi edinmek için NDK ve CMake'i yükleme ve yapılandırma başlıklı makaleye bakın.

Yerel proje oluşturun veya içe aktarın

Android Studio'yu kurduktan sonra, C/C++ Desteği ile Yeni Bir Proje oluşturabilirsiniz. Ancak mevcut bir Android Studio projesine yerel kod eklemek veya bu kodu içe aktarmak istiyorsanız şu temel süreci izlemeniz gerekir:

1. Yeni yerel kaynak dosyalar oluşturun ve bunları Android Studio projenize ekleyin.
   • Yerel kodunuz varsa veya önceden oluşturulmuş bir yerel kitaplığı içe aktarmak istiyorsanız bu adımı atlayabilirsiniz.
2. CMake'e yerel kaynaklarınızı nasıl kitaplıkta oluşturabileceğinizi bildirmek için CMake derleme komut dosyası oluşturun. Bu derleme komut dosyasını, önceden oluşturulmuş veya platform kitaplıklarını içe aktarıp bu bağlantılara bağlarken de kullanmanız gerekir.
   • Mevcut yerel kitaplığınızda CMakeLists.txt derleme komut dosyası varsa veya ndk-build ile Android.mk derleme komut dosyası bulunuyorsa bu adımı atlayabilirsiniz.
3. CMake veya ndk-build komut dosyanıza bir yol sağlayarak Gradle'ı yerel kitaplığınıza bağlayın. Gradle, kaynak kodunu Android Studio projenize aktarmak ve yerel kitaplığınızı (SO dosyası) APK'ya paketlemek için derleme komut dosyasını kullanır.

   Not: Mevcut projeniz, kullanımdan kaldırılan ndkCompile aracını kullanıyorsa Gradle'ı CMake veya ndk-build kullanacak şekilde yapılandırmadan önce build.properties dosyanızı açıp aşağıdaki kod satırını kaldırmanız gerekir:

   // Remove this line
   android.useDeprecatedNdk = true
   

4. uygulamasını Çalıştır'ı tıklayarak uygulamanızı oluşturup çalıştırın. Gradle, yerel kitaplığınızı APK'nızla derlemek, derlemek ve paketlemek için bağımlı olarak CMake veya ndk-build işleminizi ekler.

Uygulamanız fiziksel bir cihazda veya emülatörde çalıştırıldıktan sonra uygulamanızda hata ayıklama yapmak için Android Studio'yu kullanabilirsiniz. Aksi halde, NDK ve bileşenleri hakkında daha fazla bilgi edinmek için Kavramlar sayfasını okuyun.