Cara Membuat Aspose.OCR FOSS for .NET dari Sumber

Aspose.OCR FOSS untuk .NET bersifat sumber terbuka: Anda dapat mengkloning repositori dan membangunnya sendiri kapan saja, terlepas dari kapan paket yang dikompilasi dipublikasikan ke registri paket. Panduan ini menjelaskan proses mengkloning, membangun, menguji, dan merujuk perpustakaan dari sumber menggunakan CLI .NET.

Panduan Langkah-demi-Langkah

Langkah 1: Kloning dan Bangun

dotnet add package Aspose.OCR.FOSS

Membangun semua lima kerangka target (netstandard2.0, net48, net8.0, net9.0, net10.0) memerlukan .NET 10 SDK. Untuk membangun satu target saja, gunakan -f:

dotnet build src/Aspose.Ocr.Foss.csproj -c Release -f net8.0

Langkah 2: Jalankan Suite Pengujian

Jalankan proyek pengujian xUnit lengkap terhadap build yang baru saja Anda hasilkan:

dotnet test Aspose.Ocr.Foss.sln -c Release --no-build

Untuk menjalankan hanya pada satu kerangka target:

dotnet test tests/Aspose.Ocr.Foss.Tests.csproj -c Release -f net8.0

Langkah 3: Referensikan Perpustakaan dari Proyek Anda Sendiri

Cara paling sederhana untuk menggunakan build sumber adalah referensi proyek langsung dari .csproj Anda sendiri:

<ItemGroup>
  <ProjectReference Include="..\Aspose.OCR-FOSS-for-.NET\src\Aspose.Ocr.Foss.csproj" />
</ItemGroup>

using Aspose.OCR;

var api = new AsposeOcr();
using var input = new OcrInput(InputType.SingleImage);
input.Add("scan.png");
Console.WriteLine(api.Recognize(input)[0].RecognitionText);

Langkah 4: (Opsional) Buat Artefak Paket

build-packages.bat menjalankan restore, build, test, dan pack dalam satu langkah dan menulis .nupkg ke artifacts\packages:

build-packages.bat --no-pause

Atau jalankan langkah dotnet pack yang setara secara langsung, setelah build berhasil:

dotnet pack src/Aspose.Ocr.Foss.csproj -c Release --no-build -o artifacts/packages

Ini menghasilkan Aspose.OCR.FOSS.26.10.0.nupkg di artifacts/packages, sebuah file paket mandiri yang dapat Anda salin atau referensikan secara langsung dari proyek lain pada mesin yang sama.

Masalah Umum dan Perbaikan

dotnet build gagal dengan error missing-SDK pada salah satu dari lima framework target. Building net9.0 and net10.0 target memerlukan .NET 10 SDK. Bangun satu target yang didukung dengan -f net8.0 (atau target terpasang lain) jika Anda hanya memiliki SDK yang lebih lama.

Tes gagal atau dilewati pada framework target tertentu. Proyek tes menargetkan net48, net8.0, net9.0, dan net10.0. Jalankan dotnet test tests/Aspose.Ocr.Foss.Tests.csproj -c Release -f net8.0 untuk mengisolasi satu target.

dotnet pack melaporkan yang diharapkan .nupkg tidak dibuat. Pastikan langkah build dan test selesai terlebih dahulu — dotnet pack with --no-build memerlukan build sebelumnya yang berhasil.

Pertanyaan yang Sering Diajukan

Apakah saya perlu paket yang dipublikasikan untuk menggunakan perpustakaan ini?

Tidak. Referensi proyek ke src/Aspose.Ocr.Foss.csproj berfungsi sama seperti referensi paket registri, tanpa harus menunggu langkah publikasi apa pun.

SDK .NET mana yang saya perlukan?

SDK .NET 10 diperlukan untuk membangun semua lima kerangka target (netstandard2.0/net48/net8.0/net9.0/net10.0) dari satu panggilan dotnet build. SDK yang lebih lama masih dapat membangun satu target yang didukung dengan -f.

Apa yang sebenarnya dijalankan oleh build-packages.bat?

Empat langkah secara berurutan: dotnet restore, dotnet build --configuration Release, dotnet test --configuration Release --no-build, dan dotnet pack --no-build menghasilkan Aspose.OCR.FOSS.26.10.0.nupkg di artifacts/packages.