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 amacıyla Android App Bundle'ı kullanır. Böylece kullanıcılar, uygulamanızı çalıştırmak için ihtiyaç duydukları kod ve kaynakları indirir.

Play Feature Delivery, uygulamanızın belirli özelliklerinin koşullu olarak sunulmasına veya isteğe bağlı olarak indirilmesine olanak tanıyan uygulama paketlerinin gelişmiş özelliklerini kullanır. Bunu yapmak için öncelikle 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, 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 eklentisinin kullanabildiği ö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 dahil etmeniz ve dahil etmemeniz gereken özellikler açıklanmaktadır.

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

Her özellik modülü temel modüle bağlı olduğundan belirli yapılandırmaları da devralır. Dolayısıyla, özellik modülünün build.gradle dosyasında aşağıdakileri çıkarmanı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ı 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ştururken temel modülün build.gradle dosyasına android.dynamicFeatures mülkünü ekleyerek temel modüle görünür hale getirir. Aşağıda gösterildiği gibi:

// 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 (aşağıda gösterildiği gibi):

// 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 küçültme özelliğini yalnızca temel modülün derleme yapılandırması etkinleştirebilir ancak aşağıdaki gibi proguardFiles mülkünü 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ü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çerlidir.

Uygulamanızı dağıtma

Uygulamanızı özellik modülleri desteğiyle geliştirirken, menü çubuğundan Çalıştır > Çalıştır'ı seçerek (veya araç çubuğundaki Çalıştır düğmesini tıklayarak) uygulamanızı her zamanki gibi bağlı bir cihaza dağıtabilirsiniz.

Uygulama projenizde bir veya daha fazla özellik modülü varsa mevcut çalıştırma/hata ayıklama yapılandırmanızı aşağıdaki gibi değiştirerek uygulamanızı dağıtırken hangi özellikleri dahil edeceğinizi seçebilirsiniz:

1. Menü çubuğundan Çalıştır > Yapılandırmaları Düzenle'yi seçin.
2. Yapılandırmaları Çalıştır/Hata Ayıkla iletişim kutusunun sol panelinden istediğiniz Android Uygulaması yapılandırmasını seçin.
3. Genel sekmesindeki Yayınlanacak 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 boyutu yerine dağıtım hızı için optimize edilmiş APK'ları oluşturur ve cihazınıza yükler. Android Studio'yu, APK'ları ve hazır uygulama deneyimlerini bir uygulama paketinden derleyip 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ş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 fotoğraf çekme veya artırılmış gerçeklik özelliklerini destekleme gibi belirli işlevleri destekleyen cihazlar tarafından indirilecek şekilde yapılandırabilirsiniz.

Uygulamanızı uygulama paketi olarak yüklediğinizde varsayılan olarak son derece optimize edilmiş indirmeler elde edersiniz. Ancak daha gelişmiş ve özelleştirilebilir özellik yayınlama seçenekleri için özellik modülleri kullanılarak uygulamanızın özelliklerinin ek olarak yapılandırılması ve modülerleştirilmesi gerekir. Yani özellik modülleri, 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 bir pazarda ü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 bir şekilde modüler hale getirebilirsiniz:

• Hesap oturumu açma ve hesap oluşturma
• Pazar yerine göz atma
• Bir ürünü satışa sunma
• Ödemeleri işleme

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

Bir kaynak için URI oluşturma

Özellik modülünde depolanan bir kaynağa URI kullanarak erişmek isterseniz Uri.Builder() kullanarak özellik modülü kaynak URI'si oluşturmak için şu adımları uygulayabilirsiniz:

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 bölümü ç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 uygulama ve özellik modülleriniz olduğunu varsayalım:

• Uygulama paketi adı: com.example.my_app_package
• Özelliğin kaynak paket 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 atıfta bulunuyorsa yukarıdaki Uri.Builder() kodu aşağıdakileri döndürür:

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

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

URI'nizdeki yolları doğrulamak için özellik modülü APK'nızı incelemek ve paket adını belirlemek üzere APK Analiz Aracı'nı kullanabilirsiniz:

Şekil 2. Derlenmiş bir kaynak dosyasındaki 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, ayrıca uygulamanızın özelliklerinin sunumunu büyük ölçüde özelleştirerek uygulamanızın boyutunu küçültebilirsiniz. Bununla birlikte, ö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 aracılığıyla 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 sırasında yayınlama için çıkarılabilir olarak yapılandırdığınız modüllerin sayısını 10 veya daha az olacak şekilde sınırlandırın. Aksi takdirde, uygulamanızın indirme ve yükleme süresi artabilir.
• İsteğe bağlı olarak özellik indirme ve yükleme özelliği yalnızca Android 5.0 (API düzeyi 21) ve sonraki sürümleri çalıştıran cihazlarda desteklenir. Özelliğinizi Android'in önceki sürümlerinde de kullanılabilir hale getirmek için özellik modülü oluştururken Kaynaştırma'yı 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 true olarak ayarlanmış etkinlikler belirtmemelidir. Bunun nedeni, başka bir uygulama etkinliği başlatmaya çalıştığında cihazın özellik modülünü indirmiş olmasının garanti edilmemesidir. Ayrıca, uygulamanız bir özelliğin koduna ve kaynaklarına erişmeye çalışmadan önce özelliğin indirildiğini onaylamalıdır. Daha fazla bilgi edinmek 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 sorunlardan haberdar olduğunuzdan emin olun.

Özellik modülü manifesti referansı

Android Studio'yu kullanarak yeni bir özellik modülü oluştururken IDE, modülün özellik modülü gibi davranması için ihtiyaç duyduğu manifest özelliklerinin çoğunu içerir. Ayrıca, bazı özellikler derleme zamanında 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ı deneyin.

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 dahil 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 Etmenize ve Google Play'de Yüklemeleri Artırmanıza Yardımcı Olacak Yeni Araçlar

Hizmet şartları ve veri güvenliği

Play Özellik Yayınlama 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 ile çalışma zamanı arayüzüdür. Bu nedenle, uygulamanızda Play Core'u kullandığınızda Play Store kendi işlemlerini yürütür. Bu işlemler arasında, verileri Google Play Hizmet Şartları'na uygun şekilde işleme de yer alır. Aşağıdaki bilgilerde, Play Core kitaplıklarının uygulamanızdan gelen 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üvenlik uygulamalarıyla ilgili olarak Google Play'in Veri Güvenliği bölümü formuna nasıl yanıt vereceğinize karar vermek yalnızca sizin sorumluluğunuzdadır.