Play Feature Delivery'ye genel bakış

Google Play'in uygulama yayınlama modeli, her kullanıcının cihaz yapılandırması için optimize edilmiş APK'lar oluşturmak ve yayınlamak üzere Android App Bundle'ı kullanır. Böylece kullanıcılar, uygulamanızı çalıştırmak için yalnızca ihtiyaç duydukları kodu ve kaynakları indirir.

Play Feature Delivery, uygulama paketlerinin gelişmiş özelliklerini kullanarak uygulamanızın belirli özelliklerinin koşullu olarak yayınlanmasına veya isteğe bağlı olarak indirilmesine olanak tanır. Bunu yapmak için öncelikle bu özellikleri temel uygulamanızdan ayırarak özellik modüllerine dönüştürmeniz gerekir.

Özellik modülü derleme yapılandırması

Android Studio'yu kullanarak yeni bir özellik modülü oluşturduğunuzda IDE, modülün build.gradle dosyasına aşağıdaki Gradle eklentisini uygular.

// The following applies the dynamic-feature plugin to your feature module.
// The plugin includes the Gradle tasks and properties required to configure and build
// an app bundle that includes your feature module.

plugins {
  id 'com.android.dynamic-feature'
}

Standart uygulama eklentisinde kullanılabilen özelliklerin çoğu, özellik modülünüzde de kullanılabilir. Aşağıdaki bölümlerde, özellik modülünüzün derleme yapılandırmasına eklemeniz ve eklememeniz gereken özellikler açıklanmaktadır.

Özellik modülü derleme yapılandırmasına dahil edilmemesi gerekenler

Her özellik modülü temel modüle bağlı olduğundan belirli yapılandırmaları da devralır. Bu nedenle, özellik modülünün build.gradle dosyasında aşağıdakileri atlamanız gerekir:

• İmzalama yapılandırmaları: Uygulama paketleri, temel modülde belirttiğiniz imzalama yapılandırmaları kullanılarak imzalanır.
• minifyEnabled özelliği: Yalnızca temel modülün derleme yapılandırmasından uygulama projenizin tamamı için kod küçültmeyi etkinleştirebilirsiniz. Bu nedenle, bu özelliği özellik modüllerinden çıkarmanız gerekir. Ancak her özellik modülü için ek ProGuard kuralları belirleyebilirsiniz.
• versionCode ve versionName: Gradle, uygulama paketinizi oluştururken temel modülün sağladığı uygulama sürümü bilgilerini kullanır. Bu özellikleri özellik modülünüzün build.gradle dosyasından çıkarmanız gerekir.

Temel modülle ilişki oluşturma

Android Studio, özellik modülünüzü oluştururken aşağıdaki örnekte gösterildiği gibi temel modülün build.gradle dosyasına android.dynamicFeatures özelliğini ekleyerek özellik modülünüzü temel modül için görünür hale getirir:

// In the base module’s build.gradle file.
android {
    ...
    // Specifies feature modules that have a dependency on
    // this base module.
    dynamicFeatures = [":dynamic_feature", ":dynamic_feature2"]
}

Ayrıca, Android Studio, temel modülü özellik modülünün bağımlılığı olarak içerir. Bu durum aşağıda gösterilmiştir:

// In the feature module’s build.gradle file:
...
dependencies {
    ...
    // Declares a dependency on the base module, ':app'.
    implementation project(':app')
}

Ek ProGuard kurallarını belirtme

Uygulama projeniz için kod küçültmeyi yalnızca temel modülün derleme yapılandırması etkinleştirebilir. Ancak aşağıdaki örnekte gösterildiği gibi, proguardFiles özelliğini kullanarak her özellik modülüyle özel ProGuard kuralları sağlayabilirsiniz.

android.buildTypes {
     release {
         // You must use the following property to specify additional ProGuard
         // rules for feature modules.
         proguardFiles 'proguard-rules-dynamic-features.pro'
     }
}

Bu ProGuard kurallarının, derleme sırasında diğer modüllerden (temel modül dahil) gelen kurallarla birleştirildiğini unutmayın. Bu nedenle, her özellik modülü yeni bir kural grubu belirtebilir ancak bu kurallar uygulama projesindeki tüm modüller için geçerlidir.

Uygulamanızı dağıtma

Özellik modüllerini destekleyen bir uygulama geliştirirken menü çubuğundan Run > Run'ı seçerek (veya araç çubuğunda Run'ı tıklayarak) uygulamanızı normalde yaptığınız gibi bağlı bir cihaza dağıtabilirsiniz.

Uygulama projeniz bir veya daha fazla özellik modülü içeriyorsa mevcut çalıştırma/hata ayıklama yapılandırmanızı aşağıdaki şekilde değiştirerek uygulamanızı dağıtırken hangi özelliklerin dahil edileceğini seçebilirsiniz:

