Android-ImagesPickers 项目下载及安装教程

Android-ImagesPickers 项目下载及安装教程

1. 项目介绍

Android-ImagesPickers 是一个集图片选择（单选/多选）、拍照、裁剪、图片预览、图片显示容器的图片选择显示工具。使用方便，开发者仅需要几行的代码就可以集成 Android 整套图片“选裁显删”功能。可以通过设置参数选择自己想要使用的功能。Android-ImagesPickers 自身并没有强制绑定某个图片加载器（如 UIL、Glide、Fresco、Picasso），开发者可以根据自己项目需求给 Android-ImagesPickers 配置图片加载器。

2. 项目下载位置

项目下载位置为 GitHub 仓库：https://github.com/jaikydota/Android-ImagesPickers.git。

3. 项目安装环境配置

3.1 环境要求

• Android Studio 3.0 及以上版本
• Gradle 4.1 及以上版本
• JDK 1.8 及以上版本

3.2 配置 Gradle

在项目的 build.gradle 文件中添加 jcenter 仓库：

allprojects {
    repositories {
        jcenter()
    }
}

在 module 的 build.gradle 文件中添加依赖：

dependencies {
    implementation 'com.jaikydota.imagespickers:imagespickers:1.0.6'
    // 如果使用图片加载框架，添加依赖，下面用 Glide 示例
    implementation 'com.github.bumptech.glide:glide:3.6.1'
}

3.3 配置权限

在 AndroidManifest.xml 中添加如下权限：

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

4. 项目安装方式

4.1 创建图片加载器

创建一个图片加载器，例如使用 Glide：

public class GlideLoader implements ImageLoader {
    @Override
    public void displayImage(Context context, String path, ImageView imageView) {
        Glide.with(context)
             .load(path)
             .placeholder(com.jaiky.imagespickers.R.drawable.global_img_default)
             .centerCrop()
             .into(imageView);
    }
}

4.2 配置 ImageConfig

配置 UI 视图配置：

ImageConfig imageConfig = new ImageConfig.Builder(new GlideLoader())
    .steepToolBarColor(getResources().getColor(R.color.blue))
    .titleBgColor(getResources().getColor(R.color.blue))
    .titleSubmitTextColor(getResources().getColor(R.color.white))
    .titleTextColor(getResources().getColor(R.color.white))
    .build();

4.3 开启图片选择器

在需要开启图片选择器的地方调用：

ImageSelector.open(MainActivity.this, imageConfig);

5. 项目处理脚本

在 onActivityResult 中获取选中的照片路径数组：

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (requestCode == ImageSelector.IMAGE_REQUEST_CODE && resultCode == RESULT_OK && data != null) {
        List<String> pathList = data.getStringArrayListExtra(ImageSelectorActivity.EXTRA_RESULT);
        for (String path : pathList) {
            Log.i("ImagePath", path);
        }
    }
}

通过以上步骤，您可以成功下载并安装 Android-ImagesPickers 项目，并集成到您的 Android 应用中。