Aspose.Slides FOSS
.NET
شروع کار
نصب

نصب

نصب Aspose.Slides FOSS برای .NET

Aspose.Slides FOSS for .NET is distributed as a NuGet package. It targets .NET 9.0 and has no native dependencies: no Microsoft Office or other proprietary runtime required.

پیش‌نیازها

نیازمندیجزئیات
.NET نسخه.NET 9.0 SDK یا بعدی
مدیر بستهNuGet (از طریق dotnet CLI یا Visual Studio)
سیستم عاملWindows، macOS، Linux (هر پلتفرمی که توسط .NET 9.0 پشتیبانی می‌شود)
کامپایلر / ابزارهای ساخت.NET 9.0 SDK (شامل کامپایلر C#)

1. Install via dotnet CLI (Recommended)

ساده‌ترین روش برای نصب Aspose.Slides FOSS از NuGet است:

dotnet add package Aspose.Slides.Foss

NuGet بسته را به همراه وابستگی‌های آن دانلود و نصب می‌کند. نیازی به پیکربندی پس از نصب نیست.

برای نصب نسخهٔ ثابت به منظور ساخت‌های قابل تکرار:

dotnet add package Aspose.Slides.Foss --version 26.3.0

2. Install via Visual Studio

  1. روی پروژه خود در Solution Explorer کلیک راست کنید و انتخاب کنید مدیریت بسته‌های NuGet.
  2. جستجو برای Aspose.Slides.Foss.
  3. کلیک کنید نصب.

3. Install via Package Manager Console 

Install-Package Aspose.Slides.Foss

4. Verify the Installation

پس از نصب، اطمینان حاصل کنید که کتابخانه به‌درستی بارگذاری می‌شود و یک Presentation می‌توان ایجاد کرد:

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
Console.WriteLine("Aspose.Slides FOSS installed successfully");
Console.WriteLine($"Slides in empty presentation: {prs.Slides.Count}");

خروجی مورد انتظار:

Aspose.Slides FOSS installed successfully
Slides in empty presentation: 1

همچنین می‌توانید نسخهٔ نصب‌شده را با dotnet CLI بررسی کنید:

dotnet list package

این دستور نام بسته، نسخه و نسخهٔ حل‌شده را چاپ می‌کند.

شروع سریع: ایجاد یک ارائه با یک شکل

برنامه زیر یک ارائه جدید ایجاد می‌کند، یک مستطیل با متن اضافه می‌کند و آن را به‌عنوان یک .pptx فایل:

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var slide = prs.Slides[0];

// Add a rectangle shape and set its text
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 400, 150);
shape.AddTextFrame("Hello from Aspose.Slides FOSS!");

prs.Save("hello.pptx", SaveFormat.Pptx);
Console.WriteLine("Saved hello.pptx");

مهم: همیشه استفاده کنید Presentation با یک using بیان یا به‌صورت صریح فراخوانی کنید Dispose(). این اطمینان می‌دهد که منابع داخلی به‌درستی پاک‌سازی می‌شوند.

یادداشت‌های پلتفرم

ویندوز، macOS، لینوکس: کتابخانه در تمام پلتفرم‌ها یکسان است. هیچ مسیر کد یا افزونه بومی مخصوص پلتفرم وجود ندارد.

Docker / سرورلس: کتابخانه داخل تصاویر Docker .NET (مانند mcr.microsoft.com/dotnet/sdk:9.0) با dotnet add package Aspose.Slides.Foss. هیچ بسته سیستمی اضافی مورد نیاز نیست.

CI/CD: افزودن dotnet add package Aspose.Slides.Foss به مرحله وابستگی‌های خط لوله CI خود اضافه کنید، یا مرجع بسته را در .csproj فایل. نیازی به تنظیمات اضافی نیست.

منابع اضافی

 فارسی