QFsolution - 适用于AndroidQ的文件操作解决方案

1. 适用于AndroidQ的简易图片选择器。
2. 基于协程的系统文件选择，系统拍照，系统裁剪。
3. Uri转为File的究极解决方案。

开始使用

添加依赖

allprojects {
    repositories {
        maven { url "https://jitpack.io" }
    }
}

dependencies {
	implementation 'com.github.iDeMonnnnnn:QFsolution:$latest_version'
}

添加权限

    <!--如果你使用相机相关功能必须要添加，否则可忽略-->
    <uses-permission android:name="android.permission.CAMERA" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

效果动图

下载Demo.apk体验

使用方法

图片选择器

1.在启动图片选择器之前，你需要初始化图片加载器,你可以参考示例代码的GlideLoader
，实现IQFImgLoader接口，此举是为了解决不同项目的使用不同图片加载库的问题和减少库体积。

QFImgLoader.getInstance().init(GlideLoader()) //初始化图片加载器

2.配置参数，启动图片选择库。

QFHelper.getInstance()
                .isNeedGif(false) //是需要gif，默认false
                .isNeedCamera(true)  //是否需要拍照选项，默认true
                .setSpanCount(3) //每行显示多少张图片，默认&建议：3, 可根据手机分辨率实际情况大小进行调整
                .setLoadNum(30) //设置分页加载每次加载多少张图片，默认&建议：30，可根据手机分辨率实际情况大小进行调整，注意：该值最少应该保证首次加载充满全屏，否则无法加载更多
                .setMaxNum(9) //设置可选择最多maxNum张图片，默认&最小值：1
                .start(this, 0x001) //第一个参数：activity或者fragment，第二个参数requestCode

3.获取选取图片后的结果

 override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
        super.onActivityResult(requestCode, resultCode, data)
        if (resultCode == RESULT_OK) {
            when (requestCode) {
                0x001 -> {
                    val uris = QFHelper.getInstance().getResult(data) //获取选择结果，ArrayList<Uri>
                    uris?.run {
                        uri = this[0]
                        img.setImageURI(uri)
                    }
                }
            }
        }
    }

文件操作

本库的文件操作包括系统文件选择，系统拍照，系统裁剪三种。都是基于携程+GhostFragment的方式，因此需要在协程中使用，操作完成后可直接获取到返回值。

返回值根据泛型类型返回对应类型的结果：Uri：文件的Uri对线，File：文件对象，String：文件的绝对路径。

更多使用细节，可见源码注释，写的很详细。

1.系统文件选择

GlobalScope.launchUI {
uri = openFile<String>()?.run {  File(this).toUri() }
img.setImageURI(uri)
}

2.系统拍照

GlobalScope.launchUI {
     uri = gotoCamera(fileName = "DeMon-${System.currentTimeMillis()}.jpg")
     img.setImageURI(uri)
}

3.系统裁剪

GlobalScope.launchUI {
    uri?.run {
              uri = startCrop(this, 300, 600)
              img.setImageURI(uri)
  }
}

Uri转File

如何获取content://URI格式的Uri文件获取对应的File对象，一直是日常开发中的痛点，网上各种解决方案都不尽人意，本库旨在适配各种可能存在的情况，如果还是获取不到会将该Uri写入沙盒环境，
再获取对应的File对象，这样基本能100%保证获取到Uri的File对象。

AndroidQ开始无法访问非作用域存储内的文件（沙盒环境），只能通过Uri去访问文件，因此访问外部存储文件只能，按照如上方法通过将Uri写入沙盒环境成新文件，再获取File。

使用本库的uriToFile扩展方法即可，如下：

  val file: File? = uri.uriToFile(this@MainActivity)

更多使用详情，请见Demo示例及源码

其他

如果你有问题或者建议，请Issues或者Email.

致谢

Android 10适配要点，作用域存储

boxing

MIT License

Copyright (c) 2020 DeMon

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

项目地址:https://github.com/iDeMonnnnnn/QFsolution