Overview of Play Feature Delivery

Google Play’in uygulama sunma modeli, her kullanıcının cihaz yapılandırması için optimize edilmiş APK’lar oluşturmak ve sunmak için Android App Bundle‘ları kullanır, böylece kullanıcılar yalnızca uygulamanızı çalıştırmak için ihtiyaç duydukları kodu ve kaynakları indirir.

Play Feature Delivery, app bundle’ların 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 base app’inizden feature modüllerine ayırmanız gerekir.

Feature module build configuration

Android Studio kullanarak yeni bir feature 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 application plugin için kullanılabilen özelliklerin çoğu feature modülünüz için de kullanılabilir. Aşağıdaki bölümlerde, feature modülünüzün build configuration’ına dahil etmeniz ve etmemeniz gereken özellikler açıklanmaktadır.

What not to include in the feature module build configuration

Her feature modülü base modüle bağlı olduğundan, belirli yapılandırmaları da miras alır. Bu nedenle, feature modülünün build.gradle dosyasında aşağıdakileri eklememelisiniz:

• Signing configurations: App bundle’lar, base modülde belirttiğiniz signing configurations kullanılarak imzalanır.

• The minifyEnabled property: Tüm uygulama projeniz için kod küçültmeyi yalnızca base modülün build configuration’undan etkinleştirebilirsiniz. Bu nedenle, bu özelliği feature modüllerinden çıkarmanız gerekir. Bununla birlikte, her feature modülü için ek ProGuard kuralları belirleyebilirsiniz.

• versionCode ve versionName: Gradle, app bundle’ınızı oluştururken base modülün sağladığı app versiyon bilgilerini kullanır. Bu özellikleri feature modülünüzün build.gradle dosyasından çıkarmanız gerekir.

Establish a relationship to the base module

Android Studio feature modülünüzü oluşturduğunda, aşağıda gösterildiği gibi base modülün build.gradle dosyasına android.dynamicFeatures property’sini ekleyerek onu base 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, aşağıda gösterildiği gibi base modülü feature modülünün bir 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')
}

Specify additional ProGuard rules

Yalnızca base modülün build configuration’ı uygulama projeniz için kod küçültmeyi etkinleştirebilse de, aşağıda gösterildiği gibi proguardFiles özelliğini kullanarak her feature modülüyle birlikte ö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üllerdekilerle (base modül dahil) birleştirildiğini unutmayın. Dolayısıyla, her feature modülü yeni bir kural kümesi belirleyebilse de, bu kurallar uygulama projesindeki tüm modüller için geçerlidir.

Deploy your app

Uygulamanızı feature modülleri desteğiyle geliştirirken, menü çubuğundan Run > Run’ı seçerek (veya araç çubuğunda Run’a tıklayarak) uygulamanızı normalde yaptığınız gibi bağlı bir cihaza deploy edebilirsiniz.

Uygulama projeniz bir veya daha fazla feature modülü içeriyorsa, mevcut run/debug configuration‘nızı aşağıdaki gibi değiştirerek uygulamanızı deploy ederken hangi özelliklerin dahil edileceğini seçebilirsiniz:

• Menü çubuğundan Run (Çalıştır) > Edit Configurations (Yapılandırmaları Düzenle) öğesini seçin.
• Çalıştır/Debug Yapılandırmaları iletişim kutusunun sol panelinden istediğiniz Android App configuration seçin.
• Genel sekmesindeki Dağıtılacak dinamik özellikler altında, uygulamanızı dağıtırken dahil etmek istediğiniz her özellik modülünün yanındaki kutuyu işaretleyin.
• Tamam’a tıklayın.

Varsayılan olarak, Android Studio uygulamanızı deploy etmek için app bundle’ları kullanmaz. Bunun yerine IDE, APK boyutu yerine deployment hızı için optimize edilmiş APK’lar oluşturur ve cihazınıza yükler. Android Studio’yu bunun yerine APK’ları ve anlık deneyimleri bir app bundle’dan derleyip deploy edecek şekilde yapılandırmak için run/debug configuration’ınızı değiştirin.

Use feature modules for custom delivery

Feature modüllerinin benzersiz bir avantajı, uygulamanızın farklı özelliklerinin Android 5.0 (API düzeyi 21) veya daha yüksek 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 isteğe bağlı olarak indirilecek şekilde ya da yalnızca fotoğraf çekme veya artırılmış gerçeklik özelliklerini destekleme gibi belirli özellikleri destekleyen cihazlar tarafından indirilecek şekilde yapılandırabilirsiniz.

