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
以及其他相关配置以适应你的项目需求。