Android Intent

265 阅读14分钟

Android中的Intent是一个重要且常用的类,可用来在一个组件中启动App中的另一个组件或是启动另一个App的组件(指的是Activity、Service以及Broadcast)。

用途

1. 启动Activity

可将Intent对象传递给startActivity()或startActivityForResult()以启动一个Activity,该Intent对象包含了要启动的Activity的信息及其他必要的数据。

2. 启动Service

可将Intent对象传递给startService()或bindService()以启动一个Service,该Intent对象包含了要启动的Service的信息及其他必要的数据。关于使用startService()启动Service,可参见博文《Android中startService的使用及Service生命周期》。关于使用bindService()启动Service,可参见博文《Android中bindService的使用及Service生命周期》。

3. 发送广播

广播是一种所有App都可接收的信息。Android系统会发布各种类型的广播,比如发布开机广播或手机充电广播等。也可给其他的App发送广播,可将Intent对象传递给sendBroadcast()或sendOrderedBroadcast()或sendStickyBroadcast()以发送自定义广播。

类型

显式

若Intent中明确包含了要启动的组件的完整类名(包名及类名)。典型的情形是在App中启动一个组件。比如,为了响应用户操作通过显式的Intent在App中启动一个Activity或启动一个Service下载文件。

隐式

Intent未包含要启动的组件的完整类名。虽然隐式的Intent未指定要启动的组件的类名,但是一般情况下,隐式的Intent都要指定需执行的action。一般,隐式的Intent用于在一个App中通过Intent启动另一个App的组件,让另一个App的组件接收并处理该Intent。如,想在地图上给用户显示一个位置,但是App又不支持地图展示,可将位置信息放入到一个Intent中,然后给它指定相应的action,通过这样隐式的Intent请求其他的地图型的App来在地图中展示一个指定的位置。隐式的Intent也体现了Android的一种设计哲学:一个App无需包罗万象所有功能,可通过与其他App组合起来,给用户提供很好的用户体验。而连接App与其他App的纽带就是隐式Intent。

当创建了一个显式Intent去启动Activity或Service时,系统会立即启动Intent中所指定的组件。

当创建了一个隐式Intent时,Android系统会将该隐式Intent所包含的信息与设备上其他所有App中manifest文件中注册的组件的Intent Filters对比过滤,从中找出满足能接收处理该隐式Intent的App和对应的组件。若有多个App中的某个组件都符合条件,Android会弹出一个对话框让用户选择需启动哪个App。

组成

Android可根据Intent所携带的信息去查找要启动的组件,Intent还携带了一些数据信息以便要启动的组件根据Intent中的这些数据做相应的处理。

Intent由6部分组成:Component Name、Action、Data、Category、Extras、Flags。根据信息的作用,又可分为3类:

  • a. Component Name、Action、Data、Category为一类,这4中信息决定了Android会启动哪个组件,其中Component Name用于在显式Intent中使用,Action、Data、Category、Extras、Flags用于在隐式Intent中使用。
  • b. Extras为一类,里面包含了具体的用于组件实际处理的数据信息。
  • c. Flags为一类,其是Intent的元数据,决定了Android对其操作的一些行为,下面会介绍。

Component name

要启动的组件的名称。若想使用显式的Intent,就必须指定该参数,一旦设置了component name,Android会直接将Intent传递给组件名所指定的组件去启动它。若未设置,该Intent就是隐式的,Android系统会根据其他的Intent的信息(如下面要介绍到的action、data、category等)做一些比较判断决定最终要启动哪个组件。所以,若启动一个App中的组件,应该通过指定component name通过显式Intent去启动它(因为知道该组件的完整类名)。

注意,当启动Service时,应该总是指定Component Name。否则,不确定最终哪个App的哪个组件被启动了,并用户也看不到哪个Service启动了。

