PictureSelector 安装与配置指南

1. 项目基础介绍

PictureSelector 是一个适用于 Android 平台的开源图片选择器库，它支持从相册获取图片、视频、音频，支持裁剪（单张或多张）、压缩、主题自定义配置等功能，是一个动态访问且适用于 Android 5.0+ 系统的开源图片选择框架。

该项目主要使用 Java 和 Kotlin 编程语言。

2. 关键技术和框架

• Android: 项目基于 Android 开发，使用 Android SDK 进行开发。
• Glide/Picasso/Coil: 支持多种图片加载引擎，例如 Glide、Picasso 和 Coil。
• RxJava: 可能用于处理异步任务和事件流。
• Dagger/Hilt: 用于依赖注入，提高项目的模块化和可测试性。

3. 安装和配置

准备工作

在开始之前，请确保您已经安装以下环境：

• Android Studio
• Java Development Kit (JDK)
• Android SDK

安装步骤

步骤 1: 添加项目依赖

在您的项目 build.gradle 文件中，添加以下依赖项：

dependencies {
    // PictureSelector 基础（必要）
    implementation 'io.github.lucksiege:pictureselector:v3.11.2'
    // 图片压缩库（非必要）
    implementation 'io.github.lucksiege:compress:v3.11.2'
    // uCrop 库（非必要）
    implementation 'io.github.lucksiege:ucrop:v3.11.2'
    // 简单 CameraX 库（非必要）
    implementation 'io.github.lucksiege:camerax:v3.11.2'
}

如果您使用的是 Maven，则需要在 pom.xml 文件中添加以下依赖项：

<dependency>
    <groupId>io.github.lucksiege</groupId>
    <artifactId>pictureselector</artifactId>
    <version>v3.11.2</version>
</dependency>
<dependency>
    <groupId>io.github.lucksiege</groupId>
    <artifactId>compress</artifactId>
    <version>v3.11.2</version>
</dependency>
<dependency>
    <groupId>io.github.lucksiege</groupId>
    <artifactId>ucrop</artifactId>
    <version>v3.11.2</version>
</dependency>
<dependency>
    <groupId>io.github.lucksiege</groupId>
    <artifactId>camerax</artifactId>
    <version>v3.11.2</version>
</dependency>

步骤 2: 配置权限

在您的 AndroidManifest.xml 文件中，添加必要的权限声明：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_MEDIA_STORAGE" />
<uses-permission android:name="android.permission.WRITE_SETTINGS" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.VIBRATE" />

对于 Android 13 的适配，需要添加以下权限：

<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />

步骤 3: 使用 PictureSelector

以下是一个简单的使用示例：

PictureSelector.create(this)
    .openGallery(SelectMimeType.ofImage())
    .setImageEngine(GlideEngine.createGlideEngine())
    .forResult(new OnResultCallbackListener<LocalMedia>() {
        @Override
        public void onResult(ArrayList<LocalMedia> result) {
            // 处理结果
        }

        @Override
        public void onCancel() {
            // 处理取消
        }
    });

按照以上步骤操作，您应该能够成功安装并配置 PictureSelector 到您的 Android 项目中。