来自:https://developer.android.com/guide/components/intents-filters.html
Intent
是一个消息传递对象,您可以使用它从其他应用组件请求操作。尽管 Intent 可以通过多种方式促进组件之间的通信,但其基本用例主要包括以下三个:
Activity
表示应用中的一个屏幕。通过将Intent
传递给startActivity()
,您可以启动新的Activity
实例。Intent
描述了要启动的Activity,并携带了任何必要的数据。
如果您希望在 Activity 完成后收到结果,请调用startActivityForResult()
。在 Activity的onActivityResult()
回调中,您的 Activity 将结果作为单独的Intent
对象接收。如需了解详细信息,请参阅Activity指南。
Service
是一个不使用用户界面而在后台执行操作的组件。通过将Intent
传递给startService()
,您可以启动服务执行一次性操作(例如,下载文件)。Intent
描述了要启动的服务,并携带了任何必要的数据。
如果服务旨在使用客户端-服务器接口,则通过将Intent
传递给bindService()
,您可以从其他组件绑定到此服务。如需了解详细信息,请参阅服务南。
广播是任何应用均可接收的消息。系统将针对系统事件(例如:系统启动或设备开始充电时)传递各种广播。通过将Intent
传递给sendBroadcast()
、sendOrderedBroadcast()
或sendStickyBroadcast()
,您可以将广播传递给其他应用。
Intent 分为两种类型:
创建显式 Intent 启动 Activity 或服务时,系统将立即启动Intent
对象中指定的应用组件。
图 1. 隐式 Intent 如何通过系统传递以启动其他 Activity 的图解:[1] Activity A 创建包含操作描述的 Intent
,并将其传递给 startActivity()
。[2] Android 系统搜索所有应用中与 Intent 匹配的 Intent 过滤器。找到匹配项之后,[3] 该系统通过调用匹配 Activity(Activity B)的 onCreate()
方法并将其传递给Intent
,以此启动匹配 Activity。
创建隐式 Intent 时,Android 系统通过将Intent的内容与在设备上其他应用的清单文件中声明的Intent过滤器进行比较,从而找到要启动的相应组件。Intent
如果 Intent 与 Intent 过滤器匹配,则系统将启动该组件,并将其传递给对象。如果多个 Intent 过滤器兼容,则系统会显示一个对话框,支持用户选取要使用的应用。
Intent 过滤器是应用清单文件中的一个表达式,它指定该组件要接收的 Intent 类型。例如,通过为 Activity 声明 Intent 过滤器,您可以使其他应用能够直接使用某一特定类型的 Intent 启动 Activity。同样,如果您没有为 Activity 声明任何 Intent 过滤器,则 Activity 只能通过显式 Intent 启动。
警告:为了确保应用的安全性,启动Service
时,请始终使用显式 Intent,且不要为服务声明 Intent 过滤器。使用隐式 Intent 启动服务存在安全隐患,因为您无法确定哪些服务将响应Intent,且用户无法看到哪些服务已启动。从Android 5.0(API 级别 21)开始,如果使用隐式Intent调用bindService()
,系统会抛出异常。
Intent
对象携带了Android系统用来确定要启动哪个组件的信息(例如,准确的组件名称或应当接收该 Intent 的组件类别),以及收件人组件为了正确执行操作而使用的信息(例如,要采取的操作以及要处理的数据)。
Intent
中包含的主要信息如下:
这是可选项,但也是构建显式Intent 的一项重要信息,这意味着 Intent 应当仅传递给由组件名称定义的应用组件。如果没有组件名称,则 Intent 是隐式的,且系统将根据其他Intent信息(例如,以下所述的操作、数据和类别)决定哪个组件应当接收Intent。因此,如需在应用中启动特定的组件,则应指定该组件的名称。
注意:启动Service
时,您应始终指定组件名称。否则,您无法确定哪项服务会响应Intent,且用户无法看到哪项服务已启动。
Intent
的这一字段是ComponentName
对象,您可以使用目标组件的完全限定类名指定此对象,其中包括应用的软件包名称。例如,com.example.ExampleActivity
。您可以使用setComponent()
、setClass()
、setClassName()
或Intent
构造函数设置组件名称。
操作
指定要执行的通用操作(例如,“查看”或“选取”)的字符串。对于广播 Intent,这是指已发生且正在报告的操作。操作在很大程度上决定了其余 Intent 的构成,特别是数据和extra中包含的内容。
您可以指定自己的操作,供Intent在您的应用内使用(或者供其他应用在您的应用中调用组件)。但是,您通常应该使用由Intent
类或其他框架类定义的操作常量。以下是一些用于启动 Activity 的常见操作:
ACTION_VIEW
startActivity()
结合使用。
ACTION_SEND
startActivity()
结合使用。
有关更多定义通用操作的常量,请参阅Intent
类引用。 其他操作在Android框架中的其他位置定义。例如,对于在系统的设置应用中打开特定屏幕的操作,将在Settings
中定义。
您可以使用setAction()
或Intent
构造函数为Intent指定操作。
如果定义自己的操作,请确保将应用的软件包名称作为前缀。 例如:
static final String ACTION_TIMETRAVEL = "com.example.action.TIMETRAVEL";数据 引用待操作数据和/或该数据MIME类型的URI(
Uri
对象)。提供的数据类型通常由Intent的操作决定。例如,如果操作是
ACTION_EDIT
,则数据应包含待编辑文档的URI。
创建 Intent 时,除了指定URI 以外,指定数据类型(其 MIME 类型)往往也很重要。例如,能够显示图像的Activity可能无法播放音频文件,即便 URI 格式十分类似时也是如此。因此,指定数据的 MIME 类型有助于 Android 系统找到接收 Intent 的最佳组件。但有时,MIME 类型可以从URI 中推断得出,特别当数据是content:
URI 时尤其如此。这表明数据位于设备中,且由ContentProvider
控制,这使得数据 MIME 类型对系统可见。
要仅设置数据 URI,请调用setData()
。要仅设置 MIME 类型,请调用setType()
。如有必要,您可以使用setDataAndType()
同时显式设置二者。
警告:若要同时设置 URI 和 MIME 类型,请勿调用setData()
和setType()
,因为它们会互相抵消彼此的值。请始终使用setDataAndType()
同时设置 URI 和 MIME 类型。
CATEGORY_BROWSABLE
CATEGORY_LAUNCHER
有关类别的完整列表,请参阅 Intent
类描述。
您可以使用addCategory()
指定类别。
以上列出的这些属性(组件名称、操作、数据和类别)表示 Intent 的既定特征。通过读取这些属性,Android 系统能够解析应当启动哪个应用组件。
但是,Intent 也有可能会一些携带不影响其如何解析为应用组件的信息。Intent 还可以提供:
您可以使用各种putExtra()
方法添加附加数据,每种方法均接受两个参数:键名和值。您还可以创建一个包含所有附加数据的Bundle
对象,然后使用putExtras()
将Bundle
插入Intent
中。
例如,使用ACTION_SEND
创建用于发送电子邮件的 Intent 时,可以使用EXTRA_EMAIL
键指定“目标”收件人,并使用EXTRA_SUBJECT
键指定“主题”。
Intent
类将为标准化的数据类型指定多个 EXTRA_*
常量。如需声明自己的附加数据 键(对于应用接收的 Intent ),请确保将应用的软件包名称作为前缀。例如:
static final String EXTRA_GIGAWATTS = "com.example.EXTRA_GIGAWATTS";
Intent
类中定义的、充当Intent元数据的标志。标志可以指 Android系统如何启动Activity(例如,Activity应属于哪个 任务),以及启动之后如何处理(例如,它是否属于最近的Activity列表)。
如需了解详细信息,请参阅setFlags()
方法。
显式Intent是指用于启动某个特定应用组件(例如,应用中的某个特定 Activity 或服务)的 Intent。要创建显式 Intent,请为Intent
对象定义组件名称。Intent 的所有其他属性均为可选属性。
例如,如果在应用中构建了一个名为DownloadService
、旨在从 Web 中下载文件的服务,则可使用以下代码启动该服务:
// Executed in an Activity, so 'this' is theContext
// The fileUrl is a string URL, such as "http://www.example.com/image.png" Intent downloadIntent = new Intent(this, DownloadService.class); downloadIntent.setData(Uri.parse
(fileUrl)); startService(downloadIntent);
Intent(Context, Class)
构造函数分别为应用和组件提供Context
和Class
对象。因此,此Intent将显式启动该应用中的DownloadService
类。
如需了解有关构建和启动服务的详细信息,请参阅服务指南。
隐式Intent指定能够在可以执行相应操作的设备上调用任何应用的操作。如果您的应用无法执行该操作而其他应用可以,且您希望用户选取要使用的应用,则使用隐式Intent非常有用。
例如,如果您希望用户与他人共享您的内容,请使用ACTION_SEND
操作创建 Intent,并添加指定共享内容的Extra。使用该Intent 调用startActivity()
时,用户可以选取共享内容所使用的应用。
警告:用户可能没有任何应用处理您发送到startActivity()
的隐式 Intent。如果出现这种情况,则调用将会失败,且应用会崩溃。要验证 Activity是否会接收 Intent,请对Intent
对象调用resolveActivity()
。如果结果为非空,则至少有一个应用能够处理该 Intent,且可以安全调用startActivity()
。如果结果为空,则不应使用该Intent。如有可能,您应禁用发出该Intent的功能。
// Create the text message with a string Intent sendIntent = new Intent(); sendIntent.setAction(Intent.ACTION_SEND); sendIntent.putExtra(Intent.EXTRA_TEXT, textMessage); sendIntent.setType("text/plain"); // Verify that the intent will resolve to an activity if (sendIntent.resolveActivity(getPackageManager()) != null) { startActivity(sendIntent); }
注意:在这种情况下,系统并没有使用 URI,但已声明Intent的数据类型,用于指定Extra携带的内容。
调用startActivity()
时,系统将检查已安装的所有应用,确定哪些应用能够处理这种 Intent(即:含ACTION_SEND
操作并携带“文本/纯”数据的 Intent )。如果只有一个应用能够处理,则该应用将立即打开并提供给 Intent。如果多个 Activity 接受 Intent,则系统将显示一个对话框,使用户能够选取要使用的应用。
如果有多个应用响应隐式Intent,则用户可以选择要使用的应用,并将其设置为该操作的默认选项。如果用户可能希望今后一直使用相同的应用执行某项操作(例如,打开网页时,用户往往倾向于仅使用一种 Web 浏览器),则这一点十分有用。
但是,如果多个应用可以响应Intent,且用户可能希望每次使用不同的应用,则应采用显式方式显示选择器对话框。选择器对话框要求用户选择每次操作要使用的应用(用户无法为该操作选择默认应用)。 例如,当应用使用ACTION_SEND
操作执行“共享”时,用户根据目前的状况可能需要使用另一不同的应用,因此应当始终使用选择器对话框,如图 2 中所示。
图 2. 选择器对话框。
要显示选择器,请使用createChooser()
创建Intent
,并将其传递给startActivity()
。例如:
Intent sendIntent = new Intent(Intent.ACTION_SEND); ... // Always use string resources for UI text. // This says something like "Share this photo with" String title = getResources().getString(R.string.chooser_title); // Create intent to show the chooser dialog Intent chooser = Intent.createChooser(sendIntent, title); // Verify the original intent will resolve to at least one activity if (sendIntent.resolveActivity(getPackageManager()) != null) { startActivity(chooser); }
这将显示一个对话框,其中包含响应传递给createChooser()
方法的Intent的应用列表,并使用提供的文本作为对话框标题。
要公布应用可以接收哪些隐式 Intent,请在清单文件中使用 <intent-filter>;
元素为每个应用组件声明一个或多个Intent 过滤器。每个 Intent 过滤器均根据 Intent 的操作、数据和类别指定自身接受的 Intent 类型。仅当隐式 Intent 可以通过 Intent 过滤器之一传递时,系统才会将该 Intent 传递给应用组件。
注意:显式 Intent始终会传递给其目标,无论组件声明的 Intent 过滤器如何均是如此。
应用组件应当为自身可执行的每个独特作业声明单独的过滤器。例如,图像库应用中的一个 Activity 可能会有两个过滤器,分别用于查看图像和编辑图像。 当 Activity 启动时,它将检查Intent
并根据Intent
中的信息决定具体的行为(例如,是否显示编辑器控件)。
每个 Intent 过滤器均由应用清单文件中的<intent-filter>
元素定义,并嵌套在相应的应用组件(例如,
元素)中。在
内部,您可以使用以下三个元素中的一个或多个指定要接受的 Intent 类型:
name
属性中,声明接受的 Intent 操作。该值必须是操作的文本字符串值,而不是类常量。
scheme
、
host
、
port
、
path
等)各个方面和 MIME 类型的属性,声明接受的数据类型。
name
属性中,声明接受的 Intent 类别。该值必须是操作的文本字符串值,而不是类常量。
注意:为了接收隐式Intent,必须将CATEGORY_DEFAULT
类别包括在 Intent 过滤器中。方法startActivity()
和startActivityForResult()
将按照已申明CATEGORY_DEFAULT
类别的方式处理所有 Intent。 如果未在 Intent 过滤器中声明此类别,则隐式Intent不会解析为您的 Activity。
例如,以下是一个使用Intent过滤器进行的Activity声明,当数据类型为文本时,系统将接收ACTION_SEND
Intent :
android:name="ShareActivity">
android:name="android.intent.action.SEND"/>
android:name="android.intent.category.DEFAULT"/>
android:mimeType="text/plain"/>
您可以创建一个包括多个<action>
、<data>
或
实例的过滤器。创建时,仅需确定组件能够处理这些过滤器元素的任何及所有组合即可。
如需仅以操作、数据和类别类型的特定组合来处理多种 Intent,则需创建多个 Intent 过滤器。
使用 Intent 过滤器时,无法安全地防止其他应用启动组件。尽管 Intent 过滤器将组件限制为仅响应特定类型的隐式 Intent,但如果开发者确定您的组件名称,则其他应用有可能通过使用显式 Intent 启动您的应用组件。如果必须确保只有您自己的应用才能启动您的某一组件,请针对该组件将exported
属性设置为"false"
。
系统通过将 Intent 与所有这三个元素进行比较,根据过滤器测试隐式 Intent。隐式 Intent 若要传递给组件,必须通过所有这三项测试。如果 Intent 甚至无法匹配其中任何一项测试,则 Android 系统不会将其传递给组件。但是,由于一个组件可能有多个 Intent 过滤器,因此未能通过某一组件过滤器的 Intent 可能会通过另一过滤器。如需了解有关系统如何解析 Intent 的详细信息,请参阅下文的 Intent 解析部分。
警告:为了避免无意中运行不同应用的 Service
,请始终使用显式 Intent 启动您自己的服务,且不必为该服务声明 Intent 过滤器。
注意:对于所有 Activity,您必须在清单文件中声明 Intent 过滤器。但是,广播接收器的过滤器可以通过调用registerReceiver()
动态注册。稍后,您可以使用unregisterReceiver()
注销该接收器。这样一来,应用便可仅在应用运行时的某一指定时间段内侦听特定的广播。
为了更好地了解一些 Intent 过滤器的行为,我们一起来看看从社交共享应用的清单文件中截取的以下片段。
android:name="MainActivity"> android:name="android.intent.action.MAIN" /> android:name="android.intent.category.LAUNCHER" /> android:name="ShareActivity"> android:name="android.intent.action.SEND"/> android:name="android.intent.category.DEFAULT"/> android:mimeType="text/plain"/> android:name="android.intent.action.SEND"/> android:name="android.intent.action.SEND_MULTIPLE"/> android:name="android.intent.category.DEFAULT"/> android:mimeType="application/vnd.google.panorama360+jpg"/> android:mimeType="image/*"/> android:mimeType="video/*"/>
第一个 Activity MainActivity
是应用的主要入口点。当用户最初使用启动器图标启动应用时,该 Activity 将打开:
ACTION_MAIN
操作指示这是主要入口点,且不要求输入任何 Intent 数据。CATEGORY_LAUNCHER
类别指示此 Activity 的图标应放入系统的应用启动器。如果
元素未使用icon
指定图标,则系统将使用
元素中的图标。这两个元素必须配对使用,Activity 才会显示在应用启动器中。
第二个 Activity ShareActivity
旨在便于共享文本和媒体内容。尽管用户可以通过从MainActivity
导航进入此 Activity,但也可以从发出隐式 Intent(与两个 Intent 过滤器之一匹配)的另一应用中直接进入ShareActivity
。
注意:MIME 类型application/vnd.google.panorama360+jpg
是一个指定全景照片的特殊 数据类型,您可以使用Google 全景API 对其进行处理。
PendingIntent
对象是Intent
对象的包装器。PendingIntent
的主要目的是授权外部应用使用包含的Intent
,就像是它从您应用本身的进程中执行的一样。
待定 Intent 的主要用例包括:
NotificationManager
执行Intent
)。Intent
)。AlarmManager
执行Intent
)。 由于每个Intent
对象均设计为由特定类型的应用组件进行处理(Activity
、Service
或 BroadcastReceiver
),因此还必须基于相同的考虑因素创建PendingIntent
。使用待定 Intent 时,应用不会使用调用(如startActivity()
)执行该 Intent。相反,通过调用相应的创建器方法创建 PendingIntent
时,您必须声明所需的组件类型:
PendingIntent.getActivity()
,适用于启动Activity
的Intent
。PendingIntent.getService()
,适用于启动Service
的Intent
。PendingIntent.getBroadcast()
,适用于启动BroadcastReceiver
的Intent
。 除非您的应用正在从其他应用中接收待定Intent,否则上述用于创建PendingIntent
的方法可能是您所需的唯一PendingIntent
方法。
每种方法均会提取当前的应用Context
、您要包装的Intent
以及一个或多个指定应如何使用该Intent的标志(例如,是否可以多次使用该 Intent)。
如需了解有关使用待定Intent的详细信息,请参阅通知和应用小工具API 指南等手册中每个相应用例的相关文档。