Generator kodów kreskowych Xamarin: Generuj kody kreskowe w C# używając IronBarcode

Dłączego potrzebujesz profesjonalnej biblioteki BarCode dla Xamarin Forms?

Wdrożenie generowania BarCode od podstaw w Xamarin.Forms wymaga obsługi złożonych algorytmów kodowania, zarządzania różnicami w renderowaniu specyficznymi dla platformy oraz zapewnienia dokładnego wyniku dla różnych symboli BarCode. Profesjonalna biblioteka kodów kreskowych .NET, taka jak IronBarcode, eliminuje te wyzwania, zapewniając ujednolicony interfejs API, który wewnętrznie obsługuje wszystkie techniczne złożoności za pomocą prostych metod C#.

IronBarcode obsługuje ponad 30 formatów kodów kreskowych, w tym kody QR, Kod 128, Code 39, EAN-13, UPC-A, Data Matrix, PDF 417 i kody Aztec. Każdy format jest zoptymalizowany pod kątem konkretnych zastosowań. Na przykład kody QR doskonale nadają się do przechowywania adresów URL i dużych zbiorów danych tekstowych, EAN-13 służy do oznaczania produktów detalicznych, a Kod 128 zapewnia kodowanie alfanumeryczne o dużej gęstości. Biblioteka automatycznie oblicza sumy kontrolne, stosuje odpowiednie poziomy korekcji błędów i zapewnia zgodność ze standardami GS1 dla zastosowań komercyjnych.

Wielopłatformowy charakter IronBarcode gwarantuje, że kod generujący kody kreskowe pozostaje identyczny niezależnie od tego, czy tworzysz aplikację na Androida, czy na iOS. Ta spójność wykracza poza aplikacje Xamarin — ten sam kod działa w aplikacjach internetowych ASP.NET, oprogramowaniu desktopowym i kontenerach Docker, co czyni go idealnym rozwiązaniem dla Enterprise o zróżnicowanych wymaganiach wdrożeniowych. Dowiedz się więcej o możliwościach wielopłatformowych IronBarcode.

Jak zainstalować IronBarcode w projekcie Xamarin?

Instalacja IronBarcode w projekcie Xamarin.Forms zajmuje zaledwie kilka minut za pomocą menedżera pakietów NuGet. Otwórz rozwiązanie Visual Studio zawierające projekty mobilne na wiele platform i wykonaj poniższe czynności.

Kliknij prawym przyciskiem myszy na swoje rozwiązanie w Eksploratorze rozwiązań i wybierz "Zarządzaj pakietami NuGet dla rozwiązania". W zakładce Przeglądaj wyszukaj "IronBarcode". Wybierz oficjalny pakiet IronBarcode firmy Iron Software i zainstaluj go we wszystkich projektach w swoim rozwiązaniu, w tym w projekcie współdzielonym oraz w obu projektach specyficznych dla danej platformy. Możesz zapoznać się ze szczegółowymi informacjami o pakiecie NuGet, aby sprawdzić historię wersji i zależności.

Alternatywnie można użyć konsoli menedżera pakietów, wprowadzając następujące polecenie:

Install-Package BarCode

Install-Package BarCode

W przypadku projektów na Androida do podstawowego tworzenia BARCODE nie są wymagańe żadne dodatkowe uprawnienia. Jeśli jednak planujesz zapisywać wygenerowane BARCODES na nośniku zewnętrznym, dodaj uprawnienie WRITE_EXTERNAL_STORAGE do swojego AndroidManifest.xml. Zapoznaj się z przewodnikiem konfiguracji dla systemu Android, aby uzyskać szczegółowe informacje dotyczące platformy.

W przypadku projektów na iOS, jeśli zapisujesz kody QR lub BARCODE-y w bibliotece zdjęć, dodaj klucz NSPhotoLibraryAddUsageDescription do swojego Info.plist wraz z odpowiednim opisem dla użytkownika. Dokumentacja dotycząca konfiguracji BarCode w systemie iOS zawiera kompletne instrukcje.

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

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

Imports IronBarCode

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

Jak wygenerować swój pierwszy BarCode za pomocą IronBarcode?