Uygulamanızı bir app bundle olarak yüklediğinizde varsayılan olarak son derece optimize edilmiş indirmeler elde etseniz de, daha gelişmiş ve özelleştirilebilir feature delivery seçenekleri, feature modülleri kullanarak uygulamanızın özelliklerinin ek yapılandırılmasını ve modüler hale getirilmesini gerektirir. Yani feature 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 çevrimiçi bir pazarda mal alıp satmasına olanak tanıyan bir uygulama düşünün. Uygulamanın aşağıdaki işlevlerinin her birini ayrı feature modülleri halinde makul bir şekilde modüler hale getirebilirsiniz:

• Hesap girişi ve oluşturma
• Pazaryerinde gezinme
• Satış için bir ürün yerleştirme
• Ödemelerin işlenmesi

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

Buildig a URI for a resource

Bir URI kullanarak bir feature modülünde depolanan bir kaynağa erişmek istiyorsanız, Uri.Builder() kullanarak bir feature modülü kaynak URI’sinin nasıl oluşturulacağı aşağıda açıklanmıştır:

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()

Kaynağa giden yolun her bir parçası çalışma zamanında oluşturulur ve split APK’lar yüklendikten sonra doğru namespace’in oluşturulmasını sağlar.

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

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

Yukarıdaki kod parçasında resId, feature modülünüzde “my_video” adlı bir ham dosya kaynağını ifade ediyorsa, yukarıdaki Uri.Builder() kodu aşağıdaki çıktıyı verecektir:

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 feature modülünün kaynağına erişmek için kullanılabilir.

URI’nizdeki yolları doğrulamak için, feature modülü APK’nızı incelemek ve paket adını belirlemek üzere APK Analyzer kullanabilirsiniz:

Şekil 2. Derlenmiş bir kaynak dosyasındaki paket adını incelemek için APK Analyzer’ı kullanın.

Considerations for feature modules

Feature modülleri ile derleme hızını ve mühendislik hızını artırabilir ve uygulamanızın boyutunu küçültmek için uygulamanızın özelliklerinin dağıtımını kapsamlı bir şekilde özelleştirebilirsiniz. Ancak feature modüllerini kullanırken akılda tutulması gereken bazı kısıtlamalar ve istisnai durumlar vardır:

• Koşullu(conditional) veya isteğe bağlı(on-demand) dağıtım yoluyla tek bir cihaza 50 veya daha fazla feature modülü yüklemek performans sorunlarına yol açabilir. Kaldırılabilir olarak yapılandırılmayan yükleme zamanı(install-time) modülleri otomatik olarak base modüle dahil edilir ve her cihazda yalnızca bir feature modülü olarak sayılır.
• Yükleme zamanı(install-time) delivery için kaldırılabilir olarak yapılandırdığınız modül sayısını 10 veya daha az ile 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 üzeri sürümleri çalıştıran cihazlar talep üzerine(on-demand) özellik indirmeyi ve yüklemeyi destekler. Özelliğinizi Android’in önceki sürümlerinde kullanılabilir hale getirmek için, bir feature modülü oluşturduğunuzda [Fusing] özelliğini etkinleştirin.
• SplitCompat‘ı etkinleştirin, böylece uygulamanız talep üzerine teslim edilen (on-demand delivery)indirilmiş feature modüllerine erişebilir.
• Feature modülleri, manifestolarında android:exported true olarak ayarlanmış activityleri belirtmemelidir. Bunun nedeni, başka bir uygulama activity’yi başlatmaya çalıştığında cihazın feature modülünü indirdiğine dair bir garanti olmamasıdır. 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 Managed Installed modules bölümünü okuyun.
• Play Feature Delivery, uygulamanızı bir app bundle kullanarak yayınlamanızı gerektirdiğinden, app bundle’ın bilinen sorunlarından haberdar olduğunuzdan emin olun.

Feature module manifest reference

Android Studio kullanarak yeni bir feature module oluştururken, IDE modülün bir feature module gibi davranması için gereken manifesto niteliklerinin çoğunu içerir. Ayrıca, bazı özellikler derleme sırasında derleme sistemi tarafından enjekte edilir, bu nedenle bunları sizin belirtmeniz veya değiştirmeniz gerekmez. Aşağıdaki tabloda feature modüller için önemli olan manifesto attributeleri açıklanmaktadır.

Not: Feature modülleri, manifestolarında android:exported değeri true olarak ayarlanmış aktiviteleri belirtmemelidir. Bunun nedeni, başka bir uygulama activity’yi başlatmaya çalıştığında cihazın feature modülünü indirdiğine dair bir garanti olmamasıdır. Ayrıca, uygulamanız koduna ve kaynaklarına erişmeye çalışmadan önce bir özelliğin indirildiğini onaylamalıdır.

Additional resources

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

Blog posts

Videos