IronBarcodeを使用してXamarinでバーコードを生成する方法

Xamarin Formsでプロフェッショナルなバーコードライブラリを使用する理由

Xamarin.Formsでスクラッチからバーコード生成を実装するには、複雑なエンコーディングアルゴリズムの処理、プラットフォーム固有のレンダリングの違いの管理、さまざまなバーコード記法全体での正確な出力の確保が必要です。 IronBarcodeなどのプロフェッショナルな.NETバーコードライブラリは、単純なC#メソッドを通じてすべての技術的な複雑さを内部で処理する統一されたAPIを提供することにより、これらの課題を排除します。

IronBarcodeは、QRコード、Code 128、Code 39、EAN-13、UPC-A、Data Matrix、PDF 417、Aztecコードを含む30以上のバーコード形式をサポートしています。 各形式は、特定の使用ケースに最適化されています。 たとえば、QRコードはURLや大量のテキストデータの保存に優れ、EAN13は小売製品に使用され、Code128は高密度の英数字エンコーディングを提供します。 ライブラリは、自動的にチェックサムを計算し、適切なエラー訂正レベルを適用し、商業アプリケーション用のGS1標準に準拠することを保証します。

IronBarcodeのクロスプラットフォームの特性は、AndroidまたはiOSモバイルプラットフォームを対象とするかどうかに関係なく、バーコード生成コードが同一のままであることを保証します。 この一貫性はXamarinアプリケーションを超えて拡張され - 同一のコードがASP.NETアプリケーション、デスクトップソフトウェア、さらにはDockerコンテナでも機能し、さまざまな展開要件を持つ企業に最適です。 ライブラリの組み込みの画像処理能力は、解像度のスケーリングや形式変換などの一般的な問題を自動的に処理します。 IronBarcodeのクロスプラットフォーム機能について詳しく学びましょう。

XamarinプロジェクトでIronBarcodeをインストールする方法

Xamarin.FormsプロジェクトでのIronBarcodeのインストールは、NuGetパッケージマネージャーを通じて数分で完了します。 クロスプラットフォームのモバイルプロジェクトが含まれるVisual Studioソリューションを開き、既存の.NETコードへのシームレスな統合のために次の手順に従います。

まず、ソリューションエクスプローラーでソリューションを右クリックし、「ソリューションのNuGetパッケージの管理」を選択します。 「参照」タブで、「IronBarCode」（特定の大文字小文字に注意）を検索します。 Iron Softwareの公式IronBarcodeパッケージを選択し、共有プロジェクトおよび両方のプラットフォーム固有のプロジェクトを含むソリューションのすべてのプロジェクトにインストールします。 バージョン履歴や依存関係のための完全なNuGetパッケージの詳細も探索できます。

あるいは、Xamarinバーコードジェネレータープロジェクトでのクイックインストールには、このコマンドを使用してパッケージマネージャーコンソールを利用します。

Install-Package BarCode

Androidアプリケーションプロジェクトでは、基本的なバーコード作成に追加の権限は必要ありません。 ただし、生成されたスキャン済みバーコードを外部ストレージに保存する場合は、WRITE_EXTERNAL_STORAGEパーミッションをAndroidManifest.xmlファイルに追加します。プラットフォーム固有の詳細なガイドを読むには、Android固有の実装ガイドを確認してください。

iOSプロジェクトの場合、QRコードやバーコードをフォトライブラリに保存する場合は、Info.plistファイルにNSPhotoLibraryAddUsageDescriptionキーを適切な説明とともに追加します。 iOSバーコード実装ドキュメントには、完全なセットアップ手順が記載されています。

IronBarcodeの完全な機能をウォーターマークなしで使用するには、ライセンスキーが必要です。 30日間のすべてのバーコード生成機能への完全なアクセスを提供する無料のトライアルライセンスをIron Softwareのウェブサイトから取得できます。 アプリケーションのスタートアップコードで一度ライセンスキーを設定します：

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

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

IRON VB CONVERTER ERROR developers@ironsoftware.com

ライセンスキーがない場合、IronBarcodeは評価モードで動作し、生成されたバーコードにウォーターマークが付きます。 商用アプリケーション用として、Iron Softwareは、単一プロジェクト、組織全体、およびモバイルアプリ展開用のSaaS配布ライセンスなど、さまざまなライセンスオプションを提供しています。

最初のバーコードを生成する方法