Utworzenie pierwszego BARCODE-a za pomocą IronBarcode w aplikacji Xamarin.Forms wymaga minimalnej ilości kodu C#. Poniższy przykład generuje BARCODE Kod 128, zapisuje go jako plik PNG i dodaje etykietę tekstową czytelną dla człowieka:

using IronBarCode;
using System.IO;

string filePath = Path.Combine(
    Environment.GetFolderPath(Environment.SpecialFolder.Personal),
    "barcode.png");

var myBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com", BarcodeEncoding.Code128);
myBarcode.ResizeTo(500, 200);
myBarcode.AddBarcodeValueTextBelowBarcode();
myBarcode.SaveAsPng(filePath);

using IronBarCode;
using System.IO;

string filePath = Path.Combine(
    Environment.GetFolderPath(Environment.SpecialFolder.Personal),
    "barcode.png");

var myBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com", BarcodeEncoding.Code128);
myBarcode.ResizeTo(500, 200);
myBarcode.AddBarcodeValueTextBelowBarcode();
myBarcode.SaveAsPng(filePath);

Imports IronBarCode
Imports System.IO

Dim filePath As String = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.Personal), "barcode.png")

Dim myBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com", BarcodeEncoding.Code128)
myBarcode.ResizeTo(500, 200)
myBarcode.AddBarcodeValueTextBelowBarcode()
myBarcode.SaveAsPng(filePath)

Metoda BarcodeWriter.CreateBarcode() jest głównym punktem wejścia do generowania BARCODE-ów. Przyjmuje dwa argumenty: dane do zakodowania oraz format BARCODE z wyliczenia BarcodeEncoding. Metoda zwraca obiekt GeneratedBarcode, który zapewnia szerokie możliwości dostosowywania za pomocą płynnego interfejsu API.

Metoda ResizeTo() dostosowuje wymiary BARCODE, zachowując odpowiednie proporcje i wymagania dotyczące szerokości kresek dla wybranej symboliki. AddBarcodeValueTextBelowBarcode() dodaje tekst czytelny dla człowieka poniżej pasków, co jest wymagańe w wielu scenariuszach związanych ze sprzedażą detaliczną i zarządzaniem zapasami. Zapoznaj się z pełną dokumentacją API BarcodeWriter, aby poznać zaawansowane funkcje.

using IronBarCode;

var qrCode = QRCodeWriter.CreateQrCode("SKU-12345|Batch-789|Exp-2025", 500);
qrCode.ChangeBarCodeColor(IronSoftware.Drawing.Color.DarkBlue);

byte[] barcodeBytes = qrCode.ToPngBinaryData();

using IronBarCode;

var qrCode = QRCodeWriter.CreateQrCode("SKU-12345|Batch-789|Exp-2025", 500);
qrCode.ChangeBarCodeColor(IronSoftware.Drawing.Color.DarkBlue);

byte[] barcodeBytes = qrCode.ToPngBinaryData();

Imports IronBarCode
Imports IronSoftware.Drawing

Dim qrCode = QRCodeWriter.CreateQrCode("SKU-12345|Batch-789|Exp-2025", 500)
qrCode.ChangeBarCodeColor(Color.DarkBlue)

Dim barcodeBytes As Byte() = qrCode.ToPngBinaryData()

Jak pracować z różnymi formatami BarCode?

Szeroka obsługa formatów przez IronBarcode pozwala wygenerować dokładnie taki typ kodu kreskowego, jakiego wymaga Twoja aplikacja Xamarin.Forms. Poniższy przykład pokazuje, jak utworzyć BARCODE-y EAN-13, UPC-A, DataMatrix i PDF417 na podstawie pojedynczego ciągu znaków kodu produktu:

using IronBarCode;

string productCode = "012345678905";

// EAN-13 for European retail
var ean13 = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.EAN13);
ean13.SaveAsPng("product_ean13.png");

// UPC-A for North American retail
var upcA = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.UPCA);
upcA.SaveAsJpeg("product_upca.jpg");

// DataMatrix for small items with high data density
var dataMatrix = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.DataMatrix);
dataMatrix.SaveAsPdf("product_datamatrix.pdf");

// PDF417 for driver licenses and ID cards
var pdf417 = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.PDF417);
pdf417.SaveAsTiff("product_pdf417.tiff");

