先上一张Matisse官方图
image
一、Matisse的使用方式就不赘述了，可以自行看文档也可down下来跑一边demo，贴一下Matisse地址，接下来就说一下使用Matisse可能遇到的错误。
- 因为Matisse的使用需要访问SD卡路径权限，如果你在 6.0 以上系统使用，则需要动态申请权限,加入权限配置不当则会抛出如下的异常。
java.lang.SecurityException: Permission Denial: reading com.android.providers.media.MediaProvider uri content://media/external/file from pid=30724, uid=10426 requires android.permission.READ_EXTERNAL_STORAGE, or grantUriPermission()
at android.content.ContentProvider.enforceReadPermissionInner(ContentProvider.java:616)
at android.content.ContentProvider$Transport.enforceReadPermission(ContentProvider.java:483)
at android.content.ContentProvider$Transport.query(ContentProvider.java:212)
at android.content.ContentProviderNative.onTransact(ContentProviderNative.java:112)
- Matisse内置的图片加载器为Glide和Picasso，默认使用的Glide为图片的加载方式，Matisse目前使用的Glide版本为3.7，如果项目使用的版本号大于Glide3.8的话则会导致触发如下的异常。
java.lang.NoSuchMethodError: No virtual method load(Landroid/net/Uri;)Lcom/bumptech/glide/DrawableTypeRequest; in class Lcom/bumptech/glide/RequestManager; or its super classes (declaration of 'com.bumptech.glide.RequestManager' appears in /data/app/note.lym.org.noteproject-2/base.apk)
at com.zhihu.matisse.engine.impl.GlideEngine.loadThumbnail(GlideEngine.java:36)
at com.zhihu.matisse.internal.ui.widget.PhotoGrid.setImage(PhotoGrid.java:112)
at com.zhihu.matisse.internal.ui.widget.PhotoGrid.bindPhoto(PhotoGrid.java:80)
at com.zhihu.matisse.internal.ui.adapter.AlbumPhotosAdapter.onBindViewHolder(AlbumPhotosAdapter.java:111)
at com.zhihu.matisse.internal.ui.adapter.RecyclerViewCursorAdapter.onBindViewHolder(RecyclerViewCursorAdapter.java:44)
- Matisse不止提供选择图片，还提供打开手机相机拍照返回图片，如配置不当的会抛出以下异常。
java.lang.SecurityException: Uid 10424 does not have permission to uri 0 @ content://com.zhihu.matisse.sample.fileprovider/my_images/JPEG_20180307_173202.jpg
at android.os.Parcel.readException(Parcel.java:1684)
at android.os.Parcel.readException(Parcel.java:1637)
at android.app.ActivityManagerProxy.startActivity(ActivityManagerNative.java:3155)
at android.app.Instrumentation.execStartActivity(Instrumentation.java:1520)
at android.app.Activity.startActivityForResult(Activity.java:4399)
二、以上是目前使用Matisse遇到的异常情况，现在一一的解决掉异常。
2.1. 先解决在 6.0 以及更高版本系统未动态动态申请权限抛出的异常, Android 6.0 之后Google对权限机制进行了更改，在使用一些危险权限时则需要动态的进行申请，让用户感知，知晓，所以在使用前需要先检查用户是否授权，这里简单阐述一下动态权限的申请，可以参考一下张鸿洋的这篇博客，第三方库推荐使用easypermissions。
- 检查用户是否授权
if (ContextCompat.checkSelfPermission(thisActivity,
Manifest.permission.WRITE_EXTERNAL_STORAGE)
!= PackageManager.PERMISSION_GRANTED) {
未授权，此时需要申请权限
}else{
已授权
}
- 申请授权
ActivityCompat.requestPermissions(thisActivity,
new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE},
REQUEST_PERMISSION_CODE);
- 处理权限申请回调
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
super.onRequestPermissionsResult(requestCode, permissions, grantResults);
switch (requestCode) {
case REQUEST_PERMISSION_CODE:
if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
//用户已授权
} else {
//用户未授权
}
}
}
2.2. 解决Glide使用版本不一致导致触发的异常，由于Glide4.0之后Api的调用方式有了一些更改，所以之前的一些Api调用方式则会出错。 关于Glide 4.0之后Api调用方式的改动可以参考官方文档
- Matisse的当前使用Glide加载图片的类为GlideEngine,实现了ImageEngine接口，代码如下。
public class GlideEngine implements ImageEngine {
@Override
public void loadThumbnail(Context context, int resize, Drawable placeholder, ImageView imageView, Uri uri) {
RequestOptions options = new RequestOptions()
.centerCrop()
.placeholder(placeholder)//这里可自己添加占位图
.override(resize, resize);
Glide.with(context)
.asBitmap() // some .jpeg files are actually gif
.load(uri)
.apply(options)
.into(imageView);
}
@Override
public void loadGifThumbnail(Context context, int resize, Drawable placeholder, ImageView imageView, Uri uri) {
RequestOptions options = new RequestOptions()
.centerCrop()
.placeholder(placeholder)//这里可自己添加占位图
.override(resize, resize);
Glide.with(context)
.asGif() // some .jpeg files are actually gif
.load(uri)
.apply(options)
.into(imageView);
}
@Override
public void loadImage(Context context, int resizeX, int resizeY, ImageView imageView, Uri uri) {
RequestOptions options = new RequestOptions()
.centerCrop()
.override(resizeX, resizeY)
.priority(Priority.HIGH);
Glide.with(context)
.load(uri)
.apply(options)
.into(imageView);
}
@Override
public void loadGifImage(Context context, int resizeX, int resizeY, ImageView imageView, Uri uri) {
RequestOptions options = new RequestOptions()
.centerCrop()
.override(resizeX, resizeY);
Glide.with(context)
.asGif() // some .jpeg files are actually gif
.load(uri)
.apply(options)
.into(imageView);
}
@Override
public boolean supportAnimatedGif() {
return true;
}
}
- 如果你是引入module的方式使用的Matisse，那么修改Matisse的Glide版本与当前主工程Glide版本一致，然后将上面的代码覆盖到GlideEngine类即可。
- 如果是Gradle方式引入的话，则新建一个类，实现ImageEngine接口，然后将上述代码覆盖，然后在使用时设置为自己新建的图片加载类即可，如下。
Matisse.from(MainActivity.this)
.choose(MimeType.allOf())
.countable(true)
.maxSelectable(9)
.addFilter(new GifSizeFilter(320, 320, 5 * Filter.K * Filter.K))
.gridExpectedSize(getResources().getDimensionPixelSize(R.dimen.grid_expected_size))
.restrictOrientation(ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED)
.thumbnailScale(0.85f)
.imageEngine(你新建的图片加载类)
.forResult(REQUEST_CODE_CHOOSE);
2.3. 解决使用Matisse拍照时抛出的异常,配置以下步骤可避免拍照时的异常。
- 配置拍照后图片的存放地址, FILE_PATH = 你项目的包名.fileprovider,必须配置不然会抛异常
Matisse.from(HomePagerActivity.this)
.choose(MimeType.ofAll(), false)
.countable(true)
.capture(true) //使用拍照功能
.captureStrategy(new CaptureStrategy(true, FILE_PATH)) //是否拍照功能，并设置拍照后图片的保存路径
.maxSelectable(MAX_SELECT)
.gridExpectedSize(
getResources().getDimensionPixelSize(R.dimen.grid_expected_size))
.restrictOrientation(ActivityInfo.SCREEN_ORIENTATION_PORTRAIT)
.thumbnailScale(SCALE)
.imageEngine(new GlideEngine())
.forResult(REQUEST_CODE_CHOOSE);
- 在manifest文件中配置一个FileProvider，配置如下。
res里新建个包xml里新建个file_paths_public.xml文件
建议： 建议大家在使用第三方库的时候先把demo下载下来，跟着文档走一遍流程，然后再去使用的时候会得心应手有一些。