给ActionBar增加分享功能
最后更新于：2022-04-01 01:38:10
> 编写:[kesenhoo](https://github.com/kesenhoo) - 原文:[http://developer.android.com/training/sharing/shareaction.html](http://developer.android.com/training/sharing/shareaction.html)
这一课会介绍在ActionBar 中添加一个高效率且比较友好的Share功能，会使用到ActionProvider(在Android 4.0上才被引进)。它会handle出现share功能的appearance与behavior。在ShareActionProvider的例子里面，你只需要提供一个share intent，剩下的就交给[ShareActionProvider](https://developer.android.com/reference/android/widget/ShareActionProvider.html)来做。
### 更新菜单声明(Update Menu Declarations)
使用ShareActionProvider的第一步，在你的menu resources对应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的appearance与function需要与ShareActionProvider匹配。然而，你还是需要告诉provider你想分享的内容。
### Set the Share Intent(设置分享的intent)
为了能够实现ShareActionProvider的功能，你必须提供给它一个intent。这个share intent应该像第一课讲的那样，带有`ACTION_SEND`和附加数据(例如`EXTRA_TEXT`与 `EXTRA_STREAM`)的。如何使用ShareActionProvider，请看下面的例子：
~~~
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);
}
}
~~~
你也许在创建菜单的时候仅仅需要设置一次share intent就满足需求了，或者说你可能想先设置share intent，然后根据UI的变化来对intent进行更新。例如，当你在Gallery里面全图查看照片的时候，share intent会在你切换图片的时候进行改变。想要查看更多关于ShareActionProvider的内容，请查看[Action Bar](https://developer.android.com/guide/topics/ui/actionbar.html#ActionProvider) 。