【Android Developers Training】 34. 添加一个简单的分享行为(Action)

注:本文翻译自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及更高的平台上可以使用。

【Android Developers Training】 34. 添加一个简单的分享行为(Action)

图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_TEXTEXTRA_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对象的讨论。

上一篇:让footer始终待在页面底部


下一篇:Android之自定义Adapter的ListView