使用知乎开源框架Matisse需注意的地方。

先上一张Matisse官方图

一、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，配置如下。

   <provider
            android:name="android.support.v4.content.FileProvider"
            android:authorities="项目的包名.fileprovider"
            android:exported="false"
            android:grantUriPermissions="true">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/file_paths_public" />
        </provider>

    res里新建个包xml里新建个file_paths_public.xml文件
        <paths>
            <external-path
                name="my_images"
                path="Android/data/com.thunder.sample.fileprovider/files/Pictures"/>
        </paths>

建议： 建议大家在使用第三方库的时候先把demo下载下来，跟着文档走一遍流程，然后再去使用的时候会得心应手有一些。

使用知乎开源框架Matisse需注意的地方。

先上一张Matisse官方图

一、Matisse的使用方式就不赘述了，可以自行看文档也可down下来跑一边demo，贴一下Matisse地址，接下来就说一下使用Matisse可能遇到的错误。

二、以上是目前使用Matisse遇到的异常情况，现在一一的解决掉异常。

2.2. 解决Glide使用版本不一致导致触发的异常，由于Glide4.0之后Api的调用方式有了一些更改，所以之前的一些Api调用方式则会出错。 关于Glide 4.0之后Api调用方式的改动可以参考官方文档

2.2. 解决Glide使用版本不一致导致触发的异常，由于Glide4.0之后Api的调用方式有了一些更改，所以之前的一些Api调用方式则会出错。关于Glide 4.0之后Api调用方式的改动可以参考官方文档