570622566 / share2

Content Share For Android.

Share2

Share2 利用了 Android 系统的原生 API 实现了分享功能，支持文本信息、图片、音视频等其他类型文件的分享，兼容处理了不同系统版本下的常见问题，并在一些主流应用上进行了兼容测试。

系统兼容	版本号
最低	API 11
最高	API 27

如果发现 Share2 存在不兼容的情况，请在 Issues 中提出。

实现效果

Demo 下载

相关文章：

利用 Android 系统原生 API 实现分享功能 和 利用 Android 系统原生 API 实现分享功能（2）

添加项目依赖

在 Project 的 build.gradle 下添加 jcenter 仓库

repositories {
    jcenter()
}

在 Module 的 build.gradle 下添加 Share2 依赖

compile 'gdut.bsx:share2:0.9.3'

使用 Share2 进行分享

文件分享前必须要先获得存储权限，对于系统 API 22 及以上的设备请先动态获取存储授权，Share2 内部不会主动请求权限。

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

分享一张图片

new Share2.Builder(this) 
      // 指定分享的文件类型
      .setContentType(ShareContentType.IMAGE)
      // 设置要分享的文件 Uri
      .setShareFileUri(shareImageUri)
      // 设置分享选择器的标题
      .setTitle("Share Image")
      .build()
      // 发起分享
      .shareBySystem();

关键步骤

1.使用 setContentType(type) 来设置被分享文件的类型

Share2 支持多种类型的内容分享，指定 ContentType 是为了明确文件的类型，以便于系统去匹配合适的 App 处理。 如果你无法明确被分享文件的类型，那你可以使用通用的文件类型 ShareContentType.FILE。

2.调用 setShareFileUri(uri) 方法设置被分享文件的 Uri

⚠️注意 此方法传入的 Uri 必须是系统提供的 ContentProvider 返回的，而不能是自定义 FileProvider 返回的 Uri，不然会造成其他第三方应用无法识别的问题。

比如调用系统拍照录制或系统文件选择器返回的 Uri 都是符合要求的，而如果传入其他一些不符合要求 Uri，那么在分享时其他第三方应用如QQ、微信等就会提示获取不到文件的内容。

对于无法确定 Uri 是否合适的情况，建议你使用 Share2 提供的 FileUtil.getFileUri() 方法来获取对应文件的 Uri ：

// FileUtil.Class 如果不知道文件类型，参数 `shareContentType` 可以直接传入 `null`
public static Uri getFileUri (Context context, @ShareContentType String shareContentType, File file)

其他一些使用场景

分享其他类型的内容

分享文本内容时：

new Share2.Builder(this)
    .setContentType(ShareContentType.TEXT)
    // 设置要分享的文本内容
    .setTextContent("This is a test message.")
    .setTitle("Share Text")
    .build()
    .shareBySystem();

分享未知类型的文件时：

new Share2.Builder(this)
    .setContentType(ShareContentType.FILE)
    .setShareFileUri(fileUri)
    .build()
    .shareBySystem();

指定分享到特定的应用

某些场景下需要分享到特定的应用，可以使用下面这个方法：

/**
 * componentPackageName 指定接收分享的 APP 的包名
 * componentClassName 指定接收分享的 APP 的类名
 */
 public Builder setShareToComponent(String componentPackageName, String componentClassName);

比如当我们要分享到微信朋友圈时：

builder.setShareToComponent("com.tencent.mm", "com.tencent.mm.ui.tools.ShareToTimeLineUI")

设置分享时是否强制使用选择器

如果系统设置了某些类型文件的默认打开方式，当我们进行分享时会直接跳转到默认应用。调用下面的方法可以设置每次分享时是否都要显示选择器，即使系统已经有默认的打开方式了。

// 默认是 true
public Builder forcedUseSystemChooser (boolean enable)

设置分享完成后的回调

通过下面的方法可以设置分享完成后在当前分享页 Activity 的 onActivityResult 方法中接收回调：

public Builder setOnActivityResult (int requestCode)