Android Gradle Plugin 3.4.0 (Nisan 2019)

Android eklentisinin bu sürümü aşağıdakileri gerektirir:

• Gradle 5.1.1 veya sonraki sürümlerden biri. Daha fazla bilgi edinmek için Gradle güncellemesinden yararlanın.

  Not: Gradle 5.0 ve sonraki sürümleri kullanırken varsayılan Gradle arka plan bellek yığını boyutu 1 GB'tan 512 MB'a düşer. Bu, derleme performansının düşmesiyle sonuçlanabilir regresyon. Bu varsayılan ayarı geçersiz kılmak için Gradle arka plan yığın boyutunu belirtme projenizin gradle.properties dosyasında yer alır.

• SDK Derleme Araçları 28.0.3 veya sonraki sürümler.

Yeni özellikler

• Yeni lint kontrolü bağımlılık yapılandırmaları: lintChecks davranışı değişti ve yeni bir bağımlılık lintPublish yapılandırmasını kullanıma sunduk. Android cihazınızda hangi lint kontrollerinin paketleneceği konusunda daha fazla kontrol sahibi olursunuz. kitaplıklar.

  • lintChecks: Bu, şu özelliklere sahip mevcut bir yapılandırmadır: Yalnızca derleme sırasında çalıştırmak istediğiniz lint kontrolleri için yerel olarak da kullanabilirsiniz. Daha önce lint dahil edilecek lintChecks bağımlılık yapılandırması AAR'de bu bağımlıları taşımanız gerekir. yerine yeni lintPublish yapılandırmasını kullanın bakın.
  • lintPublish: Kitaplıktaki bu yeni yapılandırmayı kullan ya da yayınlanan AAR'ye dahil etmek istediğiniz lint kontrollerine ilişkin projeler, aşağıda gösterildiği gibidir. Bu durumda, kitaplığınızı kullanan projeler bu lint kontrollerini de uygulayabilirsiniz.

  Aşağıdaki kod örneği, yerel Android kitaplık projesi.

  dependencies {
    // Executes lint checks from the ':lint' project at build time.
    lintChecks project(':lint')
    // Packages lint checks from the ':lintpublish' in the published AAR.
    lintPublish project(':lintpublish')
  }
          

  dependencies {
    // Executes lint checks from the ':lint' project at build time.
    lintChecks(project(":lint"))
    // Packages lint checks from the ':lintpublish' in the published AAR.
    lintPublish(project(":lintpublish"))
      }
          

  • Genel olarak, paketleme ve imzalama görevlerinin genel bir yapıya sahip olması gerekir. hız artışı. Anahtar kelime listelerinizle ilgili bir performans regresyonu lütfen hata bildiriminde bulunun.

Davranış değişiklikleri

• Android Hazır Uygulamalar Özelliği eklentisinin kullanımdan kaldırılması uyarı: com.android.feature eklentisi kullanıyorsanız Android Gradle eklentisi 3.4.0 size desteği sonlandırma uyarısı verir. Gelecekteki sürümlerinde hazır uygulamanızı geliştirmeye devam edebilmek için hazır uygulamanızı dinamik özellik eklentisini kullanıyorsanız Böylece hem yüklü hem de hazır uygulamanızı yayınlayabilirsiniz. tek bir Android App Bundle'dan denetlenmesi gerekiyor.

• R8 varsayılan olarak etkindir: R8, sadeleştirmeyi, tek bir adımda küçültme, kodu karartma, optimize etme ve ayrıştırma inç fark edilebilir derleme performansı hakkında daha fazla bilgi edinin. R8, Android Gradle eklentisi 3.3.0 ve artık hem uygulama hem de Android kitaplık projeleri için varsayılan olarak etkin eklentisi 3.4.0 veya daha yeni bir sürüm kullanarak.

Aşağıdaki resimde, derleme işlemine üst düzey bir genel bakış sunulmaktadır teste tabi tutulmuştur.

Şimdi, R8 ile, budama, sadeleştirme, küçültme, karartma, optimize etme ve dexing (D8) tümü aşağıda gösterildiği gibi tek adımda tamamlanır.

R8'in mevcut ProGuard kurallarınızla çalışacak şekilde tasarlandığını unutmayın. R8'den yararlanmak için herhangi bir işlem yapmanız gerekmeyecektir. Ancak, Çünkü bu, özel olarak tasarlanmış ProGuard'dan farklı bir teknolojidir. küçültme ve optimizasyon, kodun kaldırılmasına neden olabilir. ProGuard'da olmayabilir. Dolayısıyla, böyle bir olasılık söz konusu olduğunda bu kodu derleme çıkışınızda tutmak için ek kurallar eklemeniz gerekir.

R8'i kullanırken sorun yaşarsanız R8 uyumluluğu hakkında SSS sorununuzun bir çözümü olup olmadığını kontrol edin. Çözüm belgelenmemişse lütfen hata bildiriminde bulunun. Aşağıdaki satırlardan birini projenize ekleyerek R8'i devre dışı bırakabilirsiniz: gradle.properties dosyası:

      # Disables R8 for Android Library modules only.
      android.enableR8.libraries = false
      # Disables R8 for all modules.
      android.enableR8 = false
      
    

Not: Belirli bir derleme türünde, Uygulamanızda useProguard ile false arasında modülünün build.gradle dosyası yüklediğinizde Android Gradle eklentisi R8'i hem bu derleme türüne göre uygulamanızın kodunu küçültmek için projenizin gradle.properties dosyasında R8'i devre dışı bırakın.

• ndkCompile desteği sonlandırıldı: Artık bir derlemek için ndkBuild kullanmaya çalışırsanız derleme hatası yerel kitaplıklar var. Bunun yerine aşağıdakileri yapmak için CMake veya ndk-build C ve C++ kodunu inceleyebilirsiniz.

Bilinen sorunlar

• Benzersiz paket adlarının doğru kullanımı şu anda zorunlu kılınmamaktadır ancak eklentinin sonraki sürümlerinde daha katı olacaktır. Android'de Gradle eklentisi 3.4.0 sürümünü kullanıyorsanız, kabul edilebilir paket isimleri bildirdiği için aşağıdaki satırı gradle.properties dosyanız.

            android.uniquePackageNames = true
            
          

  Android Gradle ile paket adı ayarlama hakkında daha fazla bilgi edinmek için eklentisine göz atın Uygulama kimliğini ayarlayın.