Kullanıcıyı başka bir uygulamaya gönderme

Android'in en önemli özelliklerinden biri, bir uygulamanın gerçekleştirmek istediği "işleme" göre kullanıcıyı başka bir uygulamaya gönderebilmesidir. Örneğin, uygulamanızda harita üzerinde göstermek istediğiniz bir işletmenin adresi varsa uygulamanızda harita gösteren bir etkinlik oluşturmanız gerekmez. Bunun yerine, Intent kullanarak adresi görüntüleme isteği oluşturabilirsiniz. Android sistemi, adresi haritada gösterebilecek bir uygulama başlatır.

İlk derste (İlk Uygulamanızı Oluşturma) açıklandığı gibi, kendi uygulamanızdaki etkinlikler arasında gezinmek için intent'leri kullanmanız gerekir. Bunu genellikle başlatmak istediğiniz bileşenin tam sınıf adını tanımlayan açık bir intent ile yaparsınız. Ancak "haritayı görüntüleme" gibi bir işlemi ayrı bir uygulamanın gerçekleştirmesini istediğinizde dolaylı intent kullanmanız gerekir.

Bu derste, belirli bir işlem için örtük intent oluşturmayı ve bunu başka bir uygulamada işlemi gerçekleştiren bir etkinliği başlatmak için nasıl kullanacağınızı öğreneceksiniz. Ayrıca, örtük intent'leriniz için çalışma zamanı kontrolleri eklemenizin neden önemli olduğunu anlamak için buraya yerleştirilmiş videoyu da izleyin.

Örtülü niyet oluşturma

Örtük intent'ler, başlatılacak bileşenin sınıf adını değil, gerçekleştirilecek işlemi bildirir. İşlem, yapmak istediğiniz şeyi belirtir. Örneğin, bir şeyi görüntüleme, düzenleme, gönderme veya alma.

Amaç işlemlerini verilerle ilişkilendirme

Intent'ler genellikle görüntülemek istediğiniz adres veya göndermek istediğiniz e-posta iletisi gibi işlemle ilişkili verileri de içerir. Oluşturmak istediğiniz amaca bağlı olarak veriler Uri veya diğer veri türlerinden biri olabilir ya da amaç için hiç veri gerekmeyebilir.

Verileriniz Uri ise işlemi ve verileri tanımlamak için kullanabileceğiniz basit bir Intent() oluşturucu vardır.

Örneğin, telefon numarasını belirtmek için Uri verilerini kullanarak telefon araması başlatma amacıyla bir intent oluşturma yöntemi aşağıda verilmiştir:

Kotlin

val callIntent: Intent = Uri.parse("tel:5551234").let { number ->
    Intent(Intent.ACTION_DIAL, number)
}

Java

Uri number = Uri.parse("tel:5551234");
Intent callIntent = new Intent(Intent.ACTION_DIAL, number);

Uygulamanız startActivity() yöntemini çağırarak bu intent'i başlattığında Telefon uygulaması, belirtilen telefon numarasını arar.

Aşağıda, diğer birkaç intent ve bunların işlem ve Uri veri çiftleri verilmiştir:

Haritayı görüntüleme

Kotlin

// Map point based on address
val mapIntent: Intent = Uri.parse(
        "geo:0,0?q=1600+Amphitheatre+Parkway,+Mountain+View,+California"
).let { location ->
    // Or map point based on latitude/longitude
    // val location: Uri = Uri.parse("geo:37.422219,-122.08364?z=14") // z param is zoom level
    Intent(Intent.ACTION_VIEW, location)
}

Java

// Map point based on address
Uri location = Uri.parse("geo:0,0?q=1600+Amphitheatre+Parkway,+Mountain+View,+California");
// Or map point based on latitude/longitude
// Uri location = Uri.parse("geo:37.422219,-122.08364?z=14"); // z param is zoom level
Intent mapIntent = new Intent(Intent.ACTION_VIEW, location);

Web sayfasını görüntüleme

Kotlin

val webIntent: Intent = Uri.parse("https://www.android.com").let { webpage ->
    Intent(Intent.ACTION_VIEW, webpage)
}

Java

Uri webpage = Uri.parse("https://www.android.com");
Intent webIntent = new Intent(Intent.ACTION_VIEW, webpage);

Bir amaca ekstralar ekleme

Diğer örtük intent türleri, dize gibi farklı veri türleri sağlayan "ekstra" veriler gerektirir. Çeşitli putExtra() yöntemlerini kullanarak bir veya daha fazla ek veri ekleyebilirsiniz.