component name在Intent中对应的field是ComponentName对象,可通过要启动的组件的完整类名(包括应用的包名)指定该值,如com.example.ExampleActivity。可通过Intent的setComponent()、setClass()、setClassName()或Intent的构造函数指定component name。

Action

要执行操作的字符串,比如查看或选择,其对应着Intent Filter中的action标签。

可指定独有的action以便于App中的Intent的使用或其他App中通过Intent调用App中的组件。Intent类和Android中其他framework级别的一些类也提供了许多已定义好的具有一定通用意义的action。以下是一些用于启动Activity的常见的action:

Intent.ACTION_VIEW 其值为 “android.intent.action.VIEW”,当有一些信息想让通过其他Activity展示给用户时,就可将Intent的action指定为ACTION_VIEW,比如在一个图片应用中查看一张图片,或在一个地图应用中展现一个位置。

Intent.ACTION_SEND 其值为”android.intent.action.SEND”,该action常用来做“分享”使用,当有一些数据想通过其他的App(如QQ、微信、百度云等)分享出去时,就可使用此action构建Intent对象,并将其传递给startActivity(),由于手机上可能有多个App的Activity均支持ACTION_SEND这一action,所以很有可能会出现如下的图片所示的情形让用户具体选择要通过哪个App分享数据:

可通过查看Intent类了解更多的Intent预定义的一些常见的action。Android中framework级别的一些类也定义了一些action,如Settings中定义了一些action用以分别打开系统中“设置”这个应用的不同界面以完成对指定配置(如WLAN设置、语言设置等)。

可通过调用intent对象的setAction()或在Intent的构造函数中指定intent的action。

若定义了action,请务必将App的包名作为该action的前缀,这是一种良好的编程习惯,避免造成混淆,如:

static final String ACTION_TIMETRAVEL = "com.example.action.TIMETRAVEL";

Data

此处所说的Intent中的data指的是Uri对象和数据的MIME类型,其对应着Intent Filter中的data标签。

一个完整的Uri由scheme、host、port、path组成,格式是://:/,如content://com.example.project:200/folder/subfolder/etc。Uri就像一个数据链接,组件可根据此Uri获得最终的数据来源。通常将Uri和action结合使用,比如将action设置为ACTION_VIEW,应该提供将要被编辑修改的文档的Uri。

当创建了一个Intent对象时,除了指定Uri之外,指定数据的MIME类型也很重要。如,一个Activity能显示图片,但是不能播放视频,显示图片的Uri和播放视频的Uri可能很类似,为了不让Android误将一个含有视频Uri的Intent对象传递给一个只能显示图片的Activity,需在该Activity的Intent Filter中指定MIME类型为图片(如<data android:mimeType="image/*" ... />)并还要给Intent对象设置对应的图片类型的MIME,这样Android就会基于Uri和MIME类型将Intent传递给符合条件的组件。然后有个特例,若Uri使用的是content:协议,那么这就说明Uri所提供的数据将来自于本地设备,即数据由ContentProvider提供,这种情况下Android会根据Uri自动推断出MIME类型,此种情况无需再指定MIME类型。

若只设置数据的Uri,需调用Intent对象的setData();若只设置数据的MIME类型,需调用Intent对象的setType();若要同时设置数据的Uri和MIME类型,需调用Intent对象的setDataAndType()。

注意,若想同时设置数据的Uri和MIME类型,不要先后调用Intent对象的setData()和setType(),因为setData()和setType()是互斥的,即若调用了setData(),会将Intent中已通过setType()设置的MIME类型重置为空。若调用了setType(),会将Intent中已通过setData()设置的Uri重置为空。所以在需同时设置数据的Uri和MIME类型时,一定要调用Intent对象的setDataAndType(),而不是分别调用setData()和setType()。

Category

category包含了关于组件如何处理Intent的一些其他信息,虽然可在Intent中加入任意数量的category,但是大多数的Intent其实不需category。

以下是一些常见的category:

CATEGORY_BROWSABLE 目标组件会允许通过一个链接被一个Web浏览器启动,该链接可能是一个图片链接或e-mail信息等。

CATEGORY_LAUNCHER 用于标识Activity是某个App的入口Activity。

可在Intent类中查找到更多预定义的category。

Extras

额外的数据信息,Intent中有一个Bundle对象存储着各种键值对,接收该Intent的组件可从中读取出所需的信息以便完成相应的工作。有的Intent需靠Uri携带数据,有的Intent是靠extras携带数据信息。

可通过调用Intent对象的各种重载的putExtra(key, value)向Intent中加入各种键值对形式的额外数据。也可直接创建一个Bundle对象,向该Bundle对象传入很多键值对,然后通过调用Intent对象的putExtras(Bundle)将其一块设置给Intent对象中去。

如,创建了一个action为ACTION_SEND的Intent对象,然后想用它启动e-mail发送邮,需给该Intent对象设置2个extra的值:

用Intent.EXTRA_EMAIL 作为key值设置收件方,用Intent.EXTRA_SUBJECT 作为key值设置邮件标题。

Intent类里面也指定了很多预定义的EXTRA_*形式的extra,如上面提到的(Intent.EXTRA_EMAIL 和Intent.EXTRA_SUBJECT)。若想声明自定义的extra,请确保将App的包名作为extra的前缀,如:

static final String EXTRA_GIGAWATTS = "com.example.EXTRA_GIGAWATTS";

Flags

Intent类中定义的flag能起到作为Intent对象的元数据的作用。这些flag会告知Android系统如何启动Activity(如,新启动的Activity属于哪个task)以及在该Activity启动后如何对待它。更多信息可参见Intent的setFlags()。

显式Intent使用示例

Intent intent = new Intent(this, ActivityB.class);
startActivity(intent);

上面的代码在Intent的构造函数中指定了要启动的组件的ComponentName是ActivityB,该intent对象是显式的,调用startActivity(intent)时,Android系统会立即启动ActivityB。

隐式Intent使用示例

之前提到过,在使用隐式Intent时需指定其action。若App不能完成某个功能,但是其他的App可能完成该功能,就可用隐式Intent启动其他的App去完成相应的功能。如,有一段文本信息,想通过其他App分享出去,隐式Intent对象去启动潜在的支持分享的App,示例代码如下:

Intent sendIntent = new Intent();
// 设置action, action对隐式Intent来说是很重要的
sendIntent.setAction(Intent.ACTION_SEND);
// 设置数据的MIME类型为纯文本类型
sendIntent.setType("text/plain");
// 设置额外的数据
sendIntent.putExtra(Intent.EXTRA_TEXT, textMessage);


// 获取包管理器
PackageManager pm = getPackageManager();
// 先判断系统中有无潜在的App的Activity支持对该sendIntent的接收与处理
if (pm.resolveActivity(sendIntent, 0) != null) {
    startActivity(sendIntent);
}

上面的代码中,构建了一个Intent对象,并未给其设置component name,所以该Intent是一个隐式的Intent对象。首先给intent设置了action的值为Intent.ACTION_SEND,action对隐式Intent来说是很重要的。然后将intent的数据的MIME类型设置为纯文本类型(“text/plain”),告知Android的Intent持有的是文本类型的数据。最后将实际的文本数据通过putExtra()作为额外数据设置进去。

注意,在构建好了Intent对象之后,未立即执行startActivity(sendIntent),而是将sendIntent作为参数传递给了PackageManager的resolveActivity()中,该会让Android根据该sendIntent找到潜在的适合启动的组件的信息,并以ResolveInfo类的对象的形式返回结果,若返回null,表示当前系统中无任何组件可接收并处理该sendIntent。若返回不是null,就表明系统中至少存在一个组件可接收并处理该sendIntent,只有在这种情况下,才会执行代码startActivity(sendIntent),在通过intent启动组件之前先判断要启动的组件存不存在是个良好的编程习惯,因为若系统中不存在支持intent的组件,那么当调用startActivity()、startService()、bindService()等时,Android就会抛出异常。

