实现Android6.0的直接分享（Direct Share ）功能

发表于 5年以前 | 总阅读数：2279 次

实现Android6.0的直接分享（Direct Share ）功能

原文链接 : Implementing Android Marshmallow Direct Share

直接分享（Direct Share ）是在Android6.0（棉花糖版本）的一个新功能，允许用户在一个应用里面分享内容到其他地方，比如联系人。核心思想是，用户可以直接分享相关内容而无需先打开一个的应用程序再去分享，这样直接分享允许用户跳过通常的分享流程中的一个步骤。

我遇到的直接分享这个功能是在研究Android Platform Features 和 Community Tools 课程的时候，现在它成了我的最喜欢的Android6.0的新特性。

直接分享概要

直接分享的一个很好的例子是分享内容给一个社交应用的联系人。最终就像这样：

随着Hangouts的出现，在短信和收件箱底部，通常会出现分享选择对话框。然而，直接分享是在这个分享对话框顶部列出的各种联系人。而不是点击分享，然后点击分享到的应用，比如说点击Hangouts。最重要的联系人出现在选择对话框里面。在这个流程，用户没有点击进入Hangouts应用并选择一个联系人，而是能够立即选择联系人。

举一个例子比较一下：使用一个示例应用程序，只分享一点文本到选定的联系人。

这是Android5.0的分享对话框：

这是Android6.0使用直接分享的对话框：

现在，在这两个Android系统运行的是同一个应用，在低版本的系统中，默认显示了低版本的Android的标准选择对话框。所以，直接分享功能可以被添加到新版本，同时也兼容旧版本。

建立一个ChooserTargetService

所以直接分享可以节省用户的时间，使分享过程更加方便。那我们如何实现直接分享呢？

第一步是创建一个服务，继承ChooserTargetService，例如以下SampleChooserTargetService.java：

public class SampleChooserTargetService extends ChooserTargetService {
  @Override
  public List<ChooserTarget> onGetChooserTargets(ComponentName targetActivityName, IntentFilter matchedFilter) {
    final List<ChooserTarget> targets = new ArrayList<>();
    for (int i = 0; i < length; i++) {
      final String targetName = ...
      final Icon targetIcon = ...
      final float targetRanking = ...
      final ComponentName targetComponentName = ...
      final Bundle targetExtras = ...
      targets.add(new ChooserTarget(
          targetName, targetIcon, targetRanking, targetComponentName, targetExtras
      ));
    }
    return targets;
  }
}

重写ongetchoosertargets()方法，返回一个ChooserTarget的List，作为直接分享对话框的选项。

每个ChooserTarget有几个参数：

目标名称
目标图标
这一目标的排序分数（0.0f，1.0f之间），在直接分享的目标太多时使用，低分的选项直接忽略。
选定目标后，启动的组件
在启动下一个组件之前，将添加到原始Intent中的一个附加Bundle

在选择对话框中目标列表的顺序，和我们提供的List的顺序相同。在创建列表的时候，所有的目标已经完成排序。

你如何创造这些目标有你决定，但通常ChooserTarget信息是由具体应用的模型层model layer决定。

更新 Android Manifest

创建ChooserTargetService之后，我们需要把他挂载到我们的应用上，这样系统才知道这个service ，才能去使用这个service

首先，你需要在AndroidManifest.xml声明自定义的ChooserTargetService ：

<service
    android:name=".SampleChooserTargetService"
    android:label="@string/app_name"
    android:permission="android.permission.BIND_CHOOSER_TARGET_SERVICE">
    <intent-filter>
        <action android:name="android.service.chooser.ChooserTargetService" />
    </intent-filter>
</service>

这样就实现了两点：

给这个Service绑定了android.permission.BIND_CHOOSER_TARGET_SERVICE权限

引入了一个IntentFilter ，action是android.service.chooser.ChooserTargetService

然后，你需要使用 meta-data 标签更新你的AndroidManifest.xml，


<activity
    android:name=".SendMessageActivity"
    android:label="@string/app_name">
    <intent-filter>
        <action android:name="android.intent.action.SEND" />
        <category android:name="android.intent.category.DEFAULT" />
        <data android:mimeType="text/plain" />
    </intent-filter>
    <meta-data
        android:name="android.service.chooser.chooser_target_service"
        android:value=".SampleChooserTargetService" />
</activity>

对于每一个你想要暴露给ChooserTargetService的Activity,都需要加上 meta-data 。指定name 是 android.service.chooser.chooser_target_service，在Service定义之前指明他的value.当一个隐式的Intent和其中一个Activity匹配，这个intent的选择对话框将会显示包含这个Activity的应用的ICON同时还会显示 ChooserTarget 列表的图标。选择应用的图标会像标准的分享Intent一样，选择ChooserTarget icon的时候会打开对应的Activity，根据Intent传递过来的数据初始化数据（在ChooserTargetService中指定的）。

直接分享流程

让我们快速从用户的角度看一下谷歌提供的直接分享的示例应用的分享流程。用户打开了一个应用，在屏幕中，有一个分享按钮，点击后会发出一个隐式的Intent。

然后用户点击了分享按钮，弹出了分享对话框：

当我们通过metedata绑定到Chooser Service 的 Activity可以响应隐式 Intent响应的时候， Chooser Service将会根据我们自定义ChooserTargetService的onGetChooserTargets（）方法生成一个选择列表。这个列表会以弹框的形式展示给用户，供用户选择去使用哪种方式响应Intent.

除此之外，真正的通过mete-data绑定的Activity会显示在已经生成的选择目标列表的旁边，用于用户选择Activity完成直接分享。通常来说，这个Activity是一个联系人列表或者是其他的用户列表。