Play Feature Delivery'ye genel bakış

Google Play'in uygulama sunma modeli, her kullanıcının cihaz yapılandırmasına göre optimize edilmiş APK'lar oluşturmak ve yayınlamak için Android Uygulama Paketleri'ni kullanır. Böylece, kullanıcılar yalnızca uygulamanızı çalıştırmak için ihtiyaç duydukları kodu ve kaynakları indirir.

Play Özellik Dağıtımı, uygulama paketlerinin gelişmiş özelliklerini kullanarak uygulamanızın belirli özelliklerinin koşullu olarak sunulmasına veya isteğe bağlı olarak indirilmesine olanak tanır. Bunu yapmak için önce bu özellikleri temel uygulamanızdan özellik modüllerine ayırmanız gerekir.

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

Android Studio'yu kullanarak yeni bir özellik modülü oluşturduğunuzda, IDE aşağıdaki Gradle eklentisini modülün build.gradle dosyasına 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ünde 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 tüm uygulama projeniz için kod daraltma özelliğini etkinleştirebilirsiniz. Bu nedenle, bu özelliği özellik modüllerinden çıkarmalısınız. Ancak, her özellik modülü için ek ProGuard kuralları belirtebilirsiniz.
• 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 kurun

Android Studio özellik modülünüzü oluşturduğunda, aşağıda gösterildiği gibi android.dynamicFeatures özelliğini temel modülün build.gradle dosyasına ekleyerek temel modüle 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 aşağıda gösterildiği gibi, temel modülü özellik modülünün bağımlılığı olarak içerir:

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

Ek ProGuard kuralları belirtin

Uygulama projeniz için kod daraltmayı yalnızca temel modülün derleme yapılandırması etkinleştirebilecek olsa da, aşağıda gösterildiği gibi proguardFiles özelliğini kullanarak her bir özellik modülünde ö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, oluşturma sırasında diğer modüllerdeki (temel modül dahil) 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çerli olur.

Uygulamanızı dağıtma

Uygulamanızı özellik modüllerini destekleyen bir şekilde geliştirirken, menü çubuğundan Çalıştır > Çalıştır'ı seçerek (veya araç çubuğundaki Çalıştır'ı 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 gibi değiştirerek uygulamanızı dağıtırken hangi özelliklerin dahil edileceğini seçebilirsiniz:

1. Menü çubuğundan Çalıştır > Yapılandırmaları Düzenle'yi seçin.
2. Çalıştır/Hata Ayıklama Yapılandırmaları iletişim kutusunun sol panelinden istediğiniz 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.

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

Özel yayınlama 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ştirebilmenizi sağlamasıdır. Örneğin, uygulamanızın ilk indirme boyutunu küçültmek için belirli özellikleri gerektiğinde isteğe bağlı olarak veya yalnızca resim çekebilme ya da artırılmış gerçeklik özelliklerini destekleme gibi belirli özellikleri destekleyen cihazlar tarafından indirilecek şekilde yapılandırabilirsiniz.

Uygulamanızı bir uygulama paketi olarak yüklediğinizde varsayılan olarak yüksek düzeyde optimize edilmiş indirmeler elde edersiniz. Ancak daha gelişmiş ve özelleştirilebilir özellik sunma seçenekleri, özellik modüllerini kullanarak uygulama özelliklerinin ek yapılandırılmasını ve modülerleştirilmesini gerektirir. Yani özellik modülleri, her biri gerektiğinde indirilecek şekilde yapılandırabileceğiniz modüler özellikler oluşturmak için yapı taşları sağlar.

Kullanıcılarınızın internetteki bir pazar yerinde ürün alıp satmasına olanak tanıyan bir uygulama düşünün. Uygulamanın aşağıdaki işlevlerinin her birini, ayrı özellik modülleri halinde makul ölçüde modüler hale getirebilirsiniz:

