注：本文翻译自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 对象的讨论。
