简介

Matisse，是一款由知乎开源的媒体选择器。

  • 在Activity和Fragment中使用
  • 支持JPEG，PNG，GIF的图片选择和MPEG，MP4格式的视频选择。不能同时选择图片和视频
  • 两种主题可供选择，因为知乎也是两种主题
  • 图片Loader
  • 自定义过滤条件

使用方法

Gradle

repositories {
    jcenter()
}

dependencies {
    compile 'com.zhihu.android:matisse:0.4.3'
}

ProGuard

如果使用Glide作为图片加载开源库

-keep public class * implements com.bumptech.glide.module.GlideModule
-keep public enum com.bumptech.glide.load.resource.bitmap.ImageHeaderParser$** {
  **[] $VALUES;
  public *;
}

# for DexGuard only
-keepresourcexmlelements manifest/application/meta-data@value=GlideModule

如果使用Picasso作为图片加载开源库

-dontwarn com.squareup.okhttp.**

代码使用

知乎主题

Matisse.from(MainActivity.this)
        .choose(MimeType.ofAll())
        .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_PORTRAIT)
        .thumbnailScale(0.85f)
        .imageEngine(new GlideEngine())
        .forResult(REQUEST_CODE_CHOOSE);

Dracula主题

Matisse.from(MainActivity.this)
        .choose(MimeType.of(MimeType.JPEG, MimeType.PNG))
        .theme(R.style.Matisse_Dracula)
        .countable(false)
        .maxSelectable(9)
        .imageEngine(new PicassoEngine())
        .forResult(REQUEST_CODE_CHOOSE);

结果处理

List<Uri> mSelected;

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (requestCode == REQUEST_CODE_CHOOSE && resultCode == RESULT_OK) {
        mSelected = Matisse.obtainResult(data);
        Log.d("Matisse", "mSelected: " + mSelected);
    }
}

更多详细内容请查阅官方Wiki.

效果

图片来源项目Github

Zhihu Style

Dracula Style

Preview




源码分析

代码结构

android 图片处理 开源 android图片选择器开源库_知乎

类分析

类名

描述

ImageEngine

图片加载接口，方便后面根据Glide和Picasso分别实现

GlideEngine

Glide实现ImageEngine

PicassoEngine

Picasso实现ImageEngine

Filter

过滤条件抽象类，我们可以通过集成Filter实现对应的过滤条件来对图片进行筛选，可以添加多个Filter,具体参考官方Demo中的GifSizeFilter

Album

相册Entity

CaptureStrategy

拍照相关，媒体处理authority

IncapableCause

信息处理，toast和dialog

Item

选择媒体界面的Item

SelectionSpec

选择参数类

AlbumLoader

相册CursorLoader

AlbumMediaLoader

图片和视频CursorLoader

AlbumCollection

AlbumLoader回调

AlbumMediaCollection

AlbumMediaLoader回调

SelectedItemCollection

被选中项集合

internal/ui包

界面显示的Adapter,自定义视图，Fragment和Activity

internal/utils包

工具类

MatisseActivity

关键类，执行选择媒体操作的时候展示出来的Activity

Matisse

开源库的入口和出口，用来传递Activity和Fragment，创建SelectionSpecBuilder和返回结果

MimeType

媒体类型

SelectionSpecBuilder

Build构造类，用来传递参数

设计思路

与PhotoPicker比较
  • 从MatisseActivity来看的话，大致的设计思路和PhotoPicker相似，都是以单独的Activity为载体，传递参数的方式和PhotoPicker不同，PhotoPicker使用的是bundle, 而Matisse使用的是SelectionSpec单例，启动应用之前，参数全部设置完毕，然后在MatisseActivity通过SelectionSpec.getInstance()拿到单例，获取参数。选择结果和PhotoPicke实现比较相似，都是通过Bundle保存结果通过setResult返回给调用的Activity或者Fragment.
    SelectedPreviewActivity就是PhotoPicker中的预览Activity，只是没有通过SelectionSpecBuilder对外暴露，要使用的话，我们只能自己显式的调用。
  • 与PhotoPicker一样，都是采用Android Loader机制作为数据加载的方式，大致原理清楚，自己在平时的开发中还没有用到过，找个机会尝试一下。
  • Build设计模式，链式代码编写方式。
  • PhotoPicker使用的是Glide作为图片加载框架，而Matisse支持Glide和Picasso，但是Picasso支持的功能Glide全都有，选择一个即可（Picasso不支持Gif）
  • Matisse，支持视频文件的选择，PhotoPicker从名字上看就不支持。
  • PhotoPicker支持自定义样式，主要是颜色；Matisse，支持两种主题模式，与知乎呼应。