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"
}

三、接入说明

• Jetpack Compose 在 debug 和 release 模式下性能差异较大，在加载图片列表时会表现得更加明显，建议进行性能测试时使用 release 包

• Matisse 通过 compose-bom 来管理依赖，以此保证使用的均是 release 版本的 Compose 依赖，且各个依赖之间是相互兼容的。由于 Compose 的迭代速度很快，一些 API 会随着版本更迭而变化，Matisse 和非 release 版本的 Compose 可能不完全兼容。因此如果遇到崩溃问题的话，可以先检查下是否由于项目中使用的是非 release 版本的 Compose 造成的

• 由于引用方必须实现 ImageEngine，因此如果引用方项目之前没有使用到 Jetpack Compose 的话，需要开启对 Jetpack Compose 的支持。kotlinCompilerExtensionVersion 的具体版本取决于引用方的 Kotlin 版本：Compose to Kotlin Compatibility Map

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