Xamarin バーコード ジェネレーター: IronBarcodeを使用して C# でバーコードを生成する

Xamarin FormsにProfessionalバーコードライブラリが必要な理由とは？

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

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

IronBarcodeのクロスプラットフォーム対応により、AndroidとiOSのどちらをターゲットにするかに関わらず、バーコード生成コードは常に同一に保たれます。 この一貫性はXamarinアプリケーションにとどまらず、同じコードがASP.NET Webアプリケーション、デスクトップソフトウェア、Dockerコンテナでも動作するため、多様な展開要件を持つ企業にとって理想的です。 IronBarcodeのクロスプラットフォーム機能について詳しくはこちらをご覧ください。

XamarinプロジェクトにIronBarcodeをインストールするにはどうすればよいですか？

Xamarin.FormsプロジェクトでのIronBarcodeのインストールは、NuGetパッケージマネージャーを通じて数分で完了します。 クロスプラットフォームのモバイルプロジェクトを含むVisual Studioソリューションを開き、以下の手順に従ってください。

ソリューションエクスプローラーでソリューションを右クリックし、"ソリューションのNuGetパッケージの管理"を選択します。 "参照"タブで"IronBarcode"を検索してください。 Iron Software社製の公式IronBarcodeパッケージを選択し、共有プロジェクトとプラットフォーム固有のプロジェクトの両方を含む、ソリューション内のすべてのプロジェクトにインストールしてください。 バージョン履歴や依存関係については、 NuGetパッケージの詳細情報を参照できます。

または、以下のコマンドを使用してパッケージマネージャーコンソールを使用します。

Install-Package BarCode

Install-Package BarCode

Androidプロジェクトの場合、基本的なバーコード作成には追加の権限は必要ありません。 ただし、生成されたバーコードを外部ストレージに保存する場合は、WRITE_EXTERNAL_STORAGE の権限を AndroidManifest.xml に追加してください。 Android固有のセットアップガイドを参照して、プラットフォームに関する詳細な注意事項を確認してください。

iOS プロジェクトの場合、QR コードまたはバーコードを写真ライブラリに保存する場合は、適切なユーザー向け説明とともに NSPhotoLibraryAddUsageDescription キーを Info.plist に追加します。 iOSのバーコード設定に関するドキュメントには、詳細な手順が記載されています。

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

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

IronBarcodeで最初のバーコードを生成するにはどうすればよいですか？

Xamarin.FormsアプリケーションでIronBarcodeを使用して最初のバーコードを作成するには、必要なC#コードは最小限です。 以下の例では、コード 128バーコードを生成し、PNG形式で保存し、人間が読めるテキストラベルを追加します。

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

BarcodeWriter.CreateBarcode() メソッドは、バーコード生成の主要なエントリポイントです。 エンコードするデータと、BarcodeEncoding 列挙型からのバーコード形式という 2 つの引数を受け取ります。 このメソッドは、流暢なAPIを通じて広範なカスタマイズを提供するオブジェクトを返します。

ResizeTo() メソッドは、選択したシンボル体系の適切なアスペクト比とバー幅の要件を維持しながら、バーコードの寸法を調整します。 AddBarcodeValueTextBelowBarcode() は、バーの下に人間が読めるテキストを追加します。これは、多くの小売業や在庫管理のシナリオで必要となります。 高度な機能については、 BarcodeWriter APIリファレンス全文をご覧ください。

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

さまざまなバーコード形式にはどのように対応していますか？

IronBarcodeは幅広いフォーマットに対応しているため、Xamarin.Formsアプリケーションが必要とするバーコードタイプを正確に生成できます。 以下の例は、単一の製品コード文字列からEAN-13、UPC-A、DataMatrix、およびPDF417バーコードを作成する方法を示しています。

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

各バーコードシンボルには、それぞれ固有の特徴と用途があります。 EAN-13とUPC-Aは、数値のみの入力を必要とし、小売スキャニング精度のために自動的にチェックディジットを計算します。 DataMatrixは、電子部品や医薬品のトラッキングに最適な最小スペースに大量のデータをエンコードできます。 PDF417は、組み込みのエラー訂正機能を備え、大容量のデータ保存をサポートしており、輸送書類や身分証明書などで一般的に使用されています。

