Google ML Kit 条形码扫描与 IronBarcode：C# 条形码库对比

什么是 Google ML Kit 条形码扫描？

Google ML Kit 条形码扫描是一个原生移动库。 那不是一个可以绕过的限制； 这是产品的设计。 ML Kit 提供两种版本：

• Android：通过 Google Maven 分发，版本号为 com.google.mlkit:barcode-scanning (Kotlin/Java)。 需要目标设备上安装 Google Play 服务。处理由相机帧、文件 URI 或位图构造的 InputImage 对象。
• iOS：通过 CocoaPods 分发，版本号为 GoogleMLKit/BarcodeScanning，依赖于 Firebase。 使用 Swift 或 Objective-C。

没有 dotnet add package google-mlkit-barcode。 没有 using Google.MLKit.BarcodeScanning;。 Google 没有发布 ML Kit 的.NET绑定。

社区维护的 Xamarin 绑定在不同时期都存在，但它们有一个始终存在的问题：ML Kit 频繁更新其 Android 和 iOS SDK，而由个人或小型团队维护的绑定项目往往会在底层 API 发生变化时滞后或完全失效。 截至 2026 年，还没有积极维护的、可用于生产的.NET NuGet包封装 ML Kit 的条形码扫描器。

ML 套件的优势

了解 ML Kit 出现在条形码比较中的原因有助于理解相关背景信息。 在原生 Android 系统上：

-设备端推理：无需服务器往返。ML Kit 的模型使用 Google Play 服务在本地运行，这意味着扫描时延迟低且无需网络依赖。 -损伤容限： ML 模型比许多基于阈值的解码器更能处理损坏、部分遮挡或低分辨率的条形码。 对于面向消费者的、扫描现实世界条形码的应用程序来说，这是一个真正的差异化优势。

• Google Lens 集成： ML Kit 的扫描器与 Google Lens 条形码检测所使用的技术栈相同。 这是一个很强的质量信号。 -移动设备上的格式广度：原生支持 QR Code、EAN-13、EAN-8、Code 128、Code 39、Code 93、Codabar、ITF、PDF417、Data Matrix、Aztec 和 UPC-A/UPC-E。 -零配置：只需三行 Kotlin 代码片段即可生成一个可用的扫描器，无需调整阈值或选择解码器策略。

这些都是实实在在的优势。 对于.NET开发人员来说，问题不在于 ML Kit 不好，而在于他们不付出大量努力就无法使用 ML Kit。

.NET开发现状

当.NET开发人员需要扫描条形码时，ML Kit 的实际路径如下所示：

没有 async/await C# API。ML Kit 使用 Android 的 Task API，以及 addOnSuccessListener 和 addOnFailureListener 回调函数。 这些与 .NET 的 Task<t> 和 await 不对应。 任何绑定层都必须适应基于回调的 Android 异步和 .NET 的 TPL——这是一个不平凡的转换，社区绑定对此的处理并不一致。

没有 .NET 依赖注入集成。 BarcodeScanning.getClient(options) 是一个静态工厂调用，返回一个 Android BarcodeScanner 对象。 没有 .NET 接口可以注册，没有 IServiceCollection.AddBarcodeScanner()，也无法将其注入到 ASP.NET Core 中间件或Azure 功能中。

不支持ASP.NET Core或 Azure 函数。ML Kit 需要 Android 或 iOS 运行时环境。 它无法在 Linux 上的 Web API 进程、Azure 函数、Windows 服务器或 Docker 容器中运行。 如果您的用例是服务器端条形码处理（接受图像并返回条形码数据的 REST 端点、文档处理管道、批处理作业），则无论绑定是否可用，ML Kit 在架构上都是不兼容的。

仅支持摄像头或帧输入——不支持文件或 PDF。ML Kit 的 InputImage 可由 Bitmap、ByteBuffer 或 Android 文件系统上的文件 URI 构建。 没有处理 PDF 文档、迭代页面或处理多页 TIFF 的概念。 服务器端文档处理完全超出了该产品的范围。

依赖于 Google Play 服务。设备上的机器学习模型通过 Google Play 服务运行。 没有 Google Play 服务的设备（例如定制的 Android 系统、某些Enterprise设备、亚马逊 Fire 平板电脑）无法使用默认的 ML Kit 配置。 "捆绑"模型选项（com.google.mlkit:barcode-scanning-bundled）可以解决这个问题，但会显著增加 APK 的大小。

将 Android ML Kit 代码移植到.NET

如果您有一个带有 ML Kit 条形码扫描功能的现有 Android 应用，并且您正在将其移植到.NET MAUI或.NET 9，以下是翻译内容。 Kotlin 代码使用了 ML Kit 的回调模式； C# 代码使用了IronBarcode的同步 API。

// Android Kotlin: ML Kit
val options = BarcodeScannerOptions.Builder()
    .setBarcodeFormats(Barcode.FORMAT_QR_CODE, Barcode.FORMAT_CODE_128)
    .build()
