Android Gradle Eklentisi 4.2.0 (Mart 2021)

Uyumluluk

Yeni özellikler

Android Gradle eklentisinin bu sürümü aşağıdaki yeni özellikleri içerir.

Varsayılan olarak Java dili sürüm 8

Sürüm 4.2'den itibaren, AGP varsayılan olarak Java 8 dil düzeyini kullanacaktır. Java 8; lambda ifadeleri, yöntem referansları ve statik arayüz yöntemleri dahil olmak üzere bir dizi yeni dil özelliğine erişim sağlar. Desteklenen özelliklerin tam listesi için Java 8 belgelerine bakın.

Eski davranışı korumak için modül düzeyindeki build.gradle.kts veya build.gradle dosyanızda Java 7'yi açıkça belirtin:

// build.gradle
android {
  ...
  compileOptions {
    sourceCompatibility JavaVersion.VERSION_1_7
    targetCompatibility JavaVersion.VERSION_1_7
  }
  // For Kotlin projects, compile to Java 6 instead of 7
  kotlinOptions {
    jvmTarget = "1.6"
  }
}

// build.gradle.kts
android {
  ...
  compileOptions {
    sourceCompatibility = JavaVersion.VERSION_1_7
    targetCompatibility = JavaVersion.VERSION_1_7
  }
  // For Kotlin projects, compile to Java 6 instead of 7
  kotlinOptions {
    jvmTarget = "1.6"
  }
}

Yeni JVM kaynak derleyicisi

Android Gradle eklentisi 4.2 aracındaki yeni JVM kaynak derleyicisi, AAPT2 kaynak derleyicisinin bazı bölümlerini değiştirerek özellikle Windows makinelerde derleme performansını iyileştirebilir. Yeni JVM kaynak derleyici varsayılan olarak etkindir.

v3 ve v4 imzalama artık destekleniyor

Android Gradle Eklentisi 4.2 artık APK v3'ü destekliyor ve APK v4 imzalama biçimlerine göz atın. Derlemenizde bu biçimlerden birini veya ikisini birden etkinleştirmek için modül düzeyindeki build.gradle veya build.gradle.kts dosyanıza aşağıdaki özellikleri ekleyin:

// build.gradle
android {
  ...
  signingConfigs {
    config {
        ...
        enableV3Signing true
        enableV4Signing true
    }
  }
}

// build.gradle.kts
android {
  ...
  signingConfigs {
      config {
          ...
          enableV3Signing = true
          enableV4Signing = true
      }
  }
}

APK v4 imzalama özelliği, ADB aracını kullanarak büyük APK'ları hızlı bir şekilde dağıtmanıza olanak tanır. artımlı APK yüklemesi Android 11. Bu yeni işaret, dağıtımdaki APK imzalama adımını halleder bahsedeceğim.

Uygulama imzalamayı varyant başına yapılandırma

Artık Android Gradle'da uygulama imzalamayı etkinleştirmek veya devre dışı bırakmak mümkün eklemeniz gerekir.

Bu örnekte, Kotlin veya Groovy'da onVariants() yöntemi kullanılarak uygulama imzalamanın varyant başına nasıl ayarlanacağı gösterilmektedir:

