Installation
التثبيت
تستعرض هذه الصفحة عملية التثبيت Aspose.Words FOSS لـ .NET عبر NuGet، أو بنائه من المصدر والإشارة إليه في مشروعك الخاص بـ .NET.
المتطلبات المسبقة
| المتطلبات | التفاصيل |
|---|---|
| .NET SDK | أي SDK يمكنه استهداف .NET Standard 2.0 — .NET Framework 4.6.2+، .NET 6، .NET 8، أو .NET 10 |
| Git | مطلوب لاستنساخ مستودع المصدر |
| OS | Windows, Linux، أو macOS |
| Dependencies | لا شيء — pure managed C#, لا تبعيات أصلية |
1. تثبيت المكتبة
الخيار أ: NuGet (مُوصى به)
dotnet add package Aspose.Words.FOSSالخيار ب: بناء من المصدر
استنسخ المستودع وابنِ الحل في إعداد الإصدار:
git clone https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git
cd Aspose.Words-FOSS-for-.NET
dotnet build Aspose.Words.sln -c Release2. الإشارة إلى المكتبة من مشروعك
إذا قمت بالتثبيت عبر NuGet، فإن المكتبة مُشار إليها بالفعل — انتقل إلى تحقق من البناء. إذا قمت بالبناء من المصدر:
أضف مرجع مشروع إلى Aspose.Words.csproj من تطبيقك الخاص، إما عبر مربع حوار إضافة مرجع في بيئة التطوير المتكاملة أو باستخدام سطر أوامر dotnet:
dotnet add reference path/to/Aspose.Words-FOSS-for-.NET/Aspose.Words/Aspose.Words.csprojالمكتبة تستهدف .NET Standard 2.0، لذا تعمل على .NET Framework 4.6.2+ و .NET 6/8/10، على أنظمة Windows و Linux و macOS، دون أي تبعيات أصلية.
3. التحقق من البناء
أنشئ تطبيقًا سطريًا بسيطًا وابنِ مستندًا يحتوي على مخطط لتأكيد حل المرجع وعمل المكتبة بشكل صحيح:
using Aspose.Words;
using Aspose.Words.Drawing.Charts;
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertChart(ChartType.Line, 432, 252);
Chart chart = shape.Chart;
// Delete default generated series.
chart.Series.Clear();
string[] categories = new string[] { "AW Category 1", "AW Category 2", "AW Category 3" };
chart.Series.Add("AW Series 1", categories, new double[] { 4.3, 2.5, 3.5 });
doc.Save("chart.docx");إذا تم إنشاء chart.docx دون أخطاء، فإن البناء والمرجع يعملان بشكل صحيح.
الخطوات التالية
- Quickstart — مثال عملي كامل للبدء
- معلومات الترخيص — تفاصيل رخصة MIT
- دليل المطور — إنشاء المستندات، التحرير، وواجهات برمجة التطبيقات للرسوم البيانية
- الميزات والوظائف — مرجع كامل للميزات مع أمثلة