知乎开源的图片选择库，让图片选择更轻松

Android

2024-02-11 11:02:12

知乎图片选择库：Android 应用中的强大图片选择解决方案

简介

图片选择是 Android 应用中常见的任务。知乎最近开源了其图片选择库，为开发人员提供了一种简化和增强应用中图片选择体验的强大工具。

特性

知乎图片选择库提供了一系列特性，使其成为 Android 开发人员的理想选择：

直观的 API： 简化图片选择过程，使开发人员能够轻松集成到他们的应用中。
多种选择模式： 支持单选、多选和摄像头模式，以满足不同的应用需求。
最佳实践： 遵循 Android 最佳实践，确保与 Android 生态系统无缝集成。
运行时权限处理： 自动处理运行时权限，简化权限处理工作量。

集成指南

1. 添加依赖项

在应用的 build.gradle 文件中添加以下依赖项：

implementation 'com.zhihu.android:zhihu-image-selector:1.0.4'

2. 请求运行时权限

对于 Android 6.0 及更高版本，需要请求运行时权限：

if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
    ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, REQUEST_WRITE_EXTERNAL_STORAGE_PERMISSION);
}

3. 创建图片选择器

ImageSelector imageSelector = new ImageSelector(this, maxSelectable, maxImageCount);

maxSelectable：最大可选择图片数
maxImageCount：最大图片张数

4. 设置选择器属性

自定义选择器属性：

mimeTypes：允许选择的 MIME 类型列表
showCamera：是否显示摄像头按钮
aspectRatioX：纵横比 X
aspectRatioY：纵横比 Y

5. 启动选择器

imageSelector.show(new ImageSelectListener() {
    @Override
    public void onImagesSelected(List<Uri> images) {
        // 处理已选图片
    }

    @Override
    public void onError(Throwable error) {
        // 处理错误
    }
});

示例代码

ImageSelector imageSelector = new ImageSelector(this, true, 9);
imageSelector.show(new ImageSelectListener() {
    @Override
    public void onImagesSelected(List<Uri> images) {
        // 处理已选图片
    }

    @Override
    public void onError(Throwable error) {
        // 处理错误
    }
});

自定义 UI

imageSelector.setTheme(int themeResId); // 设置主题
imageSelector.setStatusBarColor(int color); // 设置状态栏颜色
imageSelector.setToolbarColor(int color); // 设置工具栏颜色
imageSelector.setToolbarTitle(String title); // 设置工具栏标题
imageSelector.setToolbarTitleColor(int color); // 设置工具栏标题颜色