Temel modülü yapılandırın

Uygulama paketleri, APK'lardan farklı olarak cihazlara dağıtılamaz. Daha ziyade, uygulamanızın derlenmiş kod ve kaynaklarının tamamını tek bir derleme yapısında barındıran bir yayınlama biçimidir. Bu nedenle, imzalı uygulama paketinizi yüklediğinizde Google Play'in uygulamanızın APK'larını oluşturup imzalaması ve kullanıcılara sunması için gerekli tüm koşullar sağlanmış olur.

Başlayın

Çoğu uygulama projesinde Android App Bundle'ları desteklemek için çok fazla çaba harcanması gerekmez. Bunun nedeni, uygulamanızın temel APK'sı için kod ve kaynakları içeren modülün, Android Studio'da yeni bir uygulama projesi oluşturduğunuzda varsayılan olarak aldığınız standart uygulama modülü olmasıdır. Yani aşağıdaki snippet'te gösterildiği gibi application eklentisini build.gradle dosyasına uygulayan modül, uygulamanızın temel işlevleri için kod ve kaynaklar sağlar.

Modern

// The standard application plugin creates your app's base module.
plugins {
 id 'com.android.application'
}

Kotlin

plugins {
    // The standard application plugin creates your app's base module.
    id("com.android.application")
}

Temel modül, uygulamanızın temel işlevlerini sağlamanın yanı sıra uygulama projenizin tamamını etkileyen derleme yapılandırmalarının ve manifest girişlerinin çoğunu da sağlar.

Temel modül derleme yapılandırması

Mevcut uygulama projelerinin çoğunda, temel modülünüzün derleme yapılandırmasında herhangi bir değişiklik yapmanız gerekmez. Ancak uygulama projenize özellik modülleri eklemeyi düşünüyorsanız veya uygulamanızı daha önce birden fazla APK kullanarak yayınladıysanız temel modülün derleme yapılandırmasıyla ilgili dikkat etmeniz gereken bazı noktalar vardır.

Sürüm kodu ve uygulama güncellemeleri

Android App Bundle sayesinde, Google Play'e yüklediğiniz birden fazla APK'nın sürüm kodlarını yönetmeniz gerekmez. Bunun yerine, uygulamanızın temel modülünde yalnızca bir sürüm kodunu yönetirsiniz. Bu durum aşağıda gösterilmiştir:

// In your base module build.gradle file
android {
    defaultConfig {
        …
        // You specify your app's version code only in the base module.
        versionCode 5
        versionName "1.0"
    }
}

Uygulama paketinizi yükledikten sonra Google Play, temel modülünüzdeki sürüm kodunu kullanarak bu paketten oluşturduğu tüm APK'lara aynı sürüm kodunu atar. Yani bir cihaz uygulamanızı indirip yüklediğinde, o uygulamanın tüm bölünmüş APK'ları aynı sürüm kodunu paylaşır.

Uygulamanızı yeni kod veya kaynaklarla güncellemek istediğinizde uygulamanızın temel modülündeki sürüm kodunu güncellemeniz ve yeni, tam bir uygulama paketi oluşturmanız gerekir. Bu uygulama paketini Google Play'e yüklediğinizde, temel modülün belirttiği sürüm koduna göre yeni bir APK grubu oluşturulur. Daha sonra, kullanıcılar uygulamanızı güncellediğinde Google Play, cihazda yüklü olan tüm APK'ların güncellenmiş sürümlerini kullanıcılara sunar. Yani, yüklü tüm APK'lar yeni sürüm koduna güncellenir.

