胡凯

Android Training - 分享简单数据(Lesson 3 - 在Actionbar上添加分享功能)

| Comments

这一课会介绍在ActionBar 中添加一个高效率且比较友好的Share功能,会使用到ActionProvider(在Android 4.0上才被引进)。它会handle出现share功能的appearance与hehavior。在ShareActionProvider的例子里面,你之需要提供一个share intent,剩下的就交给ShareActionProvider来做。

actionbar-shareaction.png

Update Menu Declarations(更新菜单声明)

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

1
2
3
4
5
6
7
<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,请看下面的例子:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
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


学习自:http://developer.android.com/training/sharing/shareaction.html,请多指教,谢谢!
转载请注明出自http://kesenhoo.github.io,谢谢配合!

Comments