利用 Android 系统原生 API 实现分享功能

书到用时方恨少,事非经过不知难。这篇文章主要讲述利用 Android 系统原生 API 实现分享功能相关的知识,希望能为你提供帮助。
利用 android 系统原生 API 实现分享功能这篇文章提供一个封装好的  Share2  库供大家参考。
GitHub 项目地址:Share2
大家知道,要调用 Android 系统内建的分享功能,主要有三步流程:

  • 【利用 Android 系统原生 API 实现分享功能】创建一个 Intent ,指定其 Action 为 Intent.ACTION_SEND,表示要创建一个发送指定内容的隐式意图。
  • 然后指定需要发送的内容和类型,设置分享的文本内容或文件的Uri,以及文件的类型,便于是支持该类型内容的应用打开。
  • 最后向系统发送隐式意图,开启系统分享选择器,分享完成后收到结果返回。
知道大致的实现流程后,其实只要解决下面几个问题后就可以具体实施了。
确定要分享的内容类型这其实是直接决定了最终的实现形态,我们知道常见的使用场景中,只是为了在应用间分享图片和一些文件,那对于那些只是分享文本的产品而言,两者实现起来要考虑的问题完全不同。
所以为了解决这个问题,我们可以预先定好支持的分享内容类型,针对不同类型可以进行不同的处理。
@StringDef({ShareContentType.TEXT, ShareContentType.IMAGE, ShareContentType.AUDIO, ShareContentType.VIDEO, ShareContentType.File}) @Retention(RetentionPolicy.SOURCE) @interface ShareContentType { /** * Share Text */ final String TEXT = "text/plain"; /** * Share Image */ final String IMAGE = "image/*"; /** * Share Audio */ final String AUDIO = "audio/*"; /** * Share Video */ final String VIDEO = "video/*"; /** * Share File */ final String File = "*/*"; }`

在 Share2 中,一共定义了5种类别的分享内容,基本能覆盖常见的使用场景。在调用分享接口时可以直接指定内容类型,比如像文本、图片、音视频、已经其他各种类型文件。
确定分享的内容来源对于不同类别的内容,可能会有不同的来源。比如文本可能就只是一个字符串对象,而对于分享图片或其他文件,我们需要一个  Uri  来标识一个资源。这其实就引出来具体实施时的一个大问题,如何获取要分享文件的 Uri,并且这个  Uri  要能被接收分享内容的应用处理才行 。
通常获取文件场景有:用户通过打开文件选择器或图片选择器来获取一个指定的文件;用户通过拍照或录制音视频来获取;用户下载一个文件或直接获取本地某个文件的路径来获取。
那么,如何获取要分享内容文件的 Uri?如果处理才能让接收方也能够根据 Uri 获取到文件?
我们把文件 Uri 的来源划分为下面三种类型:
系统返回的 Uri
常见场景:通过文件选择器获取一个文件的  Uri
private static final int REQUEST_FILE_SELECT_CODE = 100; private @ShareContentType String fileType = ShareContentType. File; /** * 打开文件管理选择文件 */ private void openFileChooser() { Intent intent = new Intent(Intent.ACTION_GET_CONTENT); intent.setType("*/*"); intent.addCategory(Intent.CATEGORY_OPENABLE); try { startActivityForResult(Intent.createChooser(intent, "Choose File"), REQUEST_FILE_SELECT_CODE); } catch (Exception ex) { // not install file manager. } }@Override protected void onActivityResult(int requestCode, int resultCode, final Intent data) { super.onActivityResult(requestCode, resultCode, data); if (requestCode == FILE_SELECT_CODE & & resultCode == RESULT_OK) { // 获取到的系统返回的 Uri Uri shareFileUrl = data.getData(); } }

通过这种方式获取到的 Uri 是由系统 ContentProvider 返回的,在 Android 4.4 之前的版本和之后的版本有较大的区别,我们后面再说怎么处理。只要先记住这种系统返回给我们的 Uri 就行了。
系统返回的一些常见 Uri 样式:
content://com.android.providers.media.documents..
content://com.android.providers.downloads...
content://media/external/images/media/...
content://com.android.externalstorage.documents..
自定义 FileProvider 返回的 Uri
比如调用系统相机进行拍照或录制音视频,要传入一个生成目标文件的  Uri,从 7.0 开始我们需要用到 FileProvider 来实现。
private static final int REQUEST_FILE_SELECT_CODE = 100; /** * 打开系统相机进行拍照 */ private void openSystemCamera() { //调用系统相机 Intent takePhotoIntent = new Intent(); takePhotoIntent.setAction(MediaStore.ACTION_IMAGE_CAPTURE); if (takePhotoIntent.resolveActivity(getPackageManager()) == null) { Toast.makeText(this, "当前系统没有可用的相机应用", Toast.LENGTH_SHORT).show(); return; }String fileName = "TEMP_" + System.currentTimeMillis() + ".jpg"; File photoFile = new File(FileUtil.getPhotoCacheFolder(), fileName); // 7.0和以上版本的系统要通过 FileProvider 创建一个 content 类型的 Uri if (Build.VERSION.SDK_INT > = Build.VERSION_CODES.N) { currentTakePhotoUri = FileProvider.getUriForFile(this, getPackageName() + ".fileProvider", photoFile); takePhotoIntent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION|); } else { currentTakePhotoUri = Uri.fromFile(photoFile); }//将拍照结果保存至 outputFile 的Uri中,不保留在相册中 takePhotoIntent.putExtra(MediaStore.EXTRA_OUTPUT, currentTakePhotoUri); startActivityForResult(takePhotoIntent, TAKE_PHOTO_REQUEST_CODE); }// 调用系统相机进行拍照与上面通过文件选择器获得文件 uri 的方式类似 // 在 onActivityResult 进行回调处理,此时 Uri 是你 FileProvider 中指定的,注意与文件选择器获取的 Uri 的区别。

如果用到了 FileProvider 就要注意跟系统 ContentProvider 返回 Uri 的区别,比如我们在 Manifest 中对 FileProvider 配置  android:authorities="com.xx.xxx.fileProvider"  属性,那这时系统返回的 Uri 格式就变成了 :content://com.xx.xxx.fileProvider...,对于这种类型的 Uri 我们姑且叫自定义 FileProvider 返回的 Uri,后面一并说怎么处理。
文件的路径
我们调用 new File 时需要传入指定的文件路径,这个绝对路径通常是:/storage/emulated/0/...  这种样式,我们要想调用分享时也要变成 Uri 的形式才可以,那么如何把文件路径变成一个文件 Uri ?这个问题下面也一并进行回答。
分享文件 Uri 的处理前面提到了文件 Uri 的三种分类,对应不同类型处理方式也不同,不然你最先遇到的问题就是:
java.lang.SecurityException: Uid xxx does not have permission to uri 0 @ content://com.android.providers...

这是由于对系统返回的 Uri 缺失访问权限导致,所以要对应用进行临时访问 Uri 的授权才行,不然会提示权限缺失。
对于要分享系统返回的 Uri 我们可以这样进行处理:
// 可以对发起分享的 Intent 添加临时访问授权 shareIntent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION); // 也可以这样:由于不知道最终用户会选择哪个app,所以授予所有应用临时访问权限 if (Build.VERSION.SDK_INT < = Build.VERSION_CODES.KITKAT) { List< ResolveInfo> resInfoList = activity.getPackageManager().queryIntentActivities(shareIntent, PackageManager.MATCH_DEFAULT_ONLY); for (ResolveInfo resolveInfo : resInfoList) { String packageName = resolveInfo.activityInfo.packageName; activity.grantUriPermission(packageName, shareFileUri, Intent.FLAG_GRANT_READ_URI_PERMISSION); } }

需要注意的是对于自定义 FileProvider 返回 Uri 的处理,即使是设置临时访问权限,但是分享到第三方应用也会无法识别该 Uri
典型的场景就是,我们如果把自定义 FileProvider 的返回的 Uri 设置分享到微信或 QQ 之类的第三方应用,会提示文件不存在,这是因为他们无法识别该 Uri。
关于这个问题的处理其实跟下面要说的把文件路径变成系统返回的 Uri 一样,我们只需要把自定义 FileProvider 返回的 Uri 变成第三方应用可以识别系统返回的 Uri 就行了。
创建 FileProvider 时需要传入一个 File 对象,所以直接可以知道文件路径,那就把问题都转换成了:如何通过文件路径获取系统返回的 Uri
下面是根据传入的 File 对象和类型来查询系统 ContentProvider 来获取相应的 Uri,已经按照不同文件类型在不同系统版本下的进行了适配。
其中  forceGetFileUri  方法是通过反射实现的,处理 7.0 以上系统的特殊情况下的兼容性,一般情况下不会调用到。Android 7.0 开始不允许  file://  Uri 的方式在不同的 App 间共享文件,但是如果换成 FileProvider 的方式依然是无效的,我们可以通过反射把该检测干掉。
public static Uri getFileUri (Context context, @ShareContentType String shareContentType, File file){if (context == null) { Log.e(TAG,"getFileUri current activity is null."); return null; }if (file == null || !file.exists()) { Log.e(TAG,"getFileUri file is null or not exists."); return null; }Uri uri = null; if (Build.VERSION.SDK_INT < Build.VERSION_CODES.N) { uri = Uri.fromFile(file); } else {if (TextUtils.isEmpty(shareContentType)) { shareContentType = "*/*"; }switch (shareContentType) { case ShareContentType.IMAGE : uri = getImageContentUri(context, file); break; case ShareContentType.VIDEO : uri = getVideoContentUri(context, file); break; case ShareContentType.AUDIO : uri = getAudioContentUri(context, file); break; case ShareContentType.File : uri = getFileContentUri(context, file); break; default: break; } }if (uri == null) { uri = forceGetFileUri(file); }return uri; }private static Uri getFileContentUri(Context context, File file) { String volumeName = "external"; String filePath = file.getAbsolutePath(); String[] projection = new String[]{MediaStore.Files.FileColumns._ID}; Uri uri = null; Cursor cursor = context.getContentResolver().query(MediaStore.Files.getContentUri(volumeName), projection, MediaStore.Images.Media.DATA + "=? ", new String[] { filePath }, null); if (cursor != null) { if (cursor.moveToFirst()) { int id = cursor.getInt(cursor.getColumnIndex(MediaStore.Files.FileColumns._ID)); uri = MediaStore.Files.getContentUri(volumeName, id); } cursor.close(); }return uri; }private static Uri getImageContentUri(Context context, File imageFile) { String filePath = imageFile.getAbsolutePath(); Cursor cursor = context.getContentResolver().query(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, new String[] { MediaStore.Images.Media._ID }, MediaStore.Images.Media.DATA + "=? ", new String[] { filePath }, null); Uri uri = null; if (cursor != null) { if (cursor.moveToFirst()) { int id = cursor.getInt(cursor.getColumnIndex(MediaStore.MediaColumns._ID)); Uri baseUri = Uri.parse("content://media/external/images/media"); uri = Uri.withAppendedPath(baseUri, "" + id); }cursor.close(); }if (uri == null) { ContentValues values = new ContentValues(); values.put(MediaStore.Images.Media.DATA, filePath); uri = context.getContentResolver().insert(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, values); }return uri; }private static Uri getVideoContentUri(Context context, File videoFile) { Uri uri = null; String filePath = videoFile.getAbsolutePath(); Cursor cursor = context.getContentResolver().query(MediaStore.Video.Media.EXTERNAL_CONTENT_URI, new String[] { MediaStore.Video.Media._ID }, MediaStore.Video.Media.DATA + "=? ", new String[] { filePath }, null); if (cursor != null) { if (cursor.moveToFirst()) { int id = cursor.getInt(cursor.getColumnIndex(MediaStore.MediaColumns._ID)); Uri baseUri = Uri.parse("content://media/external/video/media"); uri = Uri.withAppendedPath(baseUri, "" + id); }cursor.close(); } if (uri == null) { ContentValues values = new ContentValues(); values.put(MediaStore.Video.Media.DATA, filePath); uri = context.getContentResolver().insert(MediaStore.Video.Media.EXTERNAL_CONTENT_URI, values); }return uri; }private static Uri getAudioContentUri(Context context, File audioFile) { Uri uri = null; String filePath = audioFile.getAbsolutePath(); Cursor cursor = context.getContentResolver().query(MediaStore.Audio.Media.EXTERNAL_CONTENT_URI, new String[] { MediaStore.Audio.Media._ID }, MediaStore.Audio.Media.DATA + "=? ", new String[] { filePath }, null); if (cursor != null) { if (cursor.moveToFirst()) { int id = cursor.getInt(cursor.getColumnIndex(MediaStore.MediaColumns._ID)); Uri baseUri = Uri.parse("content://media/external/audio/media"); uri = Uri.withAppendedPath(baseUri, "" + id); }cursor.close(); } if (uri == null) { ContentValues values = new ContentValues(); values.put(MediaStore.Audio.Media.DATA, filePath); uri = context.getContentResolver().insert(MediaStore.Audio.Media.EXTERNAL_CONTENT_URI, values); } return uri; }private static Uri forceGetFileUri(File shareFile) { if (Build.VERSION.SDK_INT > = Build.VERSION_CODES.N) { try { @SuppressLint("PrivateApi") Method rMethod = StrictMode.class.getDeclaredMethod("disableDeathOnFileUriExposure"); rMethod.invoke(null); } catch (Exception e) { Log.e(TAG, Log.getStackTraceString(e)); } }return Uri.parse("file://" + shareFile.getAbsolutePath()); }

通过 File Path 转成 Uri 的方式,我们最终统一了调用系统分享时传入内容 Uri 的三种不同场景,最终全部转换为传递系统返回的 Uri,让第三方应用能够正常的获取到分享内容。
最终实现Share2 按照上述方法进行了具体实施,可以通过下面的方式进行集成:
// 添加依赖 compile ‘gdut.bsx:share2:0.9.0‘

根据 FilePath 获取 Uri
public Uri getShareFileUri() { return FileUtil.getFileUri(this, ShareContentType.FILE, new File(filePath)); ; }

分享文本
new Share2.Builder(this) .setContentType(ShareContentType.TEXT) .setTextContent("This is a test message.") .setTitle("Share Text") .build() .shareBySystem();

分享图片
new Share2.Builder(this) .setContentType(ShareContentType.IMAGE) .setShareFileUri(getShareFileUri()) .setTitle("Share Image") .build() .shareBySystem();

分享图片到指定界面,比如分享到微信朋友圈
new Share2.Builder(this) .setContentType(ShareContentType.IMAGE) .setShareFileUri(getShareFileUri()) .setShareToComponent("com.tencent.mm", "com.tencent.mm.ui.tools.ShareToTimeLineUI") .setTitle("Share Image To WeChat") .build() .shareBySystem();

分享文件
new Share2.Builder(this) .setContentType(ShareContentType.FILE) .setShareFileUri(getShareFileUri()) .setTitle("Share File") .build() .shareBySystem();

最终效果GitHub 项目地址:Share2
 
利用 Android 系统原生 API 实现分享功能

文章图片





    推荐阅读