MultiImageSelector 使用教程

1. 项目目录结构及介绍

MultiImageSelector 是一个用于Android的图片选择库，其目录结构主要包括以下几个关键部分：

• app - 示例应用模块，包含了如何使用MultiImageSelector的一个实例。
• library - 图片选择库的核心代码，实现了图片选择界面和相关功能。
• src/main/java/me/nereo/multi_image_selector - 库的主要Java代码，包括MultiImageSelectorActivity, MultiImageSelectorFragment等核心类。
• src/main/res - UI资源，例如布局文件、图标以及字符串资源。
• build.gradle 文件分别在app和library目录下，管理各自模块的构建设置。

2. 项目的启动文件介绍

MultiImageSelectorActivity

这是库的主要活动，当用户需要启动图片选择界面时，你应该通过它来启动。它处理图片选择的生命周期和结果回调。默认情况下，MultiImageSelectorActivity包含了图片选择的界面和逻辑，你可以根据需要自定义这个活动。

MultiImageSelectorFragment

MultiImageSelectorFragment包含了实际的图片选择视图，展示了从手机相册选择的图片。此碎片可以在你的活动中添加并控制以展示图片选择界面。

3. 项目的配置文件介绍

AndroidManifest.xml

在你的应用的AndroidManifest.xml中，你需要添加以下权限以允许访问外部存储：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

<!-- Image Selector Entry -->
<activity
    android:configChanges="orientation|screenSize"
    android:name="me.nereo.multi_image_selector.MultiImageSelectorActivity" />

这些权限用于读取和写入图片，而MultiImageSelectorActivity的入口确保了图片选择功能的正常运行。

build.gradle

在你的build.gradle (app module) 文件中，添加MultiImageSelector作为依赖库：

dependencies {
    implementation 'com.github.lovetuzitong:MultiImageSelector:1.2'
}

同时，确保你的根build.gradle文件包含了JitPack仓库：

allprojects {
    repositories {
        google()
        jcenter()
        maven { url 'https://jitpack.io' }
    }
}

以上就是使用MultiImageSelector的基本配置和启动流程。在你的应用程序中，调用启动MultiImageSelectorActivity并处理返回的结果即可开始图片选择。具体调用API方法如下：

// 在Activity中启动图片选择器
MultiImageSelector.create(this)
                 .single() // 或者 .multiple() 根据需求选择单选或多选
                 .start(this, REQUEST_CODE_GALLERY);

// 重写onActivityResult以处理选择结果
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    if (requestCode == REQUEST_CODE_GALLERY && resultCode == RESULT_OK) {
        // 获取图片路径
        List<String> paths = data.getStringArrayListExtra(MultiImageSelectorActivity.EXTRA_RESULT);
        if (paths != null) {
            for (String path : paths) {
                // 对每张图片做进一步的操作，比如展示
            }
        }
    } else {
        super.onActivityResult(requestCode, resultCode, data);
    }
}

完成这些步骤之后，你就可以在你的Android应用中利用MultiImageSelector轻松实现图片选择了。