Xamarin.FormsアプリケーションでIronBarcodeを使用して最初のバーコードを作成するには、必要なC#コードは最小限です。 モバイルアプリでCode128バーコードを生成する完全な例がここにあります。

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

BarcodeWriter.CreateBarcode()メソッドは、.NETアプリケーションでのバーコード生成のための主要なエントリーポイントとして機能します。 このメソッドはエンコードするデータとBarcodeEncoding enumからのバーコード形式の2つの要素を受け取ります。 このメソッドは、流暢なAPIを通じて広範なカスタマイズオプションを提供するGeneratedBarcodeオブジェクトを返します。高度な機能のための完全なBarcodeWriter APIリファレンスを探索してください。

ResizeTo()メソッドは、選択した記法のための正しい縦横比とバー幅要求を維持しながらバーコードの寸法を調整します。 AddBarcodeValueTextBelowBarcode()メソッドは、多くの小売および在庫管理アプリケーションにおいて重要なバーコードの下に人間が読めるテキストを追加します。

QRコードの生成

XamarinバーコードスキャナーアプリでのQRコード生成の場合、特化した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

QRCodeWriter.CreateQrCode()メソッドは、ロゴの埋め込みや色のカスタマイズのような追加機能を持つQRコードの作成に特化しています。 2番目のパラメーターはピクセル単位でQRコードのサイズを指定します。 ToPngBinaryData()メソッドは、データベースに保存したり、クロスプラットフォームモバイルアプリケーションでネットワーク経由で送信するのに最適な、生成されたQRコードをバイト配列に変換します。 高度な実装に関する追加のQRコード生成例をチェックしてください。

さまざまなバーコード形式（EAN13、Data Matrixなど）の作業方法

IronBarcodeの広範なフォーマットサポートにより、Xamarin.Formsアプリケーションに必要な正確なバーコードタイプを生成できます。 モバイルプロジェクトでC#を使用してさまざまなポピュラーバーコード形式を扱う方法は以下のとおりです。

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

各バーコード記法には、モバイルアプリケーションにおける特定の特性と使用ケースがあります。 EAN-13とUPC-Aは、数値のみの入力を必要とし、小売スキャニング精度のために自動的にチェックディジットを計算します。 DataMatrixは、電子部品や医薬品のトラッキングに最適な最小スペースに大量のデータをエンコードできます。 PDF417は、通常、交通と識別文書で使用される組み込みのエラー訂正レベルを備えた広範なデータストレージをサポートします。 特定の使用ケースに最適なバーコード形式の選択方法についてさらに学びましょう。

バーコードをカスタマイズしてエクスポートする方法

IronBarcodeは、Xamarinアプリケーションの視覚的な要件とアンドロイドおよび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

スタイリングメソッドは、モバイルインタフェースでのバーコードの外観を完全に制御します。 色は、アプリのテーマに合わせてRGB値または事前定義の色定数を使用して指定できます。 SetMargins()メソッドは、バーコードが端に配置される際のスキャン問題を防ぐために、バーコードの周囲にパディングを追加します。 高度な視覚効果のための追加のバーコードカスタマイズ技術を探索してください。

クロスプラットフォームXamarin開発でのファイル処理にはプラットフォーム固有の側面が必要です。 iOSアプリはドキュメントディレクトリまたはフォトライブラリに保存する必要があり、Androidアプリは通常、外部ストレージディレクトリを使用します。 .NET Standardライブラリは、PNG、JPEG、GIF、TIFF、およびBMPを含むすべての主要な画像形式をサポートし、さらにドキュメント統合のためのPDFもサポートしています。 より複雑なシナリオのための追加の出力オプションについては、バーコードエクスポートドキュメントを参照してください。

結論

IronBarcodeは、Xamarinアプリケーションでのバーコード生成を複雑な課題からシンプルな実装に変えます。 その包括的なフォーマットサポート、クロスプラットフォームの一貫性、および広範なカスタマイズオプションは、信頼性の高いバーコードおよびQRコード機能を.NET環境で必要とするプロフェッショナルモバイルアプリケーションに最適な選択肢となります。

無料のトライアルライセンスで今日からXamarin.FormsまたはネイティブXamarinアプリケーションにプロフェッショナルなバーコード生成を実装し始めましょう。 購入の準備はできていますか？ プロジェクトのニーズに合ったライセンスの価格と購入を確認してください。