Распознавание штрих-кодов в macOS с помощью .NET приложения

Категория: Штрих-коды.NETmacOS

25 декабря 2023

В данной статье рассказывается как создать .NET консольное приложения для распознавания штрих-кодов в изображении в macOS. Для распознавания штрих-кодов в изображении используется VintaSoft Barcode .NET SDK.

Для выполнения задачи требуется выполнить следующие шаги:
  1. Открыть macOS десктоп.

  2. Создать папку в которой будут храниться файлы .NET приложения. Давайте создадим папку "Recognize_Barcodes_In_Image" на рабочем столе текущего пользователя и перейдем в папку.


  3. Открыть терминал для выполнения консольных команд.


  4. В терминале вызвать команду, которая создаст проект нового .NET консольного приложения:
    dotnet new console --framework net8.0
    



    После выполнения команды в папке появится файл проекта "Recognize_Barcodes_In_Image.csproj" и файл "Program.cs", который содержит C# код приложения. Закрыть терминал.

  5. Открыть файл проекта "Recognize_Barcodes_In_Image.csproj" в текстовом редакторе и изменить текст файла на следующий текст:
    <Project Sdk="Microsoft.NET.Sdk">
    
      <PropertyGroup>
        <OutputType>Exe</OutputType>
        <TargetFramework>net8.0</TargetFramework>
        <RootNamespace>ConsoleApp1</RootNamespace>
        <ImplicitUsings>enable</ImplicitUsings>
        <Nullable>enable</Nullable>
      </PropertyGroup>
    
      <ItemGroup>
        <PackageReference Include="SkiaSharp" Version="2.88.6" />
        <PackageReference Include="SkiaSharp.NativeAssets.macOS" Version="2.88.6" />
        <PackageReference Include="Vintasoft.Barcode" Version="14.2.0.3" />
        <PackageReference Include="Vintasoft.Barcode.SkiaSharp" Version="14.2.0.3" />
        <PackageReference Include="Vintasoft.Shared" Version="4.1.0.3" />
      </ItemGroup>
    
      <ItemGroup>
        <Content Include="AllSupportedBarcodes.png">
          <CopyToOutputDirectory>Always</CopyToOutputDirectory>
        </Content>
      </ItemGroup>
    
    </Project>
    



    Измененный проект ссылается на nuget-пакеты для VintaSoft Barcode .NET SDK (Vintasoft.Shared.dll, Vintasoft.Barcode.dll, Vintasoft.Barcode.SkiaSharp.dll).

  6. Открыть файл "Program.cs" и заменить код в файле на следующий C# код:
    namespace Recognize_Barcodes_In_Image
    {
        class Program
        {
            static void Main(string[] args)
            {
                // register the evaluation license for VintaSoft Barcode .NET SDK
                Vintasoft.Barcode.BarcodeGlobalSettings.Register("%EVAL_LIV_USER_NAME%", "%EVAL_LIC_USER_EMAIL%", "%EVAL_LIC_DATE%", "%EVAL_LIC_REG_CODE%");
    
                // Vintasoft.Barcode.SkiaSharp.dll allows to load bitmap from BMP, DNG, GIF, HEIF, JPEG, PNG, WEBP files using image codecs from SkiaSharp library
                Vintasoft.Barcode.SkiaSharpAssembly.Init();
    
                // recognize barcodes from image file
                RecognizeBarcodesFromImage("AllSupportedBarcodes.png");
            }
    
            /// <summary>
            /// Recognizes barcodes from an image file.
            /// </summary>
            /// <param name="filename">A path to an image file.</param>
            public static void RecognizeBarcodesFromImage(string filename)
            {
                // create barcode reader
                using (Vintasoft.Barcode.BarcodeReader reader = new Vintasoft.Barcode.BarcodeReader())
                {
                    // specify that reader must search for Code39, Code39Extended, Code128, SSCC18 and DataMatrix barcodes
                    reader.Settings.ScanBarcodeTypes =
                        Vintasoft.Barcode.BarcodeType.Code39 |
                        Vintasoft.Barcode.BarcodeType.Code128 |
                        Vintasoft.Barcode.BarcodeType.DataMatrix;
                    reader.Settings.ScanBarcodeSubsets.Add(Vintasoft.Barcode.SymbologySubsets.BarcodeSymbologySubsets.Code39Extended);
                    reader.Settings.ScanBarcodeSubsets.Add(Vintasoft.Barcode.SymbologySubsets.BarcodeSymbologySubsets.SSCC18);
    
                    // specify that reader must search for horizontal and vertical barcodes only
                    reader.Settings.ScanDirection = Vintasoft.Barcode.ScanDirection.Horizontal | Vintasoft.Barcode.ScanDirection.Vertical;
    
                    // use Automatic Recognition
                    reader.Settings.AutomaticRecognition = true;
    
                    // read barcodes from image file
                    Vintasoft.Barcode.IBarcodeInfo[] infos = reader.ReadBarcodes(filename);
    
                    // if barcodes are not detected
                    if (infos.Length == 0)
                    {
                        Console.WriteLine("No barcodes found.");
                    }
                    // if barcodes are detected
                    else
                    {
                        // get information about extracted barcodes
    
                        Console.WriteLine(string.Format("{0} barcodes found:", infos.Length));
                        Console.WriteLine();
                        for (int i = 0; i < infos.Length; i++)
                        {
                            Vintasoft.Barcode.IBarcodeInfo info = infos[i];
                            Console.WriteLine(string.Format("[{0}:{1}]", i + 1, info.BarcodeType));
                            Console.WriteLine(string.Format("Value:      {0}", info.Value));
                            Console.WriteLine(string.Format("Region:     {0}", info.Region));
                            Console.WriteLine();
                        }
                    }
                }
            }
    
        }
    }
    



    Код приложения распознает штрих-коды в изображении и выводит результат в консоль.

  7. Получить код для использования оценочной лицензии в macOS как описано в документации и внедрить полученный код в C# код в файле "Program.cs".


  8. Скопировать файл "AllSupportedBarcodes.png" в папку проекта.


    Вместо файла "AllSupportedBarcodes.png" можно использовать любой другой файл с изображением документа.

  9. Открыть терминал и скомпилировать .NET проект с помощью следующей команды:
    dotnet build Recognize_Barcodes_In_Image.csproj
    



    Закрыть терминал.

  10. Перейти в папку "bin/Debug/net8.0/".


  11. Открыть терминал и запустить созданное .NET приложение с помощью следующей команды:
    dotnet ./Recognize_Barcodes_In_Image.dll
    



    Посмотреть результат распознавания штрих-кодов и закрыть терминал.