Android - 和其他APP交互 - 让其他app启动你的activity

前面的两篇文章主要讲了一个方面：从app中启动其他app。但是如果你的app可以处理对其他app有用的操作，你的app也应该响应其他app的操作请求。例如，如果你创建了一个社交app可以分享信息和图片给用户的朋友，支持ACTION_SENDintent，让用户在其他app初始化分享操作然后启动你的app来执行，是一件很有趣的事情。

为了其他app可以启动activity，应该在manifest文件中添加<intent-filter>元素和响应的<activity>元素。

当app安装到设备上后，系统会识别intent filter然后把信息加到一个所有安装的app都支持的全局目录中。当app用模糊的intent调用startActivity()或者startActivityForResult()时，系统就会查询哪个activity（或哪些）可以响应这个intent。

添加一个Intent Filter

为了要正确的定义哪些intent你的activity可以处理，每个添加的intent filter在接收的操作类型和数据类型上应该尽量的明确。

系统可能会把Intent传给activity如果activity有一个intent filter完全满足这个intent的标准：

Action

要指定的动作的名字。通常是平台预定义的值比如ACTION_SEND或者ACTION_VIEW。

在intent filter中用<action>元素来指定。在这个元素中指定的值必须是动作的全名，而不是API常量。（看后面的例子）。

Data

和intent相关的数据描述

在intent filter中的用<data>元素来指定。在这个元素中使用一个或多个属性，可以只指定MIME类型，URI前缀，或者这些和其他可接受数据类型的组合。

注意：如果不不声明数据Uri的细节（比如用户处理其他类型的数据，而不是URI），应该只指明android:mimeType属性来声明activity处理的数据类型，比如text/plain或image/jpeg。

Category

提供了一个附加的方式来表示activity处理的intent的特性，通常和用户手势或开始的位置相关。系统支持好几个不同的category，但是很少用到。但是，所有明确的intent都默认定义为CATEGORY_DEFAULT。

在intent filter中用<category>元素来指定。

在intent filter中，可以通过在<intent-filter>中用每个相应的XML元素来定义你的activity可以接收什么样的标准。

例如，这里有一个activity，它通过intent filter定义了能处理ACTION_SEND的intent，并且数据类型为字符串或图片：

 <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都指定了一个动作类型和数据类型，但是可以定义多个<action>,<category>,和<data>元素在每个<intent-filter>中。

如果两组动作和数据在他们的行为中相互冲突，应该创建另外一个intent-filter来指明接收哪个操作时对应哪些数据类型。

例如，假如activity可以处理ACTION_SEND和ACTION_SENDTO intent以及字符串和图片。这种情况下，应该为这两个操作定义两个不同的intent filter，因为ACTION_SENDTO intent在用必须使用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>

注意：为了可以接收模糊的intent，必须在intent filter中包括CATEGORY_DEFAULT。方法startActivity()和startActivityForResult()只处理带有CATEGORY_DEFAULT的intent。如果没有声明它，那么没有模糊的intent会传给你的activity。

更多关于使用发送和接收ACTION_SEND intent来执行社会化分享行为，查看Receiving Content from Other Apps。

在Activity中处理Intent

为了决定在activity中执行什么动作，可以查看启动它的Intent。

当activity启动时，调用getIntent()来获取启动activity的Intent。在activity的声明周期的任何时候都可以查看，但是通常是在早期的回调方法（onCreate()或onStart()）中查看。

例如：

 @Override
 protected void onCreate(Bundle savedInstanceState) {
     super.onCreate(savedInstanceState);

     setContentView(R.layout.main);

     // 获取启动这个activity的Intent
     Intent intent = getIntent();
     Uri data = intent.getData();

     // 根据intent的类型决定做什么
     if (intent.getType().indexOf("image/") != -1) {
         // 处理带有图片数据的Intent。。。
     } else if (intent.getType().equals("text/plain")) {
         // 处理带有字符串的Intent。。。
     }
 }

返回结果

如果要返回到调用你的activity，简单的调用setResult()来指定结果代码和结果Intent。当操作完成了然后用户需要返回到以前的activity，调用finish()来关闭（然后销毁）这个activity。例如：

 // 创建intent来传递结果数据
 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）。这个在返回给自己app中的activity是很好用，因为activity接收到结果后可以根据公有的常量来决定返回码的值。

注意：不需要查看activity是由startActivity()还是startActivityForResult()启动的。直接调用setResult()因为启动activity的intent可能需要返回值。如果原始的activity调用了startActivityForResult()，那么系统会把setResult()提供的结果传递给它，否则，会忽视返回值。