このライブラリは、入力データをフォーマット要件に照らし合わせて自動的に検証し、無効な入力に対しては分かりやすい例外をスローします。 この検証により、生成されたバーコードが国際ISO規格に準拠し、小売業や物流業で使用される市販のバーコードリーダーで確実に読み取れることが保証されます。 ご自身の用途に最適なバーコード形式の選び方について詳しくはこちらをご覧ください。

モバイルUI用のバーコードをカスタマイズしてエクスポートするにはどうすればよいですか？

IronBarcodeは、Xamarinアプリケーションの視覚的な要件に合わせて、豊富なカスタマイズオプションを提供します。 以下の例は、色を適用し、テキスト注釈を追加し、プラットフォーム固有のファイル場所に保存する方法を示しています。

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

スタイリング方法を使えば、モバイルインターフェースにおけるバーコードの外観を完全に制御できます。 色は、アプリのテーマに合わせてRGB値または事前定義の色定数を使用して指定できます。 SetMargins() メソッドはバーコードの周囲にパディングを追加し、バーコードが画像の端付近に配置された場合に発生するスキャン上の問題を防止します。

クロスプラットフォームのXamarin開発におけるファイル処理には、プラットフォームの認識が不可欠です。 iOSアプリは、ドキュメントディレクトリまたはフォトライブラリに保存する必要があります。 Androidアプリは通常、外部ストレージディレクトリまたはアプリケーションの内部データディレクトリを使用します。 このライブラリは、主要な画像フォーマット(PNG、JPEG、GIF、TIFF、BMP)にPlus、ドキュメント統合用のPDFにも対応しています。 より複雑なシナリオについては、バーコードエクスポートに関するドキュメントを参照して、追加の出力オプションを確認してください。

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

Xamarinでバーコードスキャンを処理するにはどうすればいいですか？

この記事ではバーコードの生成に焦点を当てていますが、多くのXamarinアプリケーションでは、デバイスのカメラからバーコードを読み取る必要もあります。 IronBarcodeには、バーコード生成APIと同様にシンプルなバーコード読み取りAPIが搭載されています。 IronBarcodeバーコードリーダーのドキュメントには、複数バーコードの検出やフォーマットフィルタリングなど、読み取りワークフロー全体が網羅されています。

バーコードの生成とスキャン両方を行う Xamarin アプリケーション (たとえば、倉庫の受入アプリケーション) の場合、BarcodeWriter クラスと BarcodeReader クラスを同じプロジェクトに組み合わせることができます。 どちらのAPIも同じNuGetパッケージから動作し、追加の依存関係はありません。 IronBarcodeの完全なサンプルギャラリーには、この組み合わせたアプローチを示すスキャンと生成のワークフローが含まれています。

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

次のステップは何ですか?

IronBarcodeは、Xamarinアプリケーションにおけるバーコード生成を、複雑でプラットフォーム固有の課題から、わずか数行のC#コードへと変革します。 モバイル注文フロー用のQRコード、倉庫ラベル用のコード 128、小売製品用のEAN-13など、どのようなニーズにも対応できるよう、このライブラリはAndroidとiOSで同じように動作する単一のAPIを提供します。また、 ASP.NET、デスクトップ、サーバー環境でも同様に優れた性能を発揮します。

ここで学んだことをさらに深めるには、以下のリソースを活用してください。

IronBarcodeをダウンロードして無料トライアルを開始しましょう。クレジットカードなしで30日間すべての機能を評価できます。 -IronBarcodeチュートリアル集-- スキャン、バッチ生成、PDF統合に関するステップバイステップガイド

• IronBarcodeのサンプルギャラリー-- 40種類以上の一般的なバーコードタスクに対応したコピー＆ペースト可能なコードサンプル -ライセンスと価格設定- モバイル展開向けのシングル開発者、チーム、およびSaaSライセンスオプション
• .NET MAUI移行ガイド-- Xamarinプロジェクトを最新 for .NETモバイルスタックに移行する場合、 IronBarcodeはコード変更なしで両方の環境で動作します。

まずNuGetパッケージをインストールし、上記の最初の例を実行して、環境が正しく設定されていることを確認してください。 そこから先は、この記事に掲載されているフォーマット比較表とカスタマイズ例を参照することで、バーコード出力をアプリケーションの要件に合わせて正確に調整するために必要なすべての情報が得られます。