Plattform- und Wartungsprotokoll

Die Metadaten des NuGet Pakets MessagingToolkit.Barcode dokumentieren die vorgesehenen Zielplattformen. Jeder Eintrag in der folgenden Tabelle repräsentiert eine Plattform, die zum Zeitpunkt der Entwicklung der Bibliothek aktuell oder nahezu aktuell war:

Für die Bibliothek gibt es kein kompatibles Zielframework for .NET Core, .NET 5, .NET 6, .NET 7, .NET 8 oder .NET 9. Projekte, die auf diese Laufzeitumgebungen abzielen, werden einen Build-Fehler erfahren, wenn das Paket keinen kompatiblen Framework-Moniker auflösen kann – keine Laufzeitwarnung, sondern ein Kompilierungsfehler.

Detaillierter Funktionsvergleich

MessagingToolkit.Barcode-Ansatz

MessagingToolkit.Barcode ist ausschließlich für .NET Framework 3.5, 4.0 und 4.5 ausgelegt. Es hat keine .NET Standard -Bezeichnung, kein .NET Core-Ziel und keine Kompatibilitätsschicht für moderne Laufzeitumgebungen. Wenn eine Projektdatei auf dieses Paket verweist und eine beliebige moderne .NET Version als Ziel hat, schlägt der NuGet -Wiederherstellungsvorgang mit einem Framework-Kompatibilitätsfehler fehl – ​​der Build wird nicht fortgesetzt.

Die Plattformtabelle in den NuGet Metadaten macht dies konkret. Silverlight 3, 4 und 5 sind als Zielversionen aufgeführt; Alle drei Versionen werden seit 2021 nicht mehr unterstützt. Aufgeführt sind Windows Phone 7.0, 7.5, 7.8 und 8.0; Alle diese Versionen erreichten zwischen 2014 und 2017 das Ende ihres Supports. Die verbleibenden Zielversionen – .NET Framework 3.5, 4.0 und 4.5 – sind unter Windows technisch weiterhin funktionsfähig, erhalten aber von Microsoft nur noch Sicherheitsupdates und keine neuen Funktionen mehr.

Die praktische Konsequenz ist, dass MessagingToolkit.Barcode ein Framework-Upgrade blockiert. Eine Projektdatei, die net472 anvisiert und dieses Paket referenziert, kann nicht ohne vorherige Entfernung des Pakets in net8.0 geändert werden. Das Paket ist nicht nur veraltet - das Fehlen eines modernen Ziel-Framework-Kennzeichens verhindert die Ziel-Framework-Änderung, die dem Projekt den Zugriff auf moderne .NET-Fähigkeiten ermöglichen würde.

In der Dokumentation der IronBarcode Plattform finden Sie die vollständige Liste der unterstützten Frameworks und Bereitstellungsziele.

IronBarcode Ansatz

IronBarcode unterstützt .NET Framework 4.6.2 bis .NET 9 und deckt damit sowohl ältere Windows-Anwendungen als auch moderne plattformübergreifende Bereitstellungen ab. Ein einzelnes NuGet Paket lässt sich auf allen unterstützten Plattformen installieren, ohne dass separate Grafikbibliotheken oder plattformspezifische Konfigurationen erforderlich sind.

Der plattformübergreifende Support ist in der Praxis sinnvoll. Die interne Bildpipeline von IronBarcode ist nicht auf System.Drawing angewiesen, das in .NET 6 nur noch für Windows verfügbar ist. Anwendungen, die auf Linux oder macOS abzielen, einschließlich derjenigen, die in Docker-Containern, Azure App Service auf Linux oder AWS Lambda laufen, verwenden dieselbe IronBarcode-API und -Verhalten wie Windows-Deployments.

MessagingToolkit.Barcode-Ansatz

Das Lesen mit MessagingToolkit.Barcode erforderte die Erstellung einer BarcodeDecoder-Instanz, die Konstruktion einer Bitmap aus der Bilddatei, das Übergeben der Bitmap an .Decode() und das Überprüfen des Ergebnisses auf Null, bevor auf .Text zugegriffen wird. Die Generation folgte demselben Instanzmuster: Erstellen Sie eine BarcodeEncoder, legen Sie ihre .Format-Eigenschaft fest, rufen Sie .Encode() auf, um eine Bitmap zu erhalten, und rufen Sie dann .Save() auf dieser Bitmap auf.

// 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")

Die Bitmap-Abhängigkeit ist nicht zufällig. System.Drawing.Bitmap erfordert GDI+ auf Windows. In .NET 6 und später führt der Versuch, System.Drawing auf Linux oder macOS zu verwenden, zur Laufzeit zu einer PlatformNotSupportedException. Selbst wenn die MessagingToolkit.Barcode-Assembly in einem modernen .NET-Projekt geladen werden könnte – was aufgrund des fehlenden Framework-Ziels nicht möglich ist – würde die Bitmap Abhängigkeit eine plattformübergreifende Bereitstellung unabhängig davon verhindern.

IronBarcode Ansatz

IronBarcode verwendet durchgehend statische Methoden. BarcodeReader.Read() akzeptiert einen Dateipfad, einen Stream, ein Byte-Array oder einen PDF-Dateipfad — keine Bitmap erforderlich. Das Ergebnis ist eine Sammlung, nicht ein einzelnes, optionales Objekt. Die Generierung verwendet BarcodeWriter.CreateBarcode() mit dem als Parameter übergebenen Codierungstyp, und das Ergebnisobjekt bietet direkte Speichermethoden.

// 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")

Eine detaillierte Anleitung zum Lesen von Barcodes aus Bildern finden Sie unter Wie man Barcodes aus Bildern liest . Informationen zum Generieren von 1D-Barcodes, einschließlich der Formate Code 128, EAN-13 und UPC, finden Sie unter "Erstellen von 1D-Barcodes" .

MessagingToolkit.Barcode-Ansatz

MessagingToolkit.Barcode wurde seitApril 2013nicht mehr aktualisiert. Jede Anfälligkeit, die nach diesem Datum entdeckt wird — in der eigenen Bildparselogik der Bibliothek, in ihrer von ZXing abgeleiteten Dekodier-Implementierung oder in ihren transkonzeptuellen Abhängigkeiten — bleibt ungepatcht. Es gibt keinen öffentlichen Pfleger zu benachrichtigen, kein Sicherheitsberatungsprozess zu überwachen und keinen Veröffentlichungsmechanismus, durch den ein Fix Benutzer erreichen könnte, selbst wenn einer entwickelt würde.

Sicherheitsscanning-Tools — Snyk, WhiteSource, GitHub Dependabot, NuGet-Audit — kennzeichnen nicht gewartete Pakete in der Regel als erhöhtes Risiko. Die Kennzeichnung ist nicht von einer bestätigten CVE abhängig; Es spiegelt das Fehlen eines Prozesses wider, durch den bestätigte Schwachstellen behoben werden könnten. Das ist ein anderes Risikoprofil als eine Bibliothek mit einem aktiven Pfleger und einem dokumentierten Sicherheitsreaktionsprozess.

Für Teams, die unter Compliance-Rahmenwerken arbeiten – PCI DSS, HIPAA, SOC 2, ISO 27001 – hat dies praktische Konsequenzen für die Auditierung. Diese Frameworks erwarten ein aktives Patch-Management von Drittanbietersoftware, und ein ungewartetes Paket ohne Reaktionsmechanismus für Schwachstellen wird in der Regel während der Auditüberprüfung markiert, unabhängig davon, ob eine spezifische CVE dafür eingereicht wurde oder nicht. Der Befund bezieht sich auf die Wartungshaltung der Abhängigkeit und nicht auf das Vorhandensein einer bekannten Ausnutzung.

IronBarcode Ansatz

IronBarcode erhält regelmäßig NuGet Updates, die Sicherheitspatches, Abhängigkeitsaktualisierungen und neue Funktionen umfassen. Die Bibliothek wird von Iron Software entwickelt, die einen dokumentierten Supportprozess unterhält und für jedes Update Versionshinweise veröffentlicht. Sicherheitswarnungen werden, sofern zutreffend, in Patch-Releases berücksichtigt.

IronBarcode unterstützt über 50 Barcode-Formate, darunter alle Formate, die MessagingToolkit.Barcode verarbeitete – QR-Code, Code 128, EAN-13, EAN-8, UPC-A und andere – sowie Formate, die die ältere Bibliothek nie unterstützte: DataMatrix, Aztec, PDF417 und die gesamte Bandbreite moderner 2D-Symbologien.

Anforderungen an die Modernisierung des Frameworks

Der häufigste Auslöser ist ein geplantes oder laufendes .NET Upgrade. Wenn ein Team beschließt, ein Projekt von .NET Framework 4.x auf .NET 6 oder höher umzustellen, muss der Abhängigkeitsgraph auf Pakete überprüft werden, die keine Unterstützung für das moderne Framework bieten. MessagingToolkit.Barcode wird in diesem Audit als blockierende Abhängigkeit erscheinen – eine Abhängigkeit, die nicht mit einem modernen Zielframework-Moniker aufgelöst werden kann. Die Migration zu IronBarcode ist daher eine Voraussetzung für das umfassendere .NET Upgrade und keine separate Initiative. Teams, die eine Anwendungsmodernisierung durchführen, entdecken diese Abhängigkeit typischerweise früh in der Analysephase des Upgrades.

Sicherheits- und Compliance-Verpflichtungen

Ein zweites Szenario umfasst Sicherheitsüberprüfungen und Compliance-Audits. Teams, die nach den Standards von PCI DSS, HIPAA, SOC 2 oder ISO 27001 arbeiten, werden regelmäßigen Audits unterzogen, bei denen die Abhängigkeit von Drittanbietern überprüft wird. Ein ungewartetes Paket ohne Sicherheitsreaktionsmechanismus neigt dazu, als Auditbefund aus prozessualen Gründen aufzutauchen, unabhängig davon, ob eine spezifische Schwachstelle identifiziert wurde. Wenn ein Sicherheitsteam MessagingToolkit.Barcode als nicht konforme Abhängigkeit kennzeichnet, ist die Lösung der Ersatz — es gibt keinen Patch anzuwenden, keine Version zu aktualisieren und keinen Pfleger zu kontaktieren für eine Sicherheitsberatung. Die Migration zu IronBarcode beseitigt den Audit-Befund, indem eine Abhängigkeit ohne Wartungspfad durch eine ersetzt wird, die regelmäßige Sicherheitsupdates erhält.

Kapazitätserweiterung

Ein drittes Szenario entsteht, wenn neue Anforderungen über das hinausgehen, was MessagingToolkit.Barcode leisten kann. Anwendungen, die gescannte Dokumente oder PDF-Dateien verarbeiten, benötigen das Lesen von Barcodes aus diesen Formaten – MessagingToolkit.Barcode akzeptierte jedoch nur Bitmap-Eingaben, wodurch das Lesen von PDFs ohne eine separate Extraktionsschicht unmöglich war. Anwendungen, die Barcodes für die Webausgabe generieren, benötigen SVG- oder base64-Ausgaben — MessagingToolkit.Barcode gab ein Bitmap zurück, das zusätzliche Konvertierungsschritte und eine System.Drawing.Imaging Abhängigkeit erforderte. Wenn sich die Produktanforderungen auf diese Bereiche ausdehnen, werden die Einschränkungen der älteren Bibliothek zu technischen Beschränkungen, die sich nicht über ihre API-Oberfläche umgehen lassen.

Plattform-Zielwachstum

Ein viertes Szenario ist die Hinzufügung neuer Bereitstellungsziele. Teams, die ursprünglich Windows-only Anwendungen entwickelt haben und sich auf Linux-Hosting, macOS-Entwicklungsumgebungen, Docker-Container oder Cloud-Funktionen auf Linux-Laufzeiten ausdehnen, stoßen auf die System.Drawing Abhängigkeit als Blockade. MessagingToolkit.Barcode erfordert System.Drawing.Bitmap für alle Ein- und Ausgabeverfahren, und System.Drawing ist nur für Windows in .NET 6 und später verfügbar. Bei jedem anderen Zielsystem als Windows führt diese Abhängigkeit zu einem Laufzeitfehler und nicht nur zu einem Kompatibilitätsproblem. Der Umstieg auf IronBarcode beseitigt die System.Drawing Anforderung vollständig, wodurch die plattformübergreifende Bereitstellung möglich wird, die das Team zu erreichen versucht.

Namensraumersetzung

Jede Datei, die using MessagingToolkit.Barcode; enthält, erfordert ein Update auf using IronBarCode;. Eine Suche im gesamten Code nach der alten Namespace-Zeichenkette ist der zuverlässigste Ausgangspunkt, um den Umfang der Migration zu ermitteln. Dateien, die System.Drawing nur für den mit MessagingToolkit.Barcode verwendeten Bitmap-Typ importieren, können diesen Import vollständig entfernen, sobald IronBarcode vorhanden ist, da es nicht erforderlich ist.

Zielrahmenänderung

Durch das Entfernen von MessagingToolkit.Barcode aus der Projektdatei kann der Zielframework-Moniker aktualisiert werden. Die Änderung von <TargetFramework>net472</TargetFramework> zu <TargetFramework>net8.0</TargetFramework> wird möglich, sobald die blockierende Abhängigkeit entfernt ist. IronBarcode unterstützt beide Seiten dieser Umstellung – es ist kompatibel mit .NET Framework 4.6.2 und mit .NET 8 – sodass es vor dem endgültigen Abschluss des Framework-Upgrades installiert werden kann, wodurch die Migration gestaffelt und nicht in einem einzigen Schritt durchgeführt werden kann.

Namensraumunterschiede von BarcodeWriter

MessagingToolkit.Barcode verwendete BarcodeEncoder als Generationsklasse, wobei das Format als Eigenschaft (barcodeWriter.Format = BarcodeFormat.QrCode) festgelegt wurde, bevor .Encode() aufgerufen wurde. IronBarcode verwendet BarcodeWriter.CreateBarcode() als statische Methode, wobei der Codierungstyp als Parameter übergeben wird. Die Namen der Enums unterscheiden sich: BarcodeFormat.QrCode wird zu BarcodeEncoding.QRCode, und BarcodeFormat.Code128 wird zu BarcodeEncoding.Code128. Das Ergebnis von CreateBarcode() ist ein flüssiges Objekt mit .SaveAsPng(), .SaveAsJpeg(), .SaveAsSvg() und anderen Ausgabemethoden — es gibt keinen Bitmap zurück.