先上一張Matisse官方圖
一淀散、Matisse的使用方式就不贅述了,可以自行看文檔也可down下來(lái)跑一邊demo堵第,貼一下Matisse地址吧凉,接下來(lái)就說(shuō)一下使用Matisse可能遇到的錯(cuò)誤。
- 因?yàn)镸atisse的使用需要訪問(wèn)SD卡路徑權(quán)限踏志,如果你在 6.0 以上系統(tǒng)使用阀捅,則需要?jiǎng)討B(tài)申請(qǐng)權(quán)限,加入權(quán)限配置不當(dāng)則會(huì)拋出如下的異常。
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內(nèi)置的圖片加載器為Glide和Picasso针余,默認(rèn)使用的Glide為圖片的加載方式饲鄙,Matisse目前使用的Glide版本為3.7,如果項(xiàng)目使用的版本號(hào)大于Glide3.8的話則會(huì)導(dǎo)致觸發(fā)如下的異常圆雁。
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不止提供選擇圖片忍级,還提供打開(kāi)手機(jī)相機(jī)拍照返回圖片,如配置不當(dāng)?shù)臅?huì)拋出以下異常伪朽。
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遇到的異常情況,現(xiàn)在一一的解決掉異常烈涮。
2.1. 先解決在 6.0 以及更高版本系統(tǒng)未動(dòng)態(tài)動(dòng)態(tài)申請(qǐng)權(quán)限拋出的異常, Android 6.0 之后Google對(duì)權(quán)限機(jī)制進(jìn)行了更改朴肺,在使用一些危險(xiǎn)權(quán)限時(shí)則需要?jiǎng)討B(tài)的進(jìn)行申請(qǐng),讓用戶感知坚洽,知曉戈稿,所以在使用前需要先檢查用戶是否授權(quán),這里簡(jiǎn)單闡述一下動(dòng)態(tài)權(quán)限的申請(qǐng)讶舰,可以參考一下張鴻洋的這篇博客鞍盗,第三方庫(kù)推薦使用easypermissions需了。
- 檢查用戶是否授權(quán)
if (ContextCompat.checkSelfPermission(thisActivity,
Manifest.permission.WRITE_EXTERNAL_STORAGE)
!= PackageManager.PERMISSION_GRANTED) {
未授權(quán),此時(shí)需要申請(qǐng)權(quán)限
}else{
已授權(quán)
}
- 申請(qǐng)授權(quán)
ActivityCompat.requestPermissions(thisActivity,
new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE},
REQUEST_PERMISSION_CODE);
- 處理權(quán)限申請(qǐng)回調(diào)
@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) {
//用戶已授權(quán)
} else {
//用戶未授權(quán)
}
}
}
2.2. 解決Glide使用版本不一致導(dǎo)致觸發(fā)的異常般甲,由于Glide4.0之后Api的調(diào)用方式有了一些更改肋乍,所以之前的一些Api調(diào)用方式則會(huì)出錯(cuò)。 關(guān)于Glide 4.0之后Api調(diào)用方式的改動(dòng)可以參考官方文檔
- Matisse的當(dāng)前使用Glide加載圖片的類(lèi)為GlideEngine,實(shí)現(xiàn)了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版本與當(dāng)前主工程Glide版本一致历帚,然后將上面的代碼覆蓋到GlideEngine類(lèi)即可。
- 如果是Gradle方式引入的話杠娱,則新建一個(gè)類(lèi)挽牢,實(shí)現(xiàn)ImageEngine接口,然后將上述代碼覆蓋摊求,然后在使用時(shí)設(shè)置為自己新建的圖片加載類(lèi)即可禽拔,如下。
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(你新建的圖片加載類(lèi))
.forResult(REQUEST_CODE_CHOOSE);
2.3. 解決使用Matisse拍照時(shí)拋出的異常,配置以下步驟可避免拍照時(shí)的異常室叉。
- 配置拍照后圖片的存放地址, FILE_PATH = 你項(xiàng)目的包名.fileprovider,必須配置不然會(huì)拋異常
Matisse.from(HomePagerActivity.this)
.choose(MimeType.ofAll(), false)
.countable(true)
.capture(true) //使用拍照功能
.captureStrategy(new CaptureStrategy(true, FILE_PATH)) //是否拍照功能睹栖,并設(shè)置拍照后圖片的保存路徑
.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文件中配置一個(gè)FileProvider,配置如下茧痕。
<provider
android:name="android.support.v4.content.FileProvider"
android:authorities="項(xiàng)目的包名.fileprovider"
android:exported="false"
android:grantUriPermissions="true">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/file_paths_public" />
</provider>
res里新建個(gè)包xml里新建個(gè)file_paths_public.xml文件
<paths>
<external-path
name="my_images"
path="Android/data/com.thunder.sample.fileprovider/files/Pictures"/>
</paths>
建議: 建議大家在使用第三方庫(kù)的時(shí)候先把demo下載下來(lái)野来,跟著文檔走一遍流程,然后再去使用的時(shí)候會(huì)得心應(yīng)手有一些踪旷。