Android Developers:允许其它应用程序启动你的Activity

最新推荐文章于 2022-06-12 13:21:42 发布

1024工场

最新推荐文章于 2022-06-12 13:21:42 发布

阅读量2.3k

点赞数 2

分类专栏： Android文档 Android Developers 文章标签： Android Developers Activity Other Apps

Android文档同时被 2 个专栏收录

59 篇文章 0 订阅

订阅专栏

Android Developers

47 篇文章 5 订阅

订阅专栏

前面的两节课程集中在故事的一面：从你的应用程序启动其它应用程序的Activity。但是如果你的应用程序能执行一个动作，它对于其它应用程序非常有用，你的应用程序应该准备相应来自其它应用程序的请求。例如，如果你构建一个社交应用程序，它能和用户的朋友分享消息或者图片，这是你支持ACTION_SEND意图的最大兴趣，所以用户在其它应用程序开始一个“share”动作，并启动你的应用程序来执行这个动作。

为了允许其它应用程序来启动你的Activity，你需要在你的清单文件中相应的<activity>元素中添加一个<intent-filter>元素。

当你的应用是被安装在一个设备的时候，系统定义你的意图过滤器，并向所有安装的应用支持的意图分类嬉戏。当一个应用程序调用startActivity()方法或者startActivityForResult()方法的时候，使用一个隐式Intent，系统找到那个Activity（或者这多个Activity）能响应这个Intent。

添加一个意图过滤器

—————————————————————————————————————————————————————————————————

为了正确的定义你的Activty能处理哪个意图，每个你添加的意图过滤器应该竟可能的具体，在动作类型和Activity能接受的数据方面。

系统可能发送一个给定的Intent给一个Activity，如果这个Activity有一个意图过滤器满足下面Intent对象的条件：

Action

一个命名将要执行动作的字符串。通常是平台定义的一个值，例如ACTION_SEND，或者ACTION_VIEW。

在你的意图过滤器中使用<action>元素指定它。你在这个元素中指定的值必须是动作的完整字符串名称，使用API常量替代（查看下面的例子）。

Data

Intent相关的数据的描述。

在你的意图过滤器中使用<data>元素来指定它。在这个元素中使用一个或者多个属性，你能仅仅指定MIME类型，仅仅指定一个URL前缀，仅仅指定一个URI模型，或者这些的组合和其它能公认的指明数据类型。

注意：如果你不需要声明关于数据Uri的特征（例如当你的Activity处理其它类型的“额外”数据的时候，替代一个URI），你应该仅仅指定android:mimeType属性来声明你的Activity处理的数据类型，例如text/plain或者image/jpeg。

Category

提供一种额外的方式来描述这个Activity处理的Intent的特征，通常和用户请求相关，或者定位它启动的地方。这里有多个系统支持的不同的类别，但是大部分很少使用。然而，所有的隐式意图被定义为默认的CATEGORY_DEFAULT。

在你的意图过滤器中使用<category>元素指定它。

在你的意图过滤器中，你能声明你的Activity接受的条件，通过将相应的XML元素嵌入到<intent-filter>元素中来声明它们的每一个。

例如，这里是一个Activity，拥有一个意图过滤器，它处理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>，<category>，和<data>元素。

任何两组动作和数据在它们的行为上是相互独立的，你应该创建单独的意图过滤器来之来指定那个动作是可接受的，当匹配数据类型的时候。

例如，假设你的Activity处理文本和图片的ACTION_SEND和ACTION_SENDTO意图。在这种情况下，你必须为两个动作定义连个单独的意图过滤器，因为一个ACTION_SEND意图必须使用数据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>

注意：为了获取多个意图，你必须在意图过滤器中包含CATEGORY_DEFAULT类别。这个startActivity()方法和startActivityForResult()方法对待所有的意图，好像包含CATEGORY_DEFAULT类别。如果你没有声明它，没有隐式意图决定你的Activity。

更多关于发送和获取ACTION_SEND意图来执行一个社交共享行为的信息，请查阅Receiving Content from Other Apps课程。

在你的Activity中处理意图

—————————————————————————————————————————————————————————————————

为了决定在你的Activity中执行什么动作，你能读取被用于启动它的Intent。

当你的Activity启动，调用getIntent()方法来获取这个启动这个Activity的Intent。你能在这个Actvity生命周期的任何时间做，但是你通常应该在早期的回调方法中做，例如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。当你的操作完成，并且用户应该返回原来的Activiy的时候，调用finish()方法来关闭（并销毁）你的Actlvity。例如：

// 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获取”canceled”结果。

如果你仅仅需要返回一个整数，它指示着多个结果选项的一个，你能设置结果码为任何大于0的数。如果你使用结果码来传递一个整数，并且你不需要包含Intent，你可以调用setResult()方法并仅仅传递一个结果码。例如：

setResult(RESULT_COLOR_RED); 
finish();

在这种情况，这里可能只要少数可能的结果，所以结果码是一个本地定义的整数（大于0）。当你在你的自己的应用中给一个Activity返回一个结果的时候，它会工作良好，因为这个获取结果码的Activity可以引用公共的常量来确定结果码的值。

注意：没有必要检查你的Activity是否使用startActivity()或者startActivityForResult()方法启动。如果启动你的Activity的Inent希望一个结果，简单调用setResult()方法。如果原来的Activity调用了startActivityForResult()方法，那么系统分配给它你在setResult()方法提供的结果；否则，这个结果被忽视。