Niyetler ve niyet filtreleri

Intent, başka bir uygulama bileşeninden işlem isteğinde bulunmak için kullanabileceğiniz bir mesajlaşma nesnesidir. Intent'ler, bileşenler arasındaki iletişimi çeşitli şekillerde kolaylaştırsa da üç temel kullanım alanı vardır:

  • Etkinlik başlatma

    Activity, uygulamadaki tek bir ekranı temsil eder. startActivity()'a bir Intent göndererek yeni bir Activity örneği başlatabilirsiniz. Intent, başlatılacak etkinliği tanımlar ve gerekli tüm verileri taşır.

    Etkinlik tamamlandığında sonuç almak istiyorsanız startActivityForResult() numaralı telefonu arayın. Etkinliğiniz, sonucu etkinliğinizin onActivityResult() geri çağırma işlevinde ayrı bir Intent nesnesi olarak alır. Daha fazla bilgi için Etkinlikler kılavuzunu inceleyin.

  • Hizmet başlatma

    Service, kullanıcı arayüzü olmadan arka planda işlem gerçekleştiren bir bileşendir. Android 5.0 (API düzeyi 21) ve sonraki sürümlerde JobScheduler ile bir hizmet başlatabilirsiniz. JobScheduler hakkında daha fazla bilgi için API-reference documentation bölümüne bakın.

    Android 5.0'den (API düzeyi 21) önceki sürümlerde Service sınıfının yöntemlerini kullanarak bir hizmet başlatabilirsiniz. startService()'a bir Intent göndererek tek seferlik bir işlem (ör. dosya indirme) gerçekleştirmek için bir hizmet başlatabilirsiniz. Intent, başlatılacak hizmeti tanımlar ve gerekli tüm verileri taşır.

    Hizmet, istemci-sunucu arayüzüyle tasarlandıysa Intent öğesini bindService() öğesine aktararak hizmete başka bir bileşenden bağlanabilirsiniz. Daha fazla bilgi için Hizmetler kılavuzunu inceleyin.

  • Yayın yapma

    Yayın, herhangi bir uygulamanın alabileceği bir mesajdır. Sistem, sistem etkinlikleri için çeşitli yayınlar yapar (ör. sistem açıldığında veya cihaz şarj etmeye başladığında). Intent değerini sendBroadcast() veya sendOrderedBroadcast() değerine ileterek diğer uygulamalara yayın yayınlayabilirsiniz.

Bu sayfanın geri kalanında, intent'lerin işleyiş şekli ve nasıl kullanılacağı açıklanmaktadır. İlgili bilgiler için Diğer Uygulamalarla Etkileşimde Bulunma ve İçerik Paylaşma başlıklı makaleleri inceleyin.

Intent türleri

İki tür intent vardır:

  • Açık intent'ler, tam bir ComponentName belirterek hangi uygulamanın hangi bileşeninin intent'i karşılayacağını belirtir. Başlatmak istediğiniz etkinliğin veya hizmetin sınıf adını bildiğiniz için genellikle kendi uygulamanızda bir bileşeni başlatmak için açık bir intent kullanırsınız. Örneğin, kullanıcı işlemine yanıt olarak uygulamanızda yeni bir etkinlik başlatabilir veya arka planda dosya indirmek için bir hizmet başlatabilirsiniz.
  • Dolaylı intent'ler belirli bir bileşeni adlandırmaz, bunun yerine gerçekleştirilecek genel bir işlem tanımlar. Bu işlem, başka bir uygulamadaki bir bileşenin bu işlemi gerçekleştirmesine olanak tanır. Örneğin, kullanıcıya harita üzerinde bir konum göstermek istiyorsanız başka bir uygulamanın harita üzerinde belirli bir konumu göstermesini istemek için örtülü intent kullanabilirsiniz.

Şekil 1'de, etkinlik başlatırken intent'in nasıl kullanıldığı gösterilmektedir. Intent nesnesi belirli bir etkinlik bileşenini açıkça adlandırdığında sistem bu bileşeni hemen başlatır.

Şekil 1. Başka bir etkinliği başlatmak için sistem üzerinden nasıl bir dolaylı intent gönderilir? [1] A Etkinliği, işlem açıklaması içeren bir Intent oluşturur ve bunu startActivity()'e iletir. [2] Android sistemi, intent ile eşleşen bir intent filtresi için tüm uygulamaları arar. Bir eşleşme bulunduğunda [3] sistem, onCreate() yöntemini çağırarak ve Intent değerini ileterek eşleşen etkinliği (B Etkinliği) başlatır.

Android sistemi, bir dolaylı intent kullandığınızda intent'in içeriğini cihazdaki diğer uygulamaların manifest dosyasında tanımlanan intent filtreleriyle karşılaştırarak başlatılacak uygun bileşeni bulur. Intent, bir intent filtresiyle eşleşirse sistem bu bileşeni başlatır ve Intent nesnesini sunar. Birden fazla intent filtresi uyumluysa sistem, kullanıcının hangi uygulamayı kullanacağını seçebilmesi için bir iletişim kutusu görüntüler.

Intent filtresi, bir uygulamanın manifest dosyasında bulunan ve bileşenin almak istediği intent türlerini belirten bir ifadedir. Örneğin, bir etkinlik için intent filtresi tanımlayarak diğer uygulamaların etkinliğinizi belirli bir intent türüyle doğrudan başlatmasını sağlayabilirsiniz. Benzer şekilde, bir etkinlik için herhangi bir intent filtresi belirlemezse etkinlik yalnızca açık intent ile başlatılabilir.

Dikkat: Uygulamanızın güvenliğini sağlamak için Service başlatırken her zaman açık bir intent kullanın ve hizmetleriniz için intent filtreleri tanımlamayın. Bir hizmeti başlatmak için örtülü intent kullanmak güvenlik açısından risklidir. Bunun nedeni, hangi hizmetin intent'e yanıt vereceğinden emin olamama ve kullanıcının hangi hizmetin başlatıldığını görememesinden kaynaklanır. Android 5.0 (API düzeyi 21) sürümünden itibaren, bindService() metodunu implicit intent ile çağırırsanız sistem bir istisna oluşturur.

Niyet oluşturma

