التثبيت
Setup License

إعداد ملف ترخيص لـ Sheetize

الهدف: تحميل ملف ترخيص صالح حتى تقوم مكتبة Sheetize NuGet/DLL بفتح جميع الميزات المتميزة.
الخطوات أدناه تعمل مع أي لغة .NET (C#, VB.NET, C++, F#، إلخ) ومع المشاريع التي تُشير إلى Sheetize إما عبر NuGet أو بإضافة الـ .dll المُجمَّعة مباشرة.

1 – الحصول على ملف الترخيص الخاص بك

المصدر كيفية الحصول عليه
صفحة الشراء حمّل Sheetize.*.lic بعد إتمام عملية الشراء.

مهم: احفظ الملف في موقع للقراءة فقط مُضمَّن في عملية النشر، أو في مجلد آمن بجانب الملف القابل للتنفيذ. لا تُدخل ملف الترخيص في مستودع شفرة عام لتجنب استغلاله.

2 – إضافة ملف الترخيص إلى مشروعك (اختياري)

بيئة التطوير المتكاملة / نظام البناء الخطوات
Visual Studio (أي مشروع .NET) 1️⃣ انقر بزر الفأرة الأيمن على المشروع → Add → Existing Item → اختر Sheetize.(*).lic.
2️⃣ عيّن Build Action إلى Content.
3️⃣ عيّن Copy to Output Directory إلى Copy if newer (أو Copy always).

نصيحة: إذا كان لديك عدة بيئات (dev, test, prod) يمكنك الاحتفاظ بملف ترخيص منفصل لكل مجلد (licenses/dev/, licenses/prod/) ونسخه أثناء البناء باستخدام سمة Condition.

3 – تهيئة Sheetize بملف الترخيص

تتوقع مكتبة Sheetize أن تستدعي LicenseManager.Load(string path) مرة واحدة قبل استخدام أي واجهة برمجة تطبيقات أخرى. فيما يلي مقتطفات بلغات مختلفة.

C# (الأكثر شيوعًا) 

using Sheetize; // Namespace of the library
using System;
using System.IO;

public static class Program
{
    private static void Main()
    {
        // Path is relative to the running EXE's folder (where the file was copied)
        string licensePath = "/path/to/Sheetize.PdfConverter_for_.NET.lic";
        License license = new Sheetize.License();
        license.SetLicense(licensePath);

        // Now you can use premium features
        var loadOptions = new LoadOptions
        {
            InputFile = "/path/to/sample.xlsx"
        };
        var saveOptions = new SpreadsheetSaveOptions
        {
            OutputFile = "/path/to/sample.pdf"
        };
        SpreadsheetConverter.Process(loadOptions, saveOptions);
        // .
    }
}

4 – التحقق من الترخيص أثناء التشغيل

نمط شائع هو فحص ما إذا كان الملف الناتج يُظهر أو لا يُظهر العلامة المائية. إذا تم قراءة ملف الترخيص بشكل صحيح، لن تُظهر العلامة المائية.

أنت جاهز!

  1. أضف ملف Sheetize.*.lic إلى مشروعك وعنِّده ليُنسخ إلى مجلد الإخراج.
  2. استدعِ SetLicense(...) قبل أي استخدام لـ Sheetize.
  3. انشر ملف الترخيص مع ملفات الـ binary الخاصة بك (أو عبر مسار آمن).

بمجرد إكمال هذه الخطوات، ستُفتح جميع قدرات Sheetize المدفوعة – الرسوم المتقدمة، البث عالي الأداء، تشفير متعدد الأوراق، إلخ – بالكامل لمستخدميك، بغض النظر عما إذا كانوا يكتبون بـ C#، VB.NET، C++/CLI أو أي لغة أخرى يدعمها .NET.

برمجة سعيدة!

(*) يختلف هذا النص بحسب الطبعة.