Android Developers:向其它应用发送用户

Android的一个非常重要的功能是，应用程序基于它要执行的一个“动作”想其它应用程序发送用户的能力。例如，如果你的应用程序要显示一个地图，你没有在你的应用程序中创建显示地图的Activity。相反，你使用一个Intent创建了请求查看地址。Android系统然后启动一个应用，它能在地图上显示地址。

正如在第一课中解释的，Building Your First App，你必须使用intent在你自己应用中的各个Activity之间导航。你通常使用显式意图来做它，它定义了你想要启动的组件的确切类名。然而，当你想要一个分开的应用执行一个动作的时候，例如“查看地图“，你必须使用一个隐式意图。

这个课程向你展示了如何创建一个特殊动作的隐式意图来，并如何使用它来启动一个Activity，它在其它的应用中执行动作。

构建一个隐式意图

——————————————————————————————————————————————————————————————

隐式意图没有声明要启动的组件的类名，但是声明了要指定的动作来代替。这个动作指明了你想要做的事情，例如查看，编辑，或者获取一些东西。意图通常也包含数据相关的动作，例如你想要查看的地址，你想发送的邮件地址。基于你想要创建的Intent，数据可能是一个Uri，其它数据类型之一，或者意图可能不需要数据。

如果你的数据是一个Uri，这里有一个简答的Intent()构造器，你能使用它来定义动作和数据。

例如，这里展示如何创建一个Intent来初始化一个电话呼叫，使用Uri数据来指定电话号码：

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

当你的应用通过startActivity()方法调用这个Intent的时候，Phone应用程序给这个给予的电话号码启动一个呼叫。

这里是一组其它意图和他们的动作和Uri数据对：

• 查看地图：

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

其它类型的隐式意图要求提供不同数据类型的”额外“数据，例如一个字符串。你能使用各种各样的putExtra()方法添加一个或者多个额外数据。

默认，系统通过Intent包含的Uri数据来决定要求的正确的MIME类型。如果你在这个Itent中不包含一个Uri，你通常应该使用setType()方法来指定这个意图相关的数据类型。设置MIME类型指定将获取这个意图的Activity的类型。

这里有更多的Intent，添加了额外的数据来指定想要的动作：

• 发送带有附件的邮件：

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[] {"[e-mail]"}); // 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"); 

注意：用于日历事件的意图仅仅在API level 14或者更高的版本中被支持。

注意：尽可能具体的定义你的Intent是非常重要的。例如，如果你想使用ACTION_VIEW意图来显示一个图片，你应该指明iamge/* IMIE类型。这阻止了能“查看”其它类型数据（如一个地图应用）的应用程序被这个Intent触发。

核实有获取这个意图的应用

——————————————————————————————————————————————————————————————

尽管Android平台保证某些意图将会被内置的应用解析（如Phone，Email， 或者Calendar应用程序），你应该总是在调用一个意图之前包含一个核实的步骤。

当心：如果你调用一个Intent，并且在设备上没有应用程序可以处理这个Itent，你的应用将会崩溃。

为了核实是否有一个Activity有效响应这个Itent，调用queryItentActivities()方法来获取能处理你的Intent的Activity。如果被返回的列表不是空的，你可以安全的使用这个Intent。例如：

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

如果isIntentSafe是ture，那么至少一个应用程序将响应这个Intent。如果它是false，那么没有任何应用程序能处理这个Intent。

注意：你应该执行这个检查，当你的Activity第一次启动

使用Intent启动一个Activity

——————————————————————————————————————————————————————————————

一旦你创建你的Intent，并设置了额外的信息，调用startActivity()方法向系统发送它。如果系统识别超过一个Activity能处理这个intent,，它向用户显示一个对话框，来选择将要使用哪个应用，如图1所示。如果这里仅仅有一个activity能处理这个Intent，系统立刻启动它：

startActivity(intent);

这里是一个完整的例子，它显示了如何创建一个Intent来查看地图，检查存在一个处理这个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); 
} 

显示一个应用选择器

——————————————————————————————————————————————————————————————

注意到，当你通过传递你的Intent给startActivity()方法启动一个Activity，并且这里有超过一个应用响应这个Intent，用户能选择那个应用默认被使用（通过选择在对话框底部的一个checkbox；查看图1）。当用户通每次想使用相同的应用来执行的时候是非常好的，例如当打开一个网页（用户喜很可能仅仅使用一个浏览器）或者获取一张照片（用户 很可能执行照相机）。然而，如果将要执行的动作可以通过多个应用程序处理，并且用户每次可能执行不同的应用—例如一个“分享”动作，用户可能有多个应用，通过它们用户分享一个选项—你应该明白地显示一个选择器对话框，它强制用户来选择哪个应用被每次被用户这个动作（用户不能为动作选择一个默认的应用程序）。

为了显示这个选择器，创建一个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); 

这显示了一个有一列应用程序的对话框，它们响应传递给createChooser()方法的意图，并使用提供的文本作为对话框的标题。