Android官方开发教程中文版(七)

Android官方开发教程中文版

和其它App交互

和其它App交互

一个Android App通常有几个Activity，每个Activity显示一个用户界面以允许用户执行特定的任务（如查看地图和获得照片）。要让用户从一个Activity到另一个Activity，你必须使用Intent来定义App的“目的”以完成某些任务。当你把一个Intent对象通过startActivity()这样的方法传递给系统时，系统使用Intent来标识和启动适当的App组件。使用Intent甚至允许你启动一个其它App中的Activity。

一个Intent可以是“显示的”以启动一个特定组件（一个特定的Activity实例），

或者“隐式的”以启动任意组件来处理预定的操作（如“捕捉相片”）。

本课程将展示如何使用Intent执行某些和其它App的基本交互，例如启动另一个App，从那个App中接收结果，以及让你的App响应来自其它App的意向。

把用户发送到其它App

Android系统最重要的特点之一就是一个应用基于它想执行的操作，可以把用户发送到另一个App。例如，如果你的App想把一个商业地址显示在地图上，你不需要在App中创建Activity显示地图。相反，你可以使用Intent对象创建一个查看地址的请求。Android系统可以启动一个能在地图上显示地址的App。

在第一节课“创建你的第一个App”中，已经说明了必须使用Intent对象在App的两个Activity之间导航。通常使用一个“显示的”Intent来完成这件事，它定义了你想开始的组件的确切的类名。当你希望一个不同的App来执行某个操作，如“查看地图”时，你必须使用“隐式的”Intent。

本节内容展示了如何为特定操作创建隐式Intent，以及如何用它启动另一个App的Activity来执行操作。

构建隐式Intent

隐式Intent不需要声明要启动组件的类名，它需要声明要执行的操作。操作指明了你要做的事，如查看、编辑、发送和获取某些东西。Intent通常还包含了操作关联的数据，例如你想查看的地址、或要发送的Email消息。你想依靠Intent创建的数据可能是Uri，几个其它数据类型之一，或者可能是Intent不需要的数据。

如果你的数据是一个Uri，你可用Intent对象的一个简单的构造函数定义操作和数据。

下例是如何创建一个使用Uri数据指定电话号码拨打电话的Intent对象：

Uri number = Uri.parse("tel:5551234");

Intent callIntent = new Intent(Intent.ACTION_DIAL, number);

当你的App通过startActivity()调用这个Intent时，拨号程序用给定的电话号码拨出一个电话。

下面是几个其它目的的操作和Uri数据对。

查看地图

// 基于地址在地图上定位

Uri location=

Uri.parse("geo:0,0?q=1600+Amphitheatre+Parkway,+Mountain+View,+California");

// 或基于经纬度在地图上定位

// Uri location = Uri.parse("geo:37.422219,-122.08364?z=14"); // 参数z是缩放级别

Intent mapIntent = new Intent(Intent.ACTION_VIEW, location);

查看Web页面

Uri webpage = Uri.parse("https://www.360docs.net/doc/c115596303.html,");

Intent webIntent = new Intent(Intent.ACTION_VIEW, webpage);

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

默认情况下，系统根据Intent包含的Uri数据判定MIME类型。如果Intent中不包含Uri 数据，你应该用setType()方法指定关联到Intent的数据类型。设置MIME类型有助于决定应该由哪种特定的Activity接收Intent。

以下是对Intent添加额外数据以指定想要的操作：

发送带附件的Email：

Intent emailIntent = new Intent(Intent.ACTION_SEND);

// 这个Intent对象没有URI数据，所以声明"text/plain" MIME 类型

emailIntent.setType(HTTP.PLAIN_TEXT_TYPE);

emailIntent.putExtra(Intent.EXTRA_EMAIL, new String[] {"jon@https://www.360docs.net/doc/c115596303.html,"}); // 收件人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"));

// 你也可以传递Uri的ArrayList来添加多个附件

