Comment générer des codes-barres dans Xamarin en utilisant IronBarcode

Pourquoi utiliser une bibliothèque professionnelle de codes-barres pour Xamarin Forms ?

L'implémentation de la génération de codes-barres à partir de zéro dans Xamarin.Forms nécessite de gérer des algorithmes de codage complexes, de gérer les différences de rendu spécifiques à la plateforme, et d'assurer une sortie précise à travers diverses symbologies de codes-barres. Une bibliothèque .NET professionnelle pour les codes-barres, telle qu'IronBarcode, élimine ces défis en fournissant une API unifiée qui gère toutes les complexités techniques en interne par le biais de méthodes simples en C#.

IronBarcode prend en charge plus de 30 formats de codes-barres, y compris les codes QR, Code 128, Code 39, EAN-13, UPC-A, Data Matrix, PDF 417 et les codes Aztec. Chaque format est optimisé pour des cas d'utilisation spécifiques. Par exemple, les codes QR excellent à stocker des URLs et de grandes données textuelles, EAN13 sert les produits de détail, tandis que Code128 fournit un encodage alphanumérique haute densité. La bibliothèque calcule automatiquement les sommes de contrôle, applique les niveaux de correction d'erreurs appropriés, et garantit la conformité aux normes GS1 pour les applications commerciales.

La nature multiplateforme d'IronBarcode garantit que votre code de génération de codes-barres reste identique, que vous cibliez les plateformes mobiles Android ou iOS. Cette cohérence va au-delà des applications Xamarin - le même code fonctionne dans les applications ASP.NET applications, les logiciels de bureau, et même les conteneurs Docker, ce qui le rend idéal pour les entreprises ayant des exigences de déploiement diverses. Les capacités de traitement d'images intégrées de la bibliothèque gèrent automatiquement les problèmes courants comme le redimensionnement de la résolution et la conversion de format. En savoir plus sur les capacités multiplateformes d'IronBarcode.

Comment installer IronBarcode dans votre projet Xamarin ?

L'installation d'IronBarcode dans votre projet Xamarin.Forms prend seulement quelques minutes via le gestionnaire de paquets NuGet. Ouvrez votre solution Visual Studio contenant vos projets mobiles multiplateformes et suivez ces étapes pour une intégration fluide avec votre code .NET existant.

Tout d'abord, faites un clic droit sur votre solution dans l'Explorateur de solutions et sélectionnez "Gérer les paquets NuGet pour la solution". Dans l'onglet Parcourir, recherchez "IronBarCode" (notez la capitalisation spécifique). Sélectionnez le package officiel IronBarcode par Iron Software et installez-le dans tous les projets de votre solution, y compris le projet partagé et les deux projets spécifiques à la plateforme. Vous pouvez également explorer les détails complets du package NuGet pour l'historique des versions et les dépendances.

Alternativement, utilisez la console de gestion des paquets avec cette commande pour une installation rapide dans votre projet de générateur de codes-barres Xamarin :

Install-Package BarCode

Pour les projets d'applications Android, aucune permission supplémentaire n'est requise pour la création de codes-barres de base. Cependant, si vous prévoyez de sauvegarder les codes-barres scannés générés sur le stockage externe, ajoutez la permission WRITE_EXTERNAL_STORAGE à votre fichier AndroidManifest.xml. Consultez le guide de mise en œuvre spécifique à Android pour des considérations détaillées sur la plateforme.

Pour les projets iOS, si vous enregistrez des codes QR ou des codes-barres dans la photothèque, ajoutez la clé NSPhotoLibraryAddUsageDescription à votre fichier Info.plist avec une description appropriée. La documentation de mise en œuvre des codes-barres pour iOS fournit des instructions complètes de configuration.

Pour utiliser toutes les fonctionnalités d'IronBarcode sans filigranes, vous aurez besoin d'une clé de licence. Vous pouvez obtenir une licence d'essai gratuite sur le site Web de Iron Software qui fournit un accès complet à toutes les fonctionnalités de génération de codes-barres pendant 30 jours. Définissez votre clé de licence une fois dans le code de démarrage de votre application :

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

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

IRON VB CONVERTER ERROR developers@ironsoftware.com

Sans clé de licence, IronBarcode fonctionne en mode évaluation avec des filigranes sur les codes-barres générés. Pour les applications de production, Iron Software offre diverses options de licence, y compris des licences pour un projet unique, pour l'ensemble de l'organisation, et pour la distribution Saas adaptées au déploiement d'applications mobiles.

