Android Gradle Plugin 8.1.0 (Temmuz 2023)

Android Gradle eklentisi 8.1.0, çeşitli yeni özellikler ve iyileştirmeler içeren önemli bir sürümdür.

Uyumluluk

Kotlin DSL, derleme yapılandırması için varsayılandır

Yeni projelerde artık derleme yapılandırması için varsayılan olarak Kotlin DSL (build.gradle.kts) kullanılıyor. Bu, Groovy DSL'ye (build.gradle) kıyasla söz dizimi vurgulama, kod tamamlama ve bildirimlere gitme gibi özelliklerle daha iyi bir düzenleme deneyimi sunar. AGP 8.1 ve derleme yapılandırması için Kotlin DSL'yi kullanıyorsanız en iyi deneyim için Gradle 8.1'i kullanmanız gerektiğini unutmayın. Daha fazla bilgi edinmek için Kotlin DSL taşıma kılavuzuna bakın.

Uygulamaya özgü otomatik dil desteği

Android Studio Giraffe Canary 7 ve AGP 8.1.0-alpha07'den itibaren uygulamanızı uygulama başına dil tercihlerini otomatik olarak destekleyecek şekilde yapılandırabilirsiniz. Android Gradle eklentisi, proje kaynaklarınıza göre LocaleConfig dosyasını oluşturur ve son manifest dosyasına bu dosyayla ilgili bir referans ekler. Böylece, bu işlemi artık manuel olarak yapmanız gerekmez. AGP, res dosyasında hangi yerel ayarların yer alacağını belirlemek için uygulama modüllerinizin res klasörlerindeki kaynakları ve kitaplık modülü bağımlılıklarını kullanır.LocaleConfig

Uygulama başına otomatik dil özelliğinin, Android 13 (API düzeyi 33) veya sonraki sürümlerde çalışan uygulamaları desteklediğini unutmayın. Bu özelliği kullanmak için compileSdkVersion değerini 33 veya daha yüksek bir değere ayarlamanız gerekir. Android'in önceki sürümlerinde uygulamaya özgü dil tercihlerini yapılandırmak için API'leri ve uygulama içi dil seçicileri kullanmaya devam etmeniz gerekir.

Uygulama bazında otomatik dil desteğini etkinleştirmek için varsayılan bir yerel ayar belirtin:

1. Uygulama modülünün res klasöründe resources.properties adlı yeni bir dosya oluşturun.

2. resources.properties dosyasında, unqualifiedResLocale etiketiyle varsayılan yerel ayarı belirleyin. Yerel ayar adlarını oluşturmak için dil kodunu isteğe bağlı olarak komut dosyası ve bölge kodlarıyla birleştirin. Her bir kodu tireyle ayırın:

   • Dil: İki veya üç harfli ISO 639-1 kodunu kullanın.
   • Alfabe (isteğe bağlı): ISO 15924 kodunu kullanın.
   • Bölge (isteğe bağlı): İki harfli ISO 3166-1-alpha-2 kodu veya üç haneli UN_M.49 kodunu kullanın.

   Örneğin, varsayılan yerel ayarınız Amerikan İngilizcesi ise:

       unqualifiedResLocale=en-US
       

AGP, values-* dizinlerini kullanarak bu varsayılan yerel ayarı ve belirttiğiniz tüm alternatif yerel ayarları, otomatik olarak oluşturulan LocaleConfig dosyasına ekler.res

Uygulama bazında otomatik dil desteği varsayılan olarak devre dışıdır. Özelliği etkinleştirmek için modül düzeyindeki build.gradle.kts dosyasının (Groovy kullanıyorsanız build.gradle dosyası) androidResources {} bloğunda generateLocaleConfig ayarını kullanın:

android {
  androidResources {
    generateLocaleConfig = true
  }
}

android {
  androidResources {
    generateLocaleConfig true
  }
}

Android Lint, JVM 17'yi hedefleyen bayt kodu içeriyor

AGP 8.1.0-alpha04'ten itibaren Android Lint, JVM 17'yi hedefleyen bayt kodu içerir. Özel lint kontrolleri yazarsanız JDK 17 veya daha yeni bir sürümle derleme yapmanız ve Kotlin derleyici seçeneklerinizde jvmTarget = '17' belirtmeniz gerekir.

Lint aracı hakkında daha fazla bilgi edinmek için Kodunuzu lint kontrolleriyle iyileştirme başlıklı makaleyi inceleyin.

Yerel kitaplık sıkıştırma ayarı DSL'ye taşındı

AGP 8.1.0-alpha10'dan itibaren, yerel kitaplık sıkıştırmasını manifest yerine DSL kullanarak yapılandırmazsanız uyarı alırsınız. Aşağıdaki yönergelerde, yapılandırmanızı DSL'yi kullanacak şekilde nasıl güncelleyeceğiniz açıklanmaktadır. Bu güncellemeleri yapma konusunda yardım almak için AGP Yükseltme Asistanı'nı (Araçlar > AGP Yükseltme Asistanı) kullanın.

Sıkıştırılmamış yerel kitaplıkları kullanmak için manifest dosyasından android::extractNativeLibs özelliğini kaldırın ve modül düzeyindeki build.gradle.kts dosyasına (Groovy kullanıyorsanız build.gradle dosyası) aşağıdaki kodu ekleyin:

android {
  packagingOptions {
    jniLibs {
      useLegacyPackaging = false
    }
  }
}

android {
  packagingOptions {
    jniLibs {
      useLegacyPackaging false
    }
  }
}

Deneysel derleme işaretleri

Bunlar, AGP 8.1'de kullanılabilen derlemenizi yapılandırmaya yönelik deneysel işaretlerdir.

Çözülen sorunlar

Android Gradle eklentisi 8.1.0

Android Gradle eklentisi 8.1.1

Android Gradle eklentisi 8.1.2

Android Gradle eklentisi 8.1.3

Android Gradle eklentisi 8.1.4