安卓19开发文档翻译：意图,Intent

Articles
Now reading
User manage
Category
Blind Box

Read times:1855Posted at:

- no title specified

类概述

意图，是对即将进行的某个操作的抽象描述。它可有以下用途：用在 startActivity 中，以启动一个 Activity ；用在 broadcastIntent 中，以将它发送到任何对它感兴趣的 BroadcastReceiver 组件；用在 startService(Intent) 或 bindService(Intent, ServiceConnection, int) 中，以与一个后台 Service 进行交互。

意图，提供的是一种在不同应用程序之间进行延迟运行时绑定的机制。对它最典型的用途就是用来启动活动，在这个用途中，它可认为是不同活动之间的胶水。本质上，它是一个被动的数据结构，其中储存着对于某个将要进行的动作的抽象描述。

开发者指南

欲知如何创建及解析意图，则阅读意图及意图过滤器开发者指南。

意图结构

意图中包含的基本信息有：

•. 动作 —— 要进行的常规动作，例如 ACTION_VIEW 、 ACTION_EDIT 、 ACTION_MAIN 等等。
•. 数据 —— 要对其进行操作的数据，例如联系人数据库里的某个联系人记录，以 Uri 的形式表示。

以下是一些动作/数据对示例：

•. ACTION_VIEW content://contacts/people/1 —— 显示编号为"1"的联系人的信息。
•. ACTION_DIAL content://contacts/people/1 —— 显示拨号盘，并且填入指定用户的号码。
•. ACTION_VIEW tel:123 —— 显示拨号盘，并且填入指定的号码。注意感受一下，对于每个特定的URI，VIEW 动作都会做出被认为是最适合的事。
•. ACTION_DIAL tel:123 —— 显示拨号盘，并且填入指定的号码。
•. ACTION_EDIT content://contacts/people/1 —— 编辑编号为"1"的联系人的信息。
•. ACTION_VIEW content://contacts/people/ —— 显示联系人列表，供用户浏览。一般会显示出联系人应用程序，以显示出联系人列表。当用户选择要查看某个联系人时，会导致发出一个新的意图 { ACTION_VIEW content://contacts/N } ，以启动一个活动来显示该联系人的信息。

除了这些主要属性之外，还有一些附加属性，妳可以在意图中包含它们：

•. category —— 对于要执行的动作，给出额外的信息。例如： CATEGORY_LAUNCHER ，表示，它应当作为一个顶级应用程序出现在启动器中；而， CATEGORY_ALTERNATIVE ，表示，对于某一砣数据，它应当被包含在一个替代动作列表里，供用户选择。
•. type—— 为该意图中的数据指定一个显式的类型（一个多媒体类型）。正常情况下，类型是由数据本身内容来推断的。设置了这个属性之后，就会禁用那种自动判断功能，而强制使用显式设置的类型。
•. component—— 显式指定要用于此意图的组件类的名字。正常情况下，是检查该意图中的其它信息（动作、数据/类型、类别）来找到一个相匹配的能够处理该意图的组件。如果妳设置了这个属性，那么，就不会进行那些判断，而是直接使用这里所指定的组件。设置了这个属性之后，其它的Intent属性都变成可选的了。
•. extras —— 这是由额外信息组成的一个 Bundle 。这个属性可用来向该组件提供额外的信息。例如，假设我们有一个动作用来发送邮件，那么，我们可以利用这个属性来提供额外数据，以表达邮件主题、正文等等。

以下是妳可以对意图使用的其它一些额外参数：