创建日历事件：

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定义成特定的Intent。例如，如果你希望使用ACTION_VIEW Intent显示图片，你应该指定MIME类型为“image/*”。这可以防止由Intent触发的App（例如地图App）“查看”其它数据类型。

验证接收Intent的App

虽然Android平台可以确保某些Intent被解析为内建的App之一（例如拨号、Email和日历App），但你应该总是在调用目标之前包含一个验证步骤。

警告：如果设备上没有App能处理你的Intent，你的App将崩溃。

验证是否有Activity能响应Intent，调用queryIntentActivities()方法获得能够处理你的Intent对象的Activity列表，如果列表不为空，你可以安全地使用这个Intent，如：PackageManager packageManager = getPackageManager();

List activities = packageManager.queryIntentActivities(intent, 0);

boolean isIntentSafe = activities.size() > 0;

如果isIntentSafe为true，那么至少有一个App能处理这个Intent，否则没有任何App 能处理这个Intent。

注意：当Activity首次启动时，你应该执行这个检查，以防止在用户尝试使用它之前，所需要的功能被禁止了。如果你知道某个App可以处理这个Intent，你也可提供一个链接以便让用户下载这个App（参见如何“链接到你在Google Play上的产品”）。

随Intent启动Activity

一旦创建了Intent对象并设置了“额外”信息，调用startActivity()方法把Intent发送给系统。如果系统确定有多个Activity可以处理这个Intent，系统将会显示一个对话框让用户选择使用哪个App，如下图所示。

如果只有一个Activity可以处理这个Intent，系统会立即启动它。

startActivity(intent);

下面是一个完整的例子，演示了如何创建一个查看地图的Intent，验证处理这个Intent 的App是否存在，然后启动它：

// 构建Intent

Uri location =

Uri.parse("geo:0,0?q=1600+Amphitheatre+Parkway,+Mountain+View,+California");

Intent mapIntent = new Intent(Intent.ACTION_VIEW, location);

// 验证

PackageManager packageManager = getPackageManager();

List activities = packageManager.queryIntentActivities(mapIntent, 0);

boolean isIntentSafe = activities.size() > 0;

// 如果是安全的，启动它

if (isIntentSafe) {

startActivity(mapIntent);

}

显示App选择器

注意到当你传递Intent给startActivity()并且有多个App可以响应这个Intent时，用户可以选择哪个App成为默认App（勾选上图的对话框底部的复选框）。当用户常常希望每次都用同样的App执行某个操作时，比如打开Web页面（用户可能就用某个Web浏览器），或拍照（用户可能更喜欢某个照相机），这个设定很不错。

如果一个操作的执行可以被多个App处理，并且用户可能更喜欢每次用不同的App，比如“共享”操作，用户可能有好几个App可以共享一个项目，你应该明确显示一个如下图的选择对话框。选择对话框强制用户为每次操作选择一个App（用户不能为这个操作指定默认App）。

要显示选择器，使用createChooser()创建一个Intent对象，并把它传递给startActivity()：Intent intent = new Intent(Intent.ACTION_SEND);

...

// 总是为UI文本使用字符串资源

// 这里的资源是类似于"Share this photo with"的内容

String title = getResources().getString(R.string.chooser_title);

// 创建显示选择器的Intent对象

Intent chooser = Intent.createChooser(intent, title);

// 验证要处理的Intent，保证至少有一个Activity

if (intent.resolveActivity(getPackageManager()) != null) {

startActivity(chooser);

}

这会显示一个包含能够处理传递给createChooser()的Intent的App列表的对话框，并用提供的文本做为对话框的标题。

从Activity中获取结果

启动另一个Activity并不是单向的。你也可以启动Activity并接收它返回的结果。要接收结果，使用startActivityForResult()替换startActivity()方法。

例如，你的App可以启动一个相机App并把相片做为结果接收。或者，你也可以为了

使用联系人启动联系人App并把联系人详细信息做为结果接收。

当然，响应的Activity必须被设计为有返回结果，这样一来，它会发送结果给另一个Intent 对象，你的Activity可以在onActivityResult()回调方法中接收它。

注意：当你调用startActivityForResult()方法时，你可使用“显示”或“隐式”Intent。当启动你自己的Activity接收结果时，你应该使用“显示”Intent以确保你收到的是期望的结果。

启动Activity

当启动Activity接收结果时，关于Intent对象没有什么特别的。但你需要传递一个额外的整数给startActivityForResult()方法。

这个整数是一个标识你的请求的“请求代码”。当你接收结果Intent时，回调方法会提供同样的请求代码，这样你的App可以正确地识别结果并决定如何处理它。

下例是如何启动Activity并允许用户获取联系人：

static final int PICK_CONTACT_REQUEST = 1; // 请求代码

...

private void pickContact() {

Intent pickContactIntent =

new Intent(Intent.ACTION_PICK, Uri.parse("content://contacts"));

pickContactIntent.setType(Phone.CONTENT_TYPE); // 仅显示联系人的电话号码

startActivityForResult(pickContactIntent, PICK_CONTACT_REQUEST);

}

接收结果

当用户在随后的Activity中完成操作并返回时，系统调用你的Activity中的onActivityResult()回调方法，这个方法包括三个参数：

●你传递给startActivityForResult()的请求代码。

●由第二个Activity指定的结果代码。如果用户操作成功，它是RESULT_OK，如果用

户退出或是因为某种原因操作失败，它是RESULT_CANCEL。

●携带结果的Intent对象。

下例是如何处理带联系人的Intent结果：

@Override

protected void onActivityResult(int requestCode, int resultCode, Intent data) { // 检查我们响应的是哪个请求

if (requestCode == PICK_CONTACT_REQUEST) {

// 确保请求成功

if (resultCode == RESULT_OK) {

// 用户获得一个联系人.

// Intent的数据Uri标识了哪个联系人被选择

// 处理联系人的代码（更大的示例在下面）

}

}

}

在这个例子中，结果Intent由Android的联系人或人群App提供一个内容Uri，它标识

了用户选择的联系人。

为了成功处理结果，你必须了解结果Intent的格式。当Activity返回的结果是你自己的Activity之一，这很容易做到。App包含了Android系统为它们提供的API，你可以用来计算这些特殊的返回数据。例如，联系人App总是返回包括标识所选择的联系人的内容Uri的结果，照相机App则在“额外”数据中返回Bitmap对象（参见关于“拍照”的课程）。

福利：读取联系人数据

上面的代码演示了如何从联系人App中获得结果，但是没有深入到如何从结果中读取数据的细节。因为这需要更多关于“内容提供者”的高级探讨。如果你很好奇，这里有一些代码演示了如何查询结果数据，以获得选择的联系人的电话号码：

@Override

protected void onActivityResult(int requestCode, int resultCode, Intent data) { // 检查我们响应的是哪个请求

if (requestCode == PICK_CONTACT_REQUEST) {

// 确保请求是成功的

if (resultCode == RESULT_OK) {

// 获得指向所选择的联系人的URI

Uri contactUri = data.getData();

// 我们只需要NUMBER列，结果集中只有一行

String[] projection = {Phone.NUMBER};

// 对联系人执行查询以获得号码列

// 不需要选择或排序（给定的URI只有一个结果）

// 警告：query()方法应该从独立线程中调用，以避免阻塞应用的UI线程

// （为简化示例，这里没有这样做）

// 考虑使用CursorLoader执行查询

Cursor cursor = getContentResolver()

.query(contactUri, projection, null, null, null);

cursor.moveToFirst();

// 从NUMBER列中检索电话号码

int column = cursor.getColumnIndex(Phone.NUMBER);

String number = cursor.getString(column);

// 处理电话号码...

}

}

}

注意：在Android2.3（API级别9）之前，在“联系人提供者”中执行查询（象上面演示的那样），需要在App中声明READ_CONTRACTS权限（参见“安全与权限”）。从Android2.3开始，当联系人App返回结果给你的App时，它会授与App读取“联系人提供者”的临时权限。临时权限只能用于特定的联系人请求，所以你不能在其它情况下从Intent的Uri中查询联系人，除非你声明READ_CONTRACTS权限。

允许其它App启动你的Activity

前面两节课关注的都是故事的一面：从你的Activity中启动另一个App的Activity。但是如果你的App能执行一个对其它App有用的操作，那么你的App应该随时准备响应来自其它App对该操作的请求。例如，你构建了一个社交App，它可以把消息和相片分享给用户的朋友，那么你最好能支持ACTION_SEND Intent，这样用户可以在另一个App中通过执行“共享”操作来启动你的App并执行该操作。

要允许其它App启动你的Activity，你需要在清单文件中相应的元素中添加一个元素。

当你的App安装到设备上时，系统会识别你的Intent过滤器，并把信息添加到所有已安装的App支持的Intent内部目录中。当一个App通过隐式Intent调用startActivity()或startActivityForResult()时，系统查找哪一个（或哪一些）Activity能够响应这个Intent。

添加Intent过滤器

为了正确地声明你的Activity可以处理哪个Intent，你添加的每个Intent过滤器都应该在Activity可接受的数据和操作类型上尽量特别。

系统可能会给一个Activity发送指定的Intent对象，只要这个Activity有一个满足下列Intent对象标准的Intent过滤器：

Action

一个可执行的操作的字符串名称。通常是平台定义的值之一，如ACTION_SEND或

ACTION_VIEW。

在你的过滤器用元素指定它。元素的值必须是操作的完整字符串名称，而

不是API常量（参见下面的示例）。

Data

和Intent关联的数据描述。

在过滤器中用元素指定它。这个元素可以使用一个或多个属性，你可以指定

MIME类型、URI前缀、URI架构或以上的组合以及其它可接受的数据类型。

注意：如果你不需要有关数据URI的细节（比如你的Activity处理是其它类型的“额

外”数据，而不是URI），你应该仅指定android:mimeType属性，声明你的Activity

要处理的数据类型，比如text/plain或image/jpeg。

Category

提供描述Activity处理Intent的额外方式，通常和用户的手势和开始的位置有关。

系统支持几个不同的类别，但大部分很少用。默认情况下，所有隐式Intent都被定

义成CATEGORY_DEFAULT。

在过滤器的元素中指定它。

在你的Intent过滤器中，你可以在元素中对应的XML元素中定义这些Activity接受的标准。

下面是一个当数据类型是text或imae，可以处理ACTION_SEND的Activity及Intent过滤器的例子：

每个传入的Intent只有一个操作和一种数据类型，但是在中为、和元素声明多个实例是没问题的。

如果任何两对操作和数据是互相排斥的，你应该创建单独的Intent过滤器指定哪些操作搭配哪些数据类型是可以接受的。

例如，假设你的Activity可以为ACTION_SEND和ACTION_SENDTO处理text和image，你必须为两种操作定义两个单独的Intent过滤器，因为ACTION_SENDTO必须使用应用send 或sendto URI架构的数据URI指定收件人的地址。

注意：为了接收隐式Intent，你必须在过滤器中包括CATEGORY_DEFAULT。startActivity()和startActivityForResult()方法对所有的Intent都像它们声明了CATEGORY_DEFAULT一样。

如果你没有在Intent过滤器声明它，Activity将不会解析Intent。

更多用来执行社交分享行为的，有关发送和接收的ACTION_SEND Intent的信息请参见“从其它App中接收简单数据”。

在Activoty中处理Intent

为了决定在Activity中采取何种操作，你可以读取Intent来启动它。

Activity启动时，调用getIntent()方法接收启动Activity的Intent。你可以在Activity生命周期内的任何时间这么做，但通常应该在“较早”的回调方法中如onCreate()或onStart()。

例如：

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(https://www.360docs.net/doc/c115596303.html,yout.main);

// Get the intent that started this activity

Intent intent = getIntent();

Uri data = intent.getData();

// Figure out what to do based on the intent type

if (intent.getType().indexOf("image/") != -1) {

// Handle intents with image data ...

} else if (intent.getType().equals("text/plain")) {

// Handle intents with text ...

}

}

返回结果

如果你想返回一个结果给调用你的Activity，直接调用setResult()指定结果代码并返回Intent。当用户操作完成并返回最初的Activity时，调用finish()方法关闭（或销毁）你的Activity。例如：

// 创建Intent以传递某些返回数据

Intent result =

new Intent("com.example.RESULT_ACTION", Uri.parse("content://result_uri");

setResult(Activity.RESULT_OK, result);

finish();

你必须总是为结果指定结果代码，它通常是RESULT_OK或RESULT_CANCEL，必要的话，你还可以在Intent在提供额外数据。

注意：默认情况下结果代码被设置为RESULT_CANCEL。因此，用户在操作完成和你设置结果之前按下“Back”按纽，最初的Activity会接收到“取消”。

如果你只是需要返回表示几个可选结果之一的整数，你可以把结果代码设置为任何大于0的数。如果你要用结果代码传递整数并且不需要Intent，你可以调用setResult()并且仅仅传递一个结果代码。如：

setResult(RESULT_COLOR_RED);

finish();

在这个例子中，可返回的结果较少，因此结果代码是一个本地声明的整数（大于0）。这在把结果返回到自己的App中的Activity时没有问题，因为接收结果的Activity可以引用这个公开的常量来决定结果代码的值。

注意：不需要检查你的Activity是由startActivity()还是startActivityForResult()方法启动的。如果启动Activity的Intent需要一个结果，直接调用setResult()。如果最初的Activity调用了startActivityForResult()，系统会把setResult()方法设置的结果传递给它，否则，结果被忽略。