跟Google学习Android开发-起始篇-共享内容（3）

7.3 添加一个简单的分享操作

随着Android 4.0（API等级14）对ActionProvider的引入，在操作栏上实现有效且用户友好的分享操作，变得更加简单了。一个ActionProvider，一旦附在操作栏的某个菜单项，要同时处理该项的外观和行为。在使用ShareActionProvider的情况下，你只要提供了一个分享意图，它会完成剩下的工作。

注：  ShareActionProvider 只在API等级14和更高的版本中才开始可用。

图1。相册应用程序中的ShareActionProvider。

更新菜单声明

---

开始使用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>

这代表该项中ShareActionProvider的外观和功能职责 。但是，你需要告诉提供者（provider）你想要分享的东西。

设置分享意图

---

为了实现ShareActionProvider的功能，你必须给它提供一个分享意图。这一分享意图应该跟“将内容发送到其他应用程序”那节课所描述的一样，使用ACTION_SEND操作并通过额外信息像EXTRA_TEXT和EXTRA_STREAM设置附加的数据。要指定一个分享意图，当你在您的活动或片段中填充菜单资源时，首先找到相应的菜单项。接下来，调用MenuItem.getActionProvider()检索一个ShareActionProvider实例。使用setShareIntent()更新与操作项关联的意图。下面是一个例子：

private ShareActionProvider mShareActionProvider;
...

@Override
public boolean onCreateOptionsMenu(Menu menu) {
    // Inflatemenu resource file.
    getMenuInflater().inflate(R.menu.share_menu, menu);

    // LocateMenuItem with ShareActionProvider
    MenuItem item = menu.findItem(R.id.menu_item_share);

    // Fetch andstore ShareActionProvider
    mShareActionProvider = (ShareActionProvider) item.getActionProvider();

    // Return trueto display menu
    return true;
}

// Call to update the share intent
private void setShareIntent(Intent shareIntent) {
    if (mShareActionProvider != null) {
        mShareActionProvider.setShareIntent(shareIntent);
    }
}

在菜单的创建过程中您可能只需要设置一次共享意图，或者您可能想把它设置好，然后在UI变化时再更新它。例如，当您在相册应用程序中全屏浏览照片时，切换照片分享意图也会跟着变化。

有关ShareActionProvider对象的进一步讨论，请查阅操作栏指南。