كيفية تثبيت Aspose.PDF for .NET

مكون Aspose.PDF C#

Aspose.PDF هو مكون .NET مصمم لتمكين المطورين من إنشاء مستندات PDF، سواء كانت بسيطة أو معقدة، برمجيًا. يتيح Aspose.PDF for .NET للمطورين إدراج الجداول والرسوم البيانية والصور والروابط والخطوط المخصصة - وأكثر - في مستندات PDF. علاوة على ذلك، من الممكن أيضًا ضغط مستندات PDF. يوفر Aspose.PDF for .NET ميزات أمان ممتازة لتطوير مستندات PDF آمنة. وأبرز ميزة في Aspose.PDF for .NET هي أنه يدعم إنشاء مستندات PDF من خلال واجهة برمجة التطبيقات وأيضًا من قوالب XML.

وصف المنتج

Aspose.PDF for .NET هو مكون قوي من .NET يتيح للمطورين إنشاء مستندات PDF من الصفر دون استخدام Adobe Acrobat. يوفر واجهة برمجة تطبيقات (API) بسيطة وسهلة التعلم والاستخدام.

Aspose.PDF for .NET تم تنفيذه باستخدام C# المدارة ويمكن استخدامه مع أي لغة .NET مثل C# وVB.NET وJ# وغيرها. يمكن دمجه مع أي نوع من التطبيقات سواء كانت تطبيق ويب ASP.NET أو تطبيق Windows.

حتى يتمكن المطورون من البدء بسرعة، يوفر Aspose.PDF for .NET عروض توضيحية كاملة و أمثلة عملية مكتوبة بلغة C#. باستخدام هذه العروض، يمكن للمطورين التعرف بسرعة على الميزات التي يوفرها Aspose.PDF for .NET.

يخلق المكون السريع والخفيف مستندات PDF بكفاءة ويساعد تطبيقك على الأداء بشكل أفضل. Aspose.PDF for .NET هو الخيار الأول لعملائنا عند إنشاء مستندات PDF بسبب سعره وأدائه الرائع ودعمه الكبير.

Aspose.PDF for .NET آمن متعدد الخيوط طالما أن خيطًا واحدًا فقط يعمل على مستند في وقت واحد. من الشائع أن يكون هناك خيط واحد يعمل على مستند واحد. يمكن أن تعمل خيوط مختلفة بأمان على مستندات مختلفة في نفس الوقت.

الإعلان

تتطلب جميع مكونات Aspose .NET مجموعة أذونات الثقة الكاملة. السبب هو أن مكونات Aspose .NET تحتاج إلى الوصول إلى إعدادات السجل وملفات النظام بخلاف الدليل الافتراضي لبعض العمليات مثل تحليل الخطوط وما إلى ذلك. علاوة على ذلك، تعتمد مكونات Aspose .NET على فئات النظام الأساسية .NET التي تتطلب أيضًا مجموعة أذونات الثقة الكاملة في العديد من الحالات.

تفرض مزودات خدمة الإنترنت التي تستضيف تطبيقات متعددة من شركات مختلفة غالبًا مستوى أمان الثقة المتوسطة. في حالة .NET 2.0، ينطبق هذا المستوى من الأمان القيود التالية:

• OleDbPermission غير متاح. هذا يعني أنك لا تستطيع استخدام موفر بيانات OLE DB المدارة ADO.NET للوصول إلى قواعد البيانات.
• EventLogPermission غير متاح. هذا يعني أنك لا تستطيع الوصول إلى سجل أحداث Windows.
• ReflectionPermission غير متاح. هذا يعني أنك لا تستطيع استخدام الانعكاس.
• RegistryPermission غير متاح. هذا يعني أنك لا تستطيع الوصول إلى السجل.
• WebPermission مقيد. هذا يعني أن تطبيقك يمكنه فقط التواصل مع عنوان أو نطاق من العناوين التي تحددها في عنصر <trust>.
• FileIOPermission مقيد. هذا يعني أنك تستطيع فقط الوصول إلى الملفات في تسلسل الدليل الافتراضي لتطبيقك. بسبب الأسباب المذكورة أعلاه، لا يمكن استخدام مكونات Aspose .NET على الخوادم التي تمنح مجموعة أذونات غير الثقة الكاملة.

التثبيت

تقييم Aspose.PDF for .NET