强制用户使用App Chooser

在上文中已提到,若的Intent是隐式的,当通过startActivity(intent)尝试启动组件时,可能Android系统会显示上面的截图文件询问用户要启动哪个App,有时候用户会将某一个App设置为默认的App,这样下次再执行代码startActivity(intent)时就有可能不会再出现选择App的界面,而是直接运行上次用户设置为默认App的应用。这对于用户选择一个默认浏览器打开网页这种情形是有好处的,因为一般一个用户习惯于用一个喜欢的浏览器。

但是若用户不想每次都用同一个默认App处理这样的情形怎么办呢?这时可在代码中明确地使用App选择对话框,比如党的App执行一个action为ACTION_SEND的分享功能时,想让用户分享数据的代码,但是不确定用户想通过哪个App去分享,想每次都弹出App选择对话框让用户决定想通过哪个App分享,示例代码如下所示:

Intent sendIntent = new Intent(Intent.ACTION_SEND);
...


String title = "请选择想通过哪个App分享数据";


// 验证是否有App能接收并处理sendIntent
if (sendIntent.resolveActivity(getPackageManager()) != null) {
    // 根据sendIntent创建一个需显示App选择对话框的intent对象
    Intent chooserIntent = Intent.createChooser(sendIntent, title);
    // 使用chooserIntent作为startActivity()的参数,而非sendIntent
    startActivity(chooserIntent);
}

首先创建了原始的sendIntent,并对其设置action等相关信息,然后将sendIntent传递给了Intent.createChooser()中,创建了另一个chooserIntent。后面通过调用Intent.resolveActivity(PackageManager)判断系统中是否有App能接收并处理sendIntent,该与上面之前提到过的PackageManager的resolveActivity()是等价的。最后使用chooserIntent作为startActivity()的参数,而非sendIntent,chooserIntent会让Android系统强制显示用户选择App处理Intent的界面。

Intent Filter

当用户进行一项操作时,Android系统会根据配置的Intent Filter来寻找可响应该操作的组件,服务。

如:当用户点击PDF文件时,Android系统就会通过设定好的Intent Filter,匹配测试。找到能打开PDF文件的APP程序。

 <activity android:name="com.example.testmain.ShowActivity" >
      <intent-filter>
            <action android:name="test.update.mydata" />
            <category android:name="my.test.show" />
            <data android:pathPattern=".*\\.jpg" android:scheme="http" />
      </intent-filter>
 </activity>

一个组件可包含0或多个Intent Filter。Intent Filter是写在App的manifest文件中的,其通过设置action或uri数据类型等指明了组件能处理接收的Intent的类型。若给Activity设置了Intent Filter,就使得其他的App有可能通过隐式Intent启动这个Activity。反之,若Activity不包含任何Intent Filter,该Activity只能通过显式Intent启动,由于一般不会暴露出组件的完整类名,所以这种情况下,其他的App基本就不可能通过Intent启动的Activity了(因为他们不知道该Activity的完整类名),只能由App通过显式Intent启动。

注意,为确保App的安全性,应该总是使用显式Intent去启动Service并不要为该Service设置任何的Intent Filter。通过隐式的Intent启动Service有风险,因为不确定最终哪个App中的哪个Service会启动起来以响应隐式Intent,更悲催的是,由于Service无UI的在后台运行,所以用户也不知道哪个Service运行了。从Android 5.0 (API level 21)开始,用隐式Intent调用bindService(),Android会抛出异常,但是也有相应技巧,将一个隐式的Intent转换为显式的Intent,然后用显式的Intent去调用bindService()就没问题了,具体解决办法可参见博文《Android中通过Messenger与Service实现进程间双向通信》中最后的“注意事项”部分,里面有相关代码的解决方案。