Android發(fā)送Intent

編寫:kesenhoo - 原文:http://developer.android.com/training/basics/intents/sending.html

Android中最重要的特征之一就是可以利用一個帶有action的intent使當(dāng)前app能夠跳轉(zhuǎn)到其他app。例如：如果我們的app有一個地址想要顯示在地圖上，我們并不需要在app里面創(chuàng)建一個activity用來顯示地圖，而是使用Intent來發(fā)出查看地址的請求。Android系統(tǒng)則會啟動能夠顯示地圖的程序來呈現(xiàn)該地址。

正如在1.1章節(jié):建立你的第一個App(Building Your First App)中所說的，我們必須使用intent來在同一個app的兩個activity之間進(jìn)行切換。通常是定義一個顯式（explicit）的intent，它指定了需要啟動組件的類名。然而，當(dāng)想要喚起不同的app來執(zhí)行某個動作（比如查看地圖），則必須使用隱式（implicit）的intent。

本課會介紹如何為特殊的動作創(chuàng)建一個implicit intent，并使用它來啟動另一個app去執(zhí)行intent中的action。

建立隱式的Intent

Implicit intents并不聲明要啟動組件的具體類名，而是聲明一個需要執(zhí)行的action。這個action指定了我們想做的事情，例如查看，編輯，發(fā)送或者是獲取一些東西。Intents通常會在發(fā)送action的同時附帶一些數(shù)據(jù)，例如你想要查看的地址或者是你想要發(fā)送的郵件信息。數(shù)據(jù)的具體類型取決于我們想要創(chuàng)建的Intent，比如Uri或其他規(guī)定的數(shù)據(jù)類型，或者甚至也可能根本不需要數(shù)據(jù)。

如果數(shù)據(jù)是一個Uri，會有一個簡單的Intent() constructor 用于定義action與data。

例如，下面是一個帶有指定電話號碼的intent。

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

當(dāng)app通過執(zhí)行startActivity()啟動這個intent時，Phone app會使用之前的電話號碼來撥出這個電話。

下面是一些其他intent的例子：

• 查看地圖:

// 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);

• 查看網(wǎng)頁:

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

至于另外一些需要extra數(shù)據(jù)的implicit intent，我們可以使用 putExtra() 方法來添加那些數(shù)據(jù)。 默認(rèn)的，系統(tǒng)會根據(jù)Uri數(shù)據(jù)類型來決定需要哪些合適的MIME type。如果我們沒有在intent中包含一個Uri, 則通常需要使用 setType() 方法來指定intent附帶的數(shù)據(jù)類型。設(shè)置MIME type 是為了指定應(yīng)該接受這個intent的activity。例如：

• 發(fā)送一個帶附件的email:

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[] {"jon@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

• 創(chuàng)建一個日歷事件:

Intent calendarIntent = new Intent(Intent.ACTION_INSERT, Events.CONTENT_URI);
Calendar beginTime = Calendar.getInstance().set(2012, 0, 19, 7, 30);
Calendar endTime = Calendar.getInstance().set(2012, 0, 19, 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");

Note: 這個intent for Calendar的例子只使用于>=API Level 14。

Note: 請盡可能的將Intent定義的更加確切。例如，如果想要使用ACTION_VIEW 的intent來顯示一張圖片，則還應(yīng)該指定 MIME type 為image/*.這樣能夠阻止其他能夠 "查看" 其他數(shù)據(jù)類型的app（比如一個地圖app) 被這個intent叫起。

驗證是否有App去接收這個Intent

盡管Android系統(tǒng)會確保每一個確定的intent會被系統(tǒng)內(nèi)置的app(such as the Phone, Email, or Calendar app)之一接收，但是我們還是應(yīng)該在觸發(fā)一個intent之前做驗證是否有App接受這個intent的步驟。

Caution: 如果觸發(fā)了一個intent，而且沒有任何一個app會去接收這個intent，則app會crash。

為了驗證是否有合適的activity會響應(yīng)這個intent，需要執(zhí)行queryIntentActivities() 來獲取到能夠接收這個intent的所有activity的list。若返回的List非空，那么我們才可以安全的使用這個intent。例如：

PackageManager packageManager = getPackageManager();
List<ResolveInfo> activities = packageManager.queryIntentActivities(intent, 0);
boolean isIntentSafe = activities.size() > 0;

如果isIntentSafe為true, 那么至少有一個app可以響應(yīng)這個intent。false則說明沒有app可以handle這個intent。

Note:我們必須在第一次使用之前做這個檢查，若是不可行，則應(yīng)該關(guān)閉這個功能。如果知道某個確切的app能夠handle這個intent，我們也可以向用戶提供下載該app的鏈接。(see how to link to your product on Google Play).

使用Intent啟動Activity

當(dāng)創(chuàng)建好了intent并且設(shè)置好了extra數(shù)據(jù)后，通過執(zhí)行startActivity() 將intent發(fā)送到系統(tǒng)。若系統(tǒng)確定了多個activity可以handle這個intent,它會顯示出一個dialog，讓用戶選擇啟動哪個app。如果系統(tǒng)發(fā)現(xiàn)只有一個app可以handle這個intent，則系統(tǒng)將直接啟動該app。

startActivity(intent);

下面是一個演示了如何創(chuàng)建一個intent來查看地圖的完整例子，首先驗證有app可以handle這個intent,然后啟動它。

// 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);

// Verify it resolves
PackageManager packageManager = getPackageManager();
List<ResolveInfo> activities = packageManager.queryIntentActivities(mapIntent, 0);
boolean isIntentSafe = activities.size() > 0;

// Start an activity if it's safe
if (isIntentSafe) {
    startActivity(mapIntent);
}

顯示分享App的選擇界面

請注意，當(dāng)以startActivity()的形式傳遞一個intent，并且有多個app可以handle時，用戶可以在彈出dialog的時候選擇默認(rèn)啟動的app（通過勾選dialog下面的選擇框，如上圖所示）。該功能對于用戶有特殊偏好的時候非常有用（例如用戶總是喜歡啟動某個app來查看網(wǎng)頁，總是喜歡啟動某個camera來拍照）。

然而，如果用戶希望每次都彈出選擇界面，而且每次都不確定會選擇哪個app啟動，例如分享功能，用戶選擇分享到哪個app都是不確定的，這個時候，需要強制彈出選擇的對話框。（這種情況下用戶不能選擇默認(rèn)啟動的app）。

為了顯示chooser, 需要使用createChooser()來創(chuàng)建Intent

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

// Always use string resources for UI text. This says something like "Share this photo with"
String title = getResources().getText(R.string.chooser_title);
// Create and start the chooser
Intent chooser = Intent.createChooser(intent, title);
startActivity(chooser);

這樣就列出了可以響應(yīng)createChooser()中Intent的app，并且指定了標(biāo)題。