GalleryLoader

相册加载器、gallery、图片选择

1.java版本基于RxJava 实现的相册加载器，能更好更快的加载本地大量相册图片并展示
2.kotlin 版本基于协程
3.内部提供相册展示页，也可以直接使用加载器回调数据供上层使用

集成步骤

Step1:

项目根目录build文件中配置jitpack maven

 repositories {
        maven { url 'https://jitpack.io' }
    }

Step2: app目录build文件中配置引用

   implementation 'com.github.ljlstudio:GalleryLoader:1.0.4'//1.0.4以下为java 版本
   implementation 'com.github.ljlstudio:GalleryLoader:1.0.5' ..tag为最新release 版本（1.0.5以后都为kotlin版本）//kotlin 版本

代码中使用

使用loader 有两种方式:

1.使用自带相册样式：

样式1：全屏模式

     
        GalleryEngine.from(this@MainActivity)
                .setGalleryBuilder(this@MainActivity)
                .widthListPictureMargin(5)
                .widthListPictureColumnSpace(5)
                .widthListPictureRowSpace(5)
                .widthListPictureCorner(5)
                .withShouldLoadPaging(false)
                .widthPageSize(10)
                .widthListPicturePlaceholder(R.color.design_snackbar_background_color)
                .widthOnGalleryListener(object : OnGalleryListener {
                    override fun clickGallery(path: String?, position: Int) {
                        Toast.makeText(
                            this@MainActivity,
                            "------->PATH=$path------->position=$position",
                            Toast.LENGTH_SHORT
                        ).show()
                    }

                    override fun bottomSheetState(isOpen: Boolean, fromUser: Boolean) {
                        Toast.makeText(this@MainActivity, "抽屉状态$isOpen", Toast.LENGTH_SHORT).show()
                    }

                    override fun clickBadPicture(path: String?, position: Int) {
                        Toast.makeText(
                            this@MainActivity,
                            "------->点击了 损坏图片 PATH=$path------->position=$position",
                            Toast.LENGTH_SHORT
                        ).show()
                    }
                })
                .startGallery()

样式2：BottomSheet 抽屉模式


    //布局中配置BottomSheetLayout 
    <com.lee.album.activity.BottomSheetLayout
        android:id="@+id/bottom_sheet"
        android:layout_alignParentBottom="true"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"/>


       //初始化BottomSheetLayout 数据

        GalleryEngine.from(this@BottomSheetActivity)
            .setGalleryBuilder(this@BottomSheetActivity)
            .widthListPictureMargin(5)
            .widthListPictureColumnSpace(5)
            .widthListPictureRowSpace(5)
            .widthListPictureCorner(5)
            .withShouldLoadPaging(false)
            .widthPageSize(10)
            .widthShouldClickCloseBottomSheet(false)
            .withCanTouchDrag(false)
            .widthListPicturePlaceholder(R.color.design_snackbar_background_color)
            .widthOnGalleryListener(object : OnGalleryListener {
                override fun clickGallery(path: String?, position: Int) {
                    Log.d(TAG, "------->PATH=$path------->position=$position")
                }

                override fun bottomSheetState(isOpen: Boolean, fromUser: Boolean) {
                    Log.d(TAG, "抽屉状态$isOpen")
                }

                override fun clickBadPicture(path: String?, position: Int) {
                    Log.d(TAG, "------->点击了 损坏图片 PATH=$path------->position=$position")
                }
            })
        binding.bottomSheet.initData(this)

对应参数介绍：

字段	含义
listPictureMargin	设置图片距离屏幕两边距离
listPictureColumnSpace	列表图片列间距（图片之间）
listPictureRowSpace	列表图片行间距（图片之间）
listPictureCorner	设置图片圆角
shouldLoadPaging	是否分页
pageSize	分页加载一次每次返回条数建议10-30之间
listPicturePlaceholder	占位图或者颜色
onGalleryListener	相册点击回调
shouldClickCloseBottomSheet	是否点击图片关闭bottomSheet
canTouchDrag	是否可以拖拽上滑

2.使用数据加载器回调数据源：

1.初始化加载器，设置 builder
  loader = AlbumLoader()

        loader?.setAlbumLoaderBuilder(
            AlbumLoaderBuilder()
            .setCallBack(this)
            .setPageSize(10)
            .setShowLastModified(true)
            .setShouldLoadPaging(false)
        )
                
                
                
                

 /**
     * 加载相册数据
     */
    private fun loadData() {
        if (PermissionUtils.permissionsChecking(this, PermissionUtils.CLEAN_STORAGE_PERMISSIONS)) {
            loader!!.loadClassyData(this)
            loader!!.loadAllListData(this)
        } else {
            AndPermission.with(this)
                .runtime()
                .permission(*PermissionUtils.CLEAN_STORAGE_PERMISSIONS)
                .onGranted {
                    loader!!.loadClassyData(this)
                    loader!!.loadAllListData(this)
                }
                .onDenied { }
                .start()
        }
    }
                
//监听数据回调

   override fun loadClassyDataSuccess(list: List<AlbumData?>?) {
        // TODO:  //相册分类数据回调
    }

    override fun loadListDataSuccess(
        pageData: List<GalleryInfoEntity?>?,
        currentAllData: List<GalleryInfoEntity?>?
    ) {
        // TODO:  相册列表数据回调
    }

    override fun clearData() {
        // TODO: 切换分类数据
    }
    
    
    //生命周期管理
    
    
   override fun onDestroy() {
        super.onDestroy()
        loader?.destroyLoader()
    }

    override fun onResume() {
        super.onResume()
        loader?.resumeLoader()
    }

    override fun onStop() {
        super.onStop()
        loader?.pauseLoader()
    }

ljlstudio/GalleryLoader

GalleryLoader

集成步骤

代码中使用