Cách xây dựng Aspose.OCR FOSS for .NET từ mã nguồn

Aspose.OCR FOSS cho .NET là mã nguồn mở: bạn có thể sao chép kho lưu trữ và tự xây dựng nó bất kỳ lúc nào, độc lập với thời điểm gói đã biên dịch được xuất bản lên registry gói. Hướng dẫn này sẽ hướng qua việc sao chép, xây dựng, kiểm thử, và tham chiếu thư viện từ nguồn bằng cách sử dụng CLI .NET.

Hướng dẫn từng bước

Bước 1: Sao chép và Xây dựng

dotnet add package Aspose.OCR.FOSS

Việc xây dựng tất cả năm framework mục tiêu (netstandard2.0, net48, net8.0, net9.0, net10.0) yêu cầu .NET 10 SDK. Để xây dựng một mục tiêu duy nhất thay thế, hãy sử dụng -f:

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

Bước 2: Chạy bộ kiểm thử

Chạy toàn bộ dự án kiểm thử xUnit đối với bản dựng bạn vừa tạo:

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

Để chạy chỉ trên một framework mục tiêu duy nhất:

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

Bước 3: Tham chiếu Thư viện từ Dự án của riêng bạn

Cách đơn giản nhất để sử dụng bản dựng nguồn là tham chiếu dự án trực tiếp từ .csproj của bạn:

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

Bước 4: (Tùy chọn) Tạo một Package Artifact

build-packages.bat thực hiện khôi phục, xây dựng, kiểm thử và đóng gói trong một bước và ghi một .nupkg vào artifacts\packages:

build-packages.bat --no-pause

Hoặc chạy trực tiếp bước dotnet pack tương đương, sau khi xây dựng thành công:

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

Điều này tạo ra Aspose.OCR.FOSS.26.10.0.nupkg trong artifacts/packages, một tệp gói tự chứa mà bạn có thể sao chép hoặc tham chiếu trực tiếp từ các dự án khác trên cùng máy.

Các vấn đề thường gặp và cách khắc phục

dotnet build bị lỗi thiếu SDK trên một trong năm framework mục tiêu. Building net9.0 and net10.0 targets yêu cầu .NET 10 SDK. Xây dựng một mục tiêu được hỗ trợ duy nhất với -f net8.0 (hoặc một mục tiêu đã cài đặt khác) nếu bạn chỉ có SDK cũ hơn.

Các bài kiểm tra bị lỗi hoặc bị bỏ qua trên một framework mục tiêu nhất định. Dự án kiểm tra nhắm tới net48, net8.0, net9.0, và net10.0. Chạy dotnet test tests/Aspose.Ocr.Foss.Tests.csproj -c Release -f net8.0 để cô lập một mục tiêu duy nhất.

dotnet pack báo cáo như mong đợi .nupkg không được tạo ra. Xác nhận các bước xây dựng và kiểm tra đã hoàn thành trước tiên — dotnet pack with --no-build yêu cầu một bản dựng trước thành công.

Câu hỏi thường gặp

Tôi có cần một gói đã được công bố để sử dụng thư viện này không?

Không. Tham chiếu dự án tới src/Aspose.Ocr.Foss.csproj hoạt động tương tự như tham chiếu gói trong registry, mà không cần chờ bước công bố nào.

Tôi cần SDK .NET nào?

SDK .NET 10 được yêu cầu để xây dựng tất cả năm framework mục tiêu (netstandard2.0/net48/net8.0/net9.0/net10.0) từ một lời gọi dotnet build duy nhất. Các SDK trước đây vẫn có thể xây dựng một mục tiêu được hỗ trợ duy nhất với -f.

build-packages.bat thực sự chạy gì?

Bốn bước theo thứ tự: dotnet restore, dotnet build --configuration Release, dotnet test --configuration Release --no-build, và dotnet pack --no-build tạo ra Aspose.OCR.FOSS.26.10.0.nupkg trong artifacts/packages.