androidComponents {
    onVariants(selector().withName("fooDebug"), {
        signingConfig.enableV1Signing.set(false)
        signingConfig.enableV2Signing.set(true)
    })

Yeni Gradle özelliği: android.native.buildOutput.

AGP 4.2, derleme çıkışındaki dağınıklığı azaltmak için CMake ve ndk-build kullanan yerel derlemelerdeki mesajları filtreler ve varsayılan olarak yalnızca C/C++ derleyici çıkışını gösterir. Önceden, bir çıktı satırı her dosya için ayrı olarak üretildi ve bu da çok miktarda düşünebilirsiniz.

Yerel çıktının tamamını görmek istiyorsanız yeni Gradle mülkü android.native.buildOutput'ü verbose olarak ayarlayın.

Bu özelliği gradle.properties dosyasında veya komut satırından erişebilirsiniz.

gradle.properties
android.native.buildOutput=verbose

Komut satırı
-Pandroid.native.buildOutput=verbose

Bu özelliğin varsayılan değeri: quiet.

gradle.properties dosyaları için davranış değişikliği

AGP 4.2'den itibaren Gradle özelliklerini geçersiz kılmak artık mümkün değildir alt projelerde kullanılabilir. Diğer bir deyişle, gradle.properties dosyası, kök yerine bir alt projede yoksa yoksayılır.

Örneğin, önceki sürümlerde AGP, <var>projectDir</var>/gradle.properties <var>projectDir</var>/app/gradle.properties, <var>projectDir</var>/library/gradle.properties uygulama modülleri için de aynı Gradle mülkü her iki <var>projectDir</var>/gradle.properties. ve <var>projectDir</var>/app/gradle.properties, değeri <var>projectDir</var>/app/gradle.properties öncelikli hale gelecektir.

AGP 4.2'de bu davranış değiştirilmiştir ve AGP, Alt projelerde gradle.properties (ör. <var>projectDir</var>/app/gradle.properties) bilgileri gösterilir. Bu değişiklik, yeni Gradle davranışı ve özellikleri yapılandırmayı önbelleğe alma

gradle.properties ürününde değer ayarlama hakkında daha fazla bilgi hakkında daha fazla bilgi edinmek için Gradle dokümanları.

Gradle uyumluluğu ve yapılandırma değişiklikleri

Gradle derleme aracı, Android Studio'da çalışırken Studio'nun paket halinde sunulan JDK'sini kullanır. Önceki sürümlerde JDK 8, Studio ile birlikte sunuluyordu. Ancak 4.2'de bunun yerine JDK 11 paketlenmiştir. Gradle'i çalıştırmak için yeni paketlenmiş JDK kullanıldığında bu durum bazı uyumsuzluklara neden olabilir veya çöp toplayıcıdaki değişiklikler nedeniyle JVM performansını etkileyebilir. Bu sorunlar aşağıda açıklanmıştır.

Studio'nun Android Gradle eklentisiyle (AGP) uyumluluğu

Android Studio 4.2, AGP'de Gradle 4.8.1 ve sonraki sürümlerin çalıştırıldığı durumlarda AGP 3.1 ve sonraki sürümleri kullanan projeleri açabilir. Daha fazla Gradle uyumluluğu hakkında bilgi için bkz. Gradle'ı güncelleyin.

Gradle derlemelerini JDK 11 için optimize etme

JDK 11'e yapılan bu güncelleme, JVM çöp kutusunun varsayılan yapılandırmasını etkiler çünkü JDK 8 paralel çöp toplayıcı kullanırken JDK 11 G1 çöp toplayıcı.

Derleme performansını artırabilmek için Gradle derlemelerinizi test ederek yardımcı olur. gradle.properties içinde şunları ayarlayın:

org.gradle.jvmargs=-XX:+UseParallelGC

Bu alanda halihazırda ayarlanmış başka seçenekler varsa yeni bir seçenek ekleyin:

org.gradle.jvmargs=-Xmx1536m -XX:+UseParallelGC

Farklı yapılandırmalarla derleme hızını ölçmek için Derlemenizi profilleme başlıklı makaleyi inceleyin.

minSdk = 28 veya daha yüksek olduğunda APK'larda sıkıştırılmamış DEX dosyaları

AGP artık DEX dosyalarını minSdk = 28 veya daha yüksek olabilir. Bu, APK boyutunda artışa neden olur ancak cihazdaki yükleme boyutunu küçültür ve indirme boyutu yaklaşık olarak aynı kalır.

AGP'nin sıkıştırılmış DEX dosyalarını paketlemeye zorlamak için build.gradle dosyanıza eklenecek:

android {
    packagingOptions {
        dex {
            useLegacyPackaging true
        }
    }
}

Sıkıştırılmış yerel kitaplıkları paketlemek için DSL'yi kullanma

Yerel kitaplıkları sıkıştırılmamış biçimde paketlemenizi öneririz. Bu, uygulama yükleme boyutunun ve uygulama indirme boyutunun küçülmesine ve kullanıcılarınız için uygulama yükleme süresinin kısalmasına neden olur. Ancak Android Gradle eklentisinin, uygulamanızı derleyip sıkıştırılmış yerel kitaplıkları paketlemesini istiyorsanız uygulamanızın build.gradle dosyasında useLegacyPackaging değerini true olarak ayarlayın:

android {
    packagingOptions {
        jniLibs {
            useLegacyPackaging true
        }
    }
}

useLegacyPackaging işareti, extractNativeLibs manifest özelliğinin yerini alır. Daha fazla bilgi için Varsayılan olarak sıkıştırılmamış şekilde paketlenmiş yerel kitaplıklar sürüm notuna bakın.