يمكنك بسهولة تنزيل Aspose.PDF for .NET للتقييم. تنزيل التقييم هو نفسه تنزيل الشراء. يصبح إصدار التقييم مرخصًا ببساطة عندما تضيف بعض الأسطر من التعليمات البرمجية لتطبيق الترخيص.

يوفر إصدار التقييم من Aspose.PDF (بدون ترخيص محدد) الوظائف الكاملة للمنتج. ومع ذلك، لديه قيودان: يقوم بإدراج علامة مائية للتقييم، ويمكن عرض/تعديل أول أربع صفحات فقط من أي مستند.

إذا كنت ترغب في اختبار Aspose.PDF for .NET دون قيود إصدار التقييم، يمكنك أيضًا طلب ترخيص مؤقت لمدة 30 يومًا. يرجى الرجوع إلى كيفية الحصول على ترخيص مؤقت؟

تثبيت Aspose.PDF for .NET من خلال NuGet

NuGet هو نظام إدارة حزم مفتوح المصدر ومجاني يركز على المطورين لمنصة .NET يهدف إلى تبسيط عملية دمج المكتبات الخارجية في تطبيق .NET أثناء التطوير. إنه ملحق لـ Visual Studio يسهل إضافة وإزالة وتحديث المكتبات والأدوات في مشاريع Visual Studio التي تستخدم إطار عمل .NET. يمكن مشاركة مكتبة أو أداة بسهولة مع مطورين آخرين من خلال إنشاء حزمة NuGet وتخزينها داخل مستودع NuGet. عند تثبيت الحزمة، يقوم NuGet بنسخ الملفات إلى الحل الخاص بك ويجري التغييرات اللازمة تلقائيًا، مثل إضافة المراجع وتغيير ملفات app.config أو web.config الخاصة بك. إذا قررت إزالة المكتبة، يقوم NuGet بإزالة الملفات ويعكس أي تغييرات أجراها على مشروعك بحيث لا يتبقى أي فوضى.

الإشارة إلى Aspose.PDF for .NET

تثبيت الحزمة باستخدام وحدة تحكم إدارة الحزم

• افتح تطبيق .NET الخاص بك في Visual Studio.
• من قائمة الأدوات، اختر مدير حزم NuGet ثم وحدة تحكم إدارة الحزم.
• اكتب الأمر Install-Package Aspose.PDF لتثبيت أحدث إصدار كامل، أو اكتب الأمر Install-Package Aspose.PDF -prerelease لتثبيت أحدث إصدار بما في ذلك الإصلاحات العاجلة.
• اضغط على Enter.

تحديث الحزمة باستخدام وحدة تحكم إدارة الحزم

إذا كنت قد أشرت بالفعل إلى المكون من خلال NuGet، فاتبع هذه الخطوات لتحديث الإشارة إلى أحدث إصدار:

• افتح تطبيق .NET الخاص بك في Visual Studio.
• من قائمة الأدوات، اختر مدير حزم NuGet ثم وحدة تحكم إدارة الحزم.
• اكتب الأمر Update-Package Aspose.PDF للإشارة إلى أحدث إصدار كامل، أو اكتب الأمر Update-Package Aspose.PDF -prerelease لتثبيت أحدث إصدار بما في ذلك الإصلاحات العاجلة.

تثبيت الحزمة باستخدام واجهة مستخدم إدارة الحزم

اتبع هذه الخطوات للإشارة إلى المكون باستخدام واجهة مستخدم إدارة الحزم:

• افتح تطبيق .NET الخاص بك في Visual Studio.

• من قائمة المشروع اختر إدارة حزم NuGet.

• اختر علامة Broswe.

• اكتب Aspose.PDF في مربع البحث للعثور على Aspose.PDF for .NET.

• انقر على تثبيت/تحديث بجوار أحدث إصدار من Aspose.PDF for .NET.

• ثم انقر على قبول في نافذة المنبثقة.

العمل مع مكتبات .NET Core في بيئة غير ويندوز

نظرًا لأن Aspose.PDF for .NET يوفر دعم .NET Standard 2.0 (.NET Core 2.0)، يمكن استخدامه في التطبيقات الأساسية التي تعمل في أنظمة تشغيل تشبه لينكس. نحن نعمل باستمرار على تحسين دعم .NET Core في واجهة برمجة التطبيقات الخاصة بنا. ومع ذلك، هناك بعض العمليات التالية التي نوصي عملائنا بتنفيذها، من أجل الحصول على نتائج أفضل أثناء استخدام ميزات Aspose.PDF for .NET:

يرجى تثبيت:

• حزمة libgdiplus
• حزمة مع الخطوط المتوافقة مع Microsoft: ttf-mscorefonts-installer. (على سبيل المثال، sudo apt-get install ttf-mscorefonts-installer) يجب وضع هذه الخطوط في دليل “/usr/share/fonts/truetype/msttcorefonts” حيث يقوم Aspose.PDF for .NET بفحص هذا المجلد على أنظمة التشغيل الشبيهة بلينكس. في حالة وجود مجلد/دليل افتراضي آخر للخطوط في نظام التشغيل، يجب عليك استخدام السطر التالي من التعليمات البرمجية قبل إجراء أي عملية باستخدام Aspose.PDF.

Aspose.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<user's path to ms fonts>"));

إعداد Aspose.PDF for .NET في Visual Studio Code

• تثبيت .NET SDK

1. زيارة الموقع الرسمي Microsoft .NET.
2. تنزيل أحدث إصدار من .NET SDK.
3. تشغيل المثبت.
4. افتح Terminal وتحقق من التثبيت عن طريق تشغيل:

dotnet --version

• تثبيت Visual Studio Code

1. انتقل إلى https://code.visualstudio.com/.
2. قم بتنزيل الإصدار المناسب لنظام التشغيل الخاص بك.

• تثبيت ملحقات VS Code المطلوبة

1. افتح Visual Studio Code.
2. انقر على أيقونة عرض الملحقات (الأيقونة المربعة في الشريط الجانبي الأيسر).
3. ابحث عن وقم بتثبيت الملحقات التالية:
   • “C#” من Microsoft
   • “C# Dev Kit” من Microsoft
   • “.NET Core Test Explorer” (اختياري، ولكن موصى به)

• إنشاء مشروع .NET جديد

1. افتح Visual Studio Code
2. انتقل إلى Terminal > New Terminal
3. انتقل إلى دليل المشروع المرغوب

# Create a new console application
dotnet new console -n AsposePDFNetDemo
# Navigate into the project directory
cd AsposePDFNetDemo

• إضافة حزمة NuGet

# Install Aspose.PDF package
dotnet add package Aspose.PDF

• التحقق من تثبيت الحزمة

1. افتح ملف .csproj
2. تأكد من إضافة مرجع حزمة Aspose.PDF:

<ItemGroup>
  <PackageReference Include="Aspose.PDF" Version="x.x.x" />
</ItemGroup>

• إنشاء تكوين تصحيح الأخطاء

1. اضغط على Ctrl+Shift+P (Cmd+Shift+P على Mac).
2. اكتب “>.NET: Generate Assets for Build and Debug”.
3. اختر مشروعك.
4. أنشئ أو عدل .vscode/launch.json:

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": ".NET Core Launch (console)",
            "type": "coreclr",
            "request": "launch",
            "preLaunchTask": "build",
            "program": "${workspaceFolder}/bin/Debug/net7.0/AsposePDFNetDemo.dll",
            "args": [],
            "cwd": "${workspaceFolder}",
            "console": "internalConsole",
            "stopAtEntry": false
        }
    ]
}

• كتابة كود عينة في Program.cs

استبدل محتويات Program.cs بـ:

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
using System;
using Aspose.Pdf;
using Aspose.Pdf.Text;

class Program 
{
    static void Main(string[] args)
    {
        // Activate your license, you can comment out these codelines to use library in Evaluation mode
        var license = new Aspose.Pdf.License();
        license.SetLicense("Aspose.PDF.NET.lic");

        // Create PDF document
        using (var document = new Aspose.Pdf.Document())
        {
            // Add page
            var page = document.Pages.Add();
            
            // Create a text fragment
            var textFragment = new Aspose.Pdf.Text.TextFragment("Hello, Aspose.PDF for .NET!");
            textFragment.Position = new Aspose.Pdf.Text.Position(100, 600);
            
            // Add text to the page
            page.Paragraphs.Add(textFragment);
            
            // Save PDF document
            document.Save("sample.pdf");
        }
    }
}

• بناء وتشغيل

dotnet restore
dotnet build
dotnet run