val scanner = BarcodeScanning.getClient(options)
val inputImage = InputImage.fromFilePath(context, uri)
scanner.process(inputImage)
    .addOnSuccessListener { barcodes ->
        for (barcode in barcodes) {
            val rawValue = barcode.rawValue
            val format = barcode.format
        }
    }
    .addOnFailureListener { e -> Log.e("MLKit", e.message ?: "") }

// .NET C#: IronBarcode
// NuGet: dotnet add package IronBarcode
using IronBarCode;

var results = BarcodeReader.Read("captured-image.jpg");
foreach (var barcode in results)
{
    Console.WriteLine($"{barcode.Format}: {barcode.Value}");
}

// .NET C#: IronBarcode
// NuGet: dotnet add package IronBarcode
using IronBarCode;

var results = BarcodeReader.Read("captured-image.jpg");
foreach (var barcode in results)
{
    Console.WriteLine($"{barcode.Format}: {barcode.Value}");
}

Imports IronBarCode

Dim results = BarcodeReader.Read("captured-image.jpg")
For Each barcode In results
    Console.WriteLine($"{barcode.Format}: {barcode.Value}")
Next

结构上的差异不仅仅体现在句法上。 ML Kit 版本设置了一个扫描器对象，构造了一个 InputImage，调用了 scanner.process()，并注册了成功和失败回调。 如果您需要在继续之前获得结果，则必须将回调执行与其余逻辑协调起来——通常是通过 Java 中的 CountDownLatch 或 Kotlin 中的协程。

IronBarcode 的 BarcodeReader.Read() 同步返回结果集合。 你立即迭代它。 没有回调注册，没有线程同步，也不需要单独管理扫描器对象。

对于移植 Android 代码的团队来说，多条形码场景的模式转换如下所示：

// .NET C#:IronBarcode— reading multiple barcodes with options
using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    ExpectedBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128
};

var results = BarcodeReader.Read("image.jpg", options);
foreach (var barcode in results)
{
    Console.WriteLine($"Format: {barcode.Format}, Value: {barcode.Value}");
}

// .NET C#:IronBarcode— reading multiple barcodes with options
using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    ExpectedBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128
};

var results = BarcodeReader.Read("image.jpg", options);
foreach (var barcode in results)
{
    Console.WriteLine($"Format: {barcode.Format}, Value: {barcode.Value}");
}

Imports IronBarCode

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True,
    .ExpectedBarcodeTypes = BarcodeEncoding.QRCode Or BarcodeEncoding.Code128
}

Dim results = BarcodeReader.Read("image.jpg", options)
For Each barcode In results
    Console.WriteLine($"Format: {barcode.Format}, Value: {barcode.Value}")
Next

ExpectedBarcodeTypes 标志相当于 ML Kit 的 setBarcodeFormats()。 设置此设置可以缩小搜索范围并提高性能，但与 ML Kit 不同，不设置此设置不会中断读取IronBarcode将尝试所有支持的格式。

格式覆盖率比较

这两款工具都涵盖了主流的 2D 和 1D 格式。 重叠部分相当大。

IronBarcode支持 50 多种编码类型，涵盖读取和生成。 ML Kit 的格式列表固定为 Google 模型自带的格式列表——您无法添加自定义符号系统。

IronBarcode的优势

除了阅读之外， IronBarcode还涵盖了完整的条形码工作流程：

生成。ML Kit 完全没有生成 API——它读取条形码，但不创建条形码。 IronBarcode可将任何受支持的格式生成为 PNG、JPEG、SVG、HTML 或二进制数据。

// Generate a 代码 128 barcode to file
BarcodeWriter.CreateBarcode("SHIP-20240312-7834", BarcodeEncoding.Code128)
    .SaveAsPng("shipping-label.png");

// Generate a 代码 128 barcode to file
BarcodeWriter.CreateBarcode("SHIP-20240312-7834", BarcodeEncoding.Code128)
    .SaveAsPng("shipping-label.png");

' Generate a 代码 128 barcode to file
BarcodeWriter.CreateBarcode("SHIP-20240312-7834", BarcodeEncoding.Code128) _
    .SaveAsPng("shipping-label.png")

二维码定制。QRCodeWriter支持嵌入徽标、更改颜色和纠错级别——这些功能 ML Kit 不具备，因为 ML Kit 本身并不生成任何内容。

// QR code with embedded logo and custom color
QRCodeWriter.CreateQrCode("https://example.com/product/4821", 500)
    .AddBrandLogo("company-logo.png")
    .ChangeBarCodeColor(System.Drawing.Color.DarkBlue)
    .SaveAsPng("product-qr.png");

// QR code with embedded logo and custom color
QRCodeWriter.CreateQrCode("https://example.com/product/4821", 500)
    .AddBrandLogo("company-logo.png")
    .ChangeBarCodeColor(System.Drawing.Color.DarkBlue)
    .SaveAsPng("product-qr.png");

' QR code with embedded logo and custom color
QRCodeWriter.CreateQrCode("https://example.com/product/4821", 500) _
    .AddBrandLogo("company-logo.png") _
    .ChangeBarCodeColor(System.Drawing.Color.DarkBlue) _
    .SaveAsPng("product-qr.png")