•. ACTION_MAIN 并将类别设置为 CATEGORY_HOME —— 将会启动主屏幕。
•. ACTION_GET_CONTENT 并将多媒体类型设置为 vnd.android.cursor.item/phone —— 显示联系人们的电话号码列表，让用户浏览并且选中一个，被选中的那个将会返回给亲代活动。
•. ACTION_GET_CONTENT 并将多媒体类型设置为 */* ，将类别设置为 CATEGORY_OPENABLE ——显示出可由 ContentResolver.openInputStream() 打开的数据对应的所有选择器，让用户从中选择一个，然后再选择数据，并将选中的数据的URI返回给调用者。这狠有用，例如，在邮件应用程序中，可让用户选择一些数据来作为附件发送。

在Intent类中已经定义了狠多标准的Intent动作和类别常量，但是，应用程序仍然可以定义它们自己的常量。这些字符串使用 java风格的命名空间习惯，以确保它们是唯一的——例如，标准的 ACTION_VIEW ，其字符串值是 "android.intent.action.VIEW" 。

好了，将这些东西组合到一起之后呢，实际上就是，动作的集合、数据类型、类别和额外数据，它们一起定义了一种语言，系统用这种语言来表达一些操作目标，例如“拨打阿宗的手机号码”。随着新的应用程序被添加到系统中，它们能够通过添加新的动作、类型和类别来扩展这门语言，它们也可以修改已有短语所对应的行为，具体做法就是提供自己的能够处理这些短语的活动。

意图的解析

妳所使用的意图，有两种主要形式。

•. 显式意图指定了一个组件 (通过 setComponent(ComponentName) 或 setClass(Context, Class) ) ，它精确指定了要运行哪个类。这种形式下，通常不会包含其它信息，只是被应用程序用来在与用户交互的过程中启动各种内部活动。
•. 隐式意图并未指定组件；它们必须提供足够多的信息，以让系统来决定，哪个组件最适合于用来处理该意图。

在使用隐式意图时，在给出了这样一个任意类型的意图之后，我们需要知道该如何处理它。这就要靠意图解析过程来处理了，它会将一个 Intent映射到一个可以处理它的 Activity 、 BroadcastReceiver 或 Service ( 有些时候，会是两个或更多活动/接收器 ) 上去。

意图解析机制的基本过程是，将一个 Intent 与已安装的应用程序包中声明的所有 <intent-filter>描述进行匹配。 ( 另外，对于广播，还需要检查已经使用 registerReceiver(BroadcastReceiver, IntentFilter) 显式注册过的所有 BroadcastReceiver 对象。 ) 在 IntentFilter 类的文档中可看到更详细的说明。

Intent中三个方面的信息会用于解析过程：动作、类型和类别。系统会使用这个信息，向 PackageManager 查询，找到一个能够处理该意图的组件。候选的组件，会以 AndroidManifest.xml 文件中提供的意图信息为依据，按照以下方法来确定：

•. 动作（action），如果指定了这个的话，那么，候选的组件必须已经声明自己能够处理它。
•.类型（ type ），如果该Intent 中未指定的话，则会从该Intent 的数据中推断出来。与动作属性一样，如果在意图中包含了一个类型（无论是显式指定还是利用数据来隐式指定）的话，那么，候选的组件必须已经声明自己能够处理它。
•. 对于那种并非为 content: 类型URI 的数据，如果在Intent中也没有包含显式类型的话，则，会考虑该意图数据中的 scheme (例如 http: 或 mailto: ) 。同样地，与动作属性类似，候选的组件必须已经声明自己能够处理它。
•. 如果指定了 categories ，则，候选的活动应该已经声明自己能够处理它。也就是说，如果妳加入了 CATEGORY_LAUNCHER 和 CATEGORY_ALTERNATIVE 两个类别，那么，只有那些同时声明了这两个类别的组件才被成为候选组件。活动通常都需要支持 CATEGORY_DEFAULT 这个类别，这样就会被 Context.startActivity() 所发现。

例如，我们来研究一下Note Pad示例程序。它可以让用户浏览一个记录列表，并且查看单个条目的详情。斜体的文字内容表示，妳应当使用自己软件包中特定的名字来代替它。

<manifest xmlns:android="http://schemas.android.com/apk/res/android"

package=" com.android.notepad ">

<application android:icon="@drawable/app_notes"

android:label="@string/app_name">

<provider class=".NotePadProvider"

android:authorities=" com.google.provider.NotePad " />

<intent-filter>

</intent-filter>

<intent-filter>

</intent-filter>

<intent-filter>

</intent-filter>

</activity>

<intent-filter android:label="@string/resolve_edit">

</intent-filter>

<intent-filter>

</intent-filter>

</activity>

<activity class=".TitleEditor" android:label="@string/title_edit_title"

android:theme="@android:style/Theme.Dialog">

<intent-filter android:label="@string/resolve_title">

</intent-filter>

</activity>

</application>

</manifest>

第一个活动， com.android.notepad.NotesList ，充当着该应用程序的主入口。从它的3个意图模板可以看出，它能够做3件事情：

1. <intent-filter>

<action android:name=" android.intent.action.MAIN " />

<category android:name=" android.intent.category.LAUNCHER " />

</intent-filter>

这就是NotePad 应用程序的顶级入口：标准的MAIN动作表示一个主入口点(不需要在Intent中提供任何其它的信息)，而LAUNCHER这个类别表明此入口点应当在应用程序启动器中列出。
2. <intent-filter>

<action android:name=" android.intent.action.VIEW " />

<action android:name=" android.intent.action.EDIT " />

<action android:name=" android.intent.action.PICK " />

<category android:name=" android.intent.category.DEFAULT " />

<data mimeType:name="vnd.android.cursor.dir/ vnd.google.note " />

</intent-filter>

此处声明了此活动能够对一个记录目录能够做的事。所支持的类型是由<type>标记来指定的，此处的 vnd.android.cursor.dir/vnd.google.note 是一个 URI ，从该URI处可获取到一个对应着 0个或多个（ vnd.android.cursor.dir ）条目的Cursor，其中就储存着我们的记事本数据( vnd.google.note )。在这个活动中，用户可以（通过VIEW和EDIT动作）查看或编辑此目录中的数据，或者，（通过PICK动作）选中特定的某条记录并且返回给调用者。还要注意此处提供的DEFAULT 类别：如果在 Context.startActivity 中没有显式指定组件名字的话，那么，只有在妳的活动声明了这个类别的情况下才会被该方法计算在内。
3. <intent-filter>

<action android:name=" android.intent.action.GET_CONTENT " />

<category android:name=" android.intent.category.DEFAULT " />

<data android:mimeType="vnd.android.cursor.item/ vnd.google.note " />

</intent-filter>

这个过滤器，表明本活动具有以下能力：向调用者返回一个由用户选择的记录条目，而调用者不用关心它是来自哪里的。此处的数据类型， vnd.android.cursor.item/vnd.google.note ，是一个 URI ，其中包含着一个仅包含单个（ vnd.android.cursor.item ）条目的Cursor，该条目中包含着我们的记事本数据（ vnd.google.note ）。 GET_CONTENT动作与 PICK动作类似，此活动会向其调用者返回由用户选择的数据内容。区别就是，调用者会指定它们想要的数据类型。

利用这些能力，就可以让以下意图解析到NotesList 活动：

•. { action=android.app.action.MAIN } 它能够匹配到所有能够作为应用程序顶级入口的活动。
•. { action=android.app.action.MAIN, category=android.app.category.LAUNCHER } 是使用的实际意图，它使用这个意图来填充自己的顶级入口列表。
•. { action=android.intent.action.VIEW data=content://com.google.provider.NotePad/notes } 显示出"content://com.google.provider.NotePad/notes"之下的所有记事条目，用户可在其中浏览，并且查看细节。
•. { action=android.app.action.PICK data=content://com.google.provider.NotePad/notes } 列出"content://com.google.provider.NotePad/notes"之下的所有记事条目，用户可从中选择一个记事条目，该条目的数据URL会被返回给调用者。
•. { action=android.app.action.GET_CONTENT type=vnd.android.cursor.item/vnd.google.note } 类似于选取（pick）动作，但是，允许调用者指定它们想要返回的数据类型，这样，系统就能够找到适当的活动来选择某些具有该数据类型的东西。

第二个活动， com.android.notepad.NoteEditor ，会向用户显示一个单个的记录条目，以让用户编辑它。按照它的两个意图模板来看，它能够做两件事情：

1. <intent-filter android:label="@string/resolve_edit">

<action android:name=" android.intent.action.VIEW " />

<action android:name=" android.intent.action.EDIT " />

<category android:name=" android.intent.category.DEFAULT " />

<data android:mimeType="vnd.android.cursor.item/ vnd.google.note " />

</intent-filter>

此活动的第一个目的，也就是首要目的，就是，让用户与单条记录交互，记录的类型是多媒体类型 vnd.android.cursor.item/vnd.google.note 。此活动可查看（VIEW）一条记录，或者让用户编辑（EDIT）该条记录。另外，我们也支持DEFAULT类别，这样，在不显式指定此组件的情况下也能够启动此活动了。
2. <intent-filter>

<action android:name=" android.intent.action.INSERT " />

<category android:name=" android.intent.category.DEFAULT " />

<data android:mimeType="vnd.android.cursor.dir/ vnd.google.note " />

</intent-filter>

此活动的第二个用途就是，向一个已有的记录目录里插入一个新的记录条目。当用户创建一个新的记录时，会用上这个：会在记录条目目录中执行INSERT动作，使得此活动运行起来并且让创建新记录的数据内容，之后会将该内容添加到内容提供者。

利用这些能力，可以让以下意图解析到NoteEditor活动：

•. { action=android.intent.action.VIEW data=content://com.google.provider.NotePad/notes/ {ID} } 向用户显示编号为 {ID} 的记录的内容。
•. { action=android.app.action.EDIT data=content://com.google.provider.NotePad/notes/ {ID} } 让用户编辑编号为 {ID} 的记录的内容。
•. { action=android.app.action.INSERT data=content://com.google.provider.NotePad/notes } 在位于"content://com.google.provider.NotePad/notes"的记录列表中创建一个新的、空白的记录，并且让用户编辑它。如果用户将编辑的内容保存了，则，新创建的记录的URI会被返回给调用者。

最后一个活动， com.android.notepad.TitleEditor ，用来让用户编辑某个记录的标题。这个活动，本来可以实现成一个被应用程序直接调用（显式地在Intent中设置它的组件）的类，但是，此处我们有意向妳展示如何在已有的数据上发布替代操作：

<intent-filter android:label="@string/resolve_title">

</intent-filter>

在此处的单个意图模板中，我们创建了我们自己的私有动作，名为 com.android.notepad.action.EDIT_TITLE ，含意即为，编辑一个记录的标题。就像之前的查看和编辑动作一样，此动作也必须针对某个特定的记录（数据类型 vnd.android.cursor.item/vnd.google.note ）来调用，只不过，此处显示及编辑的是记录数据中包含的标题。

除了支持通常的默认类别之外，我们的标题编辑器还支持另外两个标准类别： ALTERNATIVE 和 SELECTED_ALTERNATIVE 。实现这两个类别，就使得，其它的组件可以在并不知晓它的情况下得知它能够提供的特殊动作，具体做法就是：调用 queryIntentActivityOptions(ComponentName, Intent[], Intent, int) 方法；或者，更常见的是，使用 addIntentOptions(int, int, int, ComponentName, Intent[], Intent, int, MenuItem[]) 来构建动态的菜单条目。注意，在此处的意图模板中，我们还提供了一个显式的模板名字 ( android:label="@string/resolve_title" ) ，以精确地控制用户在为她/他们正在查看的数据选择替代动作时所看到的关于此活动的说明。

利用这些能力，可以让以下意图解析到TitleEditor 活动：

•. { action=com.android.notepad.action.EDIT_TITLE data=content://com.google.provider.NotePad/notes/ {ID} } 显示并且让用户编辑与编号为 {ID} 的记录相关联的标题。

标准的活动动作

以下是由Intent 定义的用来启动活动（通常是通过 startActivity(Intent) ）的标准动作。最重要的、并且目前来看最常用的，是 ACTION_MAIN 和 ACTION_EDIT 。

标准的广播动作

以下是由Intent 定义的用来接收广播（通常是通过 registerReceiver(BroadcastReceiver, IntentFilter) 或是在清单文件中定义的一个<receiver>标记）的标准动作。

标准的类别

以下是可用来通过 addCategory(String) 进一步精确化某个Intent的标准类别。

标准的额外数据

以下是可通过 putExtra(String, Bundle) 用作额外数据的标准字段。

标志位

有一些可通过 setFlags(int) 和 addFlags(int) 设置到Intent中去的标志位。参考 setFlags(int) 以查看所有可能的标志位的列表。

packageContext	实现了这个类的应用程序包的上下文（Context）。
cls	要设置的类名，等价于 setClassName(context, cls.getName()) 。

类概述

开发者指南

意图结构

意图的解析

标准的活动动作

标准的广播动作

标准的类别

标准的额外数据

标志位

常量

public static final String ACTION_BATTERY_CHANGED

public static final String ACTION_BATTERY_LOW

public static final String ACTION_BATTERY_OKAY

public static final String ACTION_BOOT_COMPLETED

public static final String ACTION_CONFIGURATION_CHANGED

参考

public static final String ACTION_DATE_CHANGED

public static final String ACTION_DEVICE_STORAGE_LOW

public static final String ACTION_DEVICE_STORAGE_OK

public static final String ACTION_DREAMING_STARTED

public static final String ACTION_DREAMING_STOPPED

public static final String ACTION_GTALK_SERVICE_CONNECTED

public static final String ACTION_GTALK_SERVICE_DISCONNECTED

public static final String ACTION_INSTALL_PACKAGE

参考

public static final String ACTION_LOCALE_CHANGED

public static final String ACTION_MAIN

public static final String ACTION_NEW_OUTGOING_CALL

public static final String ACTION_SYNC

public static final String ACTION_TIME_CHANGED

public static final String ACTION_TIME_TICK

public static final String CATEGORY_APP_BROWSER

public static final String CATEGORY_HOME

public static final String CATEGORY_LAUNCHER

public static final int FLAG_ACTIVITY_BROUGHT_TO_FRONT

public static final int FLAG_ACTIVITY_CLEAR_TASK

public static final int FLAG_ACTIVITY_NEW_TASK

public static final int FLAG_DEBUG_LOG_RESOLUTION

public static final int FLAG_RECEIVER_NO_ABORT

公有方法

public Intent addCategory ( String category)

参数

返回

参考

public Intent addFlags (int flags)

参数

返回

参考

public Rect getSourceBounds ()

public Intent setAction ( String action)

参数

返回

参考

public Intent setClass ( Context packageContext, Class <?> cls)

参数

返回

参考

public Intent setFlags (int flags)

参数

返回

参考