注:本文翻译自Google官方的Android Developers Training文档,译者技术一般,由于喜爱安卓而产生了翻译的念头,纯属个人兴趣爱好。
原文链接:http://developer.android.com/training/basics/intents/filters.html
之前的两节课关注于故事的一面:从你的应用启动另一个应用的activity。但是如果你的应用可以执行一个对另一个应用来说有用的行为,那么你的应用就应该准备好响应由其他应用所发起的行为需求。例如,你构建了一个社交应用,它可以和用户的朋友分享信息和照片,那么此时你最感兴趣的就是支持ACTION_SEND的Intent,这样用户可以在其他应用初始化一个“分享”的行为,然后启动你的应用来执行这个行为。
为了允许其他应用启动你的Activity,你需要在清单文件中,在对应的<activity>标签内,
添加一个<intent-filter>(姑且称之为Intent过滤器)标签。
当你的应用安装在一个设备上时,系统会识别你的intent过滤器,并且将信息添加至一个内部的目录,这里面收录了所有安装的应用所支持的intents。当一个应用调用startActivity()或者startActivityForResult(),并且使用的是隐式的intent时,系统会找到哪一个(些)activity可以相应这个intent。
一). 添加一个Intent过滤器
为了恰当地定义你的activity可以处理什么intents,每个你添加的intent过滤器,就activity能接受的行为和数据类型而言,应该是越明确越好。
如果Activity的intent过滤器能够符合下面列举的Intent对象标准,那么系统会将该Intent交付给这个activity:
Action
一个字符串,表征了将要执行的行为的名称。通常是一个系统所定义的值,如:ACTION_SEND或者ACTION_VIEW。
在你的intent过滤器中,用<action>标签来特指接收的行为。在这个标签中你所特指的值必须是这个行为的全名,而不是API常量(见下面的例子)。
Data
这是一个和intent所关联的数据的描述。
在你的intent过滤器中,用<data>标签来特指它。你可以在这个标签中使用一个或多个字段,你可以只定义MIME类型,只定义一个URI前缀,只定义一个URI方案,或者是这些和其他类型的结合,它们指出了能接收的数据类型。
Note:
如果你不需要申明关于数据Uri细节(比如当你的activity处理其他类型的“extra”数据,而不是一个URI),那么你应该只指明“android:mimeType”这一属性字段,以此来声明你的activity要处理的数据类型,比如:“text/plain”或者“image/jpeg”。
Category
提供一个额外的方法来特定处理该intent的Activity,通常与用户的手势或者它所启动的地点相关。系统支持一些不同类型的category,但大多数很少使用。然而,要记住的是所有隐式的intent,默认定义了CATEGORY_DEFAULT。
在你的Intent过滤器中,用<category>标签特指它。
在你的intent过滤器中,你可以通过在<intent-filter>标签中添加合适的XML标签,来申明你的activity接收什么样的intent。
下面的例子是一个具有intent过滤器的activity,它处理的intent是这样的,具有ACTION_SEND的行为,且数据类型是文本或图像:
<activity android:name="ShareActivity"> <intent-filter> <action android:name="android.intent.action.SEND"/> <category android:name="android.intent.category.DEFAULT"/> <data android:mimeType="text/plain"/> <data android:mimeType="image/*"/> </intent-filter> </activity>
每一个输入的intent只特定一个行为和一个数据类型,但是在每个<intent-filter>标签中声明多个<action>,<data>或者<category>标签的实例也是可以的。
如果有两对行为和数据,其行为是相互排斥的,你应该分别创建intent过滤器,将行为和数据类型合理搭配避免冲突。
例如,假设你的应用处理文本和图像的数据类型,也同时相应ACTION_SEND和ACTION_SENDTO的行为。在这种情况下,你必须为两个行为分别定义两个intent过滤器,因为一个含有ACTION_SENDTO的intent必须使用数据Uri,并通过使用“send”或者“sendto”的URI方案,来指定受众地址。
<activity android:name="ShareActivity"> <!-- filter for sending text; accepts SENDTO action with sms URI schemes --> <intent-filter> <action android:name="android.intent.action.SENDTO"/> <category android:name="android.intent.category.DEFAULT"/> <data android:scheme="sms" /> <data android:scheme="smsto" /> </intent-filter> <!-- filter for sending text or images; accepts SEND action and text or image data --> <intent-filter> <action android:name="android.intent.action.SEND"/> <category android:name="android.intent.category.DEFAULT"/> <data android:mimeType="image/*"/> <data android:mimeType="text/plain"/> </intent-filter> </activity>
Note:
为了接收隐式的intent,你必须在intent过滤器中包含CATEGORY_DEFAULT这一category。startActivity()和startActivityForResult()这两个方法都将所有的intent处理为包含有CATEGORY_DEFAULT的category。如果你不声明它,你的应用不会收到任何隐式的intent。
更多关于发送和接收ACTION_SEND的intents的信息,可以阅读:Receiving Simple Data from Other Apps
二). 处理你的Activity中的Intent
为了决定在你的Activity中决定要执行什么行为,你可以读取启动你的Activity的Intent。
当你的activity启动后,调用getIntent()来获取启动这个Activity的Intent。你可以在任意一个Activity的生命周期阶段执行这件事情,但一般你应该在早期生命周期回调函数(如:onCreate()或者onStart())中执行。
例如:
@Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.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,例如:
// Create intent to deliver some kind of result data Intent result = new Intent("com.example.RESULT_ACTION", Uri.parse("content://result_uri"); setResult(Activity.RESULT_OK, result); finish();
你必须为你的结果指定结果码。通常,它不是RESULT_OK就是RESULT_CANCELED。必要时,你可以提供一个包含有额外数据的Intent。
Note:
默认结果码设置为RESULT_CANCELED。所以当用户在执行完行为,或在你将结果数据配置完毕之前,按下返回按钮,原始的activity会收到“取消”的结果。
如果你只需要返回一个整数,它代表了一些结果项中的一个,那么你可以将结果码设置为任何一个大于0的数。如果你使用结果码来返回一个整数,此时你不需要再传递一个Intent。你可以调用setResult(),并且只传递一个结果码,例如:
setResult(RESULT_COLOR_RED);
finish();
在这个例子中,可能仅有少量的一些结果,所以结果码是一个本地定义的整形(大于0)。这样做在你给自己的应用的某个activity返回一个结果时,是没有问题的,因为接收这个结果的activity可以引用公有常量来明确结果码的值。
Note:
不需要检查你的activity是被startActivity()还是被startActivityForResult()所启动的。如果启动你的activity的intent需要返回一个值,仅需要调用setResult()。如果原始activity调用的是startActivityForResult(),那么系统将会发送给它你在setResult()中提供的数据,不然的话,这个结果会被忽略。