Koşullu yayını yapılandırma

Koşullu yayınlama, özellik modüllerinin uygulama yükleme sırasında otomatik olarak indirilmesi için belirli cihaz yapılandırma şartları belirlemenize olanak tanır. Örneğin, artırılmış gerçeklik (AR) işlevini içeren bir özellik modülünü, uygulama yüklenirken yalnızca AR'yi destekleyen cihazlarda kullanılabilir olacak şekilde yapılandırabilirsiniz.

Bu yayınlama mekanizması, şu anda aşağıdaki cihaz yapılandırmalarına göre uygulama yükleme sırasında bir modülün indirilmesini kontrol etmeyi destekler:

Bir cihaz belirttiğiniz tüm koşulları karşılamıyorsa modül, uygulama yükleme sırasında indirilmez. Ancak uygulamanız daha sonra Play Core SDK'yı kullanarak modülü isteğe bağlı olarak indirmeyi talep edebilir.

Başlamadan önce Android Studio 3.5 veya sonraki bir sürümü kullandığınızdan emin olun. Aşağıdaki bölümlerde, özellik modüllerinize koşullu yayınlama desteğini nasıl ekleyeceğiniz gösterilmektedir.

Koşullu yayınlama seçenekleri içeren yeni bir modül ekleme

Koşullu yayınlama içeren yeni bir özellik modülü oluşturmanın en kolay yolu, aşağıdaki gibi Yeni Modül sihirbazını kullanmaktır:

  1. New Module (Yeni Modül) iletişim kutusunu açmak için menü çubuğundan File > New > New Module'u (Dosya > Yeni > Yeni Modül) seçin.
  2. New Module (Yeni Modül) iletişim kutusunda Dynamic Feature Module'u (Dinamik Özellik Modülü) seçip Next'i (İleri) tıklayın.
  3. Modülünüzü her zamanki gibi yapılandırın ve İleri'yi tıklayın.
  4. Modül İndirme Seçenekleri bölümünde aşağıdakileri yapın:

    1. En fazla 50 karakter kullanarak Modül başlığı'nı belirtin. Platform, modülü kullanıcılara tanımlamak için bu başlığı kullanır. Örneğin, kullanıcının modülü indirmek isteyip istemediğini onaylarken bu başlık kullanılır. Bu nedenle, uygulamanızın temel modülünde, modül başlığı çevirebileceğiniz bir dize kaynağı olarak bulunmalıdır. Android Studio'yu kullanarak modülü oluştururken IDE, dize kaynağını sizin için temel modüle ekler ve özellik modülünün manifest dosyasına aşağıdaki girişi ekler:

      <dist:module
          ...
          dist:title="@string/feature_title">
      </dist:module>
      
    2. Yükleme sırasında dahil etme bölümündeki açılır menüde Modülü yalnızca belirtilen özelliklere sahip cihazlar için uygulama yükleme sırasında dahil et'i seçin. Bu işlem, yalnızca cihaz özellikleri veya ülke gibi belirtebileceğiniz belirli yapılandırmalara sahip cihazlarda uygulama yükleme sırasında uygulamanıza dahil edilen bir modül oluşturur. Android Studio, seçiminizi yansıtmak için modülün manifest dosyasına aşağıdakileri ekler:

      <dist:module ... >
        <dist:delivery>
            <dist:install-time>
                <dist:conditions>
                    <!-- If you specify conditions, as described in the steps
                         below, the IDE includes them here. -->
                </dist:conditions>
            </dist:install-time>
        </dist:delivery>
      </dist:module>
      
    3. Modülün otomatik olarak indirilmesini belirli ülkelerle veya minimum API düzeyiyle sınırlamak istiyorsanız modülün oluşturulmasını tamamlamak için Son'u tıklayın, ardından ülkeye veya minimum API düzeyine göre koşulların nasıl belirtileceğiyle ilgili bölümü okuyun. Aksi takdirde, yükleme sırasında modülü indirmek için cihazın gerektirdiği bir özelliği eklemek üzere + cihaz özelliği'ni tıklayın.

    4. device-feature'ın yanındaki açılır menüden aşağıdaki seçeneklerden birini belirleyin ve değerini belirtin:

      • Name: Bir cihazın, modülü yükleme sırasında indirmek için ihtiyaç duyduğu donanım veya yazılım özelliğini belirtmenize olanak tanır. Koşullu yayınlamanın desteklediği özellikler, PackageManager tarafından FEATURE_* sabitleri olarak listelenenlerle aynıdır. Bu seçeneği belirlerseniz açılır menünün yanındaki alana özelliğin sabit değerinin herhangi bir bölümünü (ör. "bluetooth") yazmaya başlayın ve gösterilen önerilerden birini seçin.
      • OpenGL ES Sürümü: Bir cihazın, yükleme sırasında modülü indirmek için ihtiyaç duyduğu OpenGL ES sürümünü belirtmenize olanak tanır. Bu seçeneği belirlerseniz açılır menünün yanındaki alana sürümü (ör. "0x00030001") yazmaya başlayın ve gösterilen önerilerden birini seçin.
    5. Mevcut cihaz özelliklerine göre birden fazla koşul eklemek istiyorsanız belirtmek istediğiniz her cihaz özelliği koşulu için + cihaz özelliği'ni tıklayın.

    6. Bu modülün Android 4.4 (API düzeyi 20) ve önceki sürümleri çalıştıran cihazlarda kullanılabilmesini ve çoklu APK'lara dahil edilmesini istiyorsanız Birleştirme'nin yanındaki kutuyu işaretleyin. Bu sayede, bu modül için isteğe bağlı davranışı etkinleştirebilir ve bölünmüş APK'ların indirilip yüklenmesini desteklemeyen cihazlarda bu modülü atlamak için birleştirmeyi devre dışı bırakabilirsiniz. Android Studio, seçiminizi yansıtmak için modülün manifest dosyasına aşağıdakileri ekler:

      <dist:module ...>
          <dist:fusing dist:include="true | false" />
      </dist:module>
      
  5. Modül indirme seçeneklerini yapılandırmayı tamamladığınızda Son'u tıklayın.

