添加一个简便的分享功能

编写:kesenhoo - 原文:http://developer.android.com/training/sharing/shareaction.html

Android4.0之后系统中ActionProvider的引入使在ActionBar中添加分享功能变得更为简单。它会handle出现share功能的appearance与behavior。在ShareActionProvider的例子里面，我们只需要提供一个share intent，剩下的就交给ShareActionProvider来做。

http://static.bookstack.cn/projects/android-training-course-in-chinese/content-sharing/sharing/actionbar-shareaction.png

更新菜单声明(Update Menu Declarations)

使用ShareActionProvider的第一步，在menu resources对应item中定义android:actionProviderClass属性。

  1. <menu xmlns:android="http://schemas.android.com/apk/res/android">
  2.     <item android:id="@+id/menu_item_share"
  3.         android:showAsAction="ifRoom"
  4.         android:title="Share"
  5.         android:actionProviderClass="android.widget.ShareActionProvider" />
  6.     ...
  7. </menu>

这表明了该item的appearance与function需要与ShareActionProvider匹配。此外，你还需要告诉provider想分享的内容。

Set the Share Intent(设置分享的intent)

为了实现ShareActionProvider的功能，我们必须为它提供一个intent。该share intent应该像第一课讲的那样，带有ACTION_SEND和附加数据(例如EXTRA_TEXT与 EXTRA_STREAM)的。使用ShareActionProvider的例子如下：

  1. private ShareActionProvider mShareActionProvider;
  2. ...
  4. @Override
  5. public boolean onCreateOptionsMenu(Menu menu) {
  6.     // Inflate menu resource file.
  7.     getMenuInflater().inflate(R.menu.share_menu, menu);
  9.     // Locate MenuItem with ShareActionProvider
  10.     MenuItem item = menu.findItem(R.id.menu_item_share);
  12.     // Fetch and store ShareActionProvider
  13.     mShareActionProvider = (ShareActionProvider) item.getActionProvider();
  15.     // Return true to display menu
  16.     return true;
  17. }
  19. // Call to update the share intent
  20. private void setShareIntent(Intent shareIntent) {
  21.     if (mShareActionProvider != null) {
  22.         mShareActionProvider.setShareIntent(shareIntent);
  23.     }
  24. }

也许在创建菜单的时候仅仅需要设置一次share intent就满足需求了，或者说我们可能想先设置share intent，然后根据UI的变化来对intent进行更新。例如，当在Gallery里面全图查看照片的时候，share intent会在切换图片时候进行改变。
更多关于ShareActionProvider的内容，请查看Action Bar 。