Sistem, varsayılan olarak bir intent için gereken uygun MIME türünü, içerdiği Uri verilerine göre belirler. Amaca Uri eklemezseniz genellikle amaçla ilişkili veri türünü belirtmek için setType() kullanmanız gerekir. MIME türünü ayarlamak, intent'i hangi etkinlik türlerinin alması gerektiğini daha ayrıntılı bir şekilde belirtir.

İstenen işlemi belirtmek için ek veri ekleyen diğer bazı intent'ler şunlardır:

Ekli bir e-posta gönderme

Kotlin

Intent(Intent.ACTION_SEND).apply {
    // The intent does not have a URI, so declare the "text/plain" MIME type
    type = "text/plain"
    putExtra(Intent.EXTRA_EMAIL, arrayOf("jan@example.com")) // recipients
    putExtra(Intent.EXTRA_SUBJECT, "Email subject")
    putExtra(Intent.EXTRA_TEXT, "Email message text")
    putExtra(Intent.EXTRA_STREAM, Uri.parse("content://path/to/email/attachment"))
    // You can also attach multiple items by passing an ArrayList of Uris
}

Java

Intent emailIntent = new Intent(Intent.ACTION_SEND);
// The intent does not have a URI, so declare the "text/plain" MIME type
emailIntent.setType(HTTP.PLAIN_TEXT_TYPE);
emailIntent.putExtra(Intent.EXTRA_EMAIL, new String[] {"jan@example.com"}); // recipients
emailIntent.putExtra(Intent.EXTRA_SUBJECT, "Email subject");
emailIntent.putExtra(Intent.EXTRA_TEXT, "Email message text");
emailIntent.putExtra(Intent.EXTRA_STREAM, Uri.parse("content://path/to/email/attachment"));
// You can also attach multiple items by passing an ArrayList of Uris

Takvim etkinliği oluşturma

Not: Takvim etkinliği için bu intent yalnızca API düzeyi 14 ve sonraki sürümlerde desteklenir.

Kotlin

// Event is on January 23, 2021 -- from 7:30 AM to 10:30 AM.
Intent(Intent.ACTION_INSERT, Events.CONTENT_URI).apply {
    val beginTime: Calendar = Calendar.getInstance().apply {
        set(2021, 0, 23, 7, 30)
    }
    val endTime = Calendar.getInstance().apply {
        set(2021, 0, 23, 10, 30)
    }
    putExtra(CalendarContract.EXTRA_EVENT_BEGIN_TIME, beginTime.timeInMillis)
    putExtra(CalendarContract.EXTRA_EVENT_END_TIME, endTime.timeInMillis)
    putExtra(Events.TITLE, "Ninja class")
    putExtra(Events.EVENT_LOCATION, "Secret dojo")
}

Java

// Event is on January 23, 2021 -- from 7:30 AM to 10:30 AM.
Intent calendarIntent = new Intent(Intent.ACTION_INSERT, Events.CONTENT_URI);
Calendar beginTime = Calendar.getInstance();
beginTime.set(2021, 0, 23, 7, 30);
Calendar endTime = Calendar.getInstance();
endTime.set(2021, 0, 23, 10, 30);
calendarIntent.putExtra(CalendarContract.EXTRA_EVENT_BEGIN_TIME, beginTime.getTimeInMillis());
calendarIntent.putExtra(CalendarContract.EXTRA_EVENT_END_TIME, endTime.getTimeInMillis());
calendarIntent.putExtra(Events.TITLE, "Ninja class");
calendarIntent.putExtra(Events.EVENT_LOCATION, "Secret dojo");

Not: Intent değerinizi mümkün olduğunca ayrıntılı bir şekilde tanımlamanız önemlidir. Örneğin, ACTION_VIEW intent'ini kullanarak bir resim görüntülemek istiyorsanız image/* MIME türünü belirtmeniz gerekir. Bu sayede, diğer veri türlerini "görüntüleyebilen" uygulamaların (ör. harita uygulaması) intent tarafından tetiklenmesi önlenir.

Intent ile etkinlik başlatma

Intent nesnenizi oluşturup ek bilgileri ayarladıktan sonra sisteme göndermek için startActivity() yöntemini çağırın:

Kotlin

startActivity(intent)

Java

startActivity(intent);

Hiçbir uygulamanın intent alamadığı durumları ele alma

