إعداد الترخيص
المكان الذي يبحث فيه Doconut عن ملف الترخيص الخاص بك
بدون ترخيص، لا يزال Doconut يعرض المستندات — كل صفحة تحمل علامة مائية للتقييم فقط. تغطي هذه الصفحة الطرق الأربع لتوفير ترخيص، والترتيب الدقيق عندما يتم تعيين أكثر من واحد.
أربع طرق لتوفير ترخيص
هناك أربع: ثلاثة مصادر صريحة على DoconutOptions — تدفق، محتوى خام، أو مسار ملف — بالإضافة إلى الاكتشاف التلقائي عندما لا يتم تعيين أي منها. عندما يتم تعيين أكثر من واحد، يكون الترتيب دقيقًا:
LicenseStream يفوق LicenseContent يفوق LicensePath يفوق البحث التلقائي.
عبر المسار
LicensePath يتم تمريره إلى File.Exists كما هو بالضبط. يتم حل المسار النسبي بالنسبة إلى دليل العمل الحالي للعملية — ليس مجلد مشروعك، ولا المجلد الذي يعيش فيه Program.cs. إذا لم يتم حل المسار، لا يرمي Doconut استثناء ولا يتراجع إلى البحث التلقائي — فهو ببساطة لا يحمل أي ترخيص وتظهر علامة مائية على العارض. يعمل البحث التلقائي فقط عندما لا يتم تعيين أي من LicensePath أو LicenseContent أو LicenseStream. يتم قراءة ملفات الترخيص الخاصة بكل مكوّن إضافي في نفس المجلد (Doconut.Viewer.<Capability>.lic) معها، لذا يعمل LicensePath وAddPlugin<...>() معًا عندما تكون تراخيص الإضافات بجانب الترخيص الأساسي.
يفضل استخدام مسار مطلق (على سبيل المثال مبني من IWebHostEnvironment.WebRootPath أو AppContext.BaseDirectory)، أو تخطي LicensePath تمامًا والاعتماد على الاكتشاف التلقائي أدناه.
builder.Services.AddDoconut(options =>
{
options.LicensePath = Path.Combine(AppContext.BaseDirectory, "wwwroot", "Doconut.Viewer.lic");
});عبر التدفق
LicenseStream يُقرأ مرة واحدة عند بدء التشغيل — مفيد عندما يأتي الترخيص من مخزن سري بدلاً من ملف على القرص.
// الأولوية: LicenseStream > LicenseContent > LicensePath > البحث التلقائي.
builder.Services.AddDoconut(options =>
{
options.LicenseStream = licenseStream;
});عبر المحتوى
LicenseContent يقبل نص الترخيص نفسه — من متغيّر بيئي، قاعدة بيانات، أو مدير أسرار:
// ملف XML للترخيص من قاعدة بيانات أو متغيّر بيئي أو مدير أسرار —
// لا يوجد ملف على القرص. يتفوق عليه فقط LicenseStream.
builder.Services.AddDoconut(options =>
{
options.LicenseContent = Environment.GetEnvironmentVariable("DOCONUT_LICENSE") ?? "";
});الاكتشاف التلقائي
لا تقم بتكوين أي من المصادر الثلاثة الصريحة، وسيبحث Doconut عن الترخيص نفسه:
// لا تقم بأي إعداد، وسيبحث Doconut عن الترخيص نفسه، في هذين المجلدين فقط:
// 1. {CurrentDirectory}/wwwroot
// 2. {AppContext.BaseDirectory}/wwwroot (wwwroot داخل مجلد مخرجات البناء)
// يبحث أولاً عن Doconut.lic; إذا كان مفقودًا، Doconut.Viewer.lic بالإضافة إلى أي
// ملفات Doconut.Viewer.<Capability>.lic لكل مكوّن إضافي.
builder.Services.AddDoconut();مجلدات الفحص، بالترتيب، وأسماء الملفات التي يتم البحث عنها:
1. {CurrentDirectory}/wwwroot
2. {AppContext.BaseDirectory}/wwwroot
Filenames, in order (each one looked for in folder 1, then folder 2):
Doconut.lic — legacy all-in-one license; if found, nothing else is read
Doconut.Viewer.lic — base viewer license
Doconut.Viewer.<Capability>.lic — per-plugin licenses, read only when Doconut.Viewer.lic was foundلا يُقرأ شيء خارج مجلد wwwroot: فإن .lic في مجلد الإخراج نفسه، أو في wwwroot/lib، يتم تجاهله.
نسخ الترخيص إلى مجلد الإخراج الخاص بك
عندما لا يتم تشغيل العملية من مجلد المشروع — تطبيق منشور، IIS، حاوية، أو أداة اختبار — يفوت الفحص الأول، ويتعين على الفحص الثاني، {AppContext.BaseDirectory}/wwwroot، العثور على الملف. تقوم هدف MSBuild هذا بنسخ التراخيص إلى هناك في كل بناء:
<Target Name="CopyLicensesToOutput" AfterTargets="Build">
<ItemGroup>
<DoconutLicenseFiles Include="$(MSBuildProjectDirectory)\wwwroot\*.lic" />
<StaleOutputLicenses Include="$(OutDir)wwwroot\*.lic" />
</ItemGroup>
<!-- احذف أولاً، حتى أن إعادة تسمية أو إزالة ملف .lic في wwwroot يزيله أيضًا من المخرجات. -->
<Delete Files="@(StaleOutputLicenses)" />
<Copy SourceFiles="@(DoconutLicenseFiles)" DestinationFolder="$(OutDir)wwwroot" />
</Target>يجب أن يكون الوجهة $(OutDir)wwwroot: فإن .lic المنسوخ إلى جذر الإخراج لا يتم العثور عليه أبدًا بواسطة البحث التلقائي. أمثلة LicensePath في هذه الصفحة تشير إلى نفس المكان.
احتفظ بملفات
.licخارج التحكم في المصدر — انشرها بجانب التطبيق، أو أدخل الترخيص عبرLicenseContentأوLicenseStreamمن مخزن الأسرار الخاص بك.
ماذا يحدث بدون ترخيص
عدم وجود ترخيص لا يتسبب في استثناء. AddDoconut() ينجح، يبدأ التطبيق، ويعمل العارض — لكن كل صفحة تحمل علامة مائية للتقييم ولا تُمنح أي قدرة اختيارية.
ملف الترخيص الموجود لكنه مرفوض يختلف. توقيع غير صالح، تعديل، إدراج في القائمة السوداء، أو بناء خارج نافذة إصدار الترخيص يتسبب في أن OpenDocumentAsync يطرح LicenseException مع License.RejectionMessage. الترخيص المؤقت المنتهي يظل يعمل بوضع العلامة المائية. الترخيص المدفوع الذي تجاوز تاريخ اشتراكه يظل يعمل، نظيفًا ومع قدراته، على كل بناء تم إصداره قبل ذلك التاريخ.
الإضافات تحتاج إلى قدرات
تسجيل إضافة بدون استحقاق مطابق يختلف: بالنسبة لغياب الترخيص، أو ملف TRIAL قديم، أو ترخيص مدفوع بدون تلك القدرة، AddDoconut() يطرح InvalidOperationException، لذا لا يبدأ التطبيق. على سبيل المثال، تسجيل إضافة Converter بدون ترخيص يمنح Converter:
InvalidOperationException: The Converter plugin is registered via AddPlugin but no active
license grants Converter. Remove the AddPlugin<...>() call or install a license (or
trial/demo) that includes Converter.الرسالة تخبرك بالإصلاح مباشرة: إما إزالة استدعاء options.AddPlugin<...>() لتلك الإضافة، أو تثبيت ترخيص مدفوع أو ترخيص مؤقت/تجريبي (NFR) نشط يمنح القدرة. يُسمح للتسجيلات المؤقتة بالبقاء بعد تاريخ انتهاء صلاحيتها حتى يتمكن التطبيق المُكوَّن مسبقًا من التراجع أثناء التشغيل بدلاً من التعطل عند إعادة التشغيل؛ بمجرد انتهاء الصلاحية، تُسحب قدراتهم.
تحقق من الترخيص المحمَّل
استخدم IDoconutLicenseService، نفس مصدر الحقيقة المستخدم من قبل SDK، لكشف نقطة تشخيص موثقة أو لتوجيه أعلام الميزات. لا تُرجع محتويات الترخيص أو المفاتيح.
app.MapGet("/api/doconut/license", (IDoconutLicenseService license) => Results.Ok(new
{
viewer = license.IsViewerLicensed || license.IsTemporary,
temporary = license.IsTemporary,
search = license.IsCapabilityGranted(LicenseCapability.Search),
annotation = license.IsCapabilityGranted(LicenseCapability.Annotation),
converter = license.HasConverter,
dicom = license.HasDicom
}));يُقرأ الترخيص أثناء تسجيل AddDoconut(). ResetLicense هو حاليًا خاصية توافقية بدون مسار إعادة تحميل نشط، لذا استبدال ملف الترخيص يتطلب إعادة تشغيل التطبيق.
مصفوفة استكشاف الأخطاء وإصلاحها
| العَرَض | السبب المحتمل | الفحص |
|---|---|---|
| العارض يعمل لكن كل صفحة تحمل علامة مائية | لم يتم تحميل أي ترخيص، أو أن الترخيص المؤقت انتهت صلاحيته | حل IDoconutLicenseService؛ تحقق من دليل الإخراج ودليل عمل العملية |
AddDoconut() يطرح استثناءً لإضافة | الترخيص لا يمنح تلك القدرة للإضافة | تحقق من IsCapabilityGranted(...) وأزل التسجيلات التي لم تشترها |
| مسار نسبي مكوَّن يعمل محليًا لكنه لا يعمل في IIS/الحاوية | تغيّر دليل عمل العملية | استخدم AppContext.BaseDirectory أو مسارًا مطلقًا |
ملف .lic المستبدل لا يؤثر | تم إنشاء خدمة الترخيص المفردة بالفعل | أعد تشغيل التطبيق |
OpenDocumentAsync يطرح LicenseException | التوقيع، النطاق، نافذة الإصدار، القائمة السوداء، أو بوابة تشغيل الإضافة رفضت الترخيص | اقرأ رسالة الاستثناء/الرفض دون كشفها للعملاء غير الموثوق بهم |
الخطوات التالية
- الترخيص — القدرات، مستويات الترخيص، والتحقق مما تم تحميله أثناء التشغيل.
- استكشاف الأخطاء — العلامات المائية، الترخيص المرفوض، وأخطاء القدرات.
هل كانت هذه الصفحة مفيدة؟