[Android]史上最强的图片选择器-GalleryFinal

时间 2019-12-08

标签 android 史上最强图片选择器 galleryfinal 栏目 Android 繁體版

原文原文链接

首先很是感谢对GalleryFinal提出意见和想法的童鞋们，使得GalleryFinal通过重重迭代变得完善起来。css

简述

GalleryFinal是一个图片选择（单选/多选）、拍照、编辑、裁剪及旋转为一身的图片选择器。使用方便，功能可本身配置，GalleryFinal还能够根据开发者的喜爱来选择主题，固然也支持自定义主题。并且GalleryFinal自身并无强制绑定某个ImageLoader，开发者能够根据本身项目给GalleryFinal配置图片加载器。GalleryFinal还放弃了startActivityForResult+onActivityResult来获取选择结果，而是采用事件回调的机制。（我以为startActivityForResult+onActivityResult太麻烦了，赞成的点个赞吧，呵呵~）。GalleryFinal通过三四个月的版本迭代，修复bug,优化需求,已经处于稳定的状态。android

也许有人会问：系统不是有相册选择器吗，为何还有作一个GalleryFinal呢，有必要吗？我告诉你颇有必要。微信，QQ等等app它们都是本身带图片选择器，并无直接调系统的图片选择器。为何要这么作呢？我总结出一下几点：git

最大的问题就是兼容性了，手机厂商那么多，相册软件那么多从而引发各类奇葩的问题github
有些手机拍照图片倒立状况（如三星和魅族）缓存
拿到的bitmap或uri为空微信
很是频繁出现OOMapp
不支持多选框架
拍照/选择图片/裁剪视乎用起来有些麻烦，加上处理一些旋转、裁剪、压缩就更加麻烦了，代码多得不行不行的。eclipse
系统的图片选择UI上与本身APP样式不统一
有些不支持图片旋转
....

使用GalleryFinal以上问题你都不用考虑，就是这么的任性。?

虽然如今Github图片选择有不少，好比lovetuzitong的MultiImageSelector,habzy的GridImagePicker,还有就是YancyYe的ImageSelector（ImageSelector彷佛是在GalleryFinal 1.0版本基础上作的改版）可是GalleryFinal有本身独特的优点：

长期维护及时修复bug
虚心采纳好的意见和想法
功能强大/UI美观/可配置性强
……

如何使用

使用GalleryFinal只须要简单的几步：(这里只说AS使用方法，若是你还停留在eclipse时代请clone源码或下载最新的aar文件)

一、引入GalleryFinal

在build.gradle中添加如下语句：

compile 'cn.finalteam:galleryfinal:1.4.6'
compile 'com.android.support:support-v4:23.1.1'

二、配置通用功能/主题/ImageLoader

这里只作基础的讲解，须要更详细的文档可见github

在你的Application中添加配置GallerFinal

//配置主题
//ThemeConfig.CYAN
ThemeConfig theme = new ThemeConfig.Builder()
        ...
        .build();
//配置功能
FunctionConfig functionConfig = new FunctionConfig.Builder()
        .setEnableCamera(true)
        .setEnableEdit(true)
        .setEnableCrop(true)
        .setEnableRotate(true)
        .setCropSquare(true)
        .setEnablePreview(true)
        ...
        .build();

//配置imageloader
ImageLoader imageloader = new UILImageLoader();      
//设置核心配置信息 
CoreConfig coreConfig = new CoreConfig.Builder(context, imageloader, theme)
        .setDebug(BuildConfig.DEBUG)
        .setFunctionConfig(functionConfig)
        ...
        .build();
GalleryFinal.init(coreConfig);

GalleryFinal默认主题为DEFAULT（深蓝色）,还自带主题：DARK（黑色主题）、CYAN（蓝绿主题）、ORANGE（橙色主题）、GREEN（绿色主题）和TEAL（青绿色主题），固然也支持自定义主题（Custom Theme）,在自定义主题中用户能够配置字体颜色、图标颜色、更换图标、和背景色

主题配置类说明

setTitleBarTextColor//标题栏文本字体颜色
setTitleBarBgColor//标题栏背景颜色
setTitleBarIconColor//标题栏icon颜色，若是设置了标题栏icon，设置setTitleBarIconColor将无效
setCheckNornalColor//选择框未选颜色
setCheckSelectedColor//选择框选中颜色
setCropControlColor//设置裁剪控制点和裁剪框颜色
setFabNornalColor//设置Floating按钮Nornal状态颜色
setFabPressedColor//设置Floating按钮Pressed状态颜色

setIconBack//设置返回按钮icon
setIconCamera//设置相机icon
setIconCrop//设置裁剪icon
setIconRotate//设置选择icon
setIconClear//设置清楚选择按钮icon（标题栏清除选择按钮）
setIconFolderArrow//设置标题栏文件夹下拉arrow图标
setIconDelete//设置多选编辑页删除按钮icon
setIconCheck//设置checkbox和文件夹已选icon
setIconFab//设置Floating按钮icon
setEditPhotoBgTexture//设置图片编辑页面图片margin外背景
setIconPreview设置预览按钮icon
setPreviewBg设置预览页背景

