Uygulamanız başka bir uygulama için yararlı olabilecek bir işlem gerçekleştirebiliyorsa etkinliğinizde uygun intent filtresini belirterek işlem isteklerine yanıt vermeye hazırlayın.
Örneğin, kullanıcının arkadaşlarıyla mesaj veya fotoğraf paylaşabilen bir sosyal uygulama geliştiriyorsanız ACTION_SEND intent'ini destekleyin.
Ardından, kullanıcılar başka bir uygulamadan "paylaşma" işlemi başlattığında uygulamanız, Şekil 1'de gösterildiği gibi seçici iletişim kutusunda (anlam belirsizliğini giderme iletişim kutusu olarak da bilinir) bir seçenek olarak görünür.
Şekil 1. Seçici iletişim kutusu.
Diğer uygulamaların etkinliğinizi bu şekilde başlatmasına izin vermek için manifest dosyanızda ilgili <activity> öğesine bir <intent-filter> öğesi eklemeniz gerekir.
Uygulamanız bir cihaza yüklendiğinde sistem, intent filtrelerinizi tanımlar ve bilgileri, yüklü tüm uygulamalar tarafından desteklenen intent'lerin yer aldığı dahili bir kataloğa ekler.
Bir uygulama, dolaylı bir intent ile startActivity() veya startActivityForResult() yöntemini çağırdığında sistem, intent'e yanıt verebilecek etkinlikleri kontrol eder.
Intent filtresi ekleme
Etkinliğinizin hangi intent'leri işleyebileceğini doğru şekilde tanımlamak için eklediğiniz her intent filtresini, etkinliğin kabul ettiği işlem ve veri türü açısından mümkün olduğunca spesifik hale getirin.
Sistem, belirli bir Intent nesnesini bir etkinliğe gönderebilir. Bunun için etkinliğin, Intent nesnesinin aşağıdaki ölçütlerini karşılayan bir intent filtresine sahip olması gerekir:
- İşlem
- Gerçekleştirilecek işlemi adlandıran bir dize. Genellikle platform tarafından tanımlanan değerlerden biridir (ör.
ACTION_SENDveyaACTION_VIEW).Bunu intent filtrenizde
<action>öğesiyle belirtin. Bu öğede belirttiğiniz değer, bu sayfadaki örneklerde gösterildiği gibi API sabiti yerine işlemin tam dize adı olmalıdır. - Veriler
- Amaçla ilişkili verilerin açıklaması.
Bunu intent filtrenizde
<data>öğesiyle belirtin. Bu öğedeki bir veya daha fazla özelliği kullanarak MIME türünü, URI ön ekini, URI şemasını ya da bunların ve kabul edilen veri türünü belirten diğerlerinin bir kombinasyonunu belirtebilirsiniz.Not: Verilerle ilgili ayrıntıları beyan etmeniz gerekmiyorsa
Uri(ör. etkinliğiniz diğer türden "ekstra" verileri işlediğinde) URI yerine yalnızcaandroid:mimeTypeözelliğini belirterek etkinliğinizin işlediği veri türünü (ör.text/plainveyaimage/jpeg) beyan edin. - Kategori
- Amacı işleyen etkinliği karakterize etmek için ek bir yol sağlar. Bu genellikle kullanıcının hareketiyle veya etkinliğin başlatıldığı konumla ilgilidir. Sistem tarafından desteklenen birkaç farklı kategori vardır ancak çoğu nadiren kullanılır. Ancak tüm dolaylı intent'ler varsayılan olarak
CATEGORY_DEFAULTile tanımlanır.Bunu, intent filtrenizde
<category>öğesiyle belirtin.
Intent filtrenizde, etkinliğinizin kabul ettiği ölçütleri <intent-filter> öğesinde iç içe yerleştirilmiş karşılık gelen XML öğeleriyle bildirerek belirtebilirsiniz.
Örneğin, veri türü metin veya resim olduğunda ACTION_SEND intent'ini işleyen bir intent filtresine sahip bir etkinlik aşağıda verilmiştir:
<activity android:name="ShareActivity"> <intent-filter> <action android:name="android.intent.action.SEND"/> <category android:name="android.intent.category.DEFAULT"/> <data android:mimeType="text/plain"/> <data android:mimeType="image/*"/> </intent-filter> </activity>
İpucu: Seçici iletişim kutusundaki simgenin etkinliğinizin varsayılan simgesinden farklı olmasını istiyorsanız <intent-filter> öğesine android:icon ekleyin.
Gelen her intent yalnızca bir işlem ve bir veri türü belirtir ancak her <intent-filter> öğesinde <action>, <category> ve <data> öğelerinin birden fazla örneğini bildirebilirsiniz.
Herhangi iki işlem ve veri çiftinin davranışları birbirini dışlıyorsa hangi veri türleriyle eşleştirildiğinde hangi işlemlerin kabul edilebilir olduğunu belirtmek için ayrı intent filtreleri oluşturun.
Örneğin, etkinliğinizin hem ACTION_SEND hem de ACTION_SENDTO amaçları için metin ve resimleri işlediğini varsayalım. Bu durumda, iki işlem için iki ayrı intent filtresi tanımlamanız gerekir. Bunun nedeni, ACTION_SENDTO intent'inin, send veya sendto URI şemasını kullanarak alıcının adresini belirtmek için Uri verilerini kullanması gerektiğidir. Bu durum aşağıdaki örnekte gösterilmektedir:
<activity android:name="ShareActivity"> <!-- Filter for sending text; accepts SENDTO action with sms URI schemes --> <intent-filter> <action android:name="android.intent.action.SENDTO"/> <category android:name="android.intent.category.DEFAULT"/> <data android:scheme="sms" /> <data android:scheme="smsto" /> </intent-filter> <!-- Filter for sending text or images; accepts SEND action and text or image data --> <intent-filter> <action android:name="android.intent.action.SEND"/> <category android:name="android.intent.category.DEFAULT"/> <data android:mimeType="image/*"/> <data android:mimeType="text/plain"/> </intent-filter> </activity>
Not: Örtük intent'leri almak için intent filtresine CATEGORY_DEFAULT kategorisini eklemeniz gerekir. startActivity() ve startActivityForResult() yöntemleri, tüm intent'leri CATEGORY_DEFAULT kategorisini beyan etmiş gibi değerlendirir. Intent filtrenizde bunu belirtmezseniz hiçbir örtülü intent, etkinliğinize çözümlenmez.
Sosyal medya paylaşımı davranışları gerçekleştiren ACTION_SEND intent'leri gönderme ve alma hakkında daha fazla bilgi için Diğer uygulamalardan basit veriler alma başlıklı makaleyi inceleyin.
Veri paylaşımıyla ilgili faydalı bilgileri Basit verileri paylaşma ve Dosya paylaşma bölümlerinde de bulabilirsiniz.
Etkinliğinizde intent'i işleme
Etkinliğinizde hangi işlemi yapacağınıza karar vermek için etkinliği başlatmak üzere kullanılan Intent okuyun.
Etkinliğiniz başladığında, etkinliği başlatan Intent değerini almak için getIntent() yöntemini çağırın. Bunu etkinliğin yaşam döngüsü boyunca istediğiniz zaman yapabilirsiniz ancak genellikle onCreate() veya onStart() gibi erken geri çağırmalar sırasında yaparsınız.
Bu durum aşağıdaki örnekte gösterilmektedir:
Kotlin
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.main) val data: Uri? = intent?.data // Figure out what to do based on the intent type if (intent?.type?.startsWith("image/") == true) { // Handle intents with image data } else if (intent?.type == "text/plain") { // Handle intents with text } }
Java
@Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); // Get the intent that started this activity Intent intent = getIntent(); Uri data = intent.getData(); // Figure out what to do based on the intent type if (intent.getType().indexOf("image/") != -1) { // Handle intents with image data } else if (intent.getType().equals("text/plain")) { // Handle intents with text } }
Sonuç döndürme
Sizinkini çağıran etkinliğe bir sonuç döndürmek istiyorsanız sonuç kodunu ve Intent sonucunu belirtmek için setResult() yöntemini çağırın. İşleminiz tamamlandığında ve kullanıcı orijinal etkinliğe döndüğünde etkinliğinizi kapatıp yok etmek için finish() yöntemini çağırın. Bu durum aşağıdaki örnekte gösterilmektedir:
Kotlin
// Create intent to deliver some kind of result data Intent("com.example.RESULT_ACTION", Uri.parse("content://result_uri")).also { result -> setResult(Activity.RESULT_OK, result) } finish()
Java
// Create intent to deliver some kind of result data Intent result = new Intent("com.example.RESULT_ACTION", Uri.parse("content://result_uri")); setResult(Activity.RESULT_OK, result); finish();
Sonuçla birlikte her zaman bir sonuç kodu belirtmeniz gerekir. Genellikle RESULT_OK veya RESULT_CANCELED şeklindedir. Ardından, gerektiğinde Intent ile ek veriler sağlayabilirsiniz.
Not: Sonuç varsayılan olarak RESULT_CANCELED değerine ayarlanır. Bu nedenle, kullanıcı işlemi tamamlamadan ve siz sonucu ayarlamadan önce geri düğmesine dokunursa orijinal etkinlik "iptal edildi" sonucunu alır.
Birkaç sonuç seçeneğinden birini belirten bir tam sayı döndürmeniz gerekiyorsa sonuç kodunu 0'dan büyük herhangi bir değere ayarlayabilirsiniz. Sonuç kodunu bir tam sayı döndürmek için kullanıyorsanız ve Intent öğesini eklemeniz gerekmiyorsa setResult() yöntemini çağırıp yalnızca bir sonuç kodu iletebilirsiniz:
Kotlin
setResult(RESULT_COLOR_RED) finish()
Java
setResult(RESULT_COLOR_RED); finish();
Bu durumda, yalnızca birkaç olası sonuç olabilir. Bu nedenle sonuç kodu, yerel olarak tanımlanmış bir tam sayıdır (0'dan büyük). Bu yöntem, kendi uygulamanızdaki bir etkinliğe sonuç döndürürken iyi sonuç verir. Çünkü sonucu alan etkinlik, sonuç kodunun değerini belirlemek için herkese açık sabite başvurabilir.
Not: Etkinliğinizin startActivity() veya startActivityForResult() ile başlatılıp başlatılmadığını kontrol etmeniz gerekmez. Etkinliğinizi başlatan intent bir sonuç bekliyorsa setResult() yöntemini çağırın. Başlatan etkinlik startActivityForResult() yöntemini çağırdıysa sistem, setResult() yöntemine sağladığınız sonucu etkinliğe iletir. Aksi takdirde sonuç yoksayılır.