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

本教程将指导您了解并使用 yanzhenjie/Album 这个 Android 图片选择库。

1. 项目目录结构及介绍

在开始之前，先让我们一起看看 Album 项目的目录结构：

Album/
├── app/           // 示例应用代码
│   ├── src/       // 源码
│   ├── res/       // 资源文件
│   └── ...
├── library/       // 图片选择库的核心代码
│   ├── src/       // 主要Java代码
│   ├── res/       // 库的资源
│   └── ...
├── build.gradle   // 根级别的构建脚本
└── README.md      // 项目简介

• app: 项目提供的示例应用程序，展示了如何集成和使用 Library。
• library: 图片选择库的核心组件，包含了所有实现图片选择功能的类和资源文件。

2. 项目的启动文件介绍

MainActivity.java

在 app/src/main/java/com/yanzhenjie/gallery/MainActivity.java 文件中，可以看到如何初始化和启动图片选择器的示例代码。主要涉及以下关键步骤：

public class MainActivity extends AppCompatActivity {

    private static final int REQUEST_CODE = 100;

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

        // 初始化选择器实例
        Album.create(this, REQUEST_CODE)
                .theme(R.style.AppTheme_Album)          // 设置主题
                .columnCount(3)                       // 设置每行显示的列数
                .imageEngine(new GlideEngine())      // 配置图片加载引擎（如Glide或Picasso）
                .show();
    }

    @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        if (requestCode == REQUEST_CODE && resultCode == RESULT_OK) {
            List<Photo> photos = data.getParcelableArrayListExtra(Album.INTENT_EXTRA_PHOTOS);
            // 处理选中的照片，例如添加到相册列表
        }
    }
}

• Album.create(): 创建图片选择器实例。
• theme(): 自定义应用内选择器的主题样式。
• columnCount(): 设置图片预览界面的列数。
• imageEngine(): 指定用于加载图片的引擎。
• onActivityResult(): 接收从选择器返回的结果，获取选定的照片列表。

3. 项目的配置文件介绍

build.gradle

在项目的根目录下的 build.gradle 文件中，您需要将 Album 作为依赖库引入项目：

allprojects {
    repositories {
        google()
        jcenter()
        maven { url 'https://jitpack.io' } // 添加 JitPack 仓库，因为该库可能托管在这里
    }
}

dependencies {
    implementation 'com.github.yanzhenjie:Album:版本号' // 替换为最新版本号
}

AndroidManifest.xml

在您的主 AndroidManifest.xml 中，确保添加了读写外部存储权限，因为图片选择通常涉及到这些操作：

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

styles.xml

在 app/src/main/res/values/styles.xml 中，可以自定义选择器的主题风格，这在 MainActivity 中通过 .theme() 方法调用：

<style name="AppTheme.Album" parent="Theme.AppCompat.Light.NoActionBar">
    <!-- Customize your theme here. -->
</style>

到这里，您已经对 yanzhenjie/Album 项目有了基本的理解，现在您可以根据上述指南在自己的应用中集成和定制这个图片选择库了。如有任何疑问，可查阅项目文档或在 GitHub 上查看更详细的信息。祝您开发愉快！