内容共享 之 增加一个简便的分享按钮

利用前面提到的ActionProvider（android 4.0 ,API 14之上支持）来在ActionBar里面创建一个实用，友好的分享按钮会更加容易一些。ActionProvider,一旦被添加到一个动作条里里面作为一个菜单按钮，会自动实现这个菜单按钮的UI和功能。然后在ShareActionProvider里面，你只需要提供一个要分享的intent,它会处理剩余的工作。

注意：ShareActionProvider仅仅在API 14和之上的版本才支持。

修改菜单声明

在开始使用ShareActionProviders之前，首先要在你的对应菜单资源<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>

这个声明就表明了这个item的显示和在ShareActionProvider里面的功能。然后，你需要告诉这个provider你要分享的内容。

设置分享的Intent

为了让ShareActionProvider能够工作，你必须给它提供一个分享的intent.这个要分享的intent 和我们之前的在发送分享内容到其他APP里面讲的intent是一样的，如一个ACTION_SEND动作，然后带一些extra数据，如EXTRA_TEXT and 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就变成图片类型