Android---其他程序启动自己的Activity
2013-07-10 21:27
441 查看
本文译自:http://developer.android.com/training/basics/intents/filters.html
前面的两课一直关注了故事的一边:从你的应用程序中启动另一个应用程序的Activity。但是如果你的应用能够执行一个可能对另外的应用程序有用的操作,那么你的应用程序就应该准备响应来自其他应用程序的操作请求。例如,如果你创建了一个能够跟用户的朋友共享消息和照片的社区应用,那么你就应该支持ACTION_SEND类型的Intent,以便用户能够启动来自其他应用程序的共享操作,并加载你的应用程序来执行这个操作。
要允许其他的应用程序来启动你的Activity,你需要在你的清单文件的相应的<activity>元素中添加一个<intent-filter>元素。
当你的应用程序被安装到设备上时,系统会识别你的Intent过滤器,并把这个信息添加到一个由所有被安装应用程序所支持的内部的Intent目录中。当一个应用程序用隐含的Intent对象来调用startActivity()或startActivityForResult()方法时,系统就会在这个目录中查找那些Activity能够响应这个Intent的请求。
添加Intent过滤器
为了能够正确的定义你的Activity所能处理的Intent对象,Activity接收的操作和数据应该尽可能在每个被添加的Intent过滤器中进行具体的定义。
如果Activity有一个跟下列Intent对象条件完全匹配的Intent过滤器,系统就会把给定的Intent对象发送给这个Activity:
Action
定义要执行的操作名称(字符串)。通常是由平台定义的一个值,如ACTION_SEND或ACTION_VIEW。
使用过滤器中的<action>元素来指定操作。在这个元素中指定的值必须是该操作完整的字符串名称,而不是API常量。
Data
定义跟该Intent匹配的数据
使用过滤器中的<data>元素来指定数据。使用这个元素中的一个或多个属性,你能够只简单指定MIME类型、URI前缀、URI方案,或者是这些的组合,以及其他的能够接收的数据类型的指示。
注意:如果你不需要声明指定相关数据的Uri(如当你的Activity要处理其他类型的附加数据时,而不是URI),那么就应该只指定android:mimeType属性来声明你的Activity所能处理的数据类型,如text/plain或image/jpeg。
Category
提供两外一种Activity处理Intent对象的方法,通常与用户的手势或其他的位置有关。系统支持几种不同的分类,但是很少被使用。但是默认情况下,所有的隐含的Intent对象都要使用CATEGORY_DEFAULT来定义。
在Intent过滤器中使用<category>元素来指定这个分类信息。
在你的Intent过滤器中,你可以在<intent-filter>元素中嵌套上述对应XML元素来声明你的Activity所能接收的Intent对象的条件。
例如,以下Activity的Intent过滤器的声明,能够处理ACTION_SEND类型的Intent对象,并且数据类型可以是文本或图片:
<activityandroid: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>、<category>、<data>元素的实例。
如果任何两个操作和数据的行为是相互排斥的,那么你应该给它们建立独立的Intent过滤器,并在每个Intent过滤器中指定其可接收的操作和对应的数据类型。
例如,假设你的Activity可以使用ACTION_SEND和ACTION_SENDTO类型的Intent来处理文本和图片。这种情况下,你就必须给这两个操作分别定义独立的Intent过滤器,因为ACTION_SENDTO类型的Intent对象必须使用数据的Uri来指定收件人的地址,例如:
<activityandroid: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>
注意:为了接收隐式的Intent对象,在Intent过滤器中必须包含CATEGORY_DEFAULT分类。如果包含了CATEGORY_DEFAULT分类,startActivity()和startActivityForResult()方法启动的所有的Intent对象就会被处理,否则,隐式的Intent对象就不会被你的Activity所接收。
在你的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 ...
}
}
返回结果
如果你想要把结果返回给调用者,只需简单的调用setResult()方法来指定具体的结果代码和结果Intent对象。当操作完成后,并要返回到最初的调用者,就要调用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对象来提供另外的数据。
注意:默认的结果会被设置为RESULT_CANCELED。因此,在操作完成和结果被设定之前,如果用户按下返回按钮,那么初始的Activity就会收到“被取消”的结果。
如果你只是简单的返回一个整数,来指明几个可选结果中的一个,那么你把结果代码设置为任何比0大的值。如果你使用结果代码来发送一个整数,并且不需要包含Intent对象,那么你就可以调用setResult()方法,并且只给它传递一个结果代码。例如:
setResult(RESULT_COLOR_RED);
finish();
在这种情况中,可能的结果很少,因此结果代码可以是本地定义的整数(比0大)。这样在把结果返回给你自己应用程序中的Activity时,就会很好的工作,因为接收结果的Activity可以引用公共的常量来判断结果代码的值。
注意:不需要检查你的Activity是使用startActivity()方法、还是使用startActivityForResult()方法来启动的。如果启动你的Activity期望要有返回结果,那么只需简单的调用setResult()方法就可以了。如果启动Activity调用的是startActivityForResult()方法,那么系统就会把你提供给setResult()方法的结果发送给它,否则,这个结果会被忽略。
前面的两课一直关注了故事的一边:从你的应用程序中启动另一个应用程序的Activity。但是如果你的应用能够执行一个可能对另外的应用程序有用的操作,那么你的应用程序就应该准备响应来自其他应用程序的操作请求。例如,如果你创建了一个能够跟用户的朋友共享消息和照片的社区应用,那么你就应该支持ACTION_SEND类型的Intent,以便用户能够启动来自其他应用程序的共享操作,并加载你的应用程序来执行这个操作。
要允许其他的应用程序来启动你的Activity,你需要在你的清单文件的相应的<activity>元素中添加一个<intent-filter>元素。
当你的应用程序被安装到设备上时,系统会识别你的Intent过滤器,并把这个信息添加到一个由所有被安装应用程序所支持的内部的Intent目录中。当一个应用程序用隐含的Intent对象来调用startActivity()或startActivityForResult()方法时,系统就会在这个目录中查找那些Activity能够响应这个Intent的请求。
添加Intent过滤器
为了能够正确的定义你的Activity所能处理的Intent对象,Activity接收的操作和数据应该尽可能在每个被添加的Intent过滤器中进行具体的定义。
如果Activity有一个跟下列Intent对象条件完全匹配的Intent过滤器,系统就会把给定的Intent对象发送给这个Activity:
Action
定义要执行的操作名称(字符串)。通常是由平台定义的一个值,如ACTION_SEND或ACTION_VIEW。
使用过滤器中的<action>元素来指定操作。在这个元素中指定的值必须是该操作完整的字符串名称,而不是API常量。
Data
定义跟该Intent匹配的数据
使用过滤器中的<data>元素来指定数据。使用这个元素中的一个或多个属性,你能够只简单指定MIME类型、URI前缀、URI方案,或者是这些的组合,以及其他的能够接收的数据类型的指示。
注意:如果你不需要声明指定相关数据的Uri(如当你的Activity要处理其他类型的附加数据时,而不是URI),那么就应该只指定android:mimeType属性来声明你的Activity所能处理的数据类型,如text/plain或image/jpeg。
Category
提供两外一种Activity处理Intent对象的方法,通常与用户的手势或其他的位置有关。系统支持几种不同的分类,但是很少被使用。但是默认情况下,所有的隐含的Intent对象都要使用CATEGORY_DEFAULT来定义。
在Intent过滤器中使用<category>元素来指定这个分类信息。
在你的Intent过滤器中,你可以在<intent-filter>元素中嵌套上述对应XML元素来声明你的Activity所能接收的Intent对象的条件。
例如,以下Activity的Intent过滤器的声明,能够处理ACTION_SEND类型的Intent对象,并且数据类型可以是文本或图片:
<activityandroid: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>、<category>、<data>元素的实例。
如果任何两个操作和数据的行为是相互排斥的,那么你应该给它们建立独立的Intent过滤器,并在每个Intent过滤器中指定其可接收的操作和对应的数据类型。
例如,假设你的Activity可以使用ACTION_SEND和ACTION_SENDTO类型的Intent来处理文本和图片。这种情况下,你就必须给这两个操作分别定义独立的Intent过滤器,因为ACTION_SENDTO类型的Intent对象必须使用数据的Uri来指定收件人的地址,例如:
<activityandroid: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>
注意:为了接收隐式的Intent对象,在Intent过滤器中必须包含CATEGORY_DEFAULT分类。如果包含了CATEGORY_DEFAULT分类,startActivity()和startActivityForResult()方法启动的所有的Intent对象就会被处理,否则,隐式的Intent对象就不会被你的Activity所接收。
在你的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 ...
}
}
返回结果
如果你想要把结果返回给调用者,只需简单的调用setResult()方法来指定具体的结果代码和结果Intent对象。当操作完成后,并要返回到最初的调用者,就要调用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对象来提供另外的数据。
注意:默认的结果会被设置为RESULT_CANCELED。因此,在操作完成和结果被设定之前,如果用户按下返回按钮,那么初始的Activity就会收到“被取消”的结果。
如果你只是简单的返回一个整数,来指明几个可选结果中的一个,那么你把结果代码设置为任何比0大的值。如果你使用结果代码来发送一个整数,并且不需要包含Intent对象,那么你就可以调用setResult()方法,并且只给它传递一个结果代码。例如:
setResult(RESULT_COLOR_RED);
finish();
在这种情况中,可能的结果很少,因此结果代码可以是本地定义的整数(比0大)。这样在把结果返回给你自己应用程序中的Activity时,就会很好的工作,因为接收结果的Activity可以引用公共的常量来判断结果代码的值。
注意:不需要检查你的Activity是使用startActivity()方法、还是使用startActivityForResult()方法来启动的。如果启动你的Activity期望要有返回结果,那么只需简单的调用setResult()方法就可以了。如果启动Activity调用的是startActivityForResult()方法,那么系统就会把你提供给setResult()方法的结果发送给它,否则,这个结果会被忽略。
相关文章推荐
- Android 中启动自己另一个程序的activity如何实现
- Android中Activity启动模式详解,可以控制程序按home键后进来还会调用一个自己不喜欢的界面
- Android Training - 和其他程序交互(3) - 允许其他程序启动你的activity
- Android:调用其他程序中的activity和Permission Denial: starting Intent 错误解决办法
- UNITY3D android 启动其他程序,启动apk C#代码
- Android培训翻译_允许其他应用程序启动你的Activity
- [Android]检测和启动其他程序
- Android:通过意图启动其他程序、Uri、setAction、setData、setDataAndType
- android: startActivityForResult用法(启动其他Activity并返回结果)
- 在当前activity中启动自己另一个程序的activity
- activity能被其他的AP启动的条件 or android permission denied : starting Intent
- 【Android Training - 05】与其他Apps进行交互 [ Lesson 3 - 允许其他app启动你的activity ]
- android 屏蔽指定activity启动(程序锁)
- Android:调用其他程序中的activity和Permission Denial: starting Intent 错误解决办法
- Android程序杀死自己的进程和其他程序进程方法
- 怎样在android系统启动时自动运行自己的程序(RECEIVE_BOOT_COMPLETED)
- 怎样在android系统启动时自动运行自己的程序
- Android 学习 之 无需类名启动其他程序
- android开发(26) 和其他应用交换数据方式一,使用intent指定自定义action调用其他程序里的activity,并获得其返回的结果
- Android 启动activity的4种方式及打开其他应用的activity的坑