NDK'yı kullanmaya başlayın

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

  • Gecikme süresinin düşük olması veya oyunlar ya da fizik simülasyonları gibi işlemler açısından yoğun uygulamalar çalıştırmak için cihazdan ek performans elde edin.
  • Kendi C veya C++ kitaplıklarınızı veya diğer geliştiricilerin C ya da C++ kitaplıklarını yeniden kullanın.

Android Studio 2.2 ve sonraki sürümleri kullanarak C ve C++ kodunu yerel bir kitaplıkta derlemek ve IDE'nin entegre derleme sistemi Gradle'ı kullanarak APK'nızda paketlemek için NDK'yı kullanabilirsiniz. Java kodunuz daha sonra 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 bölümünü okuyun.

Android Studio'nun yerel kitaplıkları derlemek için kullandığı varsayılan derleme aracı CMake'dır. Android Studio, derleme araç setini kullanan çok sayıda mevcut proje nedeniyle ndk-build'i de destekler. Ancak, yeni bir yerel kitaplık oluşturuyorsanız CMake'i kullanmanız gerekir.

Bu kılavuzda, Android Studio'da NDK'yı kullanmaya başlamak için ihtiyacınız olan bilgileri bulabilirsiniz. Android Studio'nun en son sürümüne sahip değilseniz şimdi indirip yükleyin.

Deneysel Gradle kullanıcılarının dikkatine: Aşağıdaki durumlardan herhangi biri sizin için geçerliyse eklenti 2.2.0 veya sonraki bir sürüme geçmeyi ve yerel kitaplıklarınızı oluşturmak için CMake veya ndk-build'i kullanmayı düşünün: Yerel projeniz zaten CMake veya ndk-build kullanıyor. Gradle derleme sisteminin kararlı bir sürümünü kullanmayı tercih edebilirsiniz ya da CCache gibi eklenti araçları için destek almak istiyorsanız. Aksi takdirde, Gradle'ın deneysel sürümünü ve Android eklentisini kullanmaya devam edebilirsiniz.

NDK'yı ve araçları indirin

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

  • Android Native Development Kit (NDK): C ve C++ kodlarını Android'le kullanabilmenizi sağlayan bir araç seti.
  • 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şturma veya içe aktarma

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

  1. Yeni yerel kaynak dosyalar oluşturun ve bunları Android Studio projenize ekleyin.
    • Zaten yerel kodunuz varsa veya önceden oluşturulmuş bir yerel kitaplığı içe aktarmak istiyorsanız bu adımı atlayabilirsiniz.
  2. CMake'a yerel kaynaklarınızı kitaplıkta nasıl derleyeceğini bildirmek için CMake derleme komut dosyası oluşturun. Önceden oluşturulmuş kitaplıklara veya platform kitaplıklarına içe aktarma ve bağlantı oluşturma işlemleri için de bu derleme komut dosyasını kullanmanız gerekir.
    • Mevcut yerel kitaplığınızda zaten bir CMakeLists.txt derleme komut dosyası varsa veya ndk-build kullanılıyorsa ve Android.mk derleme komut dosyası içeriyorsa bu adımı atlayabilirsiniz.
  3. CMake veya ndk-build komut dosyası dosyanızın yolunu sağlayarak Gradle'ı yerel kitaplığınıza bağlayın. Gradle, kaynak kodu Android Studio projenize aktarmak ve yerel kitaplığınızı (SO dosyası) APK'da paketlemek için derleme komut dosyasını kullanır.

    Not: Mevcut projenizde kullanımdan kaldırılan ndkCompile aracı kullanılıyorsa Gradle'ı CMake veya ndk-build aracını 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. Çalıştırana menüden uygulamayı çalıştırıp çalıştırın tıklayarak uygulamanızı derleyip çalıştırın. Gradle, yerel kitaplığınızı derlemek, derlemek ve APK'nızla paketlemek için CMake veya ndk-build işleminizi bağımlılık olarak ekler.

Uygulamanız fiziksel bir cihazda veya emülatörde çalışırken uygulamanızdaki hataları ayıklamak için Android Studio'yu kullanabilirsiniz. Aksi takdirde NDK ve bileşenleri hakkında daha fazla bilgi edinmek için Kavramlar sayfasını okuyun.