Play Feature Delivery'ye genel bakış

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

Play Feature Delivery, 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 öncelikle bu özellikleri temel uygulamanızdan ayırıp ö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 bulunan ö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:

• İmza yapılandırmaları: Uygulama paketleri, temel modülde belirttiğiniz imza yapılandırmaları kullanılarak imzalanır.
• minifyEnabled özelliği: Uygulama projenizin tamamı için kod daraltmayı yalnızca temel modülün derleme yapılandırmasından etkinleştirebilirsiniz. Bu nedenle, bu özelliği özellik modüllerinden çıkarmanız gerekir. 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 kurma

Android Studio, özellik modülünüzü oluşturduğunda, temel modülün build.gradle dosyasına android.dynamicFeatures özelliğini ekleyerek temel modül tarafından 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 ekler:

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

Ek ProGuard kuralları belirtme

Uygulama projeniz için kod daraltmayı yalnızca temel modülün derleme yapılandırması etkinleştirebilse de aşağıda 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 belirtebilse de bu kurallar uygulama projesindeki tüm modüller için geçerlidir.

Uygulamanızı dağıtın

Uygulamanızı özellik modülleri desteğiyle geliştirirken, menü çubuğundan Run > Run'ı (Çalıştır > Çalıştır) seçerek (veya araç çubuğunda Run'ı tıklayarak) uygulamanızı bağlı bir cihaza normalde yaptığınız gibi 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 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 dahil etmek istediğiniz her özellik modülünün yanındaki kutuyu işaretleyin.
4. Tamam'ı tıklayın.

Android Studio, varsayılan olarak uygulamanızı dağıtmak için 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 bir uygulama paketinden APK'lar ve hazır sürüm 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 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ştirebilmenizdir. Örneğin, uygulamanızın ilk indirme boyutunu azaltmak için belirli özellikleri, gerektiğinde isteğe bağlı olarak veya yalnızca belirli özellikleri (ör. fotoğraf çekme veya artırılmış gerçeklik özelliklerini destekleme) 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 etseniz de daha gelişmiş ve özelleştirilebilir özellik sunma seçenekleri, özellik modülleri kullanılarak uygulamanızın özelliklerinin ek yapılandırmasını ve modülerleştirilmesini gerektirir. Yani özellik modülleri, her birini 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 online 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üllerine makul bir şekilde modülerleştirebilirsiniz:

• Hesaba giriş ve hesap oluşturma
• Pazar yerinde gezinme
• Bir öğeyi satışa çıkarma
• Ödemeleri işleme

Aşağıdaki tabloda, özellik modüllerinin desteklediği farklı yayınlama seçenekleri ve bu seçeneklerin, ö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 özellik modülünde depolanan kaynağa URI kullanarak erişmek istiyorsanız Uri.Builder() kullanarak özellik modülü kaynak URI'sini şu şekilde oluşturabilirsiniz:

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 parçası çalışma zamanında oluşturulur. Böylece, 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 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 dosya kaynağını ifade ediyorsa yukarıdaki Uri.Builder() kodu aşağıdaki çıkışı 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 Analyzer'ı 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 boyutunu küçültmek için uygulama özelliklerinizin yayınlanmasını kapsamlı bir şekilde özelleştirebilirsiniz. Ancak özellik modüllerini kullanırken dikkat edilmesi gereken bazı kısıtlamalar ve uç durumlar vardır:

• Koşullu veya seç-izle yayınlama aracılığıyla tek bir cihaza 50 veya daha fazla özellik modülü yüklemek performans sorunlarına yol açabilir. Kaldırılabilir olarak yapılandırılmayan yükleme zamanı modülleri, temel modüle otomatik olarak dahil edilir ve her cihazda yalnızca bir özellik modülü olarak sayılır.
• Yükleme sırasında yayınlama 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.
• Yalnızca Android 5.0 (API düzeyi 21) ve sonraki sürümleri çalıştıran cihazlar, özellikleri isteğe bağlı olarak indirmeyi ve yüklemeyi destekler. Özelliğinizi Android'in önceki sürümlerinde kullanılabilir hale getirmek için özellik modülü oluştururken Birleştirme'yi etkinleştirin.
• Uygulamanızın, isteğe bağlı olarak sunulan indirilmiş özellik modüllerine erişebilmesi için SplitCompat'i etkinleştirin.
• Özellik modüllerinin manifest dosyasında, android:exported değeri true olarak ayarlanmış etkinlikler belirtilmemelidir. Bunun nedeni, başka bir uygulama etkinliği başlatmaya çalıştığında cihazın özellik modülünü indirdiğinin garanti edilememesidir. 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 Feature Delivery, uygulamanızı bir uygulama paketi kullanarak yayınlamanızı gerektirdiğinden uygulama paketiyle ilgili bilinen sorunları inceleyin.

Ö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üresinde derleme sistemi tarafından eklenir. 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ı

• Google Play'de işinizi geliştirmenize, yayınlamanıza ve büyütmenize yardımcı olacak yeni özellikler
• Ek diller API'si de dahil olmak üzere en son Android App Bundle güncellemeleri
• Patchwork Plaid — A modularization story

Videolar

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

Hizmet Şartları ve Veri Güvenliği

Play Feature Delivery Kitaplığı'na erişerek veya 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 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 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 gelen belirli istekleri işlemek için verileri nasıl kullandığı açıklanmaktadır.

Ek diller 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şımları 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.