Dikkat edilmesi gereken diğer noktalar

  • Uygulama imzalama: Derleme dosyalarınıza imzalama bilgileri ekliyorsanız bunları yalnızca temel modülün derleme yapılandırma dosyasına eklemeniz gerekir. Daha fazla bilgi için Uygulamanızı imzalamak için Gradle'ı yapılandırma başlıklı makaleyi inceleyin.
  • Kod daraltma: Özellik modülleri de dahil olmak üzere uygulama projenizin tamamında kod daraltmayı etkinleştirmek istiyorsanız bunu temel modülün build.gradle dosyasından yapmanız gerekir. Yani bir özellik modülüne özel ProGuard kuralları ekleyebilirsiniz ancak özellik modülü derleme yapılandırmalarındaki minifyEnabled özelliği yoksayılır.
  • splits bloğu yoksayılır: Gradle, uygulama paketi oluştururken android.splits bloğundaki özellikleri yoksayar. Uygulama paketinizin hangi yapılandırma APK'sı türlerini desteklediğini kontrol etmek istiyorsanız yapılandırma APK'sı türlerini devre dışı bırakmak için android.bundle kullanın.
  • Uygulama sürümü oluşturma: Temel modül, tüm uygulama projenizin sürüm kodunu ve sürüm adını belirler. Daha fazla bilgi için Sürüm kodu ve uygulama güncellemeleri konusuna bakın.

Yapılandırma APK'sı türlerini yeniden etkinleştirme veya devre dışı bırakma

Varsayılan olarak, bir uygulama paketi oluşturduğunuzda her dil kaynağı, ekran yoğunluğu kaynağı ve ABI kitaplığı grubu için yapılandırma APK'ları oluşturulmasını destekler. Temel modülünüzün build.gradle dosyasında android.bundle bloğunu kullanarak aşağıda gösterildiği gibi bir veya daha fazla yapılandırma APK'sı türü için desteği devre dışı bırakabilirsiniz:

Modern

android {
    // When building Android App Bundles, the splits block is ignored.
    // You can remove it, unless you're going to continue to build multiple
    // APKs in parallel with the app bundle
    splits {...}

    // Instead, use the bundle block to control which types of configuration APKs
    // you want your app bundle to support.
    bundle {
        language {
            // This property is set to true by default.
            // You can specify `false` to turn off
            // generating configuration APKs for language resources.
            // These resources are instead packaged with each base and
            // feature APK.
            // Continue reading below to learn about situations when an app
            // might change setting to `false`, otherwise consider leaving
            // the default on for more optimized downloads.
            enableSplit = false
        }
        density {
            // This property is set to true by default.
            enableSplit = true
        }
        abi {
            // This property is set to true by default.
            enableSplit = true
        }
    }
}

Kotlin

android {
    // When building Android App Bundles, the splits block is ignored.
    // You can remove it, unless you're going to continue to build multiple
    // APKs in parallel with the app bundle
    splits {...}

    // Instead, use the bundle block to control which types of configuration APKs
    // you want your app bundle to support.
    bundle {
        language {
            // This property is set to true by default.
            // You can specify `false` to turn off
            // generating configuration APKs for language resources.
            // These resources are instead packaged with each base and
            // feature APK.
            // Continue reading below to learn about situations when an app
            // might change setting to `false`, otherwise consider leaving
            // the default on for more optimized downloads.
            enableSplit = false
        }
        density {
            // This property is set to true by default.
            enableSplit = true
        }
        abi {
            // This property is set to true by default.
            enableSplit = true
        }
    }
}

Dil değişikliklerini işleme

Google Play, kullanıcının cihaz ayarlarındaki dil seçimine göre uygulamayla birlikte hangi dil kaynaklarının yükleneceğini belirler. Uygulamanızı indirdikten sonra varsayılan sistem dilini değiştiren bir kullanıcı düşünün. Uygulamanız bu dili destekliyorsa cihaz, Google Play'den bu dil kaynakları için ek yapılandırma APK'ları ister ve indirir.

Uygulama içinde dil seçici sunan ve sistem düzeyindeki dil ayarından bağımsız olarak uygulamanın dilini dinamik bir şekilde değiştiren uygulamalarda, eksik kaynaklar nedeniyle kilitlenmeleri önlemek için bazı değişiklikler yapmanız gerekir. android.bundle.language.enableSplit özelliğini false olarak ayarlayın veya Ek dil kaynaklarını indirme bölümünde açıklandığı gibi Play Core kitaplığını kullanarak seç-izle dil indirme özelliğini uygulayın.