Skip to content

limao996/Kio

Repository files navigation

Kio

基于Kotlin的Android通用文件操作库

导入依赖

将其添加到根目录的 build.gradle.kts 文件中

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        mavenCentral()
        maven("https://jitpack.io")
    }
}

在项目 build.gradle.kts 添加依赖

dependencies {
    implementation("com.github.limao996:Kio:1.1.1")
}

使用方法/示例

Activity 中实例化 Kio 对象并注册 onActivityResult 回调

class MainActivity : AppCompatActivity() {
    private val kio = Kio(this)

    override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
        super.onActivityResult(requestCode, resultCode, data)
        kio.onActivityResult(requestCode, resultCode, data)
    }
}

调用 kio.open 打开 KFile 对象

// 返回 [KStorageFile] 对象
kio.open("/sdcard/test.txt")

// 返回 [KStorageFile] 对象
kio.open(File("/sdcard/test.txt"))

// 根据情况会返回 [KStorageFile] 或 [KDocumentFile]
kio.open("/sdcard/Android/data/bin.mt.plus/test.txt")

// 返回 [KUriFile] 对象
kio.open(intent.data!!)

处理文件操作所需权限

// 检查并申请权限,回调事件返回结果
file.checkAndRequestPermission { granted -> }

// 检查权限
file.checkPermission()

// 申请权限
file.requestPermission { granted -> }

// 释放权限,返回结果
// 目前仅 [KDocumentFile] 支持
file.releasePermission()

// [KUriFile] 不支持处理权限