Paket görünürlüğüyle ilgili gereksinimleri bildirme

Uygulamanızı oluştururken, uygulamanızın etkileşime geçmesi gereken cihazdaki diğer uygulamaları göz önünde bulundurmanız önemlidir. Uygulamanız Android 11 (API düzeyi 30) veya sonraki sürümleri hedefliyorsa sistem, bazı uygulamaları uygulamanıza otomatik olarak görünür hale getirir ancak diğer uygulamaları varsayılan olarak filtreler. Bu kılavuzda, diğer uygulamaların uygulamanızda nasıl görüneceği açıklanmaktadır.

Uygulamanız Android 11 veya sonraki sürümleri hedefliyorsa ve otomatik olarak görünen uygulamalar dışındaki uygulamalarla etkileşime geçmesi gerekiyorsa uygulamanızın manifest dosyasına <queries> öğesini ekleyin. <queries> öğesinde, diğer uygulamaları aşağıdaki bölümlerde açıklandığı gibi paket adına, intent imzasına veya sağlayıcı yetkilisine göre belirtin.

Belirli paket adları

Sorgulamak veya etkileşimde bulunmak istediğiniz belirli uygulamaları (ör. uygulamanızla entegre olan uygulamalar veya hizmetlerini kullandığınız uygulamalar) biliyorsanız paket adlarını <queries> öğesinin içindeki bir <package> öğesi grubuna ekleyin:

<manifest package="com.example.game">
    <queries>
        <package android:name="com.example.store" />
        <package android:name="com.example.services" />
    </queries>
    ...
</manifest>

Not: Uygulamanızın manifest dosyasında bir <package> öğesi tanımlarsanız söz konusu paket adıyla ilişkili uygulama, PackageManager için yapılan ve söz konusu uygulamadaki bir bileşenle eşleşen tüm sorguların sonuçlarında görünür.

Kitaplıktaki bir barındırıcı uygulamayla iletişim kurma

Android kitaplığı geliştiriyorsanız AAR manifest dosyanıza bir <queries> öğesi ekleyerek paket görünürlüğü ihtiyaçlarınızı belirtebilirsiniz. Bu <queries> öğesi, uygulamaların kendi manifest dosyalarında tanımlayabileceği öğeyle aynı işleve sahiptir.

Kitaplığınız, bir ana uygulamayla iletişim (ör. bağlı hizmet kullanımı) içeriyorsa ana uygulamanın paket adını belirten bir <package> öğesi ekleyin:

<!-- Place inside the <queries> element. -->
<package android:name=PACKAGE_NAME />

Bu beyanı ekleyerek ana uygulamanın yüklü olup olmadığını kontrol edebilir ve bindService() çağrısı yaparak uygulamayla etkileşim kurabilirsiniz. Bu etkileşim sonucunda, kitaplığınızı kullanan arama uygulaması ana uygulamaya otomatik olarak görünür.

Intent filtresi imzasıyla eşleşen paketler

Uygulamanızın belirli bir amaca hizmet eden bir dizi uygulamayı sorgulaması veya bu uygulamalarla etkileşime geçmesi gerekebilir ancak dahil edilecek paket adlarını bilmiyor olabilirsiniz. Bu durumda, <queries> öğenize intent filtresi imzaları ekleyebilirsiniz. Ardından uygulamanız, eşleşen <intent-filter> öğelerine sahip uygulamaları keşfedebilir.

Aşağıdaki kod örneğinde, uygulamanın JPEG resim paylaşımını destekleyen diğer yüklü uygulamaları görmesine olanak tanıyan bir <intent> öğesi gösterilmektedir:

<manifest package="com.example.game">
    <queries>
        <intent>
            <action android:name="android.intent.action.SEND" />
            <data android:mimeType="image/jpeg" />
        </intent>
    </queries>
    ...
</manifest>

<intent> öğesinin birkaç kısıtlaması vardır:

• Tam olarak bir <action> öğesi eklemeniz gerekir.
• <data> öğesinde path, pathPrefix, pathPattern veya port özelliklerini kullanamazsınız. Sistem, her bir özelliğin değerini genel joker karakter (*) olarak ayarlarmış gibi davranır.
• <data> öğesinin mimeGroup özelliğini kullanamazsınız.

• Tek bir <intent> öğesinin <data> öğelerinde aşağıdaki özelliklerin her birini en fazla bir kez kullanabilirsiniz:

  • mimeType
  • scheme
  • host

  Bu özellikleri birden fazla <data> öğesine dağıtabilir veya tek bir <data> öğesinde kullanabilirsiniz.

<intent> öğesi, birkaç özelliğin değeri olarak genel joker karakteri (*) destekler:

• <action> öğesinin name özelliği.
• Bir <data> öğesinin (image/*) mimeType özelliğinin alt türü.
• Bir <data> öğesinin (*/*) mimeType özelliğinin türü ve alt türü.
• <data> öğesinin scheme özelliği.
• <data> öğesinin host özelliği.

Önceki listede aksi belirtilmedikçe sistem, metin ve joker karakterlerin (ör. prefix*) bir karışımını desteklemez.

Belirli bir yetkiliyi kullanan paketler

Bir içerik sağlayıcıyı sorgulamanız gerekiyorsa ancak belirli paket adlarını bilmiyorsanız sağlayıcı yetkisini aşağıdaki snippet'te gösterildiği gibi bir <provider> öğesinde belirtebilirsiniz:

<manifest package="com.example.suite.enterprise">
    <queries>
        <provider android:authorities="com.example.settings.files" />
    </queries>
    ...
</manifest>

Not: <queries> öğeniz bir <provider> öğesi içeriyorsa Android Studio'da <provider> öğesiyle ilgili bir düzenleyici uyarısı görebilirsiniz. Android Gradle eklentisinin en son nokta sürümünü kullandığınızdan derlemeniz bu durumdan etkilenmez. Bu nedenle, uyarıyı yoksayabilirsiniz. Gradle derlemenizi Android 11'de paket görünürlüğü için hazırlama konulu blog yayınını inceleyerek daha fazla bilgi edinebilirsiniz.

Sağlayıcı yetkilerini tek bir <queries> öğesinde belirtebilirsiniz. <queries> öğesi içinde bir veya daha fazla <provider> öğesi tanımlayabilirsiniz. <provider> öğesi, tek bir sağlayıcı yetkilisi veya sağlayıcı yetkililerinin noktalı virgül ile ayrılmış bir listesini içerebilir.

Tüm uygulamalar (önerilmez)

Nadiren de olsa, uygulamanızın içerdikleri bileşenlerden bağımsız olarak bir cihazda yüklü tüm uygulamaları sorgulamasının veya bunlarla etkileşim kurmasının gerekmesi mümkündür. Sistem, uygulamanızın yüklü diğer tüm uygulamaları görmesine izin vermek için QUERY_ALL_PACKAGES iznini sağlar.

QUERY_ALL_PACKAGES izninin eklenmesi uygun olan bazı kullanım alanlarına örnekler:

• Erişilebilirlik uygulamaları
• Tarayıcılar
• Cihaz yönetimi uygulamaları
• Güvenlik uygulamaları
• Virüsten korunma uygulamaları

Ancak genellikle otomatik olarak görünen uygulama grubuyla etkileşime geçerek ve uygulamanızın erişmesi gereken diğer uygulamaları manifest dosyanızda açıklayarak uygulamanızın kullanım alanlarını karşılayabilirsiniz. Kullanıcı gizliliğine saygı göstermek için uygulamanız, çalışması için gereken en az paket görünürlüğü istemelidir.

Bu Google Play politikası güncellemesi, QUERY_ALL_PACKAGES iznine ihtiyaç duyan uygulamalar için yönergeler sunar.