Android Gradle eklentisinin, dinamik özellik modüllerinden lint çalıştırmayı desteklemediğini unutmayın. Hata analizini ilgili uygulama modülünden çalıştırmak, dinamik özellik modüllerinde hata analizini çalıştırır ve uygulamadaki tüm sorunları hata analizi raporuna dahil eder.

Mevcut bir özellik modülüne koşullu yayınlama seçenekleri ekleme

Mevcut bir özellik modülüne, modülün manifest dosyası üzerinden koşullu yayınlama seçenekleri ekleyebilirsiniz. Ancak öncelikle koşullu yayınlama seçeneklerinin, etkinleştirmiş olabileceğiniz diğer yayınlama seçenekleriyle uyumluluğu hakkında bilgi edinmeniz gerekir.

Başlamak için önce manifestinizi yeni <dist:delivery> öğesine taşımanız gerekir. Aşağıdaki kod snippet'inde eski söz dizimi örneği gösterilmektedir:

<!-- This is the old syntax. -->
<dist:module
  dist:title="@string/feature_title" dist:onDemand="true">
  <dist:fusing dist:include="true"/>
</dist:module>

Yukarıdaki yayınlama seçenekleri artık aşağıdaki gibi belirtilir.

<dist:module
  dist:title="@string/feature_title">
  <dist:delivery>
      <dist:on-demand/>
  </dist:delivery>
  <dist:fusing dist:include="true"/>
</dist:module>

Ardından, cihaz özelliklerine göre koşullu yayınlama seçeneklerini aşağıdaki gibi ekleyebilirsiniz.

<dist:module
    dist:title="@string/feature_title">
    <dist:delivery>
      <dist:on-demand/>
      <dist:install-time>
        <dist:conditions>
          <!-- Requires that the device support AR to download the module at
          app install-time.  -->
          <dist:device-feature dist:name="android.hardware.camera.ar"/>
        </dist:conditions>
      </dist:install-time>
    </dist:delivery>
    <dist:fusing dist:include="true"/>
</dist:module>

Aşağıdaki bölümlerde, ülkeye veya minimum API düzeyine göre koşullu yayınlama gibi diğer seçenekler ele alınmaktadır.

Diğer modül indirme seçenekleriyle uyumluluk

