Kotlin QR码生成器：ZXing库与实现技巧

使用ZXing在Kotlin中生成QR码

QR码（快速响应码）已成为现代数字世界不可或缺的一部分。它们用于快速分享链接、联系信息、Wi-Fi密码及其他数据。无论您是在开发Kotlin应用——无论是Android、后端（Ktor、Spring）还是桌面端（Compose Desktop）——都可能需要集成QR码生成功能。本文将介绍如何使用流行的ZXing（Zebra Crossing）库在Kotlin中创建简单高效的QR码生成器。

为什么选择ZXing？

ZXing是一个功能丰富的条码和QR码读写库。它基于Java编写，因此与Kotlin完美兼容。主要优势包括：

• 支持多种格式：QR码、Data Matrix、Aztec、PDF417等。
• 高性能且高度可定制。
• 活跃的社区和定期更新。
• 易于集成到Kotlin项目中。

添加依赖

首先，在您的build.gradle.kts中添加依赖（如果使用Gradle）：

dependencies {    implementation("com.google.zxing:core:3.5.3")    implementation("com.google.zxing:javase:3.5.3") // 用于BufferedImage操作}

如果您在Ktor或Spring上编写后端应用，这些依赖同样适用。对于Android，可以使用android-core模块，但大多数情况下core已足够。

基础QR码生成器

创建一个QRCodeGenerator类，接收文本并返回BufferedImage格式的QR码图像。

import com.google.zxing.BarcodeFormatimport com.google.zxing.EncodeHintTypeimport com.google.zxing.qrcode.QRCodeWriterimport com.google.zxing.common.BitMatriximport java.awt.image.BufferedImageimport java.util.*

class QRCodeGenerator {

    fun generateQRCode(text: String, width: Int = 300, height: Int = 300): BufferedImage {        // 配置编码和纠错级别        val hints = EnumMap<EncodeHintType, Any>(EncodeHintType::class.java).apply {            put(EncodeHintType.CHARACTER_SET, "UTF-8")            put(EncodeHintType.ERROR_CORRECTION, com.google.zxing.qrcode.decoder.ErrorCorrectionLevel.H) // 高纠错            put(EncodeHintType.MARGIN, 1) // QR码边距        }

        val writer = QRCodeWriter()        val bitMatrix: BitMatrix = writer.encode(text, BarcodeFormat.QR_CODE, width, height, hints)

        // 将BitMatrix转换为BufferedImage        val image = BufferedImage(width, height, BufferedImage.TYPE_INT_RGB)        for (x in 0 until width) {            for (y in 0 until height) {                image.setRGB(x, y, if (bitMatrix.get(x, y)) 0xFF000000.toInt() else 0xFFFFFFFF.toInt())            }        }        return image    }}

说明：

• QRCodeWriter — ZXing中负责创建点阵的类。
• BitMatrix — 二进制矩阵，其中true表示黑色像素。
• 我们设置了UTF-8编码和最高纠错级别（H — 可容忍30%损坏）。
• 图像以ARGB格式保存，采用黑白配色方案。

保存为文件（PNG）

要将生成的QR码保存到文件，请使用javax.imageio.ImageIO：

import java.io.Fileimport javax.imageio.ImageIO

fun saveQRCodeToFile(text: String, filePath: String) {    val generator = QRCodeGenerator()    val image = generator.generateQRCode(text)    val outputFile = File(filePath)    ImageIO.write(image, "png", outputFile)    println("QR码已保存：${outputFile.ab