Intent nesnesi, Android sisteminin hangi bileşenin başlatılacağını belirlemek için kullandığı bilgileri (ör. intent'i alması gereken bileşenin tam adı veya bileşen kategorisi) ve alıcı bileşenin işlemi düzgün bir şekilde gerçekleştirmek için kullandığı bilgileri (ör. yapılacak işlem ve işleme tabi tutulacak veriler) içerir.

Intent içinde bulunan birincil bilgiler şunlardır:

Bileşen adı
Başlanacak bileşenin adı.

Bu isteğe bağlıdır ancak bir amacı açık yapan kritik bilgi parçasıdır. Yani amaç, yalnızca bileşen adı tarafından tanımlanan uygulama bileşenine gönderilmelidir. Bileşen adı olmadan intent örtülü olur ve sistem, intent'i hangi bileşenin alması gerektiğine diğer intent bilgilerine (ör. işlem, veri ve kategori) göre karar verir. Uygulamanızda belirli bir bileşeni başlatmanız gerekiyorsa bileşen adını belirtmeniz gerekir.

Not: Bir Service başlatırken bileşen adını her zaman belirtin. Aksi takdirde, hangi hizmetin intent'e yanıt vereceğinden emin olamazsınız ve kullanıcı hangi hizmetin başlatıldığını göremez.

Intent nesnesinin bu alanı bir ComponentName nesnesi olup uygulamanın paket adı da dahil olmak üzere hedef bileşenin tam nitelikli sınıf adını kullanarak belirtebilirsiniz (ör. com.example.ExampleActivity). Bileşen adını setComponent(), setClass(), setClassName() veya Intent kurucusuyla ayarlayabilirsiniz.

İşlem
Yapılacak genel işlemi belirten bir dize (ör. görüntüle veya seç).

Yayın amacı söz konusu olduğunda, gerçekleşen ve bildirilen işlem budur. İşlem, büyük ölçüde amacın geri kalanının nasıl yapılandırıldığını (özellikle de verilerde ve eklerde bulunan bilgileri) belirler.

Uygulamanızdaki intent'ler tarafından (veya uygulamanızdaki bileşenleri çağırmak için diğer uygulamalar tarafından) kullanılmak üzere kendi işlemlerinizi belirtebilirsiniz ancak genellikle Intent sınıfı veya diğer çerçeve sınıfları tarafından tanımlanan işlem sabitlerini belirtirsiniz. Etkinlik başlatmak için kullanabileceğiniz bazı yaygın işlemler şunlardır:

ACTION_VIEW
Bir etkinliğin kullanıcıya gösterebileceği bazı bilgilere sahip olduğunuzda (ör. bir galeri uygulamasında görüntülenecek bir fotoğraf veya bir harita uygulamasında görüntülenecek bir adres) bu işlemi startActivity() ile bir intent içinde kullanın.
ACTION_SEND
Paylaşım isteği olarak da bilinen bu isteği, kullanıcının e-posta uygulaması veya sosyal paylaşım uygulaması gibi başka bir uygulama üzerinden paylaşabileceği verilere sahip olduğunuzda startActivity() ile bir istek içinde kullanmanız gerekir.

Genel işlemleri tanımlayan daha fazla sabit değer için Intent sınıf referansına bakın. Diğer işlemler, Android çerçevesinin başka bir yerinde (ör. sistem Ayarlar uygulamasında belirli ekranları açan işlemler için Settings) tanımlanır.

Bir intent için işlemi setAction() ile veya Intent kurucusuyla belirtebilirsiniz.

Kendi işlemlerinizi tanımlarsanız aşağıdaki örnekte gösterildiği gibi uygulamanızın paket adını ön ek olarak eklediğinizden emin olun:

Kotlin

const val ACTION_TIMETRAVEL = "com.example.action.TIMETRAVEL"

Java

static final String ACTION_TIMETRAVEL = "com.example.action.TIMETRAVEL";
Veri
İşlem yapılacak verilere atıfta bulunan URI (Uri nesnesi) ve/veya bu verilerin MIME türü. Sağlanan veri türü genellikle intent'in işlemine göre belirlenir. Örneğin, işlem ACTION_EDIT ise veriler, düzenlenecek dokümanın URI'sini içermelidir.

Bir intent oluştururken genellikle URI'sine ek olarak veri türünü (MIME türü) belirtmeniz gerekir. Örneğin, URI biçimleri benzer olsa bile resim görüntüleyebilen bir etkinlik muhtemelen ses dosyası oynatamayacaktır. Verilerinizin MIME türünü belirtmek, Android sisteminin intent'inizi alacak en iyi bileşeni bulmasına yardımcı olur. Ancak MIME türü bazen URI'den çıkarılabilir. Özellikle veriler content: URI'si olduğunda bu geçerlidir. content: URI, verilerin cihazda bulunduğunu ve bir ContentProvider tarafından kontrol edildiğini belirtir. Bu da veri MIME türünü sisteme görünür hale getirir.

Yalnızca veri URI'sini ayarlamak için setData() işlevini çağırın. Yalnızca MIME türünü ayarlamak için setType() işlevini çağırın. Gerekirse her ikisini de setDataAndType() ile açıkça ayarlayabilirsiniz.

Dikkat: Hem URI'yi hem de MIME türünü ayarlamak istiyorsanız setData() ve setType()'yi çağırmayın. Bu iki işlev birbirinin değerini geçersiz kılar. Hem URI'yi hem de MIME türünü ayarlamak için her zaman setDataAndType() kullanın.

Kategori
Amacın ele alması gereken bileşen türü hakkında ek bilgiler içeren bir dize. Bir intent'e istediğiniz sayıda kategori açıklaması yerleştirilebilir ancak çoğu intent için kategori gerekmez. Yaygın kategorilerden bazıları şunlardır:
CATEGORY_BROWSABLE
Hedef etkinlik, bir bağlantının referans verdiği verileri (ör. resim veya e-posta mesajı) görüntülemek için web tarayıcısı tarafından başlatılmasına izin verir.
CATEGORY_LAUNCHER
Etkinlik, bir görevin ilk etkinliğidir ve sistemin uygulama başlatıcısında listelenir.

Kategorilerin tam listesi için Intent sınıf açıklamasına bakın.

addCategory() ile bir kategori belirtebilirsiniz.

Yukarıda listelenen bu özellikler (bileşen adı, işlem, veri ve kategori), bir amacın belirleyici özelliklerini temsil eder. Android sistemi, bu özellikleri okuyarak hangi uygulama bileşenini başlatması gerektiğini çözebilir. Ancak bir intent, uygulama bileşenine nasıl çözüleceğini etkilemeyen ek bilgiler taşıyabilir. Intent'ler aşağıdaki bilgileri de sağlayabilir:

Ek özellikler
İstenen işlemi gerçekleştirmek için gereken ek bilgileri taşıyan anahtar/değer çiftleri. Bazı işlemler belirli veri URI'leri kullandığı gibi bazı işlemler de belirli ekstralar kullanır.

Her biri iki parametre (anahtar adı ve değer) kabul eden çeşitli putExtra() yöntemleriyle ek veri ekleyebilirsiniz. Ayrıca, tüm ek verileri içeren bir Bundle nesnesi oluşturabilir ve ardından putExtras() ile Bundle'yi Intent içine ekleyebilirsiniz.

Örneğin, ACTION_SEND ile e-posta gönderme niyeti oluştururken EXTRA_EMAIL anahtarını kullanarak alıcıyı ve EXTRA_SUBJECT anahtarını kullanarak konuyu belirtebilirsiniz.

Intent sınıfı, standartlaştırılmış veri türleri için birçok EXTRA_* sabit tanımlar. Kendi ek anahtarlarınızı (uygulamanızın aldığı intent'ler için) belirtmeniz gerekiyorsa aşağıdaki örnekte gösterildiği gibi uygulamanızın paket adını ön ek olarak eklediğinizden emin olun:

Kotlin

const val EXTRA_GIGAWATTS = "com.example.EXTRA_GIGAWATTS"

Java

static final String EXTRA_GIGAWATTS = "com.example.EXTRA_GIGAWATTS";

Dikkat: Başka bir uygulamanın almasını beklediğiniz bir intent gönderirken Parcelable veya Serializable verilerini kullanmayın. Bir uygulama, Bundle nesnesindeki verilere erişmeye çalışır ancak paketlenmiş veya serileştirilmiş sınıfa erişimi yoksa sistem bir RuntimeException oluşturur.

İşaretler
İşaretler, intent için meta veri işlevi gören Intent sınıfında tanımlanır. İşaretler, Android sistemine bir etkinliğin nasıl başlatılacağını (örneğin, etkinliğin hangi göreve ait olması gerektiğini) ve etkinliğin başlatıldıktan sonra nasıl ele alınacağını (örneğin, en son etkinlikler listesine eklenip eklenmeyeceğini) bildirebilir.

Daha fazla bilgi için setFlags() yöntemine bakın.

Belirgin intent örneği

Belirli bir uygulama bileşenini (ör. uygulamanızdaki belirli bir etkinlik veya hizmet) başlatmak için kullandığınız amaç, açık amaçtır. Açık amaç oluşturmak için Intent nesnesinin bileşen adını tanımlayın. Diğer tüm intent özellikleri isteğe bağlıdır.

Örneğin, uygulamanızda web'den dosya indirmek için tasarlanmış DownloadService adlı bir hizmet oluşturduysanız bu hizmeti aşağıdaki kodla başlatabilirsiniz:

Kotlin

// Executed in an Activity, so 'this' is the Context
// The fileUrl is a string URL, such as "http://www.example.com/image.png"
val downloadIntent = Intent(this, DownloadService::class.java).apply {
    data = Uri.parse(fileUrl)
}
startService(downloadIntent)

Java

// Executed in an Activity, so 'this' is the Context
// The fileUrl is a string URL, such as "http://www.example.com/image.png"
Intent downloadIntent = new Intent(this, DownloadService.class);
downloadIntent.setData(Uri.parse(fileUrl));
startService(downloadIntent);

Intent(Context, Class)Yapıcı, uygulamaya Context ve bileşene Class nesnesi sağlar. Bu nedenle, bu intent uygulamada DownloadService sınıfını açıkça başlatır.

Hizmet oluşturma ve başlatma hakkında daha fazla bilgi için Hizmetler kılavuzuna bakın.

Örnek dolaylı intent

Örtük intent, cihazdaki herhangi bir uygulamayı çağırarak işlemi gerçekleştirebilecek bir işlem belirtir. Uygulamanız işlemi gerçekleştiremiyorsa ancak diğer uygulamalar muhtemelen gerçekleştirebiliyorsa ve kullanıcının hangi uygulamayı kullanacağını seçmesini istiyorsanız örtülü intent kullanmak faydalıdır.

Örneğin, kullanıcının diğer kullanıcılarla paylaşmasını istediğiniz bir içeriğiniz varsa ACTION_SEND işlemini içeren bir intent oluşturun ve paylaşılacak içeriği belirten ekstralar ekleyin. Bu amaca sahip startActivity() etkinliğini çağırdığınızda kullanıcı, içeriği paylaşacağı uygulamayı seçebilir.

Kotlin

// Create the text message with a string.
val sendIntent = Intent().apply {
    action = Intent.ACTION_SEND
    putExtra(Intent.EXTRA_TEXT, textMessage)
    type = "text/plain"
}

// Try to invoke the intent.
try {
    startActivity(sendIntent)
} catch (e: ActivityNotFoundException) {
    // Define what your app should do if no activity can handle the intent.
}

Java

// Create the text message with a string.
Intent sendIntent = new Intent();
sendIntent.setAction(Intent.ACTION_SEND);
sendIntent.putExtra(Intent.EXTRA_TEXT, textMessage);
sendIntent.setType("text/plain");

// Try to invoke the intent.
try {
    startActivity(sendIntent);
} catch (ActivityNotFoundException e) {
    // Define what your app should do if no activity can handle the intent.
}

startActivity() çağrıldığında sistem, bu tür bir intent'i (ACTION_SEND işlemine sahip ve "text/plain" veri taşıyan bir intent) hangilerinin işleyebileceğini belirlemek için yüklü tüm uygulamaları inceler. Bunu gerçekleştirebilecek tek bir uygulama varsa bu uygulama hemen açılır ve intent verilir. Başka hiçbir uygulama bunu yapamazsa uygulamanız meydana gelen ActivityNotFoundException durumunu yakalayabilir. Birden fazla etkinlik niyeti kabul ederse sistem, kullanıcının hangi uygulamayı kullanacağını seçebilmesi için Şekil 2'de gösterilen gibi bir iletişim kutusu görüntüler.

Diğer uygulamaları başlatma hakkında daha fazla bilgiyi kullanıcıyı başka bir uygulamaya gönderme başlıklı rehberde de bulabilirsiniz.

Şekil 2. Bir seçici iletişim kutusu.

Uygulama seçiciyi zorlama

Örtük niyetinize yanıt veren birden fazla uygulama olduğunda kullanıcı, hangi uygulamanın kullanılacağını seçebilir ve bu uygulamayı işlem için varsayılan seçim yapabilir. Varsayılan bir uygulama seçebilme özelliği, kullanıcının her zaman aynı uygulamayı kullanmak isteyebileceği bir işlem gerçekleştirirken (ör. web sayfası açarken) faydalıdır (kullanıcılar genellikle tek bir web tarayıcısını tercih eder).

Ancak intent'e birden fazla uygulama yanıt verebiliyorsa ve kullanıcı her seferinde farklı bir uygulama kullanmak istiyorsa açıkça bir seçici iletişim kutusu göstermeniz gerekir. Seçici iletişim kutusu, kullanıcıdan işlem için hangi uygulamanın kullanılacağını seçmesini ister (kullanıcı işlem için varsayılan bir uygulama seçemez). Örneğin, uygulamanız ACTION_SEND işlemiyle "paylaş" işlemini gerçekleştirdiğinde kullanıcılar mevcut durumlarına bağlı olarak farklı bir uygulama kullanarak paylaşım yapmak isteyebilir. Bu nedenle, Şekil 2'de gösterildiği gibi her zaman seçici iletişim kutusunu kullanmalısınız.

Seçiciyi göstermek için createChooser() kullanarak bir Intent oluşturun ve aşağıdaki örnekte gösterildiği gibi startActivity()'ye iletin. Bu örnekte, createChooser() yöntemine iletilen intent'e yanıt veren uygulamaların listesini içeren bir iletişim kutusu gösterilmektedir. İletişim kutusu başlığında ise sağlanan metin kullanılmaktadır.

Kotlin

val sendIntent = Intent(Intent.ACTION_SEND)
...

// Always use string resources for UI text.
// This says something like "Share this photo with"
val title: String = resources.getString(R.string.chooser_title)
// Create intent to show the chooser dialog
val chooser: Intent = Intent.createChooser(sendIntent, title)

// Verify the original intent will resolve to at least one activity
if (sendIntent.resolveActivity(packageManager) != null) {
    startActivity(chooser)
}

Java

Intent sendIntent = new Intent(Intent.ACTION_SEND);
...

// Always use string resources for UI text.
// This says something like "Share this photo with"
String title = getResources().getString(R.string.chooser_title);
// Create intent to show the chooser dialog
Intent chooser = Intent.createChooser(sendIntent, title);

// Verify the original intent will resolve to at least one activity
if (sendIntent.resolveActivity(getPackageManager()) != null) {
    startActivity(chooser);
}

Güvenli olmayan intent başlatmalarını algılama

Uygulamanız, uygulamanızın içindeki bileşenler arasında gezinmek veya başka bir uygulama adına işlem yapmak için intent'ler başlatabilir. Platform güvenliğini artırmak amacıyla Android 12 (API düzeyi 31) ve sonraki sürümlerde, uygulamanız güvenli olmayan bir intent başlatırsa sizi uyaran bir hata ayıklama özelliği sunulur. Örneğin, uygulamanız başka bir intent'te ekstra olarak iletilen bir intent olan iç içe yerleştirilmiş intent'i güvenli olmayan bir şekilde başlatabilir.

Uygulamanız aşağıdaki işlemlerin ikisini de gerçekleştirirse sistem güvenli olmayan bir intent başlatma işlemi algılar ve StrictMode ihlali meydana gelir:

  1. Uygulamanız, gönderilen bir intent'in ekstralarından iç içe yerleştirilmiş bir intent'i paketten çıkarıyor.
  2. Uygulamanız, bu iç içe yerleştirilmiş niyeti kullanarak hemen bir uygulama bileşeni başlatır (ör. niyeti startActivity(), startService() veya bindService()'a iletme).

Bu durumu nasıl tespit edeceğiniz ve uygulamanızda nasıl değişiklik yapacağınız hakkında daha fazla bilgi için Medium'da Android Nesting Intents ile ilgili blog yayınını okuyun.

Güvenli olmayan intent başlatma işlemlerini kontrol etme

Uygulamanızda güvenli olmayan intent başlatma olup olmadığını kontrol etmek için VmPolicy'ınızı yapılandırırken aşağıdaki kod snippet'inde gösterildiği gibi detectUnsafeIntentLaunch() işlevini çağırın. Uygulamanız StrictMode ihlali tespit ederse hassas olabilecek bilgileri korumak için uygulamanın yürütülmesini durdurabilirsiniz.

Kotlin

fun onCreate() {
    StrictMode.setVmPolicy(VmPolicy.Builder()
        // Other StrictMode checks that you've previously added.
        // ...
        .detectUnsafeIntentLaunch()
        .penaltyLog()
        // Consider also adding penaltyDeath()
        .build())
}

Java

protected void onCreate() {
    StrictMode.setVmPolicy(new VmPolicy.Builder()
        // Other StrictMode checks that you've previously added.
        // ...
        .detectUnsafeIntentLaunch()
        .penaltyLog()
        // Consider also adding penaltyDeath()
        .build());
}

Intent'leri daha sorumlu bir şekilde kullanma

Güvenli olmayan intent başlatma ve StrictMode ihlali olasılığını en aza indirmek için aşağıdaki en iyi uygulamaları izleyin.

Amaçlardaki yalnızca gerekli ekstraları kopyalayın ve gerekli tüm temizleme ve doğrulama işlemlerini gerçekleştirin. Uygulamanız, ekstraları bir intent'ten yeni bir bileşeni başlatmak için kullanılan başka bir intent'e kopyalayabilir. Bu durum, uygulamanız putExtras(Intent) veya putExtras(Bundle)'i aradığında gerçekleşir. Uygulamanız bu işlemlerden birini gerçekleştiriyorsa yalnızca alıcı bileşenin beklediği ekstraları kopyalayın. Kopyayı alan diğer intent, dışa aktarılmayan bir bileşeni başlatıyorsa ekstraları, bileşeni başlatan intent'e kopyalamadan önce temizleyin ve doğrulayın.

Uygulamanızın bileşenlerini gereksiz yere dışa aktarmayın. Örneğin, dahili iç içe yerleştirilmiş bir intent kullanarak bir uygulama bileşeni başlatmak istiyorsanız söz konusu bileşenin android:exported özelliğini false olarak ayarlayın.

İç içe yerleştirilmiş intent yerine PendingIntent kullanın. Bu sayede, başka bir uygulama Intent içeren PendingIntent'yi paketten çıkardığında uygulamanızın kimliğini kullanarak PendingIntent'yi başlatabilir. Bu yapılandırma, diğer uygulamanın uygulamanızdaki dışa aktarılmamış bileşenler de dahil olmak üzere herhangi bir bileşeni güvenli bir şekilde başlatmasına olanak tanır.

2. görseldeki şemada, sistemin kontrolü (istemci) uygulamanızdan başka bir (hizmet) uygulamasına ve tekrar uygulamanıza nasıl aktardığı gösterilmektedir:

  1. Uygulamanız, başka bir uygulamada etkinlik çağıran bir intent oluşturur. Bu intent'e ek olarak bir PendingIntent nesnesi eklersiniz. Bu bekleyen intent, uygulamanızda bir bileşeni çağırıyor. Bu bileşen dışa aktarılmıyor.
  2. Diğer uygulama, uygulamanızın intent'ini aldıktan sonra iç içe yerleştirilmiş PendingIntent nesnesini ayıklıyor.
  3. Diğer uygulama, PendingIntent nesnesinde send() yöntemini çağırır.
  4. Sistem, kontrolü uygulamanıza geri verdikten sonra uygulamanızın bağlamını kullanarak bekleyen intent'i çağırır.

Şekil 2. İç içe yerleştirilmiş bekleyen intent kullanıldığında uygulama içi iletişim şeması.

Dolaylı intent alma

Uygulamanızın hangi gizli intent'leri alabileceğini belirtmek için manifest dosyanızda uygulama bileşenlerinizin her biri için bir veya daha fazla intent filtresi tanımlayın.<intent-filter> Her intent filtresi, intent'in işlemine, verilerine ve kategorisine göre kabul ettiği intent türlerini belirtir. Sistem, uygulama bileşeninize yalnızca intent, intent filtrelerinizden birinden geçebiliyorsa dolaylı intent gönderir.

Not: Belirli bir intent, bileşenin tanımladığı intent filtrelerinden bağımsız olarak her zaman hedefine yayınlanır.

Bir uygulama bileşeni, yapabileceği her benzersiz iş için ayrı filtreler tanımlamalıdır. Örneğin, bir resim galerisi uygulamasındaki bir etkinlikte iki filtre olabilir: bir resim görüntülemek için bir filtre ve bir resim düzenlemek için başka bir filtre. Etkinlik başladığında Intent öğesini inceler ve Intent'teki bilgilere göre nasıl davranacağına karar verir (ör. düzenleyici kontrollerini gösterme veya göstermeme).Intent

Her intent filtresi, uygulamanın manifest dosyasında bir <intent-filter> öğesiyle tanımlanır ve ilgili uygulama bileşenine (ör. <activity> öğesi) yerleştirilir.

<intent-filter> öğesi içeren her uygulama bileşeninde android:exported için açıkça bir değer ayarlayın. Bu özellik, uygulama bileşeninin diğer uygulamalar tarafından erişilebilir olup olmadığını belirtir. Intent filtreleri LAUNCHER kategorisini içeren etkinlikler gibi bazı durumlarda bu özelliği true olarak ayarlamak yararlıdır. Aksi takdirde bu özelliği false olarak ayarlamak daha güvenlidir.

Uyarı: Uygulamanızdaki bir etkinlik, hizmet veya yayın alıcısı intent filtreleri kullanıyorsa ve android:exported için değeri açıkça ayarlamıyorsa uygulamanız Android 12 veya sonraki sürümleri çalıştıran bir cihaza yüklenemez.

<intent-filter> içinde, kabul edilecek intent türlerini şu üç öğeden birini veya daha fazlasını kullanarak belirtebilirsiniz:

<action>
name özelliğinde, intent işleminin kabul edildiğini belirtir. Değer, sınıf sabit değeri değil, bir işlemin değişmez dize değeri olmalıdır.
<data>
Veri URI'sinin (scheme, host, port, path) çeşitli yönlerini belirten bir veya daha fazla özellik ve MIME türünü kullanarak kabul edilen veri türünü belirtir.
<category>
name özelliğinde, intent kategorisinin kabul edildiğini belirtir. Değer, sınıf sabit değeri değil, bir işlemin değişmez dize değeri olmalıdır.

Not: Örtük intent'ler almak için intent filtresine CATEGORY_DEFAULT kategorisini eklemeniz gerekir. startActivity() ve startActivityForResult() yöntemleri, tüm intent'leri CATEGORY_DEFAULT kategorisini belirtmiş gibi işler. Intent filtrenizde bu kategoriyi belirtmezseniz hiçbir implicit intent etkinliğinizle çözülmez.

Örneğin, veri türü metin olduğunda ACTION_SEND intent'i almak için intent filtresi içeren bir etkinlik beyanı aşağıda verilmiştir:

<activity android:name="ShareActivity" android:exported="false">
    <intent-filter>
        <action android:name="android.intent.action.SEND"/>
        <category android:name="android.intent.category.DEFAULT"/>
        <data android:mimeType="text/plain"/>
    </intent-filter>
</activity>

<action>, <data> veya <category> öğesinin birden fazla örneğini içeren bir filtre oluşturabilirsiniz. Bu durumda, bileşenin bu filtre öğelerinin tüm kombinasyonlarını işleyebileceğinden emin olmanız gerekir.

Birden fazla türde intent'i yalnızca belirli işlem, veri ve kategori türü kombinasyonlarında işlemek istediğinizde birden fazla intent filtresi oluşturmanız gerekir.

Örtük intent, intent'in üç öğenin her biriyle karşılaştırılmasıyla filtreye göre test edilir. Bileşene yayınlanabilmesi için amacın üç testin de tümünü geçmesi gerekir. Bunlardan biriyle bile eşleşemezse Android sistemi, intent'i bileşene iletmez. Ancak bir bileşenin birden fazla intent filtresi olabileceğinden, bileşenin filtrelerinden birinden geçmeyen bir intent başka bir filtreden geçebilir. Sistemin amaçları nasıl çözdüğü hakkında daha fazla bilgiyi aşağıdaki Amaç Çözümü bölümünde bulabilirsiniz.

Dikkat: Intent filtresi kullanmak, diğer uygulamaların bileşenlerinizi başlatmasını önlemek için güvenli bir yöntem değildir. Amaç filtreleri bir bileşeni yalnızca belirli türde örtülü amaçlara yanıt verecek şekilde kısıtlasa da geliştirici bileşen adlarınızı belirlerse başka bir uygulama, açık bir amaç kullanarak uygulama bileşeninizi başlatabilir. Yalnızca kendi uygulamanızın bileşenlerinizden birini başlatabilmesi önemliyse manifest dosyanızda intent filtreleri tanımlamayın. Bunun yerine, söz konusu bileşen için exported özelliğini "false" olarak ayarlayın.

Benzer şekilde, yanlışlıkla farklı bir uygulamanın Service çalıştırılmasını önlemek için kendi hizmetinizi başlatmak üzere her zaman açık bir intent kullanın.

Not: Tüm etkinlikler için intent filtrelerinizi manifest dosyasında belirtmeniz gerekir. Ancak yayın alıcıları için filtreler, registerReceiver() çağrılarak dinamik olarak kaydedilebilir. Ardından, unregisterReceiver() ile alıcının kaydını iptal edebilirsiniz. Bu sayede uygulamanız, çalışırken yalnızca belirli bir süre boyunca belirli yayınları dinleyebilir.

Örnek filtreler

Intent filtresi davranışlarından bazılarını göstermek için sosyal paylaşım uygulamasının manifest dosyasından alınmış bir örnek verilmiştir:

<activity android:name="MainActivity" android:exported="true">
    <!-- This activity is the main entry, should appear in app launcher -->
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

<activity android:name="ShareActivity" android:exported="false">
    <!-- This activity handles "SEND" actions with text data -->
    <intent-filter>
        <action android:name="android.intent.action.SEND"/>
        <category android:name="android.intent.category.DEFAULT"/>
        <data android:mimeType="text/plain"/>
    </intent-filter>
    <!-- This activity also handles "SEND" and "SEND_MULTIPLE" with media data -->
    <intent-filter>
        <action android:name="android.intent.action.SEND"/>
        <action android:name="android.intent.action.SEND_MULTIPLE"/>
        <category android:name="android.intent.category.DEFAULT"/>
        <data android:mimeType="application/vnd.google.panorama360+jpg"/>
        <data android:mimeType="image/*"/>
        <data android:mimeType="video/*"/>
    </intent-filter>
</activity>

İlk etkinlik (MainActivity), uygulamanın ana giriş noktasıdır. Kullanıcı uygulamayı başlatıcı simgesiyle ilk kez başlattığında açılan etkinliktir:

  • ACTION_MAIN işlemi, bunun ana giriş noktası olduğunu belirtir ve herhangi bir intent verisi beklemez.
  • CATEGORY_LAUNCHER kategorisi, bu etkinliğin simgesinin sistemin uygulama başlatıcısına yerleştirilmesi gerektiğini gösterir. <activity> öğesinde icon ile bir simge belirtilmezse sistem, <application> öğesindeki simgeyi kullanır.

Etkinliğin uygulama başlatıcıda görünmesi için bu iki öğenin birlikte eşlenmesi gerekir.

İkinci etkinlik olan ShareActivity, metin ve medya içeriğini paylaşmayı kolaylaştırmayı amaçlar. Kullanıcılar bu etkinliğe MainActivity'ten giderek girebilir ancak ShareActivity'e doğrudan iki intent filtresinden biriyle eşleşen bir örtülü intent yayınlayan başka bir uygulamadan da girebilir.

Not: application/vnd.google.panorama360+jpg MIME türü, Google panorama API'leriyle işleyebileceğiniz panoramik fotoğrafları belirten özel bir veri türüdür.

Niyetleri diğer uygulamaların intent filtreleriyle eşleştirme

Başka bir uygulama Android 13 (API düzeyi 33) veya sonraki sürümleri hedefliyorsa uygulamanızın amacını yalnızca amacınız, söz konusu uygulamadaki bir <intent-filter> öğesinin işlemleri ve kategorileriyle eşleşirse işleyebilir. Sistem eşleşme bulamazsa bir ActivityNotFoundException hatası oluşturur. Gönderen uygulama bu istisnayı ele almalıdır.

Benzer şekilde, uygulamanızı Android 13 veya sonraki sürümleri hedefleyecek şekilde güncellerseniz harici uygulamalardan gelen tüm intent'ler, uygulamanızın dışa aktarılan bir bileşenine yalnızca söz konusu intent, uygulamanızın tanımladığı bir <intent-filter> öğesinin işlemleri ve kategorileriyle eşleşirse gönderilir. Bu davranış, gönderen uygulamanın hedef SDK sürümünden bağımsız olarak gerçekleşir.

Aşağıdaki durumlarda intent eşleştirme zorunlu kılınmaz:

  • Niyet filtresi tanımlamayan bileşenlere iletilen niyetler.
  • Aynı uygulamadan gelen intent'ler.
  • Sistemden gelen intent'ler (yani "sistem UID'si"nden (uid=1000) gönderilen intent'ler). Sistem uygulamaları, system_server ve android:sharedUserId değerini android.uid.system olarak ayarlayan uygulamaları içerir.
  • Kökten gelen intent'ler.

Amaç eşleştirme hakkında daha fazla bilgi edinin.

Beklemedeki bir amacı kullanma

PendingIntent nesnesi, Intent nesnesini saran bir sarmalayıcıdır. PendingIntent'ün birincil amacı, harici bir uygulamaya, içerdiği Intent'yi uygulamanızın kendi sürecinden yürütülüyormuş gibi kullanma izni vermektir.

Beklemedeki intent'lerin başlıca kullanım alanları şunlardır:

  • Kullanıcı bildiriminizle bir işlem gerçekleştirdiğinde çalıştırılacak bir intent beyan etme (Android sisteminin NotificationManager, Intent'ı yürütür).
  • Kullanıcı uygulama widget'ınızla bir işlem gerçekleştirdiğinde çalıştırılacak bir intent beyan etme (Intent, ana ekran uygulaması tarafından yürütülür).
  • Belirtilen gelecekteki bir zamanda yürütülecek bir intent beyan etme (Android sisteminin AlarmManager, Intent'u yürütür).

Her Intent nesnesi belirli bir uygulama bileşeni türü (Activity, Service veya BroadcastReceiver) tarafından ele alınacak şekilde tasarlandığı gibi, PendingIntent de aynı şekilde oluşturulmalıdır. Beklemedeki bir intent kullanılırken uygulamanız, intent'i startActivity() gibi bir çağrıyla yürütmez. Bunun yerine, ilgili oluşturucu yöntemini çağırarak PendingIntent'ü oluştururken amaçlanan bileşen türünü belirtmeniz gerekir:

Uygulamanız diğer uygulamalardan bekleyen intent'ler almıyorsa PendingIntent oluşturmak için yukarıdaki yöntemler muhtemelen ihtiyacınız olacak tek PendingIntent yöntemlerdir.

Her yöntem, geçerli uygulamayı Context, sarmalamak istediğiniz Intent'i ve amacın nasıl kullanılacağını belirten bir veya daha fazla işareti (ör. amacın birden fazla kez kullanılıp kullanılamayacağını) alır.

Beklemedeki intent'leri kullanma hakkında daha fazla bilgi için ilgili kullanım alanlarının her birine ait belgelere (ör. Bildirimler ve Uygulama Widget'ları API kılavuzları) bakın.

Değişkenliği belirtme

Uygulamanız Android 12 veya sonraki sürümleri hedefliyorsa uygulamanızın oluşturduğu her PendingIntent nesnesinin değişkenliğini belirtmeniz gerekir. Belirli bir PendingIntent nesnesinin değiştirilebilir veya değiştirilemez olduğunu belirtmek için sırasıyla PendingIntent.FLAG_MUTABLE veya PendingIntent.FLAG_IMMUTABLE işaretini kullanın.

Uygulamanız, değişkenlik işaretini ayarlamadan PendingIntent nesnesi oluşturmaya çalışırsa sistem bir IllegalArgumentException hatası verir ve Logcat'te aşağıdaki mesaj görünür:

PACKAGE_NAME: Targeting S+ (version 31 and above) requires that one of \
FLAG_IMMUTABLE or FLAG_MUTABLE be specified when creating a PendingIntent.

Strongly consider using FLAG_IMMUTABLE, only use FLAG_MUTABLE if \
some functionality depends on the PendingIntent being mutable, e.g. if \
it needs to be used with inline replies or bubbles.

Mümkün olduğunda bekleyen ve değiştirilemeyen intent'ler oluşturun

Çoğu durumda uygulamanız, aşağıdaki kod snippet'inde gösterildiği gibi değişmez PendingIntent nesneleri oluşturmalıdır. Bir PendingIntent nesnesi değiştirilemezse diğer uygulamalar, intent'i çağırmanın sonucunu ayarlamak için intent'i değiştiremez.

Kotlin

val pendingIntent = PendingIntent.getActivity(applicationContext,
        REQUEST_CODE, intent,
        /* flags */ PendingIntent.FLAG_IMMUTABLE)

Java

PendingIntent pendingIntent = PendingIntent.getActivity(getApplicationContext(),
        REQUEST_CODE, intent,
        /* flags */ PendingIntent.FLAG_IMMUTABLE);

Ancak belirli kullanım alanları bunun yerine değiştirilebilir PendingIntent nesneleri gerektirir:

  • Bildirimlerde doğrudan yanıt işlemleri desteklenir. Doğrudan yanıt, yanıtla ilişkili PendingIntent nesnesinde klip verilerinde bir değişiklik yapılmasını gerektirir. Genellikle bu değişikliği, fillIn() yöntemine FILL_IN_CLIP_DATA işaretini göndererek istersiniz.
  • CarAppExtender örneklerini kullanarak bildirimleri Android Auto çerçevesiyle ilişkilendirme
  • PendingIntent örneklerini kullanarak görüşmeleri baloncuklara yerleştirme. Değişebilir bir PendingIntent nesnesi, sistemin FLAG_ACTIVITY_MULTIPLE_TASK ve FLAG_ACTIVITY_NEW_DOCUMENT gibi doğru işaretleri uygulamasına olanak tanır.
  • requestLocationUpdates() veya benzer API'leri çağırarak cihaz konumu bilgisi isteme Değişken PendingIntent nesnesi, sistemin konum yaşam döngüsü etkinliklerini temsil eden intent ekstraları eklemesine olanak tanır. Bu etkinlikler arasında konum değişikliği ve bir sağlayıcının kullanıma sunulması yer alır.
  • AlarmManager'u kullanarak alarm planlama. Değiştirilebilir PendingIntent nesnesi, sistemin EXTRA_ALARM_COUNT intent'ini ek olarak eklemesine olanak tanır. Bu ek, tekrarlanan bir alarmın kaç kez tetiklendiğini gösterir. Bu ek bilgi sayesinde intent, tekrarlanan bir alarmın birden fazla kez tetiklenip tetiklenmediği (ör. cihaz uykudayken) konusunda uygulamayı doğru bir şekilde bilgilendirebilir.

Uygulamanız değiştirilebilir bir PendingIntent nesnesi oluşturuyorsa açık intent kullanmanız ve ComponentName doldurmanız önemle tavsiye edilir. Bu sayede, başka bir uygulama PendingIntent'ü çağrdığında ve kontrolü uygulamanıza geri aktardığında uygulamanızda her zaman aynı bileşen başlar.

Beklemedeki intent'lerde belirgin intent'leri kullanma

Diğer uygulamaların, uygulamanızın bekleyen intent'lerini nasıl kullanabileceğini daha iyi tanımlamak için bekleyen intent'leri her zaman bir açık intent içine sarmalayın. Bu en iyi uygulamayı uygulamanıza yardımcı olması için aşağıdakileri yapın:

  1. Temel intent'in action (işlem), package (paket) ve component (bileşen) alanlarının ayarlandığından emin olun.

  2. Beklemede intent oluşturmak için Android 6.0'a (API düzeyi 23) eklenen FLAG_IMMUTABLE yöntemini kullanın. Bu işaret, PendingIntent alan uygulamaların doldurulmamış özellikleri doldurmasını engeller. Uygulamanızın minSdkVersion sürümü 22 veya daha düşükse aşağıdaki kodu kullanarak güvenliği ve uyumluluğu birlikte sağlayabilirsiniz:

    if (Build.VERSION.SDK_INT >= 23) {
  // Create a PendingIntent using FLAG_IMMUTABLE.
} else {
  // Existing code that creates a PendingIntent.
}

Amaç çözümü

Sistem, bir etkinliği başlatmak için dolaylı bir intent aldığında, intent'i üç yöne göre intent filtreleriyle karşılaştırarak intent için en iyi etkinliği arar:

  • İşlem.
  • Veriler (hem URI hem de veri türü).
  • Kategori.

Aşağıdaki bölümlerde, intent'lerin bir uygulamanın manifest dosyasında yer alan intent filtresi beyanına göre uygun bileşenlerle nasıl eşleştirildiği açıklanmaktadır.

İşlem testi

Kabul edilen intent işlemlerini belirtmek için bir intent filtresi, aşağıdaki örnekte gösterildiği gibi sıfır veya daha fazla <action> öğesi tanımlayabilir:

<intent-filter>
    <action android:name="android.intent.action.EDIT" />
    <action android:name="android.intent.action.VIEW" />
    ...
</intent-filter>

Bu filtrenin geçmesi için Intent bölümünde belirtilen işlemin, filtrede listelenen işlemlerden biriyle eşleşmesi gerekir.

Filtre herhangi bir işlem listelemiyorsa niyetlerin eşleşeceği bir şey yoktur. Bu nedenle tüm niyetler testte başarısız olur. Ancak bir Intent, işlem belirtmezse filtre en az bir işlem içerdiği sürece testi geçer.

Kategori testi

Kabul edilen intent kategorilerini belirtmek için intent filtresi, aşağıdaki örnekte gösterildiği gibi sıfır veya daha fazla <category> öğesi tanımlayabilir:

<intent-filter>
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    ...
</intent-filter>

Bir amacın kategori testini geçebilmesi için Intent içindeki her kategorinin filtredeki bir kategoriyle eşleşmesi gerekir. Bunun tersi gerekli değildir. Amaç filtresi, Intent'te belirtilenden daha fazla kategori belirtebilir ve Intent yine de geçer. Bu nedenle, filtrede hangi kategorilerin tanımlandığına bakılmaksızın, kategori içermeyen bir intent her zaman bu testi geçer.

Not: Android, startActivity() ve startActivityForResult()'e iletilen tüm örtülü intent'lere otomatik olarak CATEGORY_DEFAULT kategorisini uygular. Etkinliğinizin, önceki <intent-filter> örneğinde gösterildiği gibi, intent filtrelerinde "android.intent.category.DEFAULT" için bir kategori içermesi gerekir.

Veri testi

Kabul edilen intent verilerini belirtmek için intent filtresi, aşağıdaki örnekte gösterildiği gibi sıfır veya daha fazla <data> öğesi tanımlayabilir:

<intent-filter>
    <data android:mimeType="video/mpeg" android:scheme="http" ... />
    <data android:mimeType="audio/mpeg" android:scheme="http" ... />
    ...
</intent-filter>

Her <data> öğesi bir URI yapısı ve veri türü (MIME medya türü) belirtebilir. URI'nin her bölümü ayrı bir özelliktir: scheme, host, port ve path:

<scheme>://<host>:<port>/<path>

Aşağıdaki örnekte bu özelliklerin olası değerleri gösterilmektedir:

content://com.example.project:200/folder/subfolder/etc

Bu URI'de şema content, ana makine com.example.project, bağlantı noktası 200 ve yol folder/subfolder/etc'dır.

Bu özelliklerin her biri <data> öğesinde isteğe bağlıdır ancak doğrusal bağımlılıklar vardır:

  • Şema belirtilmezse ana makine yoksayılır.
  • Ana makine belirtilmezse bağlantı noktası yok sayılır.
  • Hem şema hem de ana makine belirtilmezse yol yoksayılır.

Bir intent'teki URI, filtredeki bir URI spesifikasyonuyla karşılaştırılırken yalnızca URI'nin filtreye dahil edilen bölümleriyle karşılaştırılır. Örnek:

  • Bir filtre yalnızca bir şema belirtirse bu şemaya sahip tüm URI'ler filtreyle eşleşir.
  • Bir filtrede şema ve yetkili kurum belirtilmişse ancak yol belirtilmemişse aynı şemaya ve yetkili kuruma sahip tüm URI'ler, yollarından bağımsız olarak filtreden geçer.
  • Bir filtrede bir şema, yetkili ve yol belirtilirse yalnızca aynı şemaya, yetkiliye ve yola sahip URI'ler filtreden geçer.

Not: Yol tanımı, yol adının yalnızca kısmi eşleşmesini gerektirmek için joker yıldız (*) içerebilir.

Veri testi, intent'teki URI ve MIME türünü, filtrede belirtilen URI ve MIME türüyle karşılaştırır. Kurallar aşağıdaki gibidir:

  1. Ne URI ne de MIME türü içeren bir intent, yalnızca filtre herhangi bir URI veya MIME türü belirtmediği takdirde testi geçer.
  2. URI içeren ancak MIME türü içermeyen (URI'den açıkça anlaşılamayan veya çıkarılamayan) bir intent, yalnızca URI'si filtrenin URI biçimiyle eşleştiğinde ve filtre de MIME türü belirtmediğinde testi geçer.
  3. MIME türü içeren ancak URI içermeyen bir intent, yalnızca filtre aynı MIME türünü listelediğinde ve URI biçimi belirtmediğinde testi geçer.
  4. Hem URI hem de MIME türü (açık veya URI'den çıkarılabilir) içeren bir intent, testin MIME türü bölümünü yalnızca tür filtrede listelenen bir türle eşleşirse geçer. URI'si filtredeki bir URI ile eşleşirse veya content: ya da file: URI'si varsa ve filtre bir URI belirtmiyorsa testin URI bölümünü geçer. Diğer bir deyişle, filtresinde yalnızca bir MIME türü listelenen bir bileşenin content: ve file: verilerini desteklediği varsayılır.

Not: Bir intent'te URI veya MIME türü belirtilirse <intent-filter> içinde <data> öğesi yoksa veri testi başarısız olur.

Son kural olan (d) kuralı, bileşenlerin bir dosyadan veya içerik sağlayıcıdan yerel veri alabilmesi beklentisini yansıtır. Bu nedenle, filtreleri yalnızca bir veri türünü listeleyebilir ve content: ile file: şemalarını açıkça adlandırmaları gerekmez. Aşağıdaki örnekte, bir <data> öğesinin Android'e bileşenin bir içerik sağlayıcıdan resim verileri alıp görüntüleyebileceğini söylediği tipik bir durum gösterilmektedir: 

<intent-filter>
    <data android:mimeType="image/*" />
    ...
</intent-filter>

Mevcut verilerin çoğu içerik sağlayıcılar tarafından dağıtıldığı için URI belirtmeyen ancak veri türünü belirten filtreler belki de en yaygın olanlardır.

Şema ve veri türü içeren filtreler de yaygın bir yapılandırmadır. Örneğin, aşağıdaki gibi bir <data> öğesi, Android'e bileşenin işlemi gerçekleştirmek için ağdan video verileri alabileceğini söyler: 

<intent-filter>
    <data android:scheme="http" android:mimeType="video/*" />
    ...
</intent-filter>

Intent eşleştirme

Intent'ler, yalnızca etkinleştirilecek bir hedef bileşeni bulmak için değil, aynı zamanda cihazdaki bileşen grubu hakkında bir şey bulmak için de intent filtreleriyle eşleştirilir. Örneğin, Home uygulaması, ACTION_MAIN işlemini ve CATEGORY_LAUNCHER kategorisini belirten intent filtrelerine sahip tüm etkinlikleri bularak uygulama başlatıcıyı doldurur. Eşleşme yalnızca IntentFilter sınıfının dokümanlarında açıklandığı gibi Intent'teki işlemler ve kategoriler filtreyle eşleşirse başarılı olur.

Uygulamanız, Home uygulamasına benzer şekilde intent eşleştirmeyi kullanabilir. PackageManager, belirli bir amacı kabul edebilecek tüm bileşenleri döndüren bir dizi query...() yöntemine ve bir amaca yanıt verecek en iyi bileşeni belirleyen benzer bir dizi resolve...() yöntemine sahiptir. Örneğin, queryIntentActivities() bağımsız değişken olarak iletilen intent'i gerçekleştirebilen tüm etkinliklerin listesini döndürür ve queryIntentServices() benzer bir hizmet listesini döndürür. Hiçbir yöntem bileşenleri etkinleştirmez. Yalnızca yanıt verebilecek olanları listeler. Yayın alıcıları için benzer bir yöntem de vardır (queryBroadcastReceivers()).