Intent的发送

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

Android中最重要的特征之一就是可以利用一个带有action的intent使当前app能够跳转到其他app。例如：如果我们的app有一个地址想要显示在地图上，我们并不需要在app里面创建一个activity用来显示地图，而是使用Intent来发出查看地址的请求。Android系统则会启动能够显示地图的程序来呈现该地址。

正如在1.1章节:建立你的第一个App(Building Your First App)中所说的，我们必须使用intent来在同一个app的两个activity之间进行切换。通常是定义一个显式（explicit）的intent，它指定了需要启动组件的类名。然而，当想要唤起不同的app来执行某个动作（比如查看地图），则必须使用隐式（implicit）的intent。

本课会介绍如何为特殊的动作创建一个implicit intent，并使用它来启动另一个app去执行intent中的action。

建立隐式的Intent

Implicit intents并不声明要启动组件的具体类名，而是声明一个需要执行的action。这个action指定了我们想做的事情，例如查看，编辑，发送或者是获取一些东西。Intents通常会在发送action的同时附带一些数据，例如你想要查看的地址或者是你想要发送的邮件信息。数据的具体类型取决于我们想要创建的Intent，比如Uri或其他规定的数据类型，或者甚至也可能根本不需要数据。

如果数据是一个Uri，会有一个简单的Intent() constructor 用于定义action与data。

例如，下面是一个带有指定电话号码的intent。

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

当app通过执行startActivity()启动这个intent时，Phone app会使用之前的电话号码来拨出这个电话。

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

  • 查看地图:
  1. // Map point based on address
  2. Uri location = Uri.parse("geo:0,0?q=1600+Amphitheatre+Parkway,+Mountain+View,+California");
  3. // Or map point based on latitude/longitude
  4. // Uri location = Uri.parse("geo:37.422219,-122.08364?z=14"); // z param is zoom level
  5. Intent mapIntent = new Intent(Intent.ACTION_VIEW, location);
  • 查看网页:
  1. Uri webpage = Uri.parse("http://www.android.com");
  2. Intent webIntent = new Intent(Intent.ACTION_VIEW, webpage);

至于另外一些需要extra数据的implicit intent，我们可以使用 putExtra() 方法来添加那些数据。
默认的，系统会根据Uri数据类型来决定需要哪些合适的MIME type。如果我们没有在intent中包含一个Uri, 则通常需要使用 setType() 方法来指定intent附带的数据类型。设置MIME type 是为了指定应该接受这个intent的activity。例如：

  • 发送一个带附件的email:
  1. Intent emailIntent = new Intent(Intent.ACTION_SEND);
  2. // The intent does not have a URI, so declare the "text/plain" MIME type
  3. emailIntent.setType(HTTP.PLAIN_TEXT_TYPE);
  4. emailIntent.putExtra(Intent.EXTRA_EMAIL, new String[] {"jon@example.com"}); // recipients
  5. emailIntent.putExtra(Intent.EXTRA_SUBJECT, "Email subject");
  6. emailIntent.putExtra(Intent.EXTRA_TEXT, "Email message text");
  7. emailIntent.putExtra(Intent.EXTRA_STREAM, Uri.parse("content://path/to/email/attachment"));
  8. // You can also attach multiple items by passing an ArrayList of Uris
  • 创建一个日历事件:
  1. Intent calendarIntent = new Intent(Intent.ACTION_INSERT, Events.CONTENT_URI);
  2. Calendar beginTime = Calendar.getInstance().set(2012, 0, 19, 7, 30);
  3. Calendar endTime = Calendar.getInstance().set(2012, 0, 19, 10, 30);
  4. calendarIntent.putExtra(CalendarContract.EXTRA_EVENT_BEGIN_TIME, beginTime.getTimeInMillis());
  5. calendarIntent.putExtra(CalendarContract.EXTRA_EVENT_END_TIME, endTime.getTimeInMillis());
  6. calendarIntent.putExtra(Events.TITLE, "Ninja class");
  7. calendarIntent.putExtra(Events.EVENT_LOCATION, "Secret dojo");

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

Note: 请尽可能的将Intent定义的更加确切。例如，如果想要使用ACTION_VIEW 的intent来显示一张图片，则还应该指定 MIME type 为image/*.这样能够阻止其他能够 “查看” 其他数据类型的app（比如一个地图app) 被这个intent叫起。

验证是否有App去接收这个Intent

尽管Android系统会确保每一个确定的intent会被系统内置的app(such as the Phone, Email, or Calendar app)之一接收，但是我们还是应该在触发一个intent之前做验证是否有App接受这个intent的步骤。

Caution: 如果触发了一个intent，而且没有任何一个app会去接收这个intent，则app会crash。

为了验证是否有合适的activity会响应这个intent，需要执行queryIntentActivities() 来获取到能够接收这个intent的所有activity的list。若返回的List非空，那么我们才可以安全的使用这个intent。例如：

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

如果isIntentSafe为true, 那么至少有一个app可以响应这个intent。false则说明没有app可以handle这个intent。

Note:我们必须在第一次使用之前做这个检查，若是不可行，则应该关闭这个功能。如果知道某个确切的app能够handle这个intent，我们也可以向用户提供下载该app的链接。(see how to link to your product on Google Play).

使用Intent启动Activity

当创建好了intent并且设置好了extra数据后，通过执行startActivity() 将intent发送到系统。若系统确定了多个activity可以handle这个intent,它会显示出一个dialog，让用户选择启动哪个app。如果系统发现只有一个app可以handle这个intent，则系统将直接启动该app。

  1. startActivity(intent);

http://static.bookstack.cn/projects/android-training-course-in-chinese/basics/intents/intents-choice.png

下面是一个演示了如何创建一个intent来查看地图的完整例子，首先验证有app可以handle这个intent,然后启动它。

  1. // Build the intent
  2. Uri location = Uri.parse("geo:0,0?q=1600+Amphitheatre+Parkway,+Mountain+View,+California");
  3. Intent mapIntent = new Intent(Intent.ACTION_VIEW, location);
  5. // Verify it resolves
  6. PackageManager packageManager = getPackageManager();
  7. List<ResolveInfo> activities = packageManager.queryIntentActivities(mapIntent, 0);
  8. boolean isIntentSafe = activities.size() > 0;
  10. // Start an activity if it's safe
  11. if (isIntentSafe) {
  12.     startActivity(mapIntent);
  13. }

显示分享App的选择界面

请注意，当以startActivity()的形式传递一个intent，并且有多个app可以handle时，用户可以在弹出dialog的时候选择默认启动的app（通过勾选dialog下面的选择框，如上图所示）。该功能对于用户有特殊偏好的时候非常有用（例如用户总是喜欢启动某个app来查看网页，总是喜欢启动某个camera来拍照）。

然而，如果用户希望每次都弹出选择界面，而且每次都不确定会选择哪个app启动，例如分享功能，用户选择分享到哪个app都是不确定的，这个时候，需要强制弹出选择的对话框。（这种情况下用户不能选择默认启动的app）。

intent-chooser.png

为了显示chooser, 需要使用createChooser()来创建Intent

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

这样就列出了可以响应createChooser()中Intent的app，并且指定了标题。