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 Özellik Dağıtımı, 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 ö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 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 çıkarmalısınız:

• İmza yapılandırmaları: Uygulama paketleri, temel modülde belirttiğiniz imza yapılandırmaları kullanılarak imzalanır.
• minifyEnabled mülkü: 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 ekler (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ğunda Çalıştır simgesini tıklayarak) uygulamanızı bağlı bir cihaza normal şekilde 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. 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ını sağlar.

Kullanıcılarınızın bir online pazar yerinde ürün satın almasına ve satmasına olanak tanıyan bir uygulamayı 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
• Ürünleri satışa ekleme
• Ö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

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ş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 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 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 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:

Özellik modülleriyle ilgili dikkat edilmesi gereken noktalar

Özellik modülleri sayesinde derleme hızını ve mühendislik hızını artırabilir, uygulamanızın boyutunu küçültmek için uygulamanızın özelliklerinin yayınlanmasını kapsamlı bir şekilde özelleştirebilirsiniz. Ancak özellik modüllerini kullanırken göz önünde bulundurmanız 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ı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 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ğinizin Android'in önceki sürümlerinde kullanılabilmesi için özellik modülü oluştururken Birleştirme'yi 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 sürümlerinin 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 Feature Delivery Library'ye erişerek veya bu kitaplığı kullanarak Play Core Software Development Kit Hizmet Şartları'nı kabul etmiş olursunuz. Kitaplığa erişmeden önce lütfen geçerli tüm hüküm 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 dil API'si

Play Özellik Dağıtımı

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