استخدام ترخيص Doconut الخاص بك

لمعرفة كيفية استخدام ترخيص Doconut، اتبع الإرشادات أدناه للمنصات المختلفة لـ .NET.

تثبيت ترخيص Doconut

في هذا القسم، ستتعلم كيفية تثبيت وتفعيل ترخيص Doconut الخاص بك عبر بيئات متعددة، بما في ذلك .NET Framework و .NET Standard/Core و .NET 6. اتبع الخطوات المقدمة لضمان دمج ترخيصك بسلاسة في مشروعك:

.NET Framework

الكشف التلقائي عن الترخيص

يمكن لـ Doconut اكتشاف التراخيص تلقائيًا إذا تم وضعها داخل مجلد bin الخاص بالمشروع.

إضافة ترخيص افتراضي يدوي

إذا كنت تفضل إضافة الترخيص يدويًا، فإن الخيارات التالية متاحة:

إضافة ترخيص عبر مسار الملف

تستخدم هذه الطريقة التحميل الزائد Viewer.DoconutLicense(string licencePath) لإضافة ترخيص عن طريق تحديد مسار ملف الترخيص.

var licensePath = "path/to/your/license.lic";
Viewer.DoconutLicense(licensePath);

إضافة ترخيص عبر تدفق

تستخدم هذه الطريقة التحميل الزائد Viewer.DoconutLicense(Stream licenseStream) لإضافة ترخيص باستخدام تدفق.

using (var licenseStream = new FileStream("path/to/your/license", FileMode.Open))
{
    Viewer.DoconutLicense(licenseStream);
}

إضافة ترخيص عبر مستند XML

تستخدم هذه الطريقة التحميل الزائد Viewer.DoconutLicense(XMLDocument licence) لإضافة ترخيص باستخدام مستند XML.

var xmlDoc = new XmlDocument();
xmlDoc.Load("path/to/your/license.xml");
Viewer.DoconutLicense(xmlDoc);

إضافة ترخيص مكوّن إضافي عبر مسار الملف

تستخدم هذه الطريقة التحميل الزائد Viewer.SetLicensePlugin(string pathPluginLicence) لإضافة ترخيص مكوّن إضافي عن طريق تحديد مسار ملف الترخيص الإضافي.

var pluginLicensePath = "path/to/your/plugin-license.lic";
Viewer.SetLicensePlugin(pluginLicensePath);

إضافة ترخيص مكوّن إضافي عبر تدفق

تستخدم هذه الطريقة التحميل الزائد Viewer.SetLicensePlugin(Stream pluginLicence) لإضافة ترخيص مكوّن إضافي باستخدام تدفق.

using (var pluginLicenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open))
{
    Viewer.SetLicensePlugin(pluginLicenseStream);
}

إضافة ترخيص مكوّن إضافي عبر مستند XML

تستخدم هذه الطريقة التحميل الزائد Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) لإضافة ترخيص مكوّن إضافي باستخدام مستند XML.

var pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
Viewer.SetLicensePlugin(pluginXmlDoc);

.NET Standard/Core و .NET 6 وما فوق

الكشف التلقائي عن الترخيص

يمكن لـ Doconut اكتشاف التراخيص تلقائيًا إذا تم وضعها داخل مجلد wwwroot الخاص بالمشروع.

لتهيئة docViewer مع الكشف التلقائي عن الترخيص، استخدم السطر التالي:

var docViewer = new Viewer(_cache, _accessor);

إضافة ترخيص افتراضي يدوي

يمكنك تحديد مسار ملف ترخيص افتراضي واحد يدويًا عند تهيئة المشاهد.

var licenseFilePath = Path.Combine(_hostingEnvironment.WebRootPath, "path/to/your/license");
var docViewer = new Viewer(_cache, _accessor, licenseFilePath);

إضافة ترخيص عبر تدفق

تستخدم هذه الطريقة التحميل الزائد Viewer.DoconutLicense(Stream licenseStream) لإضافة ترخيص باستخدام تدفق.

using (var licenseStream = new FileStream("path/to/your/license", FileMode.Open))
{
    Viewer.DoconutLicense(licenseStream);
}

إضافة ترخيص عبر مستند XML

تستخدم هذه الطريقة التحميل الزائد Viewer.DoconutLicense(XMLDocument licence) لإضافة ترخيص باستخدام مستند XML.

var xmlDoc = new XmlDocument();
xmlDoc.Load("path/to/your/license.xml");
Viewer.DoconutLicense(xmlDoc);

ترخيصات مكوّن إضافي متعددة افتراضية يدويًا

إذا كنت بحاجة إلى تحديد تراخيص متعددة، يمكنك توفير قائمة بمسارات الملفات لتهيئة المشاهد.

List<string> licenseFilePaths = new List<string>
{
    Path.Combine(_hostingEnvironment.WebRootPath, "Doconut.Viewer.lic"),
    Path.Combine(_hostingEnvironment.WebRootPath, "Doconut.Viewer.Annotation.lic"),
    Path.Combine(_hostingEnvironment.WebRootPath, "Doconut.Viewer.Search.lic")
};
var docViewer = new Viewer(_cache, _accessor, licenseFilePaths);

إضافة ترخيص مكوّن إضافي عبر تدفق

تستخدم هذه الطريقة التحميل الزائد Viewer.SetLicensePlugin(Stream pluginLicence) لإضافة ترخيص مكوّن إضافي باستخدام تدفق.

using (var pluginLicenseStream = new FileStream("path/to/your/plugin-license.lic", FileMode.Open))
{
    Viewer.SetLicensePlugin(pluginLicenseStream);
}

إضافة ترخيص مكوّن إضافي عبر مستند XML

تستخدم هذه الطريقة التحميل الزائد Viewer.SetLicensePlugin(XMLDocument xmlPluginLicence) لإضافة ترخيص مكوّن إضافي باستخدام مستند XML.

var pluginXmlDoc = new XmlDocument();
pluginXmlDoc.Load("path/to/your/plugin-license.xml");
Viewer.SetLicensePlugin(pluginXmlDoc);

حماية ملف الترخيص الخاص بك

لحماية ملف ترخيص Doconut الخاص بك (.lic)، من الضروري اتباع أفضل ممارسات أمان الملفات. احفظ ملف الترخيص في دليل آمن مع وصول مقيد، لضمان أن المستخدمين أو الخدمات المصرح لهم فقط يمكنهم قراءته.