วิธีสร้าง Aspose.OCR FOSS for .NET จากซอร์ส
Aspose.OCR FOSS สำหรับ .NET เป็นซอร์สเปิด: คุณสามารถโคลนรีโปซิทอรีและสร้างมันด้วยตนเองได้ทุกเวลา โดยไม่ขึ้นกับเวลาที่แพ็กเกจที่คอมไพล์แล้วถูกเผยแพร่ไปยังรีจิสทรีของแพ็กเกจ คู่มือนี้จะอธิบายขั้นตอนการโคลน, การสร้าง, การทดสอบ, และการอ้างอิงไลบรารีจากซอร์สโดยใช้ .NET CLI.
คู่มือขั้นตอนต่อขั้นตอน
ขั้นตอนที่ 1: โคลนและสร้าง
dotnet add package Aspose.OCR.FOSSการสร้างเฟรมเวิร์กเป้าหมายทั้งหมดห้าตัว (netstandard2.0, net48, net8.0, net9.0, net10.0) จำเป็นต้องใช้ .NET 10 SDK. หากต้องการสร้างเป้าหมายเดียวแทน, ใช้ -f:
dotnet build src/Aspose.Ocr.Foss.csproj -c Release -f net8.0ขั้นตอนที่ 2: รันชุดทดสอบ
เรียกใช้โครงการทดสอบ xUnit เต็มรูปแบบกับการสร้างที่คุณเพิ่งสร้าง:
dotnet test Aspose.Ocr.Foss.sln -c Release --no-buildเพื่อเรียกใช้กับกรอบงานเป้าหมายเดียวเท่านั้น:
dotnet test tests/Aspose.Ocr.Foss.Tests.csproj -c Release -f net8.0ขั้นตอนที่ 3: อ้างอิงไลบรารีจากโครงการของคุณเอง
วิธีที่ง่ายที่สุดในการใช้การสร้างจากซอร์สคือการอ้างอิงโครงการโดยตรงจาก .csproj ของคุณเอง:
<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);ขั้นตอนที่ 4: (ไม่บังคับ) สร้าง Package Artifact
build-packages.bat ทำการ restore, build, test, และ pack ในขั้นตอนเดียวและเขียน .nupkg ไปยัง artifacts\packages:
build-packages.bat --no-pauseหรือเรียกใช้ขั้นตอน dotnet pack ที่เทียบเท่าตรงๆ หลังจากการสร้างสำเร็จแล้ว:
dotnet pack src/Aspose.Ocr.Foss.csproj -c Release --no-build -o artifacts/packagesสิ่งนี้จะสร้าง Aspose.OCR.FOSS.26.10.0.nupkg ใน artifacts/packages, ซึ่งเป็นไฟล์แพคเกจแบบอิสระที่คุณสามารถคัดลอกหรืออ้างอิงโดยตรงจากโครงการอื่นบนเครื่องเดียวกันได้.
ปัญหาทั่วไปและวิธีแก้ไข
dotnet build ล้มเหลวด้วยข้อผิดพลาด missing-SDK บนหนึ่งในห้า framework ที่เป็นเป้าหมาย. Building net9.0 and net10.0 targets ต้องการ .NET 10 SDK. สร้างเป้าหมายที่รองรับเพียงหนึ่งด้วย -f net8.0 (หรือเป้าหมายที่ติดตั้งอื่น) หากคุณมี SDK ที่เก่ากว่าเท่านั้น.
การทดสอบล้มเหลวหรือถูกข้ามบน framework เป้าหมายที่กำหนด. โครงการทดสอบมุ่งเป้าไปที่ net48, net8.0, net9.0, และ net10.0. เรียกใช้ dotnet test tests/Aspose.Ocr.Foss.Tests.csproj -c Release -f net8.0 เพื่อแยกเป้าหมายเดียวออกมา.
dotnet pack รายงานตามที่คาดหวัง .nupkg ไม่ได้ถูกสร้างขึ้น. ยืนยันว่าขั้นตอนการสร้างและทดสอบเสร็จสิ้นก่อน — dotnet pack with --no-build ต้องมีการสร้างสำเร็จก่อนหน้า.
คำถามที่พบบ่อย
ฉันต้องมีแพ็กเกจที่เผยแพร่เพื่อใช้ไลบรารีนี้หรือไม่?
ไม่. การอ้างอิงโครงการไปยัง src/Aspose.Ocr.Foss.csproj ทำงานเช่นเดียวกับการอ้างอิงแพ็กเกจจากรีจิสทรี, โดยไม่ต้องรอขั้นตอนการเผยแพร่ใด ๆ.
ฉันต้องการ SDK .NET ตัวใด?
ต้องใช้ SDK .NET 10 เพื่อสร้างทุกเฟรมเวิร์กเป้าหมายทั้งห้า (netstandard2.0/net48/net8.0/net9.0/net10.0) จากการเรียก dotnet build เพียงครั้งเดียว SDK รุ่นก่อนหน้ายังสามารถสร้างเป้าหมายที่รองรับเดียวได้ด้วย -f.
build-packages.bat ทำงานอะไรจริงๆ?
สี่ขั้นตอนตามลำดับ: dotnet restore, dotnet build --configuration Release, dotnet test --configuration Release --no-build และ dotnet pack --no-build ซึ่งสร้าง Aspose.OCR.FOSS.26.10.0.nupkg ใน artifacts/packages.