PDF 处理。 BarcodeReader.Read("document.pdf") 可原生读取 PDF 每页的条形码。 无需图像提取步骤，无需使用单独的 PDF 库逐页循环——它直接处理 PDF。

// Read all barcodes from every page of a PDF
var results = BarcodeReader.Read("invoice-batch.pdf");
foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Value}");
}

// Read all barcodes from every page of a PDF
var results = BarcodeReader.Read("invoice-batch.pdf");
foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Value}");
}

Imports System

' Read all barcodes from every page of a PDF
Dim results = BarcodeReader.Read("invoice-batch.pdf")
For Each barcode In results
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Value}")
Next

IronBarcode支持服务器端和云端运行，可在Windows、Linux、macOS、Docker、Azure Functions和AWS Lambda上运行。 无需谷歌Play服务，没有摄像头，也没有移动运行时环境。

二进制输出。 .ToPngBinaryData() 直接返回 byte[] — 适用于以 HTTP 响应形式返回条形码图像而不写入磁盘的 API。

// Generate barcode and return as byte array (e.g., in a web API)
byte[] barcodeBytes = BarcodeWriter.CreateBarcode("ORDER-8821", BarcodeEncoding.QRCode)
    .ToPngBinaryData();

// Generate barcode and return as byte array (e.g., in a web API)
byte[] barcodeBytes = BarcodeWriter.CreateBarcode("ORDER-8821", BarcodeEncoding.QRCode)
    .ToPngBinaryData();

' Generate barcode and return as byte array (e.g., in a web API)
Dim barcodeBytes As Byte() = BarcodeWriter.CreateBarcode("ORDER-8821", BarcodeEncoding.QRCode) _
    .ToPngBinaryData()

功能对比

API概念图

由于没有官方的.NET ML Kit API，因此这种映射是概念性的——它显示了每个 ML Kit 操作的意图以及IronBarcode 的等效操作。

何时考虑使用IronBarcode

将 Android 应用移植到.NET MAUI或.NET 9。如果您的 Android 应用使用 ML Kit 进行条形码扫描，并且您正在构建一个.NET等效版本，那么IronBarcode就是自然之选。 概念转换很简单——读取文件，获取结果，迭代值。

服务器端条形码处理。任何涉及扫描条形码的 HTTP 端点、处理上传图像的后台作业或从 PDF 中提取条形码的文档工作流程的场景。 ML Kit 无法参与上述任何活动。

Windows桌面应用程序。Windows平台上的WinForms、WPF或.NET MAUI 。 ML Kit 完全无法在 Windows 系统上运行。

不支持 Google Play 服务的环境。如果您的 Android 部署包含不支持 Google Play 服务的设备（例如Enterprise硬件、自定义 AOSP 版本、Amazon Fire 设备），则标准 ML Kit 模型不可用。 IronBarcode没有这样的依赖项。

生成与读取并存。如果您需要同时生成和读取条形码（例如，打印货运标签和验证扫描结果）， IronBarcode可以在同一个库中处理这两项操作。 ML Kit 既不处理数据生成，也不处理服务器端读取。

无论是 Azure 还是 AWS 部署， Azure Functions、Linux 上的 Azure 应用服务、AWS Lambda 都无法托管 ML Kit。 IronBarcode的目标客户都是他们。

授权和定价

Google ML Kit 条形码扫描功能免费提供给 Android 和 iOS 应用使用。无需支付每次扫描费用，也无需商业许可。 这种定价模式在其预期的应用场景中是合理的——原生移动库与 Google Play 服务捆绑在一起。

IronBarcode是一个商业性的.NET库，采用永久授权：

-Lite： 749 美元 — 1 位开发者，1 个项目地点 -Plus： 1499 美元——最多可供 3 位开发者使用 Professional： 2,999 美元——最多 10 位开发人员 -无限： 5,999 美元 — 无限开发者

免费试用不限时长； 试验水印生成了条形码。 对于已经付费购买服务器基础设施来处理文档的团队来说，许可证成本通常只是维护非官方 ML Kit 绑定所需工程工作的一小部分。

结论

Google ML Kit 条形码扫描是一个精心设计的库，它能够完美地完成其设计目标：在 Android 和 iOS 设备上快速准确地扫描条形码。 与IronBarcode的比较与其说是比较哪个库更好，不如说是比较哪个库能够在你需要的场景下运行。

如果你正在用 Kotlin 为 Android 编写应用程序并使用摄像头进行扫描，那么 ML Kit 是一个绝佳的选择。但如果你正在用 C# 为.NET编写应用程序——无论是 Web API、文档处理服务、Windows 应用程序、云函数还是跨平台的 MAUI 应用——Google ML Kit 都无法满足你的需求。 没有NuGet包，没有 C# API，也没有 Google 支持的在托管代码中使用它的途径。 IronBarcode是一个原生的.NET库，涵盖了.NET支持的所有平台上的读取和生成功能。