Intent的发送
最后更新于:2022-04-01 01:37:53
> 编写:[kesenhoo](https://github.com/kesenhoo) - 原文:[http://developer.android.com/training/basics/intents/sending.html](http://developer.android.com/training/basics/intents/sending.html)
Android中最重要的特征之一就是可以利用一个带有`action`的`intent`使当前app能够跳转到其他app。例如:如果我们的app有一个地址想要显示在地图上,我们并不需要在app里面创建一个[activity](# "An activity represents a single screen with a user interface.")用来显示地图,而是使用Intent来发出查看地址的请求。Android系统则会启动能够显示地图的程序来呈现该地址。
正如在1.1章节:[建立你的第一个App(Building Your First App)](#)中所说的,我们必须使用intent来在同一个app的两个[activity](# "An activity represents a single screen with a user interface.")之间进行切换。通常是定义一个显式(explicit)的intent,它指定了需要启动组件的类名。然而,当想要唤起不同的app来执行某个动作(比如查看地图),则必须使用隐式(implicit)的intent。
本课会介绍如何为特殊的动作创建一个implicit intent,并使用它来启动另一个app去执行intent中的action。
### 建立隐式的Intent
Implicit intents并不声明要启动组件的具体类名,而是声明一个需要执行的action。这个action指定了我们想做的事情,例如查看,编辑,发送或者是获取一些东西。Intents通常会在发送action的同时附带一些数据,例如你想要查看的地址或者是你想要发送的邮件信息。数据的具体类型取决于我们想要创建的Intent,比如[Uri](http://developer.android.com/reference/android/net/Uri.html)或其他规定的数据类型,或者甚至也可能根本不需要数据。
如果数据是一个Uri,会有一个简单的[Intent()](http://developer.android.com/reference/android/content/Intent.html#Intent(java.lang.String, android.net.Uri)) constructor 用于定义action与data。
例如,下面是一个带有指定电话号码的intent。
~~~
Uri number = Uri.parse("tel:5551234");
Intent callIntent = new Intent(Intent.ACTION_DIAL, number);
~~~
当app通过执行[startActivity()](http://developer.android.com/reference/android/app/Activity.html#startActivity(android.content.Intent))启动这个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);
~~~
- 查看网页:
~~~
Uri webpage = Uri.parse("http://www.android.com");
Intent webIntent = new Intent(Intent.ACTION_VIEW, webpage);
~~~
至于另外一些需要`extra`数据的implicit intent,我们可以使用 [putExtra()](http://developer.android.com/reference/android/content/Intent.html#putExtra(java.lang.String, java.lang.String)) 方法来添加那些数据。默认的,系统会根据Uri数据类型来决定需要哪些合适的`MIME type`。如果我们没有在intent中包含一个Uri, 则通常需要使用 [setType()](http://developer.android.com/reference/android/content/Intent.html#setType(java.lang.String)) 方法来指定intent附带的数据类型。设置MIME type 是为了指定应该接受这个intent的[activity](# "An activity represents a single screen with a user interface.")。例如:
- 发送一个带附件的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
~~~
- 创建一个日历事件:
~~~
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来显示一张图片,则还应该指定 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](# "An activity represents a single screen with a user interface.")会响应这个intent,需要执行[queryIntentActivities()](http://developer.android.com/reference/android/content/pm/PackageManager.html#queryIntentActivities(android.content.Intent, int)) 来获取到能够接收这个intent的所有[activity](# "An activity represents a single screen with a user interface.")的list。若返回的[List](http://developer.android.com/reference/java/util/List.html)非空,那么我们才可以安全的使用这个intent。例如:
~~~
PackageManager packageManager = getPackageManager();
List<ResolveInfo> activities = packageManager.queryIntentActivities(intent, 0);
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](http://developer.android.com/distribute/googleplay/promote/linking.html)).
### 使用Intent启动[Activity](# "An activity represents a single screen with a user interface.")
当创建好了intent并且设置好了extra数据后,通过执行startActivity() 将intent发送到系统。若系统确定了多个[activity](# "An activity represents a single screen with a user interface.")可以handle这个intent,它会显示出一个dialog,让用户选择启动哪个app。如果系统发现只有一个app可以handle这个intent,则系统将直接启动该app。
~~~
startActivity(intent);
~~~
![intents-choice.png](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2015-07-28_55b724704fc82.png "Figure 1. Example of the selection dialog that appears when more than one app can handle an intent")
下面是一个演示了如何创建一个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的选择界面
请注意,当以startActivity()的形式传递一个intent,并且有多个app可以handle时,用户可以在弹出dialog的时候选择默认启动的app(通过勾选dialog下面的选择框,如上图所示)。该功能对于用户有特殊偏好的时候非常有用(例如用户总是喜欢启动某个app来查看网页,总是喜欢启动某个camera来拍照)。
然而,如果用户希望每次都弹出选择界面,而且每次都不确定会选择哪个app启动,例如分享功能,用户选择分享到哪个app都是不确定的,这个时候,需要强制弹出选择的对话框。(这种情况下用户不能选择默认启动的app)。
![intent-chooser.png](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2015-07-28_55b724705cd66.png "Example of the chooser dialog that appears when you use createChooser() to ensure that the user is always shown a list of apps that respond to your intent.")
为了显示chooser, 需要使用[createChooser()](http://developer.android.com/reference/android/content/Intent.html#createChooser(android.content.Intent, java.lang.CharSequence))来创建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);
~~~
这样就列出了可以响应`createChooser()`中Intent的app,并且指定了标题。