1. Menü çubuğundan Run > Edit Configurations'ı (Çalıştır > Yapılandırmaları Düzenle) seçin.
2. Run/Debug Configurations (Çalıştırma/Hata Ayıklama Yapılandırmaları) iletişim kutusunun sol panelinden istediğiniz Android App (Android Uygulaması) yapılandırmasını seçin.
3. Genel sekmesindeki Dağıtılacak dinamik özellikler bölümünde, uygulamanızı dağıtırken eklemek istediğiniz her özellik modülünün yanındaki kutuyu işaretleyin.
4. Tamam'ı tıklayın.

Android Studio, uygulamanızı dağıtmak için varsayılan olarak uygulama paketlerini kullanmaz. Bunun yerine, IDE, APK boyutundan ziyade dağıtım hızı için optimize edilmiş APK'lar oluşturup cihazınıza yükler. Android Studio'yu uygulama paketinden APK'lar ve hazır uygulama deneyimleri oluşturup dağıtacak şekilde yapılandırmak için çalıştırma/hata ayıklama yapılandırmanızı değiştirin.

Özel dağıtım için özellik modüllerini kullanma

Özellik modüllerinin benzersiz bir avantajı, uygulamanızın farklı özelliklerinin Android 5.0 (API düzeyi 21) veya sonraki sürümleri çalıştıran cihazlara nasıl ve ne zaman indirileceğini özelleştirebilme olanağıdır. Örneğin, uygulamanızın ilk indirme boyutunu küçültmek için bazı özellikleri isteğe bağlı olarak gerektiğinde indirilmek üzere veya yalnızca belirli işlevleri destekleyen cihazlar tarafından indirilecek şekilde yapılandırabilirsiniz. Bu işlevler arasında fotoğraf çekme veya artırılmış gerçeklik özelliklerini destekleme yer alır.

Uygulamanızı uygulama paketi olarak yüklediğinizde varsayılan olarak son derece optimize edilmiş indirmeler elde etseniz de daha gelişmiş ve özelleştirilebilir özellik dağıtım seçenekleri için uygulamanızın özelliklerinin özellik modülleri kullanılarak ek yapılandırılması ve modülerleştirilmesi gerekir. Yani özellik modülleri, her biri gerektiğinde indirilebilecek şekilde yapılandırabileceğiniz modüler özellikler oluşturmak için yapı taşları sağlar.

Kullanıcılarınızın online pazar yerinde ürün alıp satmasına olanak tanıyan bir uygulamayı ele alalım. Uygulamanın aşağıdaki işlevlerinin her birini makul bir şekilde ayrı özellik modüllerine ayırabilirsiniz:

• Hesap oluşturma ve hesaba giriş
• Marketplace'e göz atma
• Satışa sunulan öğeler
• Ödemeleri işleme

Aşağıdaki tabloda, özellik modüllerinin desteklediği farklı yayın seçenekleri ve bunların örnek pazar yeri uygulamasının ilk indirme boyutunu optimize etmek için nasıl kullanılabileceği açıklanmaktadır.

Kaynak için URI oluşturma

Bir URI kullanarak özellik modülünde depolanan bir kaynağa erişmek istiyorsanız Uri.Builder() kullanarak özellik modülü kaynak URI'si oluşturma adımlarını aşağıda bulabilirsiniz:

val uri = Uri.Builder()
                .scheme(ContentResolver.SCHEME_ANDROID_RESOURCE)
                .authority(context.getPackageName()) // Look up the resources in the application with its splits loaded
                .appendPath(resources.getResourceTypeName(resId))
                .appendPath(String.format("%s:%s",
                  resources.getResourcePackageName(resId), // Look up the dynamic resource in the split namespace.
                  resources.getResourceEntryName(resId)
                  ))
                .build()

String uri = Uri.Builder()
                .scheme(ContentResolver.SCHEME_ANDROID_RESOURCE)
                .authority(context.getPackageName()) // Look up the resources in the application with its splits loaded
                .appendPath(resources.getResourceTypeName(resId))
                .appendPath(String.format("%s:%s",
                  resources.getResourcePackageName(resId), // Look up the dynamic resource in the split namespace.
                  resources.getResourceEntryName(resId)
                  ))
                .build().toString();

Kaynağa giden yolun her bir kısmı çalışma zamanında oluşturulur. Bu sayede, bölünmüş APK'lar yüklendikten sonra doğru ad alanının oluşturulması sağlanır.

URI'nin nasıl oluşturulduğuna dair bir örnek olarak, aşağıdaki adlara sahip bir uygulamanız ve özellik modülleriniz olduğunu varsayalım:

• Uygulama paketi adı: com.example.my_app_package
• Özelliğin kaynak paketinin adı: com.example.my_app_package.my_dynamic_feature

Yukarıdaki kod snippet'indeki resId, özellik modülünüzde "my_video" adlı bir ham dosya kaynağını ifade ediyorsa yukarıdaki resId kodu aşağıdaki çıktıyı verir:Uri.Builder()

android.resource://com.example.my_app_package/raw/com.example.my_app_package.my_dynamic_feature:my_video

Bu URI, özellik modülünün kaynağına erişmek için uygulamanız tarafından kullanılabilir.

