Xamarin Barkod Üretici: IronBarcode ile C#'ta Barkodlar Üretin

Xamarin Forms için Neden Profesyonel Bir Barkod Kütüphanesine İhtiyacınız Var?

Xamarin.Forms'da sıfırdan barkod üretimini uygulamak, karmaşık kodlama algoritmalarını ele almayı, platforma özgü render farklılıklarını yönetmeyi ve çeşitli barkod sembolojileri boyunca doğru çıktı sağlamayı gerektirir. Profesyonel bir .NET barkod kütüphanesi olan IronBarcode, tüm teknik karmaşıklıkları basit C# yöntemleri ile dahili olarak ele alarak bu zorlukları ortadan kaldırır.

IronBarcode, QR kodları, Kod 128, Code 39, EAN-13, UPC-A, Veri Matrisi, PDF 417 ve Aztek kodları dahil 30'dan fazla barkod formatını destekler. Her format belirli kullanım durumları için optimize edilmiştir. Örneğin, QR kodları URL'leri ve büyük metin verilerini saklamada mükemmeldir, EAN-13 perakende ürünler için hizmet ederken Kod 128 yüksek yoğunluklu alfasayısal kodlamaya olanak tanır. Kütüphane, kontrol numaralarını otomatik olarak hesaplar, uygun hata düzeltme seviyelerini uygular ve ticari uygulamalar için GS1 standartlarıyla uyumluluğu sağlar.

IronBarcode'un çapraz platform yapısı, barkod oluşturma kodunuzun, Android veya iOS'u hedefliyor olsanız da aynı kalmasını sağlar. Bu tutarlılık, Xamarin uygulamalarının ötesine geçer ve ASP.NET web uygulamaları, masaüstü yazılımlar ve Docker konteynerlerinde de aynı kod çalışır, bu da çeşitli dağıtım gereksinimleri olan işletmeler için idealdir. IronBarcode'un çapraz platform yetenekleri hakkında daha fazla bilgi edinin.

Xamarin Projesine IronBarcode Nasıl Kurulur?

Xamarin.Forms projenize IronBarcode kurmak sadece birkaç dakikanızı alır ve bu işlemi NuGet Paket Yöneticisi üzerinden yapabilirsiniz. Çoklu platform mobil projelerinizi içeren Visual Studio çözümünüzü açın ve aşağıdaki adımları izleyin.

Solution Explorer'da çözümünüze sağ tıklayın ve "Manage NuGet Packages for Solution" seçeneğini seçin. "Gözat" sekmesinde, 'IronBarcode' arayın. Iron Software tarafından sağlanan resmi IronBarcode paketini seçin ve tüm projelerinizde, ortak projede ve her iki platforma özgü projede kurun. Sürüm geçmişi ve bağımlılıklar için tam NuGet paket detaylarını keşfedebilirsiniz.

Alternatif olarak, bu komutla Paket Yöneticisi Konsolu'nu kullanın:

Install-Package BarCode

Android projeleri için, temel barkod oluşturma için ek izinler gerekmez. Ancak, oluşturulan barkodları harici depolamaya kaydetmeyi planlıyorsanız, WRITE_EXTERNAL_STORAGE iznini AndroidManifest.xml e ekleyin. Detaylı platform değerlendirmeleri için Android'e özgü kurulum kılavuzunu inceleyin.

iOS projeleri için, QR kodlarını veya barkodları fotoğraf kütüphanesine kaydediyorsanız, NSPhotoLibraryAddUsageDescription anahtarını Info.plist e uygun bir kullanıcıya yönelik açıklama ile ekleyin. Tam talimatlar için iOS barkod kurulum belgelerini inceleyin.

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

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

Imports IronBarCode

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

IronBarcode ile İlk Barkodunuzu Nasıl Üretirsiniz?

Xamarin.Forms uygulamanızda IronBarcode ile ilk barkodunuzu oluşturmak için çok az C# kodu gereklidir. Aşağıdaki örnek bir Kod 128 barkodu oluşturarak bir PNG olarak kaydeder ve çubukların altına insanlar için okunabilir bir metin etiketi ekler:

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)

BarcodeWriter.CreateBarcode() yöntemi barkod oluşturma için ana giriş noktasıdır. Bu, kodlanacak veri ve BarcodeEncoding numarasından barkod formatı olmak üzere iki argüman alır. Yöntem, akıcı bir API aracılığıyla kapsamlı özelleştirme sağlayan bir GeneratedBarcode nesnesi döndürür.

ResizeTo() yöntemi, seçilen sembolojinin uygun en-boy oranlarını ve çubuk genişliği gereksinimlerini korurken barkod boyutlarını ayarlar. AddBarcodeValueTextBelowBarcode() birçok perakende ve envanter yönetimi senaryosu için gereken, çubukların altına okunabilir metin ekler. Gelişmiş özellikler için tam BarcodeWriter API referansını keşfedin.

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()

Farklı Barkod Biçimlarıyla Nasıl Çalışılır?

IronBarcode'un geniş format desteği, Xamarin.Forms uygulamanızın ihtiyaç duyduğu tam barkod türünü oluşturmanıza olanak tanır. Aşağıdaki örnek, tek bir ürün kodu dizisinden EAN-13, UPC-A, Veri Matrisi ve PDF417 barkodlarını nasıl oluşturduğunuzu gösterir:

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

// Veri Matrisi for small items with high data density
var dataMatrix = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.Veri Matrisi);
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");

// Veri Matrisi for small items with high data density
var dataMatrix = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.Veri Matrisi);
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")