Comment générer votre premier code-barres ?

Créer votre premier code-barres avec IronBarcode dans une application Xamarin.Forms nécessite un minimum de code C#. Voici un exemple complet qui génère un code-barres Code128 dans votre application mobile :

using IronBarCode;
using System.IO;
public void GenerateSimpleBarcode(object sender, EventArgs e)
{
    // Create a barcode with one line of code
    var myBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com", BarcodeEncoding.Code128);
    // Resize to specific dimensions
    myBarcode.ResizeTo(500, 200);
    // Add text annotations
    myBarcode.AddBarcodeValueTextBelowBarcode();
    // Save as image
    string filePath = Path.Combine(Environment.GetFolderPath(
        Environment.SpecialFolder.Personal), "barcode.png");
    myBarcode.SaveAsPng(filePath);
}

using IronBarCode;
using System.IO;
public void GenerateSimpleBarcode(object sender, EventArgs e)
{
    // Create a barcode with one line of code
    var myBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com", BarcodeEncoding.Code128);
    // Resize to specific dimensions
    myBarcode.ResizeTo(500, 200);
    // Add text annotations
    myBarcode.AddBarcodeValueTextBelowBarcode();
    // Save as image
    string filePath = Path.Combine(Environment.GetFolderPath(
        Environment.SpecialFolder.Personal), "barcode.png");
    myBarcode.SaveAsPng(filePath);
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

La méthode BarcodeWriter.CreateBarcode() sert de point d'entrée principal pour la génération de codes-barres dans les applications .NET. Elle accepte deux éléments : les données à encoder et le format de code-barres à partir de l'énumération BarcodeEncoding. La méthode renvoie un objet GeneratedBarcode qui offre de vastes options de personnalisation par le biais d'APIs fluides. Explorez la référence complète de l'API BarcodeWriter pour des fonctionnalités avancées.

La méthode ResizeTo() ajuste les dimensions du code-barres tout en maintenant les exigences de rapport d'aspect et de largeur de barre appropriées pour la symbologie sélectionnée. La méthode AddBarcodeValueTextBelowBarcode() ajoute du texte lisible par les humains sous le code-barres, ce qui est essentiel pour de nombreuses applications de gestion de vente au détail et d'inventaire dans Xamarin.

Générer un code QR

Pour la génération de codes QR dans votre application de lecteur de codes-barres Xamarin, le processus est tout aussi simple en utilisant la classe spécialisée QRCodeWriter :

public void GenerateQRCode()
{
    // Create a QR code with custom data
    var qrCode = QRCodeWriter.CreateQrCode("SKU-12345|Batch-789|Exp-2025", 500);
    // Set error correction to high for better reliability
    qrCode.ChangeBarCodeColor(IronSoftware.Drawing.Color.DarkBlue);
    // Convert to byte array for database storage
    byte[] barcodeBytes = qrCode.ToPngBinaryData();
}

public void GenerateQRCode()
{
    // Create a QR code with custom data
    var qrCode = QRCodeWriter.CreateQrCode("SKU-12345|Batch-789|Exp-2025", 500);
    // Set error correction to high for better reliability
    qrCode.ChangeBarCodeColor(IronSoftware.Drawing.Color.DarkBlue);
    // Convert to byte array for database storage
    byte[] barcodeBytes = qrCode.ToPngBinaryData();
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

La méthode QRCodeWriter.CreateQrCode() se spécialise dans la création de codes QR avec des fonctionnalités supplémentaires telles que l'intégration de logo et la personnalisation des couleurs. Le second paramètre spécifie la taille du code QR en pixels. La méthode ToPngBinaryData() convertit le code QR généré en un tableau d'octets, parfait pour être stocké dans des bases de données ou transmis sur les réseaux dans votre application mobile multiplateforme. Découvrez d'autres exemples de génération de codes QR pour des implémentations avancées.

Comment travailler avec différents formats de codes-barres (EAN13, Data Matrix, etc.) ?

Le support étendu des formats d'IronBarcode vous permet de générer le type exact de code-barres dont votre application Xamarin.Forms a besoin. Voici comment travailler avec divers formats de codes-barres populaires en utilisant C# dans vos projets mobiles :

public void GenerateMultipleFormats(string productCode)
{
    // 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");
}

public void GenerateMultipleFormats(string productCode)
{
    // 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");
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Chaque symbologie de code-barres a des caractéristiques spécifiques et des cas d'utilisation dans les applications mobiles. EAN-13 et UPC-A nécessitent une entrée uniquement numérique et calculent automatiquement les chiffres de contrôle pour une précision de numérisation au détail. DataMatrix excelle à encoder de grandes quantités de données dans un espace minimal, ce qui le rend idéal pour le suivi des composants électroniques et des produits pharmaceutiques. PDF417 prend en charge un stockage étendu de données avec des niveaux de correction d'erreurs intégrés, souvent utilisé dans les documents de transport et d'identification. En savoir plus sur le choix du bon format de code-barres pour votre cas d'utilisation spécifique.

Comment personnaliser et exporter des codes-barres ?

IronBarcode offre des options de personnalisation complètes pour répondre aux exigences visuelles de votre application Xamarin et aux besoins d'exportation pour les plateformes Android et iOS :

public void CustomizeAndExportBarcode()
{
    var barcode = BarcodeWriter.CreateBarcode("CUSTOM-2024", BarcodeEncoding.Code128);
    // Styling options for mobile UI consistency
    barcode.ChangeBarCodeColor(IronSoftware.Drawing.Color.Navy);
    barcode.ChangeBackgroundColor(IronSoftware.Drawing.Color.LightGray);
    barcode.SetMargins(10);
    // Add annotations for human readability
    barcode.AddAnnotationTextAboveBarcode("Product ID");
    barcode.AddBarcodeValueTextBelowBarcode(IronSoftware.Drawing.Font("Arial", 12));
    // Platform-specific file handling in Xamarin
    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 for versatility
    barcode.SaveAsPng(Path.Combine(documentsPath, "barcode.png"));
    barcode.SaveAsWindowsBitmap(Path.Combine(documentsPath, "barcode.bmp"));
    barcode.SaveAsPdf(Path.Combine(documentsPath, "barcode.pdf"));
}

public void CustomizeAndExportBarcode()
{
    var barcode = BarcodeWriter.CreateBarcode("CUSTOM-2024", BarcodeEncoding.Code128);
    // Styling options for mobile UI consistency
    barcode.ChangeBarCodeColor(IronSoftware.Drawing.Color.Navy);
    barcode.ChangeBackgroundColor(IronSoftware.Drawing.Color.LightGray);
    barcode.SetMargins(10);
    // Add annotations for human readability
    barcode.AddAnnotationTextAboveBarcode("Product ID");
    barcode.AddBarcodeValueTextBelowBarcode(IronSoftware.Drawing.Font("Arial", 12));
    // Platform-specific file handling in Xamarin
    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 for versatility
    barcode.SaveAsPng(Path.Combine(documentsPath, "barcode.png"));
    barcode.SaveAsWindowsBitmap(Path.Combine(documentsPath, "barcode.bmp"));
    barcode.SaveAsPdf(Path.Combine(documentsPath, "barcode.pdf"));
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Les méthodes de stylisation permettent un contrôle total sur l'apparence des codes-barres dans votre interface mobile. Les couleurs peuvent être spécifiées en utilisant des valeurs RGB ou des constantes de couleurs prédéfinies pour correspondre au thème de votre application. La méthode SetMargins() ajoute des marges autour du code-barres, évitant les problèmes de numérisation lorsque les codes-barres sont placés près des bords. Explorez d'autres techniques de personnalisation des codes-barres pour des effets visuels avancés.

La gestion des fichiers dans le développement multiplateforme Xamarin nécessite des aspects spécifiques à la plateforme. Les applications iOS doivent enregistrer dans le répertoire des documents ou la photothèque, tandis que les applications Android utilisent généralement des répertoires de stockage externe. La bibliothèque .NET Standard prend en charge tous les principaux formats d'images, y compris PNG, JPEG, GIF, TIFF et BMP, ainsi que PDF pour l'intégration de documents. Pour des scénarios plus complexes, consultez la documentation sur l'exportation des codes-barres pour des options de sortie supplémentaires.

Conclusion

IronBarcode transforme la génération de codes-barres dans les applications Xamarin d'un défi complexe en une implémentation simple. Son support complet des formats, sa cohérence multiplateforme et ses vastes options de personnalisation en font le choix idéal pour les applications mobiles professionnelles nécessitant une fonctionnalité fiable de codes-barres et de codes QR dans les environnements .NET.

Commencez à implémenter la génération professionnelle de codes-barres dans votre application Xamarin.Forms ou Xamarin native dès aujourd'hui avec une licence d'essai gratuite. Prêt à acheter ? Consultez les prix et achetez une licence qui répond à vos besoins de projet.