Home

一、Matisse

一个用 Jetpack Compose 实现的 Android 图片/视频 选择框架

特点 & 优势：

• 适配到 Android 13
• 解决了多个系统兼容性问题
• 按需索取权限，极简的权限声明
• 完全用 Kotlin & Jetpack Compose 实现
• 支持自定义主题，提供了日夜间两套默认主题
• 支持多种拍照策略，可以自由选择是否要申请权限

关联的文章：

• Android 13 媒体权限适配指南
• Jetpack Compose 实现一个图片选择框架

二、导入依赖

allprojects {
    repositories {
        maven { url "https://jitpack.io" }
    }
}

dependencies {
    implementation "com.github.leavesCZY:Matisse:latestVersion"
}

三、接入说明

• 0.0.9 ~ 0.0.14 版本只支持选择图片
• 1.0.0-beta01 版本开始支持选择图片和视频，并允许外部自定义加载图片的逻辑。此版本进行了大范围重构，如遇到问题请提 issues 反馈

请参照对应版本的接入指南进行接入

此外，由于 Matisse 是通过 Jetpack Compose 来实现 UI 层的，所以即使引用方没有直接使用 Jetpack Compose，也需要开启对 Jetpack Compose 的支持。kotlinCompilerExtensionVersion 的具体版本取决于引用方的 Kotlin 版本：Compose to Kotlin Compatibility Map

android {
    buildFeatures {
        compose true
    }
    composeOptions {
        kotlinCompilerExtensionVersion "x.x.x"
    }
}

目前 Matisse 是通过 compose-bom 来管理依赖，对应的版本是 2023.04.00。而由于 Jetpack Compose 的迭代速度很快，很多 API 会随着版本更迭而变化，如果遇到崩溃问题，可以先检查下是否由于 Compose 使用的是非 release 版本造成的