' Veri Matrisi 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")

Her barkod sembolojisinin belirli karakteristikleri ve kullanım durumları vardır. EAN-13 ve UPC-A yalnızca sayısal girdi gerektirir ve perakende tarama doğruluğu için kontrol rakamlarını otomatik olarak hesaplar. Veri Matrisi, elektronik bileşenler ve ilaç izleme için ideal hale getirerek minimal alanda büyük veri miktarlarını kodlamada mükemmeldir. PDF417, taşımacılık ve kimlik belgelerinde sıkça kullanılan geniş veri depolama ve yerleşik hata düzeltme desteği sunar.

Kütüphane, girdi verilerini format gereksinimlerine karşı otomatik olarak doğrular ve geçersiz girdiler için açıklayıcı istisnalar fırlatır. Bu doğrulama, üretilen barkodların uluslararası ISO standartlarına uyumlu olduğunu ve perakende ve lojistikte kullanılan ticari barkod okuyucularıyla güvenilir şekilde tarandığını sağlar. Özel kullanım durumunuz için doğru barkod formatını seçme hakkında daha fazla bilgi edinin.

Mobil Kullanıcı Arayüzleri için Barkodları Nasıl Özelleştirir ve Dışa Aktarırsınız?

IronBarcode, Xamarin uygulamanızın görsel gereksinimlerini karşılamak için kapsamlı özelleştirme seçenekleri sunar. Aşağıdaki örnek, renklerin nasıl uygulanacağını, metin açıklamalarının nasıl ekleneceğini ve platforma özgü dosya konumlarına nasıl kaydedileceğini gösterir:

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

Stil verme yöntemleri, mobil arayüzünüzde barkod görünümü üzerinde tam kontrol sağlar. Renkler, uygulamanızın temasına uyacak şekilde RGB değerleri kullanılarak veya önceden tanımlanmış renk sabitleri ile belirtilebilir. SetMargins() yöntemi, barkodun etrafına dolgu ekler ve bu dolgu, barkodlar görüntü kenarlarına yerleştirildiğinde ortaya çıkan tarama sorunlarını önler.

Çapraz platformlu Xamarin geliştirmede dosya işleme, platform farkındalığı gerektirir. iOS uygulamaları belgeler dizinine veya fotoğraf kitaplığına kaydetmelidir. Android uygulamaları genellikle harici depolama dizinlerini veya uygulamanın iç veri dizinini kullanır. Kütüphane, tüm önemli resim formatlarını -- PNG, JPEG, GIF, TIFF, BMP -- ve ayrıca belge entegrasyonu için PDF dosyalarını destekler. Daha karmaşık senaryolar için, ek çıktı seçenekleri için barkod ihracat belgelendirmesini inceleyin.

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

Xamarin'de Barkod Tarama Nasıl Yapılır?

Bu makale barkod üretimine odaklanırken, birçok Xamarin uygulaması ayrıca cihaz kameralarından barkod okumaya da ihtiyaç duyar. IronBarcode, nesil API'sinin sadeliğini yansıtan bir barkod okuma API'si içerir. IronBarcode barkod okuyucu belgelendirmesi tam okuma iş akışını kapsar, birden fazla barkod algılama ve format filtrelemeyi dahil eder.

Hem barkod üreten hem de tarayan bir Xamarin uygulaması için -- örneğin bir depo alım uygulaması -- BarcodeWriter ve BarcodeReader sınıflarını aynı projede birleştirebilirsiniz. Her iki API de ek bir bağımlılık olmadan aynı NuGet paketinden çalışır. Tam IronBarcode örnekleri galerisi bu birleşik yaklaşımı gösteren bir tarama ve oluşturma iş akışı içerir.

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

Sonraki Adımlarınız Neler?

IronBarcode, Xamarin uygulamalarında barkod oluşturmayı, karmaşık ve platforma özgü bir zorluktan, birkaç satır C# koduna dönüştürür. Mobil sipariş akışları için QR kodlarına, depo etiketleri için Kod 128'e veya perakende ürünler için EAN-13'e ihtiyacınız olsun, kütüphane Android ve iOS'ta aynı şekilde çalışan tek bir API sunar -- ve ASP.NET, masaüstü ve sunucu ortamlarında da aynı derecede iyi çalışır.

Burada öğrendiklerinizi geliştirmeye devam etmek için bu kaynakları keşfedin:

• IronBarcode'u indir ve ücretsiz denemeye başla -- tüm özellikleri kredi kartı gerektirmeden 30 gün boyunca değerlendirin
• IronBarcode eğitim koleksiyonu -- tarama, toplu oluşturma ve PDF entegrasyonu için adım adım kılavuzlar IronBarcode örnekleri galerisi -- 40'tan fazla yaygın barkod görevi için kopyala-yapıştır kod örnekleri
• Lisanslama ve fiyatlandırma -- mobil dağıtımlar için tek geliştirici, ekip ve SaaS lisans seçenekleri
• .NET MAUI geçiş kılavuzu -- Xamarin projenizi modern .NET mobil yığınına taşıyorsanız, IronBarcode her iki ortamda da kod değişikliği yapmadan çalışır

NuGet paketi kurulumu ile başlayın ve ortamınızın doğru bir şekilde kurulduğunu doğrulamak için yukarıdaki ilk örneği çalıştırın. Bu makaledeki biçim karşılaştırma tablosu ve özelleştirme örnekleri, barkod çıktısını uygulamanızın tam gereksinimlerine uyacak şekilde özelleştirmeniz için ihtiyaç duyduğunuz her şeyi sağlar.