本篇文章已授權(quán)微信公眾號(hào) guolin_blog （郭霖）獨(dú)家發(fā)布

前言

在實(shí)際開發(fā)中，圖片選擇器一直都是必不可少的一個(gè)部分奸焙，不管是 QQ 頭像的設(shè)置崇裁，還是發(fā)送一條裝逼的微信朋友圈，都要用到圖片選擇器來(lái)給用戶選擇他們想要上傳的圖片础拨，最近知乎開源了一款圖片選擇庫(kù) Matisse 簡(jiǎn)直美哭了氮块，而且完全遵循 Android 交互設(shè)計(jì)規(guī)范，實(shí)在是很良心诡宗。

在開始正文之前滔蝉，先欣賞一下這個(gè)圖片選擇器的效果

Matisse

是不是感覺相當(dāng)?shù)暮?jiǎn)潔好看，反正我是這么認(rèn)為的塔沃。

一蝠引、基本使用

1、導(dǎo)入相應(yīng)的依賴庫(kù)

Gradle:

repositories {
    jcenter()
}

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

有一點(diǎn)要注意一下蛀柴， 這個(gè)圖片選擇庫(kù)是使用 Glide 或 Picasso 作為圖片加載引擎

如果你使用 Glide 作為你的圖片加載引擎螃概，請(qǐng)?zhí)砑?Glide 的 README 上所說(shuō)的規(guī)則，以及添加額外的規(guī)則：

-dontwarn com.squareup.picasso.**

如果你使用 Picasso 作為你的圖片加載引擎鸽疾，請(qǐng)?zhí)砑?Picasso 的 README 上所說(shuō)的規(guī)則吊洼，以及添加額外的規(guī)則：

-dontwarn com.bumptech.glide.**

2、啟動(dòng) Matisse

在正式寫代碼之前制肮，有兩個(gè)相關(guān)的權(quán)限需要先申請(qǐng)：

android.permission.READ_EXTERNAL_STORAGE
android.permission.WRITE_EXTERNAL_STORAGE

所以冒窍，如果你的 APP 是跑在 Android 6.0+ 的話，你需要在下個(gè)步驟之前處理一下運(yùn)行時(shí)權(quán)限豺鼻。

我們可以在平常的 Activity 或 Fragment 中啟動(dòng) MatisseActivity

Matisse.from(MainActivity.this)
        .choose(MimeType.ofAll(), false) // 選擇 mime 的類型
        .countable(true)
        .maxSelectable(9) // 圖片選擇的最多數(shù)量
        .gridExpectedSize(getResources().getDimensionPixelSize(R.dimen.grid_expected_size))
        .restrictOrientation(ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED)
        .thumbnailScale(0.85f) // 縮略圖的比例
        .imageEngine(new GlideEngine()) // 使用的圖片加載引擎
        .forResult(REQUEST_CODE_CHOOSE); // 設(shè)置作為標(biāo)記的請(qǐng)求碼

3综液、接收選擇的結(jié)果

在啟動(dòng)圖片選擇器的 Activity 或 Fragment 中的 onActivityResult() 進(jìn)行結(jié)果的回調(diào)處理

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

二、常用的 API

Mime 類型

Matisse 支持以下的 mime 類型

默認(rèn)情況下儒飒，所有的圖像和視頻都將顯示在 Matisse 中谬莹，而且你并不能通過(guò)以下方法來(lái)限制可選擇的 mime 類型：

• MimeType.ofAll()
• MimeType.of(MimeType type, MimeType... rest)
• MimeType.ofImage()
• MimeType.ofVideo()

不過(guò)你可以讓 Matisse 只顯示一種媒體類型，如果

• 啟動(dòng)的時(shí)候桩了，調(diào)用 showSingleMediaType(true)
• 只選擇圖片或者視頻

數(shù)量

默認(rèn)情況
在縮略圖的右上角有一個(gè)復(fù)選標(biāo)記届良，讓你不僅可以選擇一個(gè)圖像

自動(dòng)增長(zhǎng)的數(shù)目
使用 countable(true) 來(lái)顯示一個(gè)從 1 開始的數(shù)字

最大的數(shù)字?jǐn)?shù)量
使用 maxSelectable(int maxSelectable) 來(lái)限制可選擇的最大數(shù)目

方向

使用 restrictOrientation*(@ScreenOrientation int orientation) 來(lái)設(shè)置圖像選擇和預(yù)覽活動(dòng)所需的方向。

網(wǎng)格的規(guī)格

如果你想要固定的跨度計(jì)數(shù)圣猎，請(qǐng)使用 spanCount(int spanCount)士葫，當(dāng)方向更改時(shí)，范圍計(jì)數(shù)將保持不變送悔。

如果希望可以靈活地適應(yīng)不同屏幕的網(wǎng)格大小慢显，請(qǐng)使用 spanCount(int spanCount)，該值不一定被應(yīng)用欠啤，因?yàn)閳D片網(wǎng)格應(yīng)該填滿視圖容器荚藻。測(cè)量的圖片網(wǎng)格的大小將盡可能接近該值。

縮略圖縮放

使用 thumnailScale(float scale) 來(lái)設(shè)置縮略圖位圖相對(duì)于視圖大小的縮放比例洁段，而且它應(yīng)該是（0.0应狱，1.0）中的浮點(diǎn)值。

三祠丝、主題

內(nèi)置的主題

在 Matisse 中有兩種內(nèi)置的主題：

• Zhihu（亮藍(lán)色主題）
• Dracula（黑色主題）

當(dāng)啟動(dòng) Matisse 的時(shí)候疾呻，調(diào)用 theme(@styleRes int themeId) 方法來(lái)使用其中一種主題

Matisse.from(MainActivity.this)
    ...
    .theme(R.style.Matisse_Zhihu | R.style.Matisse_Dracula)
    .forResult(REQUEST_CODE_CHOOSE);

自定義主題

從兩個(gè)內(nèi)置主題除嘹，甚至是他們的父母派生自定義主題，你可以自定義 Matisse 的外觀

這些屬性（在 attrs.xml 中定義）可以修改：

以上便是本文的全部?jī)?nèi)容，如果想進(jìn)一步了解 Matisse 的源碼實(shí)現(xiàn)璃岳，可以看下這篇文章：知乎 Matisse 源碼解析年缎，帶你探究高效圖片選擇庫(kù)的秘密

猜你喜歡

• Android 一款十分簡(jiǎn)潔、優(yōu)雅的日記 APP
• Android 能讓你少走彎路的干貨整理
• Android 擼起袖子铃慷，自己封裝 DialogFragment
• 手把手教你從零開始做一個(gè)好看的 APP