Share2 利用了 Android 系统的原生 API 实现了分享功能,支持文本信息、图片、音视频等其他类型文件的分享,兼容处理了不同系统版本下的常见问题,并在一些主流应用上进行了兼容测试。
| 系统兼容 | 版本号 |
|---|---|
| 最低 | API 11 |
| 最高 | API 27 |
如果发现 Share2 存在不兼容的情况,请在 Issues 中提出。
利用 Android 系统原生 API 实现分享功能 和 利用 Android 系统原生 API 实现分享功能(2)
在 Project 的 build.gradle 下添加 jcenter 仓库
repositories {
jcenter()
}
在 Module 的 build.gradle 下添加 Share2 依赖
compile 'gdut.bsx:share2:0.9.3'
文件分享前必须要先获得存储权限,对于系统 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();
Share2 支持多种类型的内容分享,指定 ContentType 是为了明确文件的类型,以便于系统去匹配合适的 App 处理。 如果你无法明确被分享文件的类型,那你可以使用通用的文件类型 ShareContentType.FILE。
比如调用系统拍照录制或系统文件选择器返回的 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)