[OpenSource] Android 图片、视频选择库 PVSelector

Android 图片、视频选择库 PVSelector

写在开始

去年在编写公司项目的时候，牵涉到图片选择的部分，UX“借鉴”了微信的相关UI，因为工期原因，没有时间雕琢一个比较精致的选择库，所幸的是刚好在github发现了一个类似的开源项目：PictureSelector，当时这个项目也是才提交未久，匆匆改掉了一些bug，当做module就直接使用了。到今年年初的时候，抽空将之进行了剥离，创建了开源项目PVSelector,故名思义就是：Picture&Video selector。并计划对项目进行优化。

无意冒犯PictureSelector的作者，但当时clone的代码确实可读性太糟糕，在修改bug时造成了很多麻烦。近期抽空对项目进行了优化，从命名、逻辑拆分、精简入手进行了风格和规范调整。并且添加了链式调用的API层，避免了使用Config模式的麻烦。

近期又关注了一下PictureSelector项目，半年来也做了很多更新。但在此也鞭策自己一下。

Feature 概览

图片

• 单图、多图选择模式
• 即时拍照
• 图片裁剪 使用开源项目UCrop
• 图片压缩 可使用：
  
  • 系统bitmap的API进行压缩
  • 开源项目LuBan进行压缩
• 图片预览，依赖[PhotoView]版本较旧

视频

• 单个、多个视频选择模式
• 预览

风格配置

QQ风格 or WeChat 风格
文字、配色的配置

集成

当前最新版本：
扩展的UCrop module：2.4.0
PVSelectorlib：1.1.0

编译包托管于JFog-JCenter

使用gradle引入依赖：

如果无法拉取到文件，显式的配置下仓库地址

allprojects {
    repositories {
        mavenCentral()
        jcenter {
            url "http://jcenter.bintray.com/"
        }
    }
}

添加依赖，注意需要添加Glide

dependencies {
       //...
    compile 'individual.leobert.libs:pvselectorlib:1.1.0'
    compile 'individual.leobert.libs:ucrop:2.4.0'
    compile 'com.github.bumptech.glide:glide:3.7.0'
}

使用

permission

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

manifest文件添加FileProvider配置 (适配Android 7.0 私有文件夹)

 <provider
            android:name="android.support.v4.content.FileProvider"
            android:authorities="${applicationId}.provider"
            android:exported="false"
            android:grantUriPermissions="true">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/file_paths" />
        </provider>

配置式使用参考sample
关键在于配置FunctionConfig。
启动：

PictureConfig.init(config);
                    PictureConfig.getPictureConfig().openPhoto(mContext, resultCallback);

链式调用：

//video
 PVSelector.getVideoSelector(this)
     .multiSelect(4)
     .enableCamera()
     .enablePreview()              
     .setCompleteTxtColor(ContextCompat.getColor(this,
        R.color.colorPrimary))
     .launch(resultCallback);

//picture
 PVSelector.getPhotoSelector(this)
                .singleSelect()
                .enableCamera()
                .enableCrop(FunctionConfig.CROP_MODE_16_9)
                .useSystemCompress(true,true)
                .setSelectedMedia(selectMedia) //已经选择的内容
                .launch(resultCallback);

关于UI的配置,API 如下：

public interface ICustomStyle<T> {

    /**
     * @param spanCount 单行数量上限
     */
    T setImageSpanCount(int spanCount);

    /**
     * @param mainColor 主色 Context.getColor(resId)
     */
    T setThemeColor(@ColorInt int mainColor);

    /**
     * 设置选择图片页面底部背景色
     *
     * @param color
     */
    T setBottomBarBgColor(@ColorInt int color);


    /**
     * "预览"文字颜色
     *
     * @param color
     */
    T setPreviewTxtColor(@ColorInt int color);

    /**
     * “已完成”文字颜色
     *
     * @param color
     */
    T setCompleteTxtColor(@ColorInt int color);

    /**
     * 设置完成选取的文字
     * @param completeText
     */
    T setCompleteText(CharSequence completeText);

    /**
     * 启用计数checkbox
     */
    T enableDisplayCandidateNo();

    T setCheckedBoxDrawable(@DrawableRes int drawableResId);

}

预览已经选择的图片，库中提供了简单实现：

 PictureConfig.getPictureConfig()
                        .externalPicturePreview(mContext, position, selectMedia);

写在最后

截至1.1.0版本，代码中依旧存在着太多值得修改的内容，接下来还是先将这些代码进行修改（我是一个有代码洁癖[pi发第三声]的人），并对部分依赖库进行升级。然后再添加Friendly Functions以及扩展功能，如果支持Audio就要改名PVASelector啦。

项目遵守MIT，托管于github，再次给出传送门：click me，希望喜欢的朋友点个star支持下。