Özellik modülleri, her bir özelliğin kullanıcının cihazına nasıl yayınlanacağını yapılandırmak için birden fazla seçenek sunduğundan, koşullu yayınlama seçeneklerinin diğer ayarlardan nasıl etkilendiğini anlamak önemlidir. Aşağıdaki tabloda, koşullu yayınlamanın diğer modül indirme seçenekleriyle uyumluluğu özetlenmiştir.

Modül indirme seçeneği Koşullu yayınlama ile uyumluluk
Füzyon (<dist:fusing dist:include="true"/>) Bir modül bu seçeneği "true" olarak ayarlarsa Google Play, uygulamanızı API düzeyi 19 veya daha düşük olan cihazlara dağıtırken belirttiğiniz koşullu dağıtım seçeneklerini dikkate almaz. Yani, birleştirme özelliğini etkinleştiren özellik modülleri, API düzeyi 19 veya daha düşük olan cihazlarda her zaman yükleme sırasında dahil edilir.
Hazır sürüm etkin (<dist:module dist:instant="true"/>) Koşullu yayınlama seçenekleri, hazır sürüm etkin özellik modülleri için desteklenmez.
Seç-izle (<dist:on-demand/>) Varsayılan olarak, koşullu yayınlama seçeneklerini belirtirseniz modül isteğe bağlı olarak da kullanılabilir.

Ülkeye göre koşulları belirtme

Koşullu yayınlama, uygulamanın yükleme zamanında modülünüzün indirilmesini hariç tutmak (veya dahil etmek) istediğiniz ülkeleri belirtmenize de olanak tanır. Örneğin, modülünüz belirli bölgelerde kullanılamayan bir ödeme yöntemi uyguluyorsa bu koşulu belirtmek faydalı olabilir.

Bu bağlamda, cihazın bulunduğu ülke genellikle kullanıcının Google Play hesabında kayıtlı fatura adresine göre belirlenir.

Modülünüz için ülkeleri belirtmek üzere özellik modülünün manifest dosyasına aşağıdakileri ekleyin.

<dist:conditions>
   <!-- Set to "true" to specify countries to exclude from downloading
   this module at app install-time. By default, modules are available
   for download to all user countries. -->
  <dist:user-countries dist:exclude="true">
    <!-- Specifies the two-letter  CLDR country code for regions that should
    not download the module at app install-time. -->
    <dist:country dist:code="CN"/>
    <dist:country dist:code="HK"/>
  </dist:user-countries>
</dist:conditions>

API düzeyi için koşulları belirtme

Bir özellik modülü, Android platformunun yalnızca belirli sürümlerinde kullanılabilen API'lere bağlıysa cihazın API düzeyine göre bir koşul belirtmek faydalı olabilir.

Minimum veya maksimum cihaz API düzeyine göre bir koşul belirlemek için özellik modülünüzün manifest dosyasına aşağıdakileri ekleyin.

<dist:conditions>
    <!-- Specifies the minimum API level that the device must satisfy
         in order to download your module at app install-time. The API level you
         specify must be greater or equal to the module's own minSdkVersion. -->
   <dist:min-sdk dist:value="21"/>
    <!-- Specifies the maximum API level that the device cannot exceed
         in order to download your module at app install-time. The API level you
         specify must be less than or equal to the module's own maxSdkVersion. -->
   <dist:max-sdk dist:value="24"/>
</dist:conditions>

Diğer cihaz özellikleri için koşulları belirtme (beta)

Model adı, RAM, sistem özellikleri ve çip üzerinde sistem gibi diğer cihaz özellikleri için koşullar belirtmek isterseniz cihaz hedefleme yapılandırma dosyası kullanabilirsiniz.

Cihaz hedefleme yapılandırma dosyası oluşturmak için cihaz hedefleme belgelerine bakın.

Yapılandırma dosyasını oluşturduktan sonra özellik modülünün manifest dosyasına aşağıdakileri ekleyerek modülünüz için cihaz grupları belirtebilirsiniz.

<dist:conditions>
   <dist:device-groups>
      <dist:device-group dist:name="myCustomGroup1"/>
      <dist:device-group dist:name="myCustomGroup2"/>
   </dist:device-groups>
</dist:conditions>