Birçok intent, cihazda yüklü olan başka bir uygulama (ör. telefon, e-posta veya takvim uygulaması) tarafından başarıyla işlense de uygulamanız, uygulamanızın intent'ini işleyebilecek hiçbir etkinliğin olmadığı duruma hazırlıklı olmalıdır. Bir intent'i her çağırdığınızda, uygulamanızın intent'ini işleyebilecek başka bir etkinlik yoksa ortaya çıkan ActivityNotFoundException hatasını yakalamaya hazır olun:

Kotlin

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

Java

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

Bu istisnayı yakaladıktan sonra uygulamanızın bir sonraki işlemine karar verin. Bu sonraki adım, çağırmaya çalıştığınız intent'in belirli özelliklerine bağlıdır. Örneğin, intent'i işleyebilecek belirli bir uygulama biliyorsanız kullanıcının uygulamayı indirmesi için bir bağlantı sağlayın. Google Play'de ürününüze nasıl bağlantı vereceğiniz hakkında daha fazla bilgi edinin.

Anlam belirsizliğini giderme iletişim kutusu

Sistem, intent'i işleyebilecek birden fazla etkinlik tanımlarsa kullanıcının hangi uygulamayı kullanacağını seçmesi için bir iletişim kutusu (bazen "anlam belirsizliğini giderme iletişim kutusu" olarak adlandırılır) gösterir (Şekil 1'de gösterildiği gibi). Intent'i işleyen tek bir etkinlik varsa sistem bu etkinliği hemen başlatır.

Ekranın alt kısmına yakın bir yerde bir panel görünür. Bu panelde, intent'i işleyebilecek farklı uygulamalar listelenir.

Şekil 1. Bir intent'i birden fazla uygulamanın işleyebildiği durumlarda gösterilen seçim iletişim kutusu örneği.

Eksiksiz örnek

Aşağıda, harita görüntüleme amacıyla intent oluşturma, intent'i işleyecek bir uygulamanın mevcut olduğunu doğrulama ve ardından intent'i başlatma işlemlerinin nasıl yapılacağını gösteren eksiksiz bir örnek verilmiştir:

Kotlin

// Build the intent.
val location = Uri.parse("geo:0,0?q=1600+Amphitheatre+Parkway,+Mountain+View,+California")
val mapIntent = Intent(Intent.ACTION_VIEW, location)

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

Java

// Build the intent.
Uri location = Uri.parse("geo:0,0?q=1600+Amphitheatre+Parkway,+Mountain+View,+California");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, location);

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

Uygulama seçici gösterme

Şekil 2. Seçici iletişim kutusu.

Intent öğenizi startActivity() öğesine ileterek bir etkinlik başlattığınızda ve amaca yanıt veren birden fazla uygulama olduğunda kullanıcının varsayılan olarak hangi uygulamayı kullanacağını seçebileceğini (iletişim kutusunun altındaki bir onay kutusunu işaretleyerek; bkz. Şekil 1) unutmayın. Bu, kullanıcının genellikle her seferinde aynı uygulamayı kullanmak istediği bir işlem gerçekleştirirken (ör. web sayfası açma [kullanıcılar muhtemelen yalnızca bir web tarayıcısı kullanır] veya fotoğraf çekme [kullanıcılar muhtemelen bir kamerayı tercih eder]) kullanışlıdır.

Ancak gerçekleştirilecek işlem birden fazla uygulama tarafından gerçekleştirilebiliyorsa ve kullanıcı her seferinde farklı bir uygulama tercih edebiliyorsa (ör. kullanıcıların bir öğeyi paylaşabileceği birden fazla uygulamaya sahip olabileceği bir "paylaşma" işlemi) Şekil 2'de gösterildiği gibi açıkça bir seçici iletişim kutusu göstermeniz gerekir. Seçici iletişim kutusu, kullanıcıyı her seferinde işlem için hangi uygulamanın kullanılacağını seçmeye zorlar (kullanıcı, işlem için varsayılan bir uygulama seçemez).

Seçiciyi göstermek için createChooser() kullanarak bir Intent oluşturun ve bunu startActivity() yöntemine iletin. Örneğin:

Kotlin

val intent = Intent(Intent.ACTION_SEND)

// Create intent to show chooser
val chooser = Intent.createChooser(intent, /* title */ null)

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

Java

Intent intent = new Intent(Intent.ACTION_SEND);

// Create intent to show chooser
Intent chooser = Intent.createChooser(intent, /* title */ null);

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

Bu işlem, createChooser() yöntemine iletilen intent'e yanıt veren uygulamaların listesini içeren bir iletişim kutusu gösterir. İşlem ACTION_SEND veya ACTION_SEND_MULTIPLE değilse title parametresi sağlanabilir.