IronBarcode 開始使用 在安卓設備上設定 How to Read and Write Barcode on Android in .NET MAUI Curtis Chau 更新日期:6月 29, 2025 Download IronBarcode NuGet 下載 DLL 下載 Start Free Trial Copy for LLMs Copy for LLMs Copy page as Markdown for LLMs Open in ChatGPT Ask ChatGPT about this page Open in Gemini Ask Gemini about this page Open in Grok Ask Grok about this page Open in Perplexity Ask Perplexity about this page Share Share on Facebook Share on X (Twitter) Share on LinkedIn Copy URL Email article This article was translated from English: Does it need improvement? Translated View the article in English class="container-fluid"> class="row"> class="col-md-2"> .NET MAUI(多平台應用程式 UI)是 Xamarin.Forms 的繼任者,使開發人員能夠使用 .NET 建立 Android、iOS、macOS 和 Windows 的跨平台應用程式。 它簡化了開發過程,允許創建在多個平台上無縫運作的原生使用者介面。 BarCode.Android套件將條碼支持帶到 Android! class="hsg-featured-snippet"> 如何在 .NET MAUI 上讀取和寫入 Android 上的條碼 下載 C# 庫以在 Android 上讀取和寫入條碼 創建 .NET MAUI 應用程式項目 編輯 XAML 文件以添加激活按鈕並顯示輸出文字 編輯相應的 C# 文件以處理條碼識別 下載範例項目以快速入門 IronBarcode Android 套件 BarCode.Android套件透過 .NET 跨平台項目在 Android 設備上實現條碼功能。 不需要原始的 BarCode 套件。 Install-Package BarCode.Android class="products-download-section"> data-modal-id="trial-license-after-download"> class="product-image"> class="product-info"> 使用 NuGet 安裝 class="copy-nuget-row"> Install-Package BarCode.Android class="copy-button"> class="nuget-link">nuget.org/packages/BarCode.Android/ ## 創建 .NET MAUI 項目 打開 Visual Studio 並點擊 "創建新項目"。 搜索 MAUI,選擇 .NET MAUI 應用程式並點擊 "下一步"。 包含 BarCode.Android 庫 可以通過多種方式添加該庫。 最簡單的可能是使用 NuGet。 在 Visual Studio 中,右鍵點擊 "Dependencies" 並選擇 "管理 NuGet 套件..."。 選擇 "瀏覽" 標籤,搜索 "BarCode.Android"。 選擇 "BarCode.Android" 套件並點擊 "安裝"。 為了避免與其他平台的問題,修改 csproj 文件以便僅在針對 Android 平台時包含該套件。 要做到這一點: 右鍵點擊項目的 *.csproj 文件並選擇 "編輯專案文件"。 創建一個新的 ItemGroup 元素,如下所示: <ItemGroup Condition="$(TargetFramework.Contains('android')) == true"> <PackageReference Include="BarCode.Android" Version="2025.3.4" /> </ItemGroup> <ItemGroup Condition="$(TargetFramework.Contains('android')) == true"> <PackageReference Include="BarCode.Android" Version="2025.3.4" /> </ItemGroup> XML 將 "BarCode.Android" PackageReference 移動到我們剛剛創建的 ItemGroup 內。 以上步驟將防止 "BarCode.Android" 包在 iOS 等平台上被使用。 為此目的,請安裝BarCode.iOS。 配置 Android 捆綁包 為了使 Android 工作,需要配置 Android 捆綁包設置。 在您的“.csproj”文件中,添加以下條目以指定 Android 捆綁包的配置文件: <AndroidBundleConfigurationFile>BundleConfig.json</AndroidBundleConfigurationFile> <AndroidBundleConfigurationFile>BundleConfig.json</AndroidBundleConfigurationFile> XML 在項目的根目錄中創建一個名為“BundleConfig.json”的文件。 該 JSON 文件包含了 Android 捆綁包所需的設置,這對於庫的功能至關重要。 { "optimizations": { "uncompress_native_libraries": {} } } 該配置確保本機庫未壓縮,這是使庫在 Android 環境中正常運行情況的一個必要步驟。 設計應用程式介面 更新 XAML 文件,以允許用戶輸入生成條碼和 QR 碼的值。 另外,添加一個按鈕,以選擇用於條碼閱讀的文件。 這是一個示例: <?xml version="1.0" encoding="utf-8" ?> <ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui" xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml" x:Class="IronBarcodeMauiAndroid.MainPage"> <VerticalStackLayout Padding="20"> <HorizontalStackLayout> <CheckBox x:Name="generatePdfCheckBox" IsChecked="{Binding IsGeneratePdfChecked}" /> <Label Text="PDF (unchecked for PNG)" VerticalOptions="Center"/> </HorizontalStackLayout> <Entry x:Name="barcodeInput" Placeholder="Enter barcode value..." /> <Button Text="Generate and save barcode" Clicked="WriteBarcode" /> <Entry x:Name="qrInput" Placeholder="Enter QR code value..." /> <Button Text="Generate and save QR code" Clicked="WriteQRcode" /> <Button Text="Read Barcode" Clicked="ReadBarcode" Grid.Row="0" HorizontalOptions="Center" Margin="20, 20, 20, 10"/> <ScrollView Grid.Row="1" BackgroundColor="LightGray" Padding="10" Margin="10, 10, 10, 30"> <Label x:Name="OutputText"/> </ScrollView> </VerticalStackLayout> </ContentPage> <?xml version="1.0" encoding="utf-8" ?> <ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui" xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml" x:Class="IronBarcodeMauiAndroid.MainPage"> <VerticalStackLayout Padding="20"> <HorizontalStackLayout> <CheckBox x:Name="generatePdfCheckBox" IsChecked="{Binding IsGeneratePdfChecked}" /> <Label Text="PDF (unchecked for PNG)" VerticalOptions="Center"/> </HorizontalStackLayout> <Entry x:Name="barcodeInput" Placeholder="Enter barcode value..." /> <Button Text="Generate and save barcode" Clicked="WriteBarcode" /> <Entry x:Name="qrInput" Placeholder="Enter QR code value..." /> <Button Text="Generate and save QR code" Clicked="WriteQRcode" /> <Button Text="Read Barcode" Clicked="ReadBarcode" Grid.Row="0" HorizontalOptions="Center" Margin="20, 20, 20, 10"/> <ScrollView Grid.Row="1" BackgroundColor="LightGray" Padding="10" Margin="10, 10, 10, 30"> <Label x:Name="OutputText"/> </ScrollView> </VerticalStackLayout> </ContentPage> XML 讀取和寫入條碼 從上述 MainPage.xaml 代碼中,我們可以看到該復選框決定生成的條碼和 QR 碼是否應為 PDF 格式。 接下來,我們設置 授權密鑰。 請在此步驟中使用試用授權密鑰或付費授權密鑰。 代碼檢查並檢索barcodeInput變數中的值,然後使用CreateBarcode方法生成條碼。 最後,它調用SaveToDownloadsAsync方法,這可以在 Android 和 iOS 上正確保存文件。 在 iOS 上,需要自定義文件路徑以將文檔導出到Files應用程序中。 using IronBarCode; using System; using System.IO; using System.Threading.Tasks; using Xamarin.Essentials; namespace IronBarcodeMauiAndroid { public partial class MainPage : ContentPage { public bool IsGeneratePdfChecked { get => generatePdfCheckBox.IsChecked; set { generatePdfCheckBox.IsChecked = value; } } public MainPage() { InitializeComponent(); // Set the license key for IronBarcode, replace with your actual license key. License.LicenseKey = "IRONBARCODE-MYLICENSE-KEY-1EF01"; } private async void WriteBarcode(object sender, EventArgs e) { try { if (!string.IsNullOrEmpty(barcodeInput.Text)) { // Create a barcode from the text input with the EAN13 encoding. var barcode = BarcodeWriter.CreateBarcode(barcodeInput.Text, BarcodeEncoding.EAN13); // Determine the file extension and data format based on the checkbox state. string fileExtension = IsGeneratePdfChecked ? "pdf" : "png"; string fileName = $"Barcode_{DateTime.Now:yyyyMMddHHmmss}.{fileExtension}"; byte[] fileData = IsGeneratePdfChecked ? barcode.ToPdfBinaryData() : barcode.ToPngBinaryData(); // Save the generated barcode to the Downloads folder. await SaveToDownloadsAsync(fileData, fileName); await Application.Current.MainPage.DisplayAlert("Saved", "File saved to Downloads folder", "OK"); } } catch (Exception ex) { // Handle exceptions and log the error. System.Diagnostics.Debug.WriteLine(ex); } } private async void WriteQRcode(object sender, EventArgs e) { try { if (!string.IsNullOrEmpty(qrInput.Text)) { // Create a QR code from the text input. var barcode = QRCodeWriter.CreateQrCode(qrInput.Text); // Determine the file extension and data format based on the checkbox state. string fileExtension = IsGeneratePdfChecked ? "pdf" : "png"; string fileName = $"QRcode_{DateTime.Now:yyyyMMddHHmmss}.{fileExtension}"; byte[] fileData = IsGeneratePdfChecked ? barcode.ToPdfBinaryData() : barcode.ToPngBinaryData(); // Save the generated QR code to the Downloads folder. await SaveToDownloadsAsync(fileData, fileName); await Application.Current.MainPage.DisplayAlert("Saved", "File saved to Downloads folder", "OK"); } } catch (Exception ex) { // Handle exceptions and log the error. System.Diagnostics.Debug.WriteLine(ex); } } private async void ReadBarcode(object sender, EventArgs e) { try { var options = new PickOptions { PickerTitle = "Please select a file" }; var file = await FilePicker.PickAsync(options); OutputText.Text = ""; if (file != null) { using var stream = await file.OpenReadAsync(); BarcodeResults result; if (file.ContentType.Contains("image")) { // Read barcodes from an image file. result = BarcodeReader.Read(stream); } else { // Read barcodes from a PDF file. result = BarcodeReader.ReadPdf(stream); } string barcodeResult = ""; int count = 1; // Retrieve and format the barcode reading results. result.ForEach(x => { barcodeResult += $"Barcode {count}: {x.Value}\n"; count++; }); OutputText.Text = barcodeResult; } } catch (Exception ex) { // Handle exceptions and log the error. System.Diagnostics.Debug.WriteLine(ex); } } public async Task SaveToDownloadsAsync(byte[] fileData, string fileName) { var downloadsPath = Android.OS.Environment.GetExternalStoragePublicDirectory(Android.OS.Environment.DirectoryDownloads); var filePath = Path.Combine(downloadsPath.AbsolutePath, fileName); try { // Create the directory if it doesn't exist. if (!Directory.Exists(downloadsPath.AbsolutePath)) { Directory.CreateDirectory(downloadsPath.AbsolutePath); } // Save the file to the Downloads folder. await File.WriteAllBytesAsync(filePath, fileData); } catch (Exception ex) { // Log errors if file saving fails. System.Diagnostics.Debug.WriteLine("Error saving file: " + ex.Message); } } } } using IronBarCode; using System; using System.IO; using System.Threading.Tasks; using Xamarin.Essentials; namespace IronBarcodeMauiAndroid { public partial class MainPage : ContentPage { public bool IsGeneratePdfChecked { get => generatePdfCheckBox.IsChecked; set { generatePdfCheckBox.IsChecked = value; } } public MainPage() { InitializeComponent(); // Set the license key for IronBarcode, replace with your actual license key. License.LicenseKey = "IRONBARCODE-MYLICENSE-KEY-1EF01"; } private async void WriteBarcode(object sender, EventArgs e) { try { if (!string.IsNullOrEmpty(barcodeInput.Text)) { // Create a barcode from the text input with the EAN13 encoding. var barcode = BarcodeWriter.CreateBarcode(barcodeInput.Text, BarcodeEncoding.EAN13); // Determine the file extension and data format based on the checkbox state. string fileExtension = IsGeneratePdfChecked ? "pdf" : "png"; string fileName = $"Barcode_{DateTime.Now:yyyyMMddHHmmss}.{fileExtension}"; byte[] fileData = IsGeneratePdfChecked ? barcode.ToPdfBinaryData() : barcode.ToPngBinaryData(); // Save the generated barcode to the Downloads folder. await SaveToDownloadsAsync(fileData, fileName); await Application.Current.MainPage.DisplayAlert("Saved", "File saved to Downloads folder", "OK"); } } catch (Exception ex) { // Handle exceptions and log the error. System.Diagnostics.Debug.WriteLine(ex); } } private async void WriteQRcode(object sender, EventArgs e) { try { if (!string.IsNullOrEmpty(qrInput.Text)) { // Create a QR code from the text input. var barcode = QRCodeWriter.CreateQrCode(qrInput.Text); // Determine the file extension and data format based on the checkbox state. string fileExtension = IsGeneratePdfChecked ? "pdf" : "png"; string fileName = $"QRcode_{DateTime.Now:yyyyMMddHHmmss}.{fileExtension}"; byte[] fileData = IsGeneratePdfChecked ? barcode.ToPdfBinaryData() : barcode.ToPngBinaryData(); // Save the generated QR code to the Downloads folder. await SaveToDownloadsAsync(fileData, fileName); await Application.Current.MainPage.DisplayAlert("Saved", "File saved to Downloads folder", "OK"); } } catch (Exception ex) { // Handle exceptions and log the error. System.Diagnostics.Debug.WriteLine(ex); } } private async void ReadBarcode(object sender, EventArgs e) { try { var options = new PickOptions { PickerTitle = "Please select a file" }; var file = await FilePicker.PickAsync(options); OutputText.Text = ""; if (file != null) { using var stream = await file.OpenReadAsync(); BarcodeResults result; if (file.ContentType.Contains("image")) { // Read barcodes from an image file. result = BarcodeReader.Read(stream); } else { // Read barcodes from a PDF file. result = BarcodeReader.ReadPdf(stream); } string barcodeResult = ""; int count = 1; // Retrieve and format the barcode reading results. result.ForEach(x => { barcodeResult += $"Barcode {count}: {x.Value}\n"; count++; }); OutputText.Text = barcodeResult; } } catch (Exception ex) { // Handle exceptions and log the error. System.Diagnostics.Debug.WriteLine(ex); } } public async Task SaveToDownloadsAsync(byte[] fileData, string fileName) { var downloadsPath = Android.OS.Environment.GetExternalStoragePublicDirectory(Android.OS.Environment.DirectoryDownloads); var filePath = Path.Combine(downloadsPath.AbsolutePath, fileName); try { // Create the directory if it doesn't exist. if (!Directory.Exists(downloadsPath.AbsolutePath)) { Directory.CreateDirectory(downloadsPath.AbsolutePath); } // Save the file to the Downloads folder. await File.WriteAllBytesAsync(filePath, fileData); } catch (Exception ex) { // Log errors if file saving fails. System.Diagnostics.Debug.WriteLine("Error saving file: " + ex.Message); } } } } Imports Microsoft.VisualBasic Imports IronBarCode Imports System Imports System.IO Imports System.Threading.Tasks Imports Xamarin.Essentials Namespace IronBarcodeMauiAndroid Partial Public Class MainPage Inherits ContentPage Public Property IsGeneratePdfChecked() As Boolean Get Return generatePdfCheckBox.IsChecked End Get Set(ByVal value As Boolean) generatePdfCheckBox.IsChecked = value End Set End Property Public Sub New() InitializeComponent() ' Set the license key for IronBarcode, replace with your actual license key. License.LicenseKey = "IRONBARCODE-MYLICENSE-KEY-1EF01" End Sub Private Async Sub WriteBarcode(ByVal sender As Object, ByVal e As EventArgs) Try If Not String.IsNullOrEmpty(barcodeInput.Text) Then ' Create a barcode from the text input with the EAN13 encoding. Dim barcode = BarcodeWriter.CreateBarcode(barcodeInput.Text, BarcodeEncoding.EAN13) ' Determine the file extension and data format based on the checkbox state. Dim fileExtension As String = If(IsGeneratePdfChecked, "pdf", "png") Dim fileName As String = $"Barcode_{DateTime.Now:yyyyMMddHHmmss}.{fileExtension}" Dim fileData() As Byte = If(IsGeneratePdfChecked, barcode.ToPdfBinaryData(), barcode.ToPngBinaryData()) ' Save the generated barcode to the Downloads folder. Await SaveToDownloadsAsync(fileData, fileName) Await Application.Current.MainPage.DisplayAlert("Saved", "File saved to Downloads folder", "OK") End If Catch ex As Exception ' Handle exceptions and log the error. System.Diagnostics.Debug.WriteLine(ex) End Try End Sub Private Async Sub WriteQRcode(ByVal sender As Object, ByVal e As EventArgs) Try If Not String.IsNullOrEmpty(qrInput.Text) Then ' Create a QR code from the text input. Dim barcode = QRCodeWriter.CreateQrCode(qrInput.Text) ' Determine the file extension and data format based on the checkbox state. Dim fileExtension As String = If(IsGeneratePdfChecked, "pdf", "png") Dim fileName As String = $"QRcode_{DateTime.Now:yyyyMMddHHmmss}.{fileExtension}" Dim fileData() As Byte = If(IsGeneratePdfChecked, barcode.ToPdfBinaryData(), barcode.ToPngBinaryData()) ' Save the generated QR code to the Downloads folder. Await SaveToDownloadsAsync(fileData, fileName) Await Application.Current.MainPage.DisplayAlert("Saved", "File saved to Downloads folder", "OK") End If Catch ex As Exception ' Handle exceptions and log the error. System.Diagnostics.Debug.WriteLine(ex) End Try End Sub Private Async Sub ReadBarcode(ByVal sender As Object, ByVal e As EventArgs) Try Dim options = New PickOptions With {.PickerTitle = "Please select a file"} Dim file = Await FilePicker.PickAsync(options) OutputText.Text = "" If file IsNot Nothing Then Dim stream = Await file.OpenReadAsync() Dim result As BarcodeResults If file.ContentType.Contains("image") Then ' Read barcodes from an image file. result = BarcodeReader.Read(stream) Else ' Read barcodes from a PDF file. result = BarcodeReader.ReadPdf(stream) End If Dim barcodeResult As String = "" Dim count As Integer = 1 ' Retrieve and format the barcode reading results. result.ForEach(Sub(x) barcodeResult &= $"Barcode {count}: {x.Value}" & vbLf count += 1 End Sub) OutputText.Text = barcodeResult End If Catch ex As Exception ' Handle exceptions and log the error. System.Diagnostics.Debug.WriteLine(ex) End Try End Sub Public Async Function SaveToDownloadsAsync(ByVal fileData() As Byte, ByVal fileName As String) As Task Dim downloadsPath = Android.OS.Environment.GetExternalStoragePublicDirectory(Android.OS.Environment.DirectoryDownloads) Dim filePath = Path.Combine(downloadsPath.AbsolutePath, fileName) Try ' Create the directory if it doesn't exist. If Not Directory.Exists(downloadsPath.AbsolutePath) Then Directory.CreateDirectory(downloadsPath.AbsolutePath) End If ' Save the file to the Downloads folder. Await File.WriteAllBytesAsync(filePath, fileData) Catch ex As Exception ' Log errors if file saving fails. System.Diagnostics.Debug.WriteLine("Error saving file: " & ex.Message) End Try End Function End Class End Namespace $vbLabelText $csharpLabel 運行項目 這將向您展示如何運行該項目並使用條碼功能。 下載 .NET MAUI 應用程式項目 您可以下載此指南的完整代碼。 它來作為一個壓縮文件,您可以在 Visual Studio 中打開它作為 .NET MAUI 應用程式項目。 點擊這裡下載項目。 常見問題解答 如何在適用於 Android 的 .NET MAUI 應用程式中建立和掃描條碼? 您可以在 .NET MAUI 專案中使用 BarCode.Android 套件來建立和掃描 Android 裝置上的條碼。這需要在 Visual Studio 中透過 NuGet 設定該套件,並使用提供的WriteBarcode和ReadBarcode等方法實現條碼功能。 在 .NET MAUI 專案中為 Android 設定條碼功能需要哪些步驟? 若要在 .NET MAUI 專案中設定條碼功能,請使用 NuGet 安裝 BarCode.Android 套件,請配置 .csproj 檔案以有條件地包含 Android 套件,並確保透過 BundleConfig.json 檔案配置 Android 套件。 如何配置 .csproj 文件,使其僅在 Android 系統上啟用條碼功能? 編輯 .csproj 文件,新增以下內容:並指定目標平台為 Android。將 BarCode.Android 套件包含在此群組中,以確保條碼功能僅為 Android 版本新增。 在 Android 專案中使用 BundleConfig.json 檔案的目的為何? BundleConfig.json 檔案用於配置 Android 軟體包設置,確保原生庫未被壓縮。這對於條碼庫在 Android 裝置上正常運作至關重要。 如何在.NET MAUI應用程式中設計條碼操作介面? 使用 XAML 設計應用程式介面,使用戶能夠輸入資料以產生條碼和二維碼。介面應包含用於選擇要從中讀取條碼的文件以及產生、儲存和掃描條碼的按鈕。 在 C# 中,應用程式中使用哪些方法來產生和讀取條碼? 在 .NET MAUI 應用程式中,可以使用WriteBarcode 、 WriteQRcode和ReadBarcode等方法分別產生條碼、建立二維碼和從檔案中讀取條碼。 如何在我的 .NET MAUI 應用程式中測試條碼功能? 在完成專案所需的設定和條碼實現後,您可以透過 Visual Studio 在 Android 裝置或模擬器上執行專案來測試各項功能。 在哪裡可以找到一個完整的、具有條碼功能的.NET MAUI應用程式專案? 您可以從 IronBarcode 網站下載包含條碼功能的完整 .NET MAUI 應用程式專案(壓縮套件格式)。此專案可在 Visual Studio 中開啟,以便進行更深入的探索和自訂。 我的 Android 專案使用條碼庫需要許可證嗎? 是的,在您的專案中使用條碼庫需要試用版或付費版許可證金鑰。您需要在 MainPage 建構函數中輸入此金鑰以啟動庫的功能。 Curtis Chau 立即與工程團隊聊天 技術作家 Curtis Chau 擁有卡爾頓大學計算機科學學士學位,專注於前端開發,擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。除了開發之外,Curtis 對物聯網 (IoT) 有著濃厚的興趣,探索將硬體和軟體結合的創新方式。在閒暇時間,他喜愛遊戲並構建 Discord 機器人,結合科技與創意的樂趣。 準備好開始了嗎? Nuget 下載 1,935,276 | 版本: 2025.11 剛剛發布 免費 NuGet 下載 總下載量:1,935,276 查看許可證