• Hesaba giriş ve hesap oluşturma
• Marketplace'e göz atma
• Ürünü satışa verme
• Ödemeleri işleme koyma

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

Bir kaynak için URI oluşturma

URI kullanarak bir özellik modülünde depolanan kaynağa erişmek istiyorsanız Uri.Builder() ile özellik modülü kaynak URI'si oluşturmak için aşağıdaki adımları uygulayın:

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 bölümü çalışma zamanında oluşturulur. Böylece, bölünmüş APK'lar yüklendikten sonra doğru ad alanı oluşturulur.

URI'nın nasıl oluşturulduğuna ilişkin bir örnek olarak aşağıdaki adlara sahip bir uygulama ve özellik modülleriniz olduğunu varsayalım:

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

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

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

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

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

2. Şekil. Derlenmiş bir kaynak dosyasında paket adını incelemek için APK Analiz Aracı'nı kullanın.

Ö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 boyutunu küçültmek için uygulama özelliklerinin sunumunu büyük ölçüde özelleştirebilirsiniz. Ancak özellik modüllerini kullanırken unutulmaması gereken bazı kısıtlamalar ve uç durumlar vardır:

• Koşullu veya isteğe bağlı yayınlama yoluyla tek bir cihaza 50 veya daha fazla özellik modülü yüklemek performans sorunlarına neden olabilir. Çıkarılabilir olarak yapılandırılmamış yükleme süresi modülleri, temel modüle otomatik olarak dahil edilir ve her cihazda yalnızca bir özellik modülü olarak sayılır.
• Yükleme anında teslim için kaldırılabilir olarak yapılandırdığınız modüllerin sayısını en fazla 10 tane olacak şekilde sınırlandırın. Aksi takdirde, uygulamanızın indirme ve yükleme süresi artabilir.
• Yalnızca Android 5.0 (API düzeyi 21) ve sonraki sürümleri çalıştıran cihazlar isteğe bağlı özelliklerin indirilmesini ve yüklenmesini destekler. Özelliğinizi Android'in önceki sürümlerinde kullanılabilir hale getirmek için bir özellik modülü oluştururken Kaynaştırma'yı etkinleştirin.
• Uygulamanızın isteğe bağlı sunulan indirilen özellik modüllerine erişebilmesi için SplitCompat'ı etkinleştirin.
• Özellik modülleri, android:exported ayarı true olarak belirlenmiş manifest dosyalarında etkinlikleri 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 edinmek için Yüklü modülleri yönetme konulu makaleyi inceleyin.
• Play Özellik Dağıtımı, uygulamanızı bir uygulama paketi kullanarak yayınlamanızı gerektirdiğinden uygulama paketi ile ilgili bilinen sorunları bildiğinizden emin olun.

Özellik modülü manifest referansı

Android Studio kullanarak yeni bir özellik modülü oluştururken 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 eklendiğinden bunları sizin 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ı deneyin.

Blog yayınları

• Google Play'de işinizi geliştirmenize, yayınlamanıza ve büyütmenize yardımcı olacak yeni özellikler
• Ek diller API'sini de içeren en son Android App Bundle güncellemeleri
• Patchwork Plaid: Bir modülerleştirme hikayesi

Videolar

• Uygulama Paketi ile Özelleştirilebilir Yayınlama ve Test Derlemelerinin Kolay Paylaşımı
• Uygulamanızın Boyutunu Optimize Etmek ve Google Play'deki Yükleme Sayısını Artırmak için Yeni Araçlar

Hizmet Şartları ve veri güvenliği

Play Özellik Dağıtım Kitaplığı'na erişerek veya bu kitaplığı kullanarak Play Core Yazılım Geliştirme Kiti Hizmet Şartları'nı kabul etmiş olursunuz. Kitaplığa erişmeden önce lütfen geçerli tüm şartları ve politikaları okuyup anlayın.

Veri Güvenliği

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

Ek diller API'si

Play Özellik Dağıtımı

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