Matisse README

The project's README from github.com/zhihu/Matisse. As one markdown file: README.md.

Image

Matisse

Build Status Download

Matisse is a well-designed local image and video selector for Android. You can

Zhihu Style Dracula Style Preview

Download

Gradle:

repositories {
    jcenter()
}

dependencies {
    implementation 'com.zhihu.android:matisse:$latest_version'
}

Check out Matisse releases to see more unstable versions.

ProGuard

If you use Glide as your image engine, add rules as Glide's README says.
And add extra rule:

-dontwarn com.squareup.picasso.**

If you use Picasso as your image engine, add rules as Picasso's README says.
And add extra rule:

-dontwarn com.bumptech.glide.**

Attention: The above progurad rules are correct.

How do I use Matisse?

Permission

The library requires two permissions:

So if you are targeting Android 6.0+, you need to handle runtime permission request before next step.

Simple usage snippet

Start MatisseActivity from current Activity or Fragment:

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(new GlideEngine())
        .showPreview(false) // Default is `true`
        .forResult(REQUEST_CODE_CHOOSE);

Themes

There are two built-in themes you can use to start MatisseActivity:

And Also you can define your own theme as you wish.

Receive Result

In onActivityResult() callback of the starting Activity or Fragment:

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);
    }
}

More

Find more details about Matisse in wiki.

Contributing

Matisse is an Open Source Project

Thanks

This library is inspired by Laevatein and uses some of its source code.

License

Copyright 2017 Zhihu Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Matisse (zhihu/Matisse)

Searching Database…

12.5K ·GitHub
Matisse
这是什么？Matisse 是一个 Android 库，能为你的应用提供设计精良的本地图片和视频选择器，因此你无需自己开发相册选择界面。
它是独立应用，还是我可以加到项目里的库？它是一个可以嵌入你自己应用中的 Android 库；通过在 Activity 或 Fragment 中启动，它以 Activity 的形式运行，而不是一个单独的应用。
我该怎么把它添加到我的 Android 项目里？通过 Gradle 将其作为依赖项添加，在 Releases 页面查看版本信息，然后从你的 Activity 或 Fragment 启动 MatisseActivity，并在 onActivityResult() 中处理返回结果。
使用前还需要做别的设置吗，比如权限或 ProGuard 规则？需要。该库需要 READ_EXTERNAL_STORAGE 和 WRITE_EXTERNAL_STORAGE 权限（在 Android 6.0 及以上版本中需在运行时申请）；如果你使用 Glide 或 Picasso 作为图片加载器，还必须添加它们各自的 ProGuard 规则，外加一条额外规则。
它到底支持哪些文件类型和自定义功能？它支持选择 JPEG、PNG、GIF 图片以及 MPEG、MP4 视频，内置两种主题（知乎浅色、Dracula 深色），支持自定义主题、可替换的图片加载器以及自定义过滤规则。
它内置的两个主题叫什么？R.style.MatisseZhihu 为浅色模式，R.style.MatisseDracula 为深色模式；你也可以定义自己的自定义主题。
它支持哪些图片加载库？它支持可插拔的图片加载引擎，并分别给出了 Glide 和 Picasso 的 ProGuard 配置说明。
Matisse 为什么要开发？它由知乎开发，旨在为 Android 开发者提供一个成熟、现成的本地媒体选择器，免得大家都从零开始自己做。
What are similar projects?PictureSelector, Android-Universal-Image-Loader, GSYVideoPlayer, material-components-android, CircleImageView, AndroidAutoSize, Android-PickerView, banner
Which topics is it in?android-library, image-processing, video, java, mobile, ui, android, gui, apache-2.0, library, open-source
Creator
zhihu
Size
1.9 MB
Stars
12.5K
Updated
CommitOct 30Releasev0.5.3-beta3Oct 18
Age
9y
Commits · 90 Days