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

先上一张Matisse官方图

使用知乎开源框架Matisse需注意的地方。_第1张图片
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下载下来,跟着文档走一遍流程,然后再去使用的时候会得心应手有一些。

你可能感兴趣的:(使用知乎开源框架Matisse需注意的地方。)