Android derleme sistemi, uygulama kaynaklarını ve kaynak kodunu derleyip test edebileceğiniz, dağıtabileceğiniz, imzalayabileceğiniz ve dağıtabileceğiniz APK'lar veya Android App Bundle'lar halinde paketler.
Gradle ve Android Gradle eklentisi, derlemenizin aşağıdaki özelliklerini yapılandırmanıza yardımcı olur:
Derleme türleri
Derleme türleri, Gradle'ın uygulamanızı derleyip paketlerken kullandığı belirli özellikleri tanımlar. Derleme türleri genellikle geliştirme yaşam döngünüzün farklı aşamaları için yapılandırılır.
Örneğin, hata ayıklama derleme türü hata ayıklama seçeneklerini etkinleştirir ve uygulamayı hata ayıklama anahtarıyla imzalar. Yayın derleme türü ise dağıtım için uygulamanızı küçültebilir, kodu karartabilir ve bir sürüm anahtarıyla imzalayabilir.
Uygulamanızı derlemek için en az bir derleme türü tanımlamanız gerekir. Android Studio, hata ayıklama ve sürüm derleme türlerini varsayılan olarak oluşturur. Uygulamanızın paketleme ayarlarını özelleştirmeye başlamak için derleme türlerini nasıl yapılandıracağınızı öğrenin.
Ürün varyantları
Ürün varyantları, uygulamanızın kullanıcılara sunabileceğiniz farklı sürümlerini (ör. ücretsiz ve ücretli sürümler) temsil eder. Ürün aromalarını, uygulamanızın tüm sürümlerinde ortak olan bölümleri paylaşırken ve yeniden kullanırken farklı kod ve kaynaklar kullanacak şekilde özelleştirebilirsiniz. Ürün aromaları isteğe bağlıdır ve bunları manuel olarak oluşturmanız gerekir. Uygulamanızın farklı sürümlerini oluşturmaya başlamak için ürün aromalarını nasıl yapılandıracağınızı öğrenin.
Varyant oluşturma
Derleme varyantı, derleme türü ile ürün çeşidinin kesişimidir ve Gradle'ın uygulamanızı derlemek için kullandığı yapılandırmadır. Derleme varyantlarını kullanarak, geliştirme sırasında ürün çeşidinizi hata ayıklama sürümünü ve dağıtım için ürün çeşidinizi imzalanan sürümlerini derleyebilirsiniz.
Derleme varyantlarını doğrudan yapılandırmasanız da bunları oluşturan derleme türlerini ve ürün varyantlarını yapılandırırsınız. Ek derleme türleri veya ürün varyantları oluşturmak da ek derleme varyantları oluşturur. Derleme varyantlarını nasıl oluşturacağınızı ve yöneteceğinizi öğrenmek için Derleme varyantlarını yapılandırma başlıklı genel bakış makalesini inceleyin.
Manifest girişleri
Derleme varyantı yapılandırmasında manifest dosyasının bazı özelliklerinin değerlerini belirtebilirsiniz. Bu derleme değerleri, manifest dosyasında mevcut değerleri geçersiz kılar. Bu, uygulamanızın farklı bir uygulama adıyla, minimum SDK sürümüyle veya hedef SDK sürümüyle birden fazla varyantını oluşturmak istiyorsanız kullanışlıdır. Birden fazla manifest olduğunda manifest birleştirme aracı
manifest ayarlarını birleştirir.
Bağımlılıklar
Derleme sistemi, yerel dosya sisteminizden ve uzak depolardan proje bağımlılıkları yönetir. Yani bağımlılıklarınızın ikili paketlerini manuel olarak aramanız, indirmeniz ve proje dizininize kopyalamanız gerekmez. Daha fazla bilgi için Derleme bağımlılıklarını ekleme başlıklı makaleyi inceleyin.
İmza
Derleme sistemi, derleme yapılandırmasında imzalama ayarlarını belirtmenize olanak tanır ve derleme işlemi sırasında uygulamanızı otomatik olarak imzalayabilir. Derleme sistemi, derleme sırasında şifre istemi gösterilmesini önlemek için bilinen kimlik bilgilerini kullanarak hata ayıklama sürümünü varsayılan bir anahtar ve sertifikayla imzalar. Bu derleme için açıkça bir imzalama yapılandırması tanımlamadığınız sürece derleme sistemi sürümünü imzalamaz. Sürüm anahtarınız yoksa Uygulamanızı imzalama bölümünde açıklandığı şekilde bir anahtar oluşturabilirsiniz. Uygulamaların çoğu uygulama mağazasında dağıtılması için imzalanmış sürüm derlemeleri gerekir.
Kod ve kaynak küçültme
Derleme sistemi, her derleme varyantı için farklı bir ProGuard kural dosyası belirtmenize olanak tanır. Derleme sistemi, uygulamanızı derlerken R8 gibi yerleşik sıkıştırma araçlarını kullanarak kodunuzu ve kaynaklarınızı sıkıştırmak için uygun kural grubunu uygular.
Kodunuzu ve kaynaklarınızı küçültmek, APK veya AAB boyutunuzu küçültmenize yardımcı olabilir.
Birden fazla APK desteği
Derleme sistemi, her biri yalnızca belirli bir ekran yoğunluğu veya Uygulama İkili Arayüzü (ABI) için gereken kod ve kaynakları içeren farklı APK'ları otomatik olarak oluşturmanıza olanak tanır.
Daha fazla bilgi için
Birden fazla APK oluşturma başlıklı makaleyi inceleyin. Ancak tek bir AAB yayınlamak, ekran yoğunluğu ve ABI'ye ek olarak dile göre bölme olanağı sunarken Google Play'e birden fazla yapı yükleme ihtiyacını ortadan kaldırdığı için önerilen yaklaşımdır. Ağustos 2021'den sonra gönderilen tüm yeni uygulamaların AAB kullanması gerekir.
Android derlemelerindeki Java sürümleri
Kaynak kodunuz Java, Kotlin veya her ikisi ile yazılmış olsun, derleme işleminiz için bir JDK veya Java dil sürümü seçmeniz gereken birkaç yer vardır. Ayrıntılar için Android derlemelerindeki Java sürümleri başlıklı makaleyi inceleyin.
Derleme yapılandırma dosyaları
Özel derleme yapılandırmaları oluşturmak için bir veya daha fazla derleme yapılandırma dosyasında değişiklik yapmanız gerekir. Bu düz metin dosyaları, Kotlin dilinin bir çeşidi olan Kotlin komut dosyasını kullanarak derleme mantığını tanımlamak ve değiştirmek için alana özgü bir dil (DSL) kullanır. Derlemelerinizi yapılandırmak için Java Sanal Makinesi (JVM) için dinamik bir dil olan Groovy'yi de kullanabilirsiniz.
Android Gradle eklentisi, ihtiyacınız olan DSL öğelerinin çoğunu kullanıma sunduğundan derlemenizi yapılandırmaya başlamak için Kotlin komut dosyası veya Groovy bilmenize gerek yoktur. Android Gradle eklentisi DSL'si hakkında daha fazla bilgi edinmek için DSL referans belgelerini inceleyin. Kotlin komut dosyası, temel Gradle Kotlin DSL'yi de kullanır.
Android Studio, yeni bir proje başlattığınızda bu dosyaların bazılarını sizin için otomatik olarak oluşturur ve makul varsayılanlara göre doldurur. Oluşturulan dosyalara genel bakış için Android derleme yapısı başlıklı makaleyi inceleyin.
Gradle Wrapper dosyası
Gradle sarmalayıcısı (gradlew), kaynak kodunuza dahil edilmiş ve Gradle'ı indirip başlatan küçük bir uygulamadır.
Bu sayede daha tutarlı bir derleme yürütme işlemi gerçekleşir. Geliştiriciler uygulama kaynağını indirip gradlew'ü çalıştırır. Bu işlem, gerekli Gradle dağıtımını indirir ve uygulamanızı derlemek için Gradle'i başlatır.
gradle/wrapper/gradle-wrapper.properties dosyası, derlemenizi çalıştırmak için Gradle'in hangi sürümünün kullanıldığını açıklayan distributionUrl mülkünü içerir.
settings.gradle.kts dosyası (Kotlin DSL için) veya settings.gradle dosyası (Groovy DSL için) proje dizinindeki kök klasörde bulunur. Bu ayarlar dosyası, proje düzeyinde depo ayarlarını tanımlar ve Gradle'e uygulamanızı derleyirken hangi modülleri dahil etmesi gerektiğini bildirir. Çok modüllü projelerde, nihai derlemeye dahil edilecek her modülün belirtilmesi gerekir.
Çoğu projede dosya varsayılan olarak aşağıdaki gibi görünür:
Üst düzey build.gradle.kts dosyası (Kotlin DSL için) veya build.gradle dosyası (Groovy DSL için) proje kök dizininde bulunur. Genellikle projenizdeki modüller tarafından kullanılan eklentilerin yaygın sürümlerini tanımlar.
Aşağıdaki kod örneğinde, yeni bir proje oluşturulduktan sonra üst düzey derleme komut dosyasında varsayılan ayarlar ve DSL öğeleri açıklanmaktadır:
Modül düzeyinde build.gradle.kts (Kotlin DSL için) veya build.gradle dosyası (Groovy DSL için) her project/module/ dizininde bulunur. Bu, bulunduğu belirli modül için derleme ayarlarını yapılandırmanıza olanak tanır. Bu derleme ayarlarını yapılandırmak, ek derleme türleri ve ürün varyantları gibi özel paketleme seçenekleri sunmanıza ve main/ uygulama manifest dosyasında veya üst düzey derleme komut dosyasında ayarları geçersiz kılmanıza olanak tanır.
Android SDK Ayarları
Uygulamanızın modül düzeyindeki derleme dosyası, derleme sırasında kullanılan Android SDK sürümlerini, platform davranışlarını seçmeyi ve uygulamanızın çalıştığı minimum sürümü belirtmeyi gösteren ayarları içerir.
Şekil 1. Bir derlemedeki Android SDK'ları
compileSdk
compileSdk, kaynak kodunuz derlenirken hangi Android ve Java API'lerinin kullanılabileceğini belirler. En yeni Android özelliklerini kullanmak için derleme
Her Android SDK'sı, uygulamanızda kullanılacak bir Java API alt kümesi sağlar.
Java veya Kotlin kaynak kodumda hangi Java API'lerini kullanabilirim? başlıklı makaledeki tabloda, Android SDK sürümüne göre hangi Java API düzeyinin kullanılabildiği gösterilmektedir.
Yeni Java API'leri, derlemenizde etkinleştirilmesi gereken şekerleme kaldırma işlemiyle Android'in önceki sürümlerinde desteklenir.
compileSdk dosyanız Android Studio'nun, AGP'nin veya projenizin kitaplık bağımlılık şartlarının mevcut sürümüyle çakışıyorsa Android Studio uyarı görüntüler.
minSdk
minSdk, uygulamanızın desteklemesini istediğiniz en düşük Android sürümünü belirtir. minSdk ayarı, uygulamanızı hangi cihazların yükleyebileceğini kısıtlar.
Android'in daha eski sürümlerini desteklemek için kodunuzda daha fazla koşullu kontrol veya AndroidX uyumluluk kitaplıklarının daha fazla kullanılması gerekebilir. Alt sürümleri desteklemenin bakım maliyetini, bu alt sürümleri kullanmaya devam eden kullanıcıların yüzdesine göre değerlendirmeniz gerekir. Mevcut sürüm kullanım yüzdeleri için Android Studio'nun Yeni proje sihirbazı'ndaki sürüm grafiğine bakın.
Android Studio'da kodunuzu düzenlerken veya derleme sırasında kontrolleri çalıştırırken lint, kullandığınız ve minSdk'te bulunmayan API'ler hakkında uyarı verir. Bu sorunları,
yeni özellikleri koşullu hale getirerek veya geriye dönük uyumluluk için Appcompat kullanarak düzeltmeniz gerekir.
targetSdk
targetSdk iki amaca hizmet eder:
Uygulamanızın çalışma zamanındaki davranışını belirler.
Testi hangi Android sürümüne göre yaptığınızı doğrular.
targetSdk'ünüzden daha yüksek bir Android sürümü kullanan bir cihazda uygulamanızı çalıştırırsanız Android, uygulamanızı targetSdk'ünüzde belirtilen daha düşük sürüme benzer şekilde çalışan bir uyumluluk modunda çalıştırır. Örneğin, API 23 çalışma zamanı izinleri modelini kullanıma sunarken tüm uygulamalar bu modeli hemen kullanmaya hazır değildi.
targetSdk değerini 22 olarak ayarlayarak bu uygulamalar, API 23 cihazlarda çalışma zamanında izin kullanmadan çalışabilir ve en son compileSdk sürümüne dahil edilen özellikleri kullanabilir. Google Play dağıtım politikası,
hedef API düzeyinde ek politikalar uygular.
targetSdk değeri, compileSdk değerinden küçük veya buna eşit olmalıdır.
Not:compileSdk ve targetSdk değerlerinin aynı olması gerekmez. Aşağıdaki temel ilkeleri göz önünde bulundurun:
compileSdk, yeni API'lere erişim sağlar
targetSdk, uygulamanızın çalışma zamanı davranışını belirler
targetSdk, compileSdk değerinden küçük veya buna eşit olmalıdır
Örnek uygulama modülü derleme komut dosyası
Bu örnek Android uygulama modülü derleme komut dosyası, temel DSL öğelerinin ve ayarlarının bazılarını özetler:
Gradle, kök proje dizininizde bulunan ve Gradle derleme araç setinin ayarlarını belirtmek için kullanabileceğiniz iki özellik dosyası da içerir:
gradle.properties
Burada, Gradle daemon'un maksimum yığın boyutu gibi proje genelindeki Gradle ayarlarını yapılandırabilirsiniz. Daha fazla bilgi için Derleme Ortamı başlıklı makaleyi inceleyin.
local.properties
Aşağıdakiler dahil olmak üzere derleme sistemi için yerel ortam özelliklerini yapılandırır:
ndk.dir: NDK'nın yolu. Bu özelliğin desteği sonlandırıldı. NDK'nın indirilen tüm sürümleri, Android SDK dizininin ndk dizinine yüklenir.
sdk.dir: Android SDK'sının yolu.
cmake.dir: CMake'in yolu.
ndk.symlinkdir - Android Studio 3.5 ve sonraki sürümlerde, NDK'ye yüklenen NDK yolundan daha kısa olabilecek bir sembolik bağlantı oluşturur.
NDK'yı daha kısa bir yola yeniden eşleme (yalnızca Windows)
Windows'da, yüklü NDK klasöründeki ld.exe gibi araçlar uzun yollarla sona erer. Araçlar uzun yolları iyi desteklemez.
Daha kısa bir yol oluşturmak için local.properties içinde ndk.symlinkdir mülkünü, Android Gradle eklentisinin NDK için bir sembolik bağlantı oluşturmasını isteyecek şekilde ayarlayın. Bu sembolik bağlantının yolu, mevcut NDK klasöründen daha kısa olabilir.
Örneğin, ndk.symlinkdir = C:\ şu kısayol bağlantısını oluşturur:
C:\ndk\19.0.5232133
Projeyi Gradle dosyalarıyla senkronize etme
Projenizdeki derleme yapılandırma dosyalarında değişiklik yaptığınızda Android Studio, derleme yapılandırma değişikliklerinizi içe aktarabilmesi ve yapılandırmanızın derleme hatası oluşturmadığından emin olmak için bazı kontroller yapabilmesi için proje dosyalarınızı senkronize etmenizi gerektirir.
Proje dosyalarınızı senkronize etmek için, değişiklik yaptığınızda görünen bildirim çubuğunda Şimdi Senkronize Et'i (Şekil 2'de gösterildiği gibi) veya menü çubuğundan Projeyi Senkronize Et'i tıklayın. Android Studio, yapılandırmanızda hata bulursa (örneğin, kaynak kodunuz yalnızca compileSdkVersion değerinizden daha yüksek bir API düzeyinde kullanılabilen API özelliklerini kullanıyorsa) Mesajlar penceresinde sorun açıklanır.
Şekil 2. Projeyi Android Studio'daki derleme yapılandırma dosyalarıyla senkronize edin.
Kaynak grupları
Android Studio, her modülün kaynak kodunu ve kaynaklarını mantıksal olarak kaynak kümelerine gruplandırır. Yeni bir modül oluşturduğunuzda Android Studio, modül içinde bir main/ kaynak grubu oluşturur. Bir modülün main/ kaynak grubu, tüm yapı varyantları tarafından kullanılan kod ve kaynakları içerir.
Ek kaynak kümesi dizinleri isteğe bağlıdır ve Android Studio, yeni derleme varyantlarını yapılandırdığınızda bunları sizin için otomatik olarak oluşturmaz. Ancak main/'e benzer şekilde kaynak kümeleri oluşturmak, Gradle'in yalnızca uygulamanızın belirli sürümlerini derleyeceği dosyaları ve kaynakları düzenlemenize yardımcı olur:
src/main/
Bu kaynak grubu, tüm derleme varyantlarında ortak olan kod ve kaynakları içerir.
src/buildType/
Bu kaynak kümesini, yalnızca belirli bir derleme türüne ait kod ve kaynakları içerecek şekilde oluşturun.
src/productFlavor/
Bu kaynak grubunu, yalnızca belirli bir ürün aromasına ait kod ve kaynakları içerecek şekilde oluşturun.
Not: Derlemenizi birden fazla ürün çeşidini birleştirecek şekilde yapılandırırsanız çeşidi boyutları arasında her bir ürün çeşidi kombinasyonu için kaynak kümesi dizinleri oluşturabilirsiniz:
src/productFlavor1ProductFlavor2/.
src/productFlavorBuildType/
Bu kaynak grubunu, yalnızca belirli bir derleme varyantına ait kod ve kaynakları içerecek şekilde oluşturun.
Örneğin, derleme sistemi, uygulamanızın "fullDebug" sürümünü oluşturmak için aşağıdaki kaynak gruplarındaki kod, ayar ve kaynakları birleştirir:
src/fullDebug/ (derleme varyantı kaynak grubu)
src/debug/ (derleme türü kaynak grubu)
src/full/ (ürün türü kaynak grubu)
src/main/ (ana kaynak grubu)
Not: Android Studio'da yeni bir dosya veya dizin oluşturduğunuzda, Dosya > Yeni menü seçeneklerini kullanarak dosyayı belirli bir kaynak grubu için oluşturun. Aralarından seçim yapabileceğiniz kaynak kümeleri, derleme yapılandırmalarınıza dayanır ve Android Studio, henüz mevcut değilse gerekli dizinleri otomatik olarak oluşturur.
Farklı kaynak kümeleri aynı dosyanın farklı sürümlerini içeriyorsa Gradle, kullanılacak dosyaya karar verirken aşağıdaki öncelik sırasını kullanır. Soldaki kaynak
derleme varyantı > derleme türü > ürün çeşidi > ana kaynak grubu >
kitaplık bağımlılıkları
Bu sayede Gradle, derlemeye çalıştığınız derleme varyantına özgü dosyaları kullanırken uygulamanızın diğer sürümlerinde ortak olan etkinlikleri, uygulama mantığını ve kaynakları yeniden kullanır.
Gradle, birden fazla manifest'i birleştirirken aynı öncelik sırasını kullanır. Böylece her derleme varyantı nihai manifest'te farklı bileşenler veya izinler tanımlayabilir. Özel kaynak kümesi oluşturma hakkında daha fazla bilgi edinmek için Kaynak kümesi oluşturma başlıklı makaleyi inceleyin.
Sürüm katalogları
Derlemeniz ortak bağımlılıkları olan birden fazla modül içeriyorsa veya ortak bağımlılıkları olan birden fazla bağımsız projeniz varsa ortak sürümleri belirtmek için bir sürüm kataloğu veya malzeme listesi (BOM) kullanmanızı öneririz.
Diğer derleme sistemleri
Android uygulamalarını Bazel ile derlemek mümkündür ancak bu işlem resmi olarak desteklenmemektedir. Android Studio, Bazel projelerini resmi olarak desteklemez.
Bazel ile derlemeyle ilgili mevcut sınırlamaları daha iyi anlamak için bilinen sorunlar bölümüne bakın.
Bu sayfadaki içerik ve kod örnekleri, İçerik Lisansı sayfasında açıklanan lisanslara tabidir. Java ve OpenJDK, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.