【Android Developers Training】 34. 添加一个简单的分享行为（Action）

注：本文翻译自Google官方的Android Developers Training文档，译者技术一般，由于喜爱安卓而产生了翻译的念头，纯属个人兴趣爱好。

原文链接：http://developer.android.com/training/sharing/shareaction.html

---

想要在你的ActionBar中实现一个高效和用户友好的分享行为，这在Android 4.0（API Level 14）及以上中通过引入ActionProvider而变得更加简单。一个ActionProvider，一旦被添加至ActionBar中的一个项目，那么它就能处理它的外观和行为。在ShareActionProvider的例子时，你只要提供一个分享的Intent，然后剩下的事情就交给它了。

Note：

ShareActionProvider在API Level 14及更高的平台上可以使用。

图1. 在图库应用中的ShareActionProvider

一）. 更新菜单声明

从ShareActionProvider入手，在你的menu resource文件中，为对应的<item>定义其属性字段“android:actionProviderClass”。


<menu xmlns:android="http://schemas.android.com/apk/res/android">
    <item
            android:id="@+id/menu_item_share"
            android:showAsAction="ifRoom"
            android:title="Share"
            android:actionProviderClass=
                "android.widget.ShareActionProvider" />
    ...
</menu>

这样就将处理该项的外观和功能的任务交给了ShareActionProvider。当然你需要告诉它你要分享什么内容。

二）. 设置分享Intent

为了让ShareActionProvider起作用，你必须提供给它一个分享的Intent。这个分享Intent应该和课程：Sending Simple Data to Other Apps（博客链接：http://www.cnblogs.com/jdneo/p/3473170.html）中所讨论的一样，设置行为为ACTION_SEND，然后通过extras（比如：EXTRA_TEXT和EXTRA_STREAM等）设置额外的数据集。为了交付一个分享的Intent，首先当你在Activity或Fragment中填充你的菜单资源时，找到对应的MenuItem。然后，调用MenuItem.getActionProvider()来获得一个ShareActionProvider实例。使用setShareIntent()和该项相关联的分享的Intent。下面是一个例子：

private ShareActionProvider mShareActionProvider;
...
 
@Override
public boolean onCreateOptionsMenu(Menu menu) {
    // Inflate menu resource file.
    getMenuInflater().inflate(R.menu.share_menu, menu);
 
    // Locate MenuItem with ShareActionProvider
    MenuItem item = menu.findItem(R.id.menu_item_share);
 
    // Fetch and store ShareActionProvider
    mShareActionProvider = (ShareActionProvider) item.getActionProvider();
 
    // Return true to display menu
    return true;
}
 
// Call to update the share intent
private void setShareIntent(Intent shareIntent) {
    if (mShareActionProvider != null) {
        mShareActionProvider.setShareIntent(shareIntent);
    }
}

在创建你的菜单阶段，你可能只需要设置你的分享Intent一次，或者你可能希望设置它之后，随着UI的改变而更新它。例如，当你在图库应用中全屏查看照片，分享Intent会随着你切换照片而改变。

可以在文档：Action Bar中，获得更多关于ShareActionProvider对象的讨论。