?? 導(dǎo)入

確保項(xiàng)目的 build.gradle 或 build.gradle.kts 已配置 Maven Central 倉(cāng)庫(kù)：

repositories {
    mavenCentral()
}

在模塊的構(gòu)建文件中添加依賴(lài)：

Kotlin DSL (build.gradle.kts):

dependencies {
    implementation("top.zibin:luban:2.0.0")
}

Groovy (build.gradle):

dependencies {
    implementation 'top.zibin:luban:2.0.0'
}

注意：請(qǐng)?jiān)L問(wèn) Maven Central 查看最新版本號(hào)。

?? 使用

? Kotlin (Coroutines)

在 Kotlin 中，推薦使用 suspend 函數(shù)進(jìn)行調(diào)用，代碼更簡(jiǎn)潔。

壓縮單張圖片

lifecycleScope.launch {
    val inputUri: Uri = ... // 圖片 Uri
    val outputDir = context.cacheDir
    
    Luban.compress(context, inputUri, outputDir)
        .onSuccess { file ->
            // 壓縮成功，file 為壓縮后的圖片文件
            Log.d("Luban", "Compressed: ${file.absolutePath}")
        }
        .onFailure { error ->
            // 處理錯(cuò)誤
            Log.e("Luban", "Error: ${error.message}")
        }
}

壓縮單張圖片文件

lifecycleScope.launch {
    val inputFile: File = ... 
    val outputDir = context.cacheDir
    
    Luban.compress(inputFile, outputDir)
        .onSuccess { file ->
            Log.d("Luban", "Compressed: ${file.absolutePath}")
        }
        .onFailure { error ->
            Log.e("Luban", "Error: ${error.message}")
        }
}

壓縮到指定文件路徑

lifecycleScope.launch {
    val inputFile: File = ...
    val outputFile = File(context.cacheDir, "custom_output.jpg")
    
    Luban.compressToFile(inputFile, outputFile)
        .onSuccess { file ->
            Log.d("Luban", "Compressed to: ${file.absolutePath}")
        }
        .onFailure { error ->
            Log.e("Luban", "Error: ${error.message}")
        }
}

并發(fā)壓縮多張圖片

lifecycleScope.launch {
    val uris: List<Uri> = ... 
    val outputDir = context.cacheDir

    val results = Luban.compress(context, uris, outputDir)
    
    results.forEach { result ->
        result.onSuccess { file -> 
            Log.d("Luban", "Compressed: ${file.absolutePath}")
        }
        .onFailure { error ->
            Log.e("Luban", "Error: ${error.message}")
        }
    }
}

并發(fā)壓縮多個(gè)文件

lifecycleScope.launch {
    val files: List<File> = ...
    val outputDir = context.cacheDir

    val results = Luban.compress(files, outputDir)
    
    results.forEach { result ->
        result.onSuccess { file -> 
            Log.d("Luban", "Compressed: ${file.absolutePath}")
        }
        .onFailure { error ->
            Log.e("Luban", "Error: ${error.message}")
        }
    }
}

在其他協(xié)程作用域中使用

如果不在 Activity/Fragment 中使用，可以使用 CoroutineScope：

val scope = CoroutineScope(Dispatchers.Main + SupervisorJob())

scope.launch {
    val inputUri: Uri = ...
    val outputDir = context.cacheDir
    
    Luban.compress(context, inputUri, outputDir)
        .onSuccess { file ->
            // 處理成功
        }
        .onFailure { error ->
            // 處理錯(cuò)誤
        }
}

? Java / Builder 模式

對(duì)于 Java 項(xiàng)目或偏好回調(diào)風(fēng)格的開(kāi)發(fā)者，可以使用兼容舊版風(fēng)格的 Luban.with() API。

壓縮單張圖片

Luban.with(context)
    .load(imageFile) // 支持 File, Uri, 或 String 路徑
    .setTargetDir(context.getCacheDir())
    .bindLifecycle(lifecycleOwner) // 可選：頁(yè)面銷(xiāo)毀時(shí)自動(dòng)取消
    .setCompressListener(new OnCompressListener() {
        @Override
        public void onStart() {
            // 開(kāi)始?jí)嚎s
        }

        @Override
        public void onSuccess(File file) {
            // 壓縮成功
        }

        @Override
        public void onError(Throwable e) {
            // 發(fā)生錯(cuò)誤
        }
    })
    .launch();

壓縮多張圖片

List<String> imagePaths = ...; // 圖片路徑列表

Luban.with(context)
    .load(imagePaths) // 加載圖片列表
    .setTargetDir(context.getCacheDir())
    .setCompressListener(new OnCompressListener() {
        @Override
        public void onStart() {
            // 開(kāi)始?jí)嚎s
        }

        @Override
        public void onSuccess(File file) {
            // 每張圖片壓縮成功后都會(huì)回調(diào)一次
            Log.d("Luban", "Compressed: " + file.getAbsolutePath());
        }

        @Override
        public void onError(Throwable e) {
            // 發(fā)生錯(cuò)誤
        }
    })
    .launch();

彩蛋

Flutter 版 Luban 2 即將上線(xiàn)，Android、iOS都能使用，敬請(qǐng)期待~