添加一个简便的分享功能

编写: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_TEXTEXTRA_STREAM)的。使用ShareActionProvider的例子如下:

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

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