URI'nizdeki yolları doğrulamak için APK Analiz Aracı'nı kullanarak özellik modülü APK'nızı inceleyebilir ve paket adını belirleyebilirsiniz:

Özellik modülleriyle ilgili dikkat edilmesi gereken noktalar

Özellik modülleriyle derleme hızını ve mühendislik hızını artırabilir, uygulamanızın özelliklerinin teslimini kapsamlı bir şekilde özelleştirerek uygulamanızın boyutunu küçültebilirsiniz. Ancak özellik modüllerini kullanırken aklınızda bulundurmanız gereken bazı kısıtlamalar ve uç durumlar vardır:

• Tek bir cihaza koşullu veya isteğe bağlı yayınlama yoluyla 50 ya da daha fazla özellik modülü yüklemek performans sorunlarına yol açabilir. Kaldırılabilir olarak yapılandırılmayan yükleme sırasında yayınlanan modüller, temel modüle otomatik olarak dahil edilir ve her cihazda yalnızca bir özellik modülü olarak sayılır.
• Yükleme zamanında teslim için kaldırılabilir olarak yapılandırdığınız modül sayısını 10 veya daha az olacak şekilde sınırlayın. Aksi takdirde, uygulamanızın indirme ve yükleme süresi artabilir.
• İsteğe bağlı özelliklerin indirilmesi ve yüklenmesi yalnızca Android 5.0 (API düzeyi 21) ve sonraki sürümlerin yüklü olduğu cihazlarda desteklenir. Özelliğinizi Android'in önceki sürümlerinde kullanıma sunmak için özellik modülü oluştururken birleştirme seçeneğini etkinleştirin.
• Uygulamanızın, isteğe bağlı olarak sunulan indirilen özellik modüllerine erişebilmesi için SplitCompat'i etkinleştirin.
• Özellik modülleri, manifest dosyalarında android:exported değeri true olarak ayarlanmış etkinlikler belirtmemelidir. Bunun nedeni, başka bir uygulama etkinliği başlatmaya çalıştığında cihazın özellik modülünü indirdiğinin garanti edilmemesidir. Ayrıca, uygulamanız koduna ve kaynaklarına erişmeye çalışmadan önce bir özelliğin indirildiğini onaylamalıdır. Daha fazla bilgi için Yüklü modülleri yönetme başlıklı makaleyi inceleyin.
• Play Özellik Dağıtımı, uygulamanızı bir uygulama paketi kullanarak yayınlamanızı gerektirdiğinden uygulama paketiyle ilgili bilinen sorunlar hakkında bilgi sahibi olduğunuzdan emin olun.

Özellik modülü manifest referansı

Android Studio'yu kullanarak yeni bir özellik modülü oluşturduğunuzda IDE, modülün özellik modülü gibi davranması için gereken manifest özelliklerinin çoğunu içerir. Ayrıca, bazı özellikler derleme sırasında derleme sistemi tarafından yerleştirilir. Bu nedenle, bunları kendiniz belirtmeniz veya değiştirmeniz gerekmez. Aşağıdaki tabloda, özellik modülleri için önemli olan manifest özellikleri açıklanmaktadır.

Ek kaynaklar

Özellik modüllerini kullanma hakkında daha fazla bilgi edinmek için aşağıdaki kaynakları inceleyin.

Blog yayınları

• Uygulama ve oyun geliştirmenize, sunmanıza ve işinizi Google Play'de büyütmenize yardımcı olacak yeni özellikler
• Ek dil API'si de dahil olmak üzere en son Android App Bundle güncellemeleri
• Patchwork Plaid :  Bir modülerleştirme hikayesi

Videolar

• Uygulama paketi ile özelleştirilebilir yayınlama ve test sürümlerinin kolay paylaşımı
• Uygulamanızın boyutunu optimize etmenize ve Google Play'deki yükleme sayısını artırmanıza yardımcı olacak yeni araçlar

Hizmet şartları ve veri güvenliği

Play Feature Delivery Library'ye erişerek veya bu kitaplığı kullanarak Play Core Software Development Kit Hizmet Şartları'nı kabul etmiş olursunuz. Lütfen kitaplığa erişmeden önce geçerli tüm şartları ve politikaları okuyup anlayın.

Veri Güvenliği

Play Core kitaplıkları, uygulamanızın Google Play Store ile çalışma zamanı arayüzüdür. Bu nedenle, uygulamanızda Play Core'u kullandığınızda Play Store, Google Play Hizmet Şartları'na göre yönetilen verilerin işlenmesi de dahil olmak üzere kendi işlemlerini yürütür. Aşağıdaki bilgilerde, Play Core kitaplıklarının uygulamanızdan gelen belirli istekleri işlemek için verileri nasıl kullandığı açıklanmaktadır.

Ek dil API'si

Play Özellik Dağıtımı

Olabildiğince şeffaf olmayı hedeflesek de uygulamanızın kullanıcı verilerini toplama, paylaşma ve güvenlikle ilgili yaklaşımı hakkında Google Play'in Veri Güvenliği bölümü formuna nasıl yanıt vereceğinize karar vermek tamamen sizin sorumluluğunuzdadır.