功能配置类说明

setMutiSelect(boolean)//配置是否多选
setMutiSelectMaxSize(int maxSize)//配置多选数量
setEnableEdit(boolean)//开启编辑功能
setEnableCrop(boolean)//开启裁剪功能
setEnableRotate(boolean)//开启选择功能
setEnableCamera(boolean)//开启相机功能
setCropWidth(int width)//裁剪宽度
setCropHeight(int height)//裁剪高度
setCropSquare(boolean)//裁剪正方形
setSelected(List)//添加已选列表,只是在列表中默认呗选中不会过滤图片
setFilter(List list)//添加图片过滤，也就是不在GalleryFinal中显示
takePhotoFolter(File file)//配置拍照保存目录，不作配置的话默认是/sdcard/DCIM/GalleryFinal/
setRotateReplaceSource(boolean)//配置选择图片时是否替换原始图片，默认不替换
setCropReplaceSource(boolean)//配置裁剪图片时是否替换原始图片，默认不替换
setForceCrop(boolean)//启动强制裁剪功能,一进入编辑页面就开启图片裁剪，不须要用户手动点击裁剪，此功能只针对单选操做
setForceCropEdit(boolean)//在开启强制裁剪功能时是否能够对图片进行编辑（也就是是否显示旋转图标和拍照图标）
setEnablePreview(boolean)//是否开启预览功能

图片加载器

开发者能够根据app现使用的ImageLoader来实现GalleryFinal ImageLoader，我的相对比较看好Glide，固然Fresco很是棒,不过它很是大。Picasso和UIL是老牌的ImageLoader也能够。至于Xutil3如今还不稳定，有些问题待修复。若是你有其余的ImageLoader也能够参考demo自行实现，若是有不明白之处加Q群(218801658)提问。

eg.

Glide

public class GlideImageLoader implements cn.finalteam.galleryfinal.ImageLoader {

    @Override
    public void displayImage(Activity activity, String path, final GFImageView imageView, Drawable defaultDrawable, int width, int height) {
        Glide.with(activity)
                .load("file://" + path)
                .placeholder(defaultDrawable)
                .error(defaultDrawable)
                .override(width, height)
                .diskCacheStrategy(DiskCacheStrategy.NONE) //不缓存到SD卡
                .skipMemoryCache(true)
                //.centerCrop()
                .into(new ImageViewTarget<GlideDrawable>(imageView) {
                    @Override
                    protected void setResource(GlideDrawable resource) {
                        imageView.setImageDrawable(resource);
                    }

                    @Override
                    public void setRequest(Request request) {
                        imageView.setTag(R.id.adapter_item_tag_key,request);
                    }

                    @Override
                    public Request getRequest() {
                        return (Request) imageView.getTag(R.id.adapter_item_tag_key);
                    }
                });
    }

    @Override
    public void clearMemoryCache() {
    }
}

三、启动GalleryFinal

单选打开相册

GalleryFinal.openGallerySingle(REQUEST_CODE_GALLERY, mOnHanlderResultCallback);
//带配置
GalleryFinal.openGallerySingle(REQUEST_CODE_GALLERY, functionConfig, mOnHanlderResultCallback);

多选打开相册

GalleryFinal.openGalleryMuti(REQUEST_CODE_GALLERY, mOnHanlderResultCallback);
//带配置
FunctionConfig config = new FunctionConfig.Builder(MainActivity.this)
    .setMutiSelectMaxSize(8)
    .build();
GalleryFinal.openGalleryMuti(REQUEST_CODE_GALLERY, functionConfig, mOnHanlderResultCallback);

拍照

GalleryFinal.openCamera(REQUEST_CODE_CAMERA, mOnHanlderResultCallback);
//带配置
GalleryFinal.openCamera(REQUEST_CODE_CAMERA, functionConfig, mOnHanlderResultCallback);

裁剪

GalleryFinal.openCrop(REQUEST_CODE_CAMERA, mOnHanlderResultCallback);
//带配置
GalleryFinal.openCrop(REQUEST_CODE_CAMERA, functionConfig, mOnHanlderResultCallback);

图片编辑

GalleryFinal.openEdit(REQUEST_CODE_CAMERA, mOnHanlderResultCallback);
//带配置
GalleryFinal.openEdit(REQUEST_CODE_CAMERA, functionConfig, mOnHanlderResultCallback);

技术原理

获取图片

经过内容提供者（Content Provider）获取到全部的图片信息，而后根据文件夹名称分类

图片加载

GalleryFinal经过ImageLoader接口对图片进行加载，图片质量，清晰度开发者自行决择。demo提供了UIL/Glide/Picsso/Fresco/xUtils3等框架的默认GalleryFinal ImageLoader实现

public interface ImageLoader{
    void displayImage(Activity activity, String path, GFImageView imageView, Drawable defaultDrawable, int width, int height);
    void clearMemoryCache();
}

其余

图片裁剪采用android-crop
图片缩放采用PhotoView