using IronBarCode;

string productCode = "012345678905";

// EAN-13 for European retail
var ean13 = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.EAN13);
ean13.SaveAsPng("product_ean13.png");

// UPC-A for North American retail
var upcA = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.UPCA);
upcA.SaveAsJpeg("product_upca.jpg");

// DataMatrix for small items with high data density
var dataMatrix = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.DataMatrix);
dataMatrix.SaveAsPdf("product_datamatrix.pdf");

// PDF417 for driver licenses and ID cards
var pdf417 = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.PDF417);
pdf417.SaveAsTiff("product_pdf417.tiff");

Imports IronBarCode

Dim productCode As String = "012345678905"

' EAN-13 for European retail
Dim ean13 = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.EAN13)
ean13.SaveAsPng("product_ean13.png")

' UPC-A for North American retail
Dim upcA = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.UPCA)
upcA.SaveAsJpeg("product_upca.jpg")

' DataMatrix for small items with high data density
Dim dataMatrix = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.DataMatrix)
dataMatrix.SaveAsPdf("product_datamatrix.pdf")

' PDF417 for driver licenses and ID cards
Dim pdf417 = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.PDF417)
pdf417.SaveAsTiff("product_pdf417.tiff")

Każda symbolika BarCode ma specyficzne cechy i zastosowania. Kody EAN-13 i UPC-A wymagają wprowadzania wyłącznie cyfr i automatycznie obliczają cyfry kontrolne w celu zapewnienia dokładności skanowania w handlu detalicznym. DataMatrix doskonale sprawdza się w kodowaniu dużych ilości danych na minimalnej przestrzeni, co czyni go idealnym rozwiązaniem do śledzenia komponentów elektronicznych i farmaceutyków. PDF417 obsługuje przechowywanie dużych ilości danych z wbudowaną korekcją błędów, co jest powszechnie stosowane w transporcie i dokumentach identyfikacyjnych.

Biblioteka automatycznie sprawdza dane wejściowe pod kątem zgodności z wymaganiami formatowymi i generuje opisowe wyjątki w przypadku nieprawidłowych danych wejściowych. Ta walidacja gwarantuje, że wygenerowane kody kreskowe są zgodne z międzynarodowymi normami ISO i można je niezawodnie skanować za pomocą komercyjnych czytników BarCode używanych w handlu detalicznym i logistyce. Dowiedz się więcej o wyborze odpowiedniego formatu BARCODE do konkretnego zastosowania.

Jak dostosować i wyeksportować BarCodes do interfejsów użytkownika urządzeń mobilnych?

IronBarcode oferuje szerokie możliwości dostosowania do wymagań wizualnych aplikacji Xamarin. Poniższy przykład pokazuje, jak zastosować kolory, dodać adnotacje tekstowe i zapisać pliki w lokalizacjach specyficznych dla danej platformy:

using IronBarCode;
using System.IO;
using Xamarin.Forms;

var barcode = BarcodeWriter.CreateBarcode("CUSTOM-2024", BarcodeEncoding.Code128);

// Apply styling to match your mobile UI
barcode.ChangeBarCodeColor(IronSoftware.Drawing.Color.Navy);
barcode.ChangeBackgroundColor(IronSoftware.Drawing.Color.LightGray);
barcode.SetMargins(10);

// Add human-readable annotations
barcode.AddAnnotationTextAboveBarcode("Product ID");
barcode.AddBarcodeValueTextBelowBarcode(new IronSoftware.Drawing.Font("Arial", 12));

// Determine platform-specific save path
string documentsPath;
if (Device.RuntimePlatform == Device.iOS)
{
    documentsPath = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
}
else // Android
{
    documentsPath = Android.OS.Environment
        .GetExternalStoragePublicDirectory(Android.OS.Environment.DirectoryDownloads)
        .AbsolutePath;
}

// Export in multiple formats
barcode.SaveAsPng(Path.Combine(documentsPath, "barcode.png"));
barcode.SaveAsPdf(Path.Combine(documentsPath, "barcode.pdf"));

using IronBarCode;
using System.IO;
using Xamarin.Forms;

var barcode = BarcodeWriter.CreateBarcode("CUSTOM-2024", BarcodeEncoding.Code128);

