ShareActionProvider

public class ShareActionProvider
extends ActionProvider

提供适用于活动应用栏的分享操作。 创建启用数据共享的视图。 如果供应商出现在溢出菜单中，它将创建一个具有适当共享操作的子菜单。

Adding a share action

要将“分享”操作添加到您的活动中，请将ShareActionProvider放入应用栏的菜单资源中。 例如：

 <item android:id="@+id/action_share"
      android:title="@string/share"
      app:showAsAction="ifRoom"
      app:actionProviderClass="android.support.v7.widget.ShareActionProvider"/>
 

您不需要指定图标，因为ShareActionProvider小部件会关注其自身的外观和行为。 但是，如果操作在溢出菜单中结束，您需要指定一个标题为android:title的标题。

接下来，设置包含您的活动能够共享的内容的意图。 您应该在您的处理程序中为onCreateOptionsMenu()创建此意图，并在每次共享内容更改时更新它。 建立意图：

1. Get a reference to the ShareActionProvider by calling getActionProvider() and passing the share action's MenuItem. For example:

    MenuItem shareItem = menu.findItem(R.id.action_share);
    ShareActionProvider myShareActionProvider =
        (ShareActionProvider) MenuItemCompat.getActionProvider(shareItem);

2. Create an intent with the ACTION_SEND action, and attach the content shared by the activity. For example, the following intent shares an image:

    Intent myShareIntent = new Intent(Intent.ACTION_SEND);
    myShareIntent.setType("image/*");
    myShareIntent.putExtra(Intent.EXTRA_STREAM, myImageUri);

3. Call setShareIntent() to attach this intent to the action provider:

    myShareActionProvider.setShareIntent(myShareIntent);
    

4. When the content changes, modify the intent or create a new one, and call setShareIntent() again. For example:

    // Image has changed! Update the intent:
    myShareIntent.putExtra(Intent.EXTRA_STREAM, myNewImageUri);
    myShareActionProvider.setShareIntent(myShareIntent);

Share target rankings

基于用户选择每个目标的频率，共享操作提供程序会为每个共享目标保留一个排名。 用户选择目标的频率越高，排名越高; 最常用的目标会出现在应用程序栏中作为默认目标。

默认情况下，目标排名信息存储在名称为DEFAULT_SHARE_HISTORY_FILE_NAME的私人文件中。 通常，共享操作提供程序将所有历史记录存储在此单个文件中。 但是，如果共享操作提供程序用于不同类型的内容，则使用单一排名可能没有意义。 例如，如果活动有时共享图像并且有时共享联系人，则您需要维护两组不同的排名。

要设置历史文件，请调用setShareHistoryFileName()并传递XML文件的名称。 您指定的文件将一直使用，直到您下次拨打电话setShareHistoryFileName() 。

Summary

Inherited methods
From class android.support.v4.view.ActionProvider Context getContext() 获取与此操作提供者关联的上下文。 boolean hasSubMenu() 确定此ActionProvider是否具有与其关联的子菜单。 boolean isVisible() 如果 overridesItemVisibility()返回true，则此方法的返回值将有助于确定此ActionProvider绑定到的 MenuItem的可见性。 abstract View onCreateActionView() 用于创建新操作视图的工厂方法。 View onCreateActionView(MenuItem forItem) 由Android框架调用的工厂方法来创建新的操作视图。 boolean onPerformDefaultAction() 执行可选的默认操作。 void onPrepareSubMenu(SubMenu subMenu) 调用以为由此ActionProvider支持的菜单项准备相关的子菜单。 boolean overridesItemVisibility() 这种方法的结果，判断是否 isVisible()将由使用 MenuItem此ActionProvider必然会有助于确定其可见性。 void refreshVisibility() 如果此ActionProvider与菜单中的项目相关联，请根据 overridesItemVisibility()和 isVisible()刷新该项目的可见性。 void setVisibilityListener(ActionProvider.VisibilityListener listener) 设置一个侦听器，当这个ActionProvider被覆盖的可见性发生变化时通知它。
From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程为该对象调用方法 notify()或方法 notifyAll() ，或者某个其他线程中断当前线程，或者经过一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的方法 notify()或方法 notifyAll() ，或者经过指定的时间量。 final void wait() 导致当前线程等待，直到另一个线程调用此对象的方法 notify()或方法 notifyAll() 。

Constants

String DEFAULT_SHARE_HISTORY_FILE_NAME

Public constructors

ShareActionProvider (Context context)

Public methods

boolean hasSubMenu ()

View onCreateActionView ()

void onPrepareSubMenu (SubMenu subMenu)

void setOnShareTargetSelectedListener (ShareActionProvider.OnShareTargetSelectedListener listener)

void setShareHistoryFileName (String shareHistoryFile)

 private void doShare(Intent intent) {
     if (IMAGE.equals(intent.getMimeType())) {
         mShareActionProvider.setHistoryFileName(SHARE_IMAGE_HISTORY_FILE_NAME);
     } else if (TEXT.equals(intent.getMimeType())) {
         mShareActionProvider.setHistoryFileName(SHARE_TEXT_HISTORY_FILE_NAME);
     }
     mShareActionProvider.setIntent(intent);
     supportInvalidateOptionsMenu();
 }
 

void setShareIntent (Intent shareIntent)

  Intent shareIntent = new Intent(Intent.ACTION_SEND);
  shareIntent.setType("image/*");
  Uri uri = Uri.fromFile(new File(getFilesDir(), "foo.jpg"));
  shareIntent.putExtra(Intent.EXTRA_STREAM, uri.toString());