플랫폼 및 유지보수 기록

MessagingToolkit.Barcode의 NuGet 패키지 메타데이터는 해당 패키지의 대상 사용자를 설명합니다. 다음 표의 각 항목은 라이브러리 개발 당시 최신 또는 최신에 가까운 플랫폼을 나타냅니다.

이 라이브러리는 .NET Core, .NET 5, .NET 6, .NET 7, .NET 8 또는 .NET 9와 호환되는 대상 프레임워크를 지원하지 않습니다. 이러한 런타임을 대상으로 하는 프로젝트는 패키지가 호환되는 프레임워크 이름을 확인할 수 없을 때 빌드 시 오류가 발생합니다. 이는 런타임 경고가 아니라 컴파일 오류입니다.

상세 기능 비교

메시징툴킷.바코드 접근법

MessagingToolkit.Barcode는 .NET Framework 3.5, 4.0 및 4.5만 대상으로 합니다. 이 애플리케이션은 .NET Standard 명칭도 없고, .NET Core대상으로 하지도 않으며, 최신 런타임과의 호환성을 위한 별도의 도구도 없습니다. 프로젝트 파일에서 이 패키지를 참조하고 최신 .NET 버전을 대상으로 하는 경우 NuGet 복원 작업이 프레임워크 호환성 오류와 함께 실패하고 빌드가 진행되지 않습니다.

NuGet 메타데이터의 플랫폼 테이블이 이를 구체화합니다. Silverlight 3, 4, 5가 목표물로 지정되어 있습니다. 이 세 가지 버전 모두 2021년 이후 단종되었습니다. 윈도우 폰 7.0, 7.5, 7.8, 8.0이 목록에 있습니다. 모든 버전은 2014년에서 2017년 사이에 지원이 종료되었습니다. 나머지 대상인 .NET Framework 3.5, 4.0 및 4.5는 기술적으로 Windows에서 계속 작동하지만 Microsoft에서 보안 패치만 제공하며 새로운 기능 개발은 더 이상 이루어지지 않습니다.

현실적인 결과는 MessagingToolkit.Barcode가 프레임워크 업그레이드를 차단한다는 것입니다. net472을 대상으로 하고 이 패키지를 참조하는 프로젝트 파일은 먼저 패키지를 제거하지 않고는 net8.0로 변경할 수 없습니다. 이 패키지는 단순히 구형이 아닙니다 — 현대적인 .NET 기능에 접근할 수 있도록 프로젝트를 허용할 타겟 프레임워크 변경을 방해하는 현대적인 타겟 프레임워크 이름이 없기 때문입니다.

지원되는 프레임워크 및 배포 대상의 전체 목록은 IronBarcode 플랫폼 문서를 참조하십시오.

IronBarcode 접근법

IronBarcode .NET Framework 4.6.2부터 .NET 9까지 지원하며, 기존 Windows 애플리케이션과 최신 크로스 플랫폼 배포를 모두 지원합니다. 별도의 그래픽 라이브러리나 플랫폼별 구성 없이 단일 NuGet 패키지로 지원되는 모든 플랫폼에 설치할 수 있습니다.

크로스 플랫폼 지원이 실제로 의미가 있습니다. IronBarcode의 내부 이미지 파이프라인은 .NET 6에서 Windows 전용이 된 System.Drawing에 의존하지 않으며 Linux 또는 macOS( Docker 컨테이너, Azure Linux의 앱 서비스 또는 AWS Lambda 포함)를 대상으로 하는 응용 프로그램이 Windows 배포와 같은IronBarcode API 및 동작을 사용합니다.

메시징툴킷.바코드 접근법

MessagingToolkit.Barcode로 읽으려면 BarcodeDecoder 인스턴스를 생성하고, 이미지 파일에서 Bitmap를 구성해 비트맵을 .Decode()에 전달한 후 .Text에 액세스하기 전에 결과가 null인지 확인해야 했습니다. 생성은 동일한 인스턴스 패턴을 따랐습니다: BarcodeEncoder를 생성하여 .Format 프로퍼티를 설정하고 .Encode()를 호출하여 Bitmap를 받고, 그 비트맵에 .Save()를 호출합니다.

// MessagingToolkit.Barcode — .NET Framework target frameworks
using MessagingToolkit.Barcode;
using System.Drawing;

// Reading
var barcodeReader = new BarcodeDecoder();
var bitmap = new Bitmap("barcode.png");
var result = barcodeReader.Decode(bitmap);
string value = result?.Text;
string format = result?.BarcodeFormat.ToString();

// Writing
var barcodeWriter = new BarcodeEncoder();
barcodeWriter.Format = BarcodeFormat.QrCode;
var outputBitmap = barcodeWriter.Encode("Hello World");
outputBitmap.Save("output.png");

// MessagingToolkit.Barcode — .NET Framework target frameworks
using MessagingToolkit.Barcode;
using System.Drawing;

// Reading
var barcodeReader = new BarcodeDecoder();
var bitmap = new Bitmap("barcode.png");
var result = barcodeReader.Decode(bitmap);
string value = result?.Text;
string format = result?.BarcodeFormat.ToString();

// Writing
var barcodeWriter = new BarcodeEncoder();
barcodeWriter.Format = BarcodeFormat.QrCode;
var outputBitmap = barcodeWriter.Encode("Hello World");
outputBitmap.Save("output.png");

Imports MessagingToolkit.Barcode
Imports System.Drawing

' Reading
Dim barcodeReader As New BarcodeDecoder()
Dim bitmap As New Bitmap("barcode.png")
Dim result = barcodeReader.Decode(bitmap)
Dim value As String = result?.Text
Dim format As String = result?.BarcodeFormat.ToString()

' Writing
Dim barcodeWriter As New BarcodeEncoder()
barcodeWriter.Format = BarcodeFormat.QrCode
Dim outputBitmap = barcodeWriter.Encode("Hello World")
outputBitmap.Save("output.png")

Bitmap 의존성은 우연이 아닙니다. System.Drawing.Bitmap은 Windows에서 GDI+이 필요합니다. .NET 6 이후 버전에서 Linux 또는 macOS에서 System.Drawing을 사용하려고 시도하면 런타임에 PlatformNotSupportedException 예외가 발생합니다. 설령 최신 .NET 프로젝트에서 MessagingToolkit.Barcode 어셈블리가 로드된다고 해도(결측 프레임워크 타겟으로 인해 불가능함) Bitmap 의존성 때문에 크로스 플랫폼 배포가 불가능합니다.

IronBarcode 접근법

IronBarcode 전체적으로 정적 메서드를 사용합니다. BarcodeReader.Read()은 파일 경로, Stream, 바이트 배열 또는 PDF 파일 경로를 수용합니다 — Bitmap 불필요. 결과는 null 값을 허용하는 단일 객체가 아니라 컬렉션입니다. 생성은 인코딩 유형을 매개변수로 전달하여 BarcodeWriter.CreateBarcode()을 사용하며, 결과 객체는 직접적으로 저장 메소드를 노출합니다.

//IronBarcode— .NET Framework 4.6.2 through .NET 9
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// Reading
var results = BarcodeReader.Read("barcode.png");
string value = results.FirstOrDefault()?.Value;
string format = results.FirstOrDefault()?.Format.ToString();

// Writing
BarcodeWriter.CreateBarcode("Hello World", BarcodeEncoding.QRCode)
    .SaveAsPng("output.png");

//IronBarcode— .NET Framework 4.6.2 through .NET 9
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// Reading
var results = BarcodeReader.Read("barcode.png");
string value = results.FirstOrDefault()?.Value;
string format = results.FirstOrDefault()?.Format.ToString();

// Writing
BarcodeWriter.CreateBarcode("Hello World", BarcodeEncoding.QRCode)
    .SaveAsPng("output.png");

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

' Reading
Dim results = BarcodeReader.Read("barcode.png")
Dim value As String = results.FirstOrDefault()?.Value
Dim format As String = results.FirstOrDefault()?.Format.ToString()

' Writing
BarcodeWriter.CreateBarcode("Hello World", BarcodeEncoding.QRCode) _
    .SaveAsPng("output.png")

이미지에서 바코드를 읽는 방법에 대한 자세한 지침은 이미지에서 바코드를 읽는 방법을 참조하세요. Code 128, EAN-13, UPC 형식을 포함한 1D 바코드를 생성하는 방법에 대해서는 1D 바코드 생성 방법을 참조하십시오.

메시징툴킷.바코드 접근법

MessagingToolkit.Barcode는 2013년 4월 이후로 업데이트를 받지 않았습니다. 그 날짜 이후에 발견된 어떤 취약점 - 라이브러리 자체의 이미지 파싱 로직, ZXing에 유래한 디코드 구현, 전이 종속성 - 도 패치되지 않은 상태로 남습니다. 알릴 공용 유지 보수자가 없고, 모니터링할 보안 자문 프로세스가 없으며, 개발되더라도 사용자가 수정 사항을 받을 수 있는 릴리스 메커니즘이 없습니다.

보안 스캐닝 도구 — Snyk, WhiteSource, GitHub Dependabot, NuGet 감사 — 는 일반적으로 유지 관리되지 않은 패키지를 위험도가 높다고 표시합니다. 해당 플래그 지정은 CVE가 확정되었는지 여부와 관계가 없습니다. 이는 확인된 취약점을 해결할 수 있는 절차가 전혀 없음을 반영합니다. 이는 활발한 유지보수자와 문서화된 보안 대응 프로세스를 가진 라이브러리와는 다른 위험 프로파일입니다.

PCI DSS, HIPAA, SOC 2, ISO 27001과 같은 규정 준수 체계 하에서 운영되는 팀의 경우 이는 실질적인 감사 결과에 영향을 미칩니다. 이 프레임워크들은 제3자 소프트웨어의 패치 관리를 기대하며, 보안 취약점에 대한 대응 메커니즘이 없는 유지 관리되지 않은 패키지는 감사 검토 중에 특정 CVE가 제출되었는지 여부에 관계없이 일반적으로 플래그가 지정됩니다. 발견 사항은 알려진 취약점의 존재보다는 종속물의 유지 관리 태도에 관한 것입니다.

IronBarcode 접근법

IronBarcode 보안 패치, 종속성 업데이트 및 새로운 기능을 포함하는 정기적인 NuGet 업데이트를 받습니다. 이 라이브러리는 Iron Software 에서 개발했으며, Iron Software는 문서화된 지원 프로세스를 유지하고 각 업데이트에 대한 릴리스 노트를 게시합니다. 보안 권고 사항은 해당되는 경우 패치 릴리스에서 해결됩니다.

IronBarcode MessagingToolkit.Barcode에서 지원했던 모든 형식(QR 코드, Code 128, EAN-13, EAN-8, UPC-A 등)을 포함하여 50개 이상의 바코드 형식을 지원합니다. 또한 이전 라이브러리에서 지원하지 않았던 형식(DataMatrix, Aztec, PDF417, 다양한 최신 2D 심볼)도 지원합니다.

프레임워크 현대화 요구사항

가장 흔한 원인은 계획되었거나 진행 중인 .NET 업그레이드입니다. 팀에서 프로젝트를 .NET Framework 4.x에서 .NET 6 이상으로 마이그레이션하기로 결정하면 최신 프레임워크를 지원하지 않는 패키지가 있는지 종속성 그래프를 검토해야 합니다. MessagingToolkit.Barcode는 최신 대상 프레임워크 명칭에 대해 해결할 수 없는 차단 종속성으로 해당 감사 보고서에 표시됩니다. 따라서IronBarcode로의 마이그레이션은 별도의 작업이 아니라 더 광범위한 .NET 업그레이드를 위한 필수 조건입니다. 애플리케이션 현대화를 진행하는 팀은 일반적으로 업그레이드 분석 단계 초기에 이러한 종속성을 발견합니다.

보안 및 규정 준수 의무

두 번째 시나리오는 보안 검토 및 규정 준수 감사와 관련이 있습니다. PCI DSS, HIPAA, SOC 2 또는 ISO 27001 프레임워크에 따라 운영되는 팀은 제3자 의존성 상태를 검사하는 정기적인 감사를 받습니다. 보안 대응 메커니즘이 없는 유지 관리되지 않은 패키지는 특정 취약점이 확인되었는지 여부에 관계없이 프로세스상의 이유로 감사 발견물로 나타나는 경향이 있습니다. 보안 팀이 MessagingToolkit.Barcode를 비준수 종속성으로 플래그 지정할 때, 해결 방법은 교체입니다 — 사용할 수 있는 패치가 없고, 업그레이드할 버전이 없으며, 보안 경고를 위한 연락처가 없습니다. IronBarcode로의 마이그레이션은 유지 관리 경로가 없는 종속성을 제거하고 정기적인 보안 업데이트를 받는 종속성으로 교체하여 감사 결과를 해결합니다.

역량 확장

세 번째 시나리오는 새로운 요구 사항이 MessagingToolkit.Barcode가 제공할 수 있는 범위를 넘어설 때 발생합니다. 스캔한 문서나 PDF 파일을 처리하는 애플리케이션은 해당 형식에서 바코드를 읽어야 합니다. MessagingToolkit.Barcode는 비트맵 입력만 허용했기 때문에 별도의 추출 레이어 없이는 PDF를 읽을 수 없었습니다. 웹 배포를 위한 바코드를 생성하는 애플리케이션은 SVG 또는 base64 출력을 필요로 합니다 — MessagingToolkit.Barcode는 Bitmap을 반환하여 추가 변환 단계와 System.Drawing.Imaging 의존성을 요구합니다. 제품 요구 사항이 이러한 영역으로 확장되면 기존 라이브러리의 한계는 API 표면 내에서 해결할 수 없는 엔지니어링 제약 조건이 됩니다.

플랫폼 목표 성장률

네 번째 시나리오는 새로운 배포 대상을 추가하는 것입니다. 처음에 Windows 전용 애플리케이션을 구축하고 Linux 호스팅, macOS 개발 환경, Docker 컨테이너 또는 Linux 런타임에서의 클라우드 함수로 확장하는 팀은 System.Drawing 의존성을 차단 문제로 만납니다. MessagingToolkit.Barcode는 모든 입력 및 출력 작업에 대해 System.Drawing.Bitmap를 필요로 하며 System.Drawing은 .NET 6 이후 버전에서 Windows 전용입니다. Windows 이외의 배포 대상을 사용하는 경우, 이 종속성은 단순한 호환성 문제가 아니라 런타임 오류로 이어집니다. IronBarcode로의 마이그레이션은 System.Drawing 요구 조건을 완전히 제거하여 팀이 달성하려는 크로스 플랫폼 배포가 가능하게 만듭니다.

네임스페이스 교체

using MessagingToolkit.Barcode;이 포함된 모든 파일은 using IronBarCode;로 업데이트해야 합니다. 이전 네임스페이스 문자열을 코드베이스 전체에서 검색하는 것이 마이그레이션 범위를 파악하는 가장 확실한 시작점입니다. MessagingToolkit.Barcode와 함께 사용하는 Bitmap 유형을 위해 System.Drawing을 단독으로 가져오는 파일은 IronBarcode가 적용되면 해당 가져오기를 완전히 제거할 수 있습니다, IronBarcode는 이를 필요로 하지 않기 때문입니다.

목표 프레임워크 변경

프로젝트 파일에서 MessagingToolkit.Barcode를 제거하면 대상 프레임워크의 모니커를 업데이트할 수 있습니다. 차단 의존성이 제거되면 <TargetFramework>net472</TargetFramework>에서 <TargetFramework>net8.0</TargetFramework>으로 변경할 수 있게 됩니다.IronBarcode이러한 변경 사항의 양면을 모두 지원합니다. .NET Framework 4.6.2 및 .NET 8과 호환되므로 프레임워크 업그레이드가 완료되기 전에 설치할 수 있어 마이그레이션을 한 번에 수행하는 대신 단계적으로 진행할 수 있습니다.

BarcodeWriter 네임스페이스 차이점

MessagingToolkit.Barcode는 생성 클래스으로써 BarcodeEncoder를 사용했으며, 호출 전 속성으로 barcodeWriter.Format = BarcodeFormat.QrCode을 설정했습니다. IronBarcode는 정적 메서드로 BarcodeWriter.CreateBarcode()을 사용하며, 인코딩 유형은 매개변수로 전달됩니다. 열거형 이름이 다릅니다: BarcodeFormat.QrCode이 BarcodeEncoding.QRCode로, BarcodeFormat.Code128이 BarcodeEncoding.Code128로 변경됩니다. CreateBarcode()의 결과는 .SaveAsPng(), .SaveAsJpeg(), .SaveAsSvg() 및 다른 출력 메소드를 가진 유창한 객체이며 — Bitmap을 반환하지 않습니다.