// Apply styling to match your mobile UI
barcode.ChangeBarCodeColor(IronSoftware.Drawing.Color.Navy);
barcode.ChangeBackgroundColor(IronSoftware.Drawing.Color.LightGray);
barcode.SetMargins(10);

// Add human-readable annotations
barcode.AddAnnotationTextAboveBarcode("Product ID");
barcode.AddBarcodeValueTextBelowBarcode(new IronSoftware.Drawing.Font("Arial", 12));

// Determine platform-specific save path
string documentsPath;
if (Device.RuntimePlatform == Device.iOS)
{
    documentsPath = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
}
else // Android
{
    documentsPath = Android.OS.Environment
        .GetExternalStoragePublicDirectory(Android.OS.Environment.DirectoryDownloads)
        .AbsolutePath;
}

// Export in multiple formats
barcode.SaveAsPng(Path.Combine(documentsPath, "barcode.png"));
barcode.SaveAsPdf(Path.Combine(documentsPath, "barcode.pdf"));

Imports IronBarCode
Imports System.IO
Imports Xamarin.Forms
Imports IronSoftware.Drawing

Dim barcode = BarcodeWriter.CreateBarcode("CUSTOM-2024", BarcodeEncoding.Code128)

' Apply styling to match your mobile UI
barcode.ChangeBarCodeColor(Color.Navy)
barcode.ChangeBackgroundColor(Color.LightGray)
barcode.SetMargins(10)

' Add human-readable annotations
barcode.AddAnnotationTextAboveBarcode("Product ID")
barcode.AddBarcodeValueTextBelowBarcode(New Font("Arial", 12))

' Determine platform-specific save path
Dim documentsPath As String
If Device.RuntimePlatform = Device.iOS Then
    documentsPath = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments)
Else ' Android
    documentsPath = Android.OS.Environment.GetExternalStoragePublicDirectory(Android.OS.Environment.DirectoryDownloads).AbsolutePath
End If

' Export in multiple formats
barcode.SaveAsPng(Path.Combine(documentsPath, "barcode.png"))
barcode.SaveAsPdf(Path.Combine(documentsPath, "barcode.pdf"))

Metody stylizacji zapewniają pełną kontrolę nad wyglądem BARCODE-ów w interfejsie mobilnym. Kolory można określić za pomocą wartości RGB lub predefiniowanych stałych kolorów, aby dopasować je do motywu aplikacji. Metoda SetMargins() dodaje wypełnienie wokół BarCoda, zapobiegając problemom ze skanowaniem, które pojawiają się, gdy BarCodes są umieszczone blisko krawędzi obrazu.

Obsługa plików w wielopłatformowym programowaniu Xamarin wymaga znajomości platform. Aplikacje na iOS powinny zapisywać pliki w katalogu dokumentów lub bibliotece zdjęć. Aplikacje na Androida zazwyczaj korzystają z zewnętrznych katalogów pamięci masowej lub wewnętrznego katalogu danych aplikacji. Biblioteka obsługuje wszystkie główne formaty obrazów — PNG, JPEG, GIF, TIFF, BMP — Plus PDF w celu integracji dokumentów. W przypadku bardziej złożonych scenariuszy zapoznaj się z dokumentacją dotyczącą eksportu BarCode, aby uzyskać informacje o dodatkowych opcjach wyjściowych.

using IronBarCode;
using System.IO;
using Xamarin.Forms;

var barcode = BarcodeWriter.CreateBarcode("ORDER-99812", BarcodeEncoding.QRCode, 300);
byte[] pngBytes = barcode.ToPngBinaryData();

barcodeImage.Source = ImageSource.FromStream(() => new MemoryStream(pngBytes));

using IronBarCode;
using System.IO;
using Xamarin.Forms;

var barcode = BarcodeWriter.CreateBarcode("ORDER-99812", BarcodeEncoding.QRCode, 300);
byte[] pngBytes = barcode.ToPngBinaryData();

barcodeImage.Source = ImageSource.FromStream(() => new MemoryStream(pngBytes));

Imports IronBarCode
Imports System.IO
Imports Xamarin.Forms

Dim barcode = BarcodeWriter.CreateBarcode("ORDER-99812", BarcodeEncoding.QRCode, 300)
Dim pngBytes As Byte() = barcode.ToPngBinaryData()

barcodeImage.Source = ImageSource.FromStream(Function() New MemoryStream(pngBytes))

Jak obsługuje się skanowanie BarCode w Xamarin?

Chociaż niniejszy artykuł skupia się na generowaniu kodów kreskowych, wiele aplikacji Xamarin wymaga również odczytu kodów kreskowych z aparatów urządzeń. IronBarcode zawiera interfejs API do odczytu kodów kreskowych, który pod względem prostoty odzwierciedla interfejs API do generowania kodów. Dokumentacja czytnika kodów kreskowych IronBarcode obejmuje cały proces odczytu, w tym wykrywanie wielu kodów kreskowych i filtrowanie formatów.

W przypadku aplikacji Xamarin, która zarówno generuje, jak i skanuje BARCODE-sygnatury — na przykład aplikacji do przyjmowania towarów w magazynie — można połączyć klasy BarcodeWriter i BarcodeReader w tym samym projekcie. Oba interfejsy API działają w ramach tego samego pakietu NuGet bez dodatkowych zależności. Pełna galeria przykładów IronBarcode zawiera proces skanowania i generowania, który ilustruje to połączone podejście.

using IronBarCode;

try
{
    var barcode = BarcodeWriter.CreateBarcode(userInputValue, BarcodeEncoding.EAN13);
    barcode.SaveAsPng("output.png");
}
catch (BarcodeException ex)
{
    Console.WriteLine($"Barcode generation failed: {ex.Message}");
}

using IronBarCode;

try
{
    var barcode = BarcodeWriter.CreateBarcode(userInputValue, BarcodeEncoding.EAN13);
    barcode.SaveAsPng("output.png");
}
catch (BarcodeException ex)
{
    Console.WriteLine($"Barcode generation failed: {ex.Message}");
}

Imports IronBarCode

Try
    Dim barcode = BarcodeWriter.CreateBarcode(userInputValue, BarcodeEncoding.EAN13)
    barcode.SaveAsPng("output.png")
Catch ex As BarcodeException
    Console.WriteLine($"Barcode generation failed: {ex.Message}")
End Try

Jakie są Twoje kolejne kroki?

IronBarcode sprawia, że generowanie kodów kreskowych w aplikacjach Xamarin przestaje być skomplikówanym wyzwaniem związanym z konkretną platformą, a staje się kilkoma wierszami kodu C#. Niezależnie od tego, czy potrzebujesz kodów QR do mobilnych procesów zamówień, kodu 128 do etykiet magazynowych, czy EAN-13 do produktów detalicznych, biblioteka zapewnia jeden interfejs API, który działa identycznie na systemach Android i iOS — a także równie dobrze w środowiskach ASP.NET, desktopowych i serwerowych.

Aby pogłębić zdobytą tutaj wiedzę, zapoznaj się z poniższymi zasobami:

• Pobierz IronBarcode i rozpocznij bezpłatny okres próbny — wypróbuj wszystkie funkcje przez 30 dni bez podawania danych karty kredytowej
• Zbiór samouczków IronBarcode — przewodniki krok po kroku dotyczące skanowania, generowania partii i integracji z PDF
• Galeria przykładów IronBarcode — gotowe do skopiowania i wklejenia przykłady kodu dla ponad 40 typowych zadań związanych z kodami kreskowymi
• Licencjonowanie i ceny — opcje licencji dla pojedynczego programisty, zespołu oraz SaaS dla wdrożeń mobilnych
• Przewodnik po migracji do .NET MAUI — jeśli przenosisz swój projekt Xamarin do nowoczesnego stosu mobilnego .NET, IronBarcode działa w obu środowiskach bez konieczności wprowadzania zmian w kodzie

Zacznij od zainstalowania pakietu NuGet i uruchom pierwszy przykład powyżej, aby sprawdzić, czy Twoje środowisko jest poprawnie skonfigurowane. Na tej podstawie tabela porównawcza formatów i przykłady dostosowania zawarte w tym artykułe dostarczają wszystkich informacji potrzebnych do dostosowania generowanych kodów BarCode do konkretnych wymagań aplikacji.