把用戶帶到另外一個應用程序
Android最重要的特點就是,基於用戶不同的動作,它能把用戶帶到另外一個應用程序。例如:如果你的APP 有一個商業地址需要在地圖上顯示,你不用在自己的APP中新建一個活動來顯示這個地圖,相反,你可以通過intent來發送查看這個地址的請求。Android系統會自動啓動一個能在地圖上查看這個地址的APP.
我們知道,當你需要啓動本應用中其它的活動時,你能夠通過一個顯示的intent,然後指定需要被啓動的組件類名。然後,當需要被啓動的組件在另外一個APP中時,你就必須使用一個隱式的intent.
這篇文章主要講的就是如果爲一個特定的action創建一個隱式的intent,以及如何利用它來啓動其它APP中的活動來執行這個action.
創建一個隱式的intent
隱式的intent不會指定要啓動的組件類名,相反,它定義一個action 來執行。這個action指定了你要做的事情,例如:查看,編輯,發送,獲得等等。跟這個action想關聯的包括一個數據,例如你要查看的地址,你要發送的郵件類容,取決於你要創建的intent,數據可能是一個Uri,或者其它數據類型,也可能沒有數據。
如下是一些定義隱式intent的例子
第一個是撥打電話的隱式intent:
Uri number = Uri.parse(“tel:5551234”);
Intent callIntent = new Intent(Intent.ACTION_DIAL,number);
當你的APP 通過startActivity()來喚起這個intent時,電話APP就會給指定的號碼打電話。
第二個是查看地圖:
// 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);
第三個是查看網頁:
Uri webpage = Uri.parse(“http://www.android.com”);
Intent webIntent = new Intent(Intent.ACTION_VIEW,webpage);
提供其它數據類型的隱式intent 需要額外數據,例如字符串。不能夠通過不同putExtra()方法來添加多個額外數據。
通常情況下,系統會根據intent所包含的Uri數據來決定intent的MIME類型。如果你的intent中沒有U ri,你應該通過setType()來指定跟這個intent相關的數據類型。設定MIME 類型進一步指定哪些活動應該接收這個intent.
如下是一些添加了額外數據的intent,來指定期望的action.
發送一個包含附件的郵件:
Intent emailIntent =newIntent(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,newString[]{"[email protected]"});// 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
創建一個日曆事件
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");
注意:一個日曆事件的intent只適應於API 14 或者更高。
注意:定義隱式intent的時候越明確越好。例如,當你要查看一個圖片的時候,使用ACTION_VIEW,同時,你還應該指定MIME 類型爲image/*.這樣才能阻止能查看其它數據類型的APP觸發(例如地圖APP).
查證至少有一個APP能接收這個intent
儘管Android平臺保證一些intents可以有系統內置的APP去響應(例如電話,郵件,日曆等),你還是應該在調用一個intent之前驗證下。
警告:如果你調用一個intent之後,設備上沒有APP能夠處理intent,你的APP就會崩潰掉。
調用queryIntentActivities()
就能夠得到所有能響應這個intent的活動。如果返回的List不爲空,,你就能安全使用這個intent.
例子:
PackageManager packageManager = getPackageManager();
List<ResolveInfo> activities = packageManager.queryIntentActivities(intent, 0);
boolean isIntentSafe = activities.size() > 0;
如果isIntentSafe爲真的話,表示至少有一個APP能響應這個intent.如果爲假表示沒有任何APP能響應這個intent.
注意:你應該在你的活動第一次start時進行這個驗證。因爲在用戶嘗試使用它之前,你要讓使用這個intent的功能不可用。如果你知道某個APP能處理這個intent,你也可以一個鏈接讓用戶去下載這個APP.(詳見如果讓你的設備鏈接到Google Play).
使用Intent啓動一個活動
一旦你創建了一個intent,幷包含額外數據,然後調用startActivity()把它傳遞給系統。如果系統找到多餘一個活動能處理這個intent的時候,系統會彈出一個列表來供用戶選擇啓動哪個。如果只有一個活動,那麼系統就直接啓動它。
startActivity(intent);
如下是一個完整的例子,它通過一個intent來顯示地圖,驗證有APP能處理這個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選擇器
當一個Intent有多個APP可以響應的時候,系統會彈出一個對話框給用戶選擇。對話框的底部有一個設置爲默認的選項,當勾選了這個以後,每次都會啓動同一個APP(不用用戶選擇)。但是某些時候,可能用戶每次需要選擇的APP都不一樣,例如分享的時候,這時候就應該創建一個每次都需要選擇,不提供默認的APP對話框。
爲了顯示這種選擇框,使用Intent.createChooser()並將其傳遞給startActivity()
例子:
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);
這樣就能創建一個對話框了,對話框裏面的APP是能夠處理傳遞給createChooser()的intent的APP.對話框的標題 傳遞給它的title.