【亲测免费】 Android 图片选择器库使用教程

1. 项目目录结构及介绍

在Android Image Picker项目中，主要的目录结构如下：

android-image-picker/
|-- app/            # 示例应用模块，包含了示例代码和资源
|   |-- src/         # 源码目录
|   |   |-- main/    # 主应用源码和资源
|   |   |   |-- java/       # Java源代码
|   |   |   |-- res/        # 资源文件
|   |-- build.gradle     # 应用构建脚本
|-- imagepicker/      # 图片选择器核心库模块
|   |-- src/           # 核心库源码和资源
|   |   |-- main/    # 主库源码和资源
|   |   |   |-- java/       # Java源代码
|   |   |   |-- res/        # 共享资源
|   |-- build.gradle     # 库构建脚本
|-- gradle/            # 第三方Gradle依赖
|-- .gitignore          # Git忽略文件列表
|-- README.md           # 项目README
|-- build.gradle        # 顶层构建脚本
|-- settings.gradle     # 项目设置

这个项目由两个主要部分组成：app模块是一个包含示例应用程序的模块，用于展示如何使用图片选择器库；imagepicker模块是实际的图片选择器库的核心代码。

2. 项目的启动文件介绍

在app/src/main/java/com/example/imagepicker下，你可以找到MainActivity.java，这是示例应用的入口点。在这个文件里，主要展示了如何初始化并调用图片选择器库：

public class MainActivity extends AppCompatActivity {

    private static final int RC_PICK_IMAGE = 1;
    private ImageView imageView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        imageView = findViewById(R.id.imageView);
        Button pickImageButton = findViewById(R.id.pick_image_button);
        pickImageButton.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                openImagePicker();
            }
        });
    }

    private void openImagePicker() {
        ImagePicker imagePicker = ImagePicker.create(this)
                .folderMode(false)             // 默认false
                .imageEngine(GlideEngine.createGlideEngine()) // 使用Glide加载图片
                .showCamera(true)              // 显示拍照选项，默认true
                .selectionMode(PickMode.SINGLE)  // 单选模式，默认
                .disableLog()                  // 关闭日志输出，默认关闭
                .start(RC_PICK_IMAGE);         // 请求码
    }

    @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        if (requestCode == RC_PICK_IMAGE && resultCode == RESULT_OK) {
            List<Image> images = data.getParcelableArrayListExtra(ImagePicker.EXTRA_RESULTS_IMAGES);
            if (!images.isEmpty()) {
                // 显示选定的图片
                Glide.with(this).load(images.get(0).getPath()).into(imageView);
            }
        }
    }
}

在这个启动文件中，点击按钮时调用openImagePicker()方法启动图片选择器，然后在onActivityResult中处理用户选择的结果。

3. 项目的配置文件介绍

build.gradle（顶级构建脚本）

顶级的build.gradle文件用于配置所有子项目的共性，比如定义全局的Gradle版本以及添加Maven仓库。

// Top-level build file where you can add configuration options common to all sub-projects/modules.

buildscript {
    repositories {
        google()
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:4.1.0'
    }
}

allprojects {
    repositories {
        google()
        jcenter()
        maven { url "https://jitpack.io" } // 添加JitPack仓库，因为ImagePicker库从这里获取
    }
}

build.gradle（应用模块或库模块）

每个模块的build.gradle文件负责该模块的具体构建配置，包括依赖库、编译选项等。例如，在app/build.gradle中的配置可能如下所示：

apply plugin: 'com.android.application'

android {
    compileSdkVersion 30
    buildToolsVersion "30.0.3"

    defaultConfig {
        applicationId "com.example.imagepicker"
        minSdkVersion 19
        targetSdkVersion 30
        versionCode 1
        versionName "1.0"
    }

    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    implementation 'androidx.appcompat:appcompat:1.3.1'
    implementation 'com.github.bumptech.glide:glide:4.11.0'
    annotationProcessor 'com.github.bumptech.glide:compiler:4.11.0'
    implementation 'com.github.esafirm.android-image-picker:imagepicker:2.1.0'  // 引入ImagePicker库
}

这里，除了添加了必要的Android支持库之外，还引入了imagepicker库的最新版本。

AndroidManifest.xml

虽然没有特别提到，但在app/src/main/AndroidManifest.xml中，你需要确保应用具有相机和外部存储的权限，因为图片选择器可能会涉及这些功能：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.imagepicker">

    <uses-permission android:name="android.permission.CAMERA"/>
    <uses-feature android:name="android.hardware.camera" android:required="false"/>
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

    <application>
        ...
    </application>

</manifest>

完成上述步骤后，你就可以在自己的项目中集成Android Image Picker库，提供给用户一个优雅的图片选择体验。记得调整minSdkVersion, targetSdkVersion以及其他相关配置以适应你的项目需求。