نصب

SDK Documentize را می‌توان از طریق چندین روش نصب کرد که هر کدام برای محیط‌های توسعه و سلیقه‌های مختلف طراحی شده است. در زیر روش‌های توصیه شده برای نصب Documentize آمده است:

1. NuGet (روش ترجیحی)

NuGet ساده‌ترین و ترجیحی‌ترین روش برای نصب Documentize است و اطمینان می‌دهد که همیشه آخرین نسخه و به‌روزرسانی‌ها را مستقیماً در محیط توسعه خود دارید. اطلاعات بیشتر درباره این روش نصب را در نحوه نصب SDKهای Documentize با استفاده از NuGet بررسی کنید.

2. نصب‌کننده MSI

نصب‌کننده MSI گزینه‌ای راحت است اگر ترجیح می‌دهید DLLهای Documentize مستقیماً بر روی سیستم شما نصب شوند. این روش برای توسعه‌دهندگانی که ممکن است بخواهند از Documentize در چندین پروژه استفاده کنند بدون نیاز به مدیریت دستی فایل‌های DLL ایده‌آل است. اطلاعات بیشتر درباره این روش نصب را در نحوه نصب SDKهای Documentize با استفاده از MSI بررسی کنید.

3. آرشیو ZIP

برای توسعه‌دهندگانی که رویکرد دستی را ترجیح می‌دهند، آرشیو ZIP شامل DLLهای Documentize است که می‌توان آن‌ها را استخراج و مستقیماً به پروژه شما اضافه کرد. اطلاعات بیشتر درباره این روش نصب را در نحوه نصب SDKهای Documentize با استفاده از ZIP بررسی کنید.

28 دسامبر 2024

Subsections of نصب

نیازمندی‌های سیستم

SDK های Documentize برای ادغام با برنامه‌های .NET طراحی شده‌اند و از سیستم‌عامل‌ها و محیط‌های توسعه مختلف پشتیبانی می‌کنند. در زیر نیازمندی‌های کلیدی سیستم آورده شده است:

سیستم‌عامل‌های پشتیبانی شده

ویندوز

  • ویندوز 7 (x64, x86)
  • ویندوز 8، 8.1 (x64, x86)
  • ویندوز 10 (x64, x86)
  • ویندوز 11 (x64, x86)
  • ویندوز سرور 2003 تا ویندوز سرور 2022 (x64, x86)
  • ابری: مایکروسافت آژور

macOS

  • macOS 10.12 (Sierra) و بالاتر

لینوکس

  • سازگار با چندین توزیع لینوکس:
    • اوبونتو (16.04، 18.04، 20.04، 22.04)
    • سنت‌اوس (7، 8)
    • دبیان (9، 10)
    • اوپن‌سوزه (Leap 15+، SLES 12+)

اندروید

  • از اندروید 8.0 (Oreo) و بالاتر پشتیبانی می‌کند.

محیط‌های توسعه

  • مایکروسافت ویژوال استودیو:
    • ویژوال استودیو 2010 و بالاتر (شامل 2019 و 2022)
  • از هر محیط توسعه‌ای که هدف آن پلتفرم‌های .NET باشد، پشتیبانی می‌کند.

فریم‌ورک‌های .NET پشتیبانی شده

  • .NET Framework 4.0 و بالاتر
  • .NET Standard 2.0 (.NET Core 3.1+)
  • .NET 6.0، .NET 7.0، .NET 8.0

یادداشت‌های اضافی

  • Adobe Acrobat برای اجرای SDK های Documentize ضروری نیست، اما برای مشاهده PDF ها توصیه می‌شود.
28 دسامبر 2024

اعلامیه

SDKهای Documentize.com هنگام استفاده در برنامه‌های .NET به مجموعه مجوز دسترسی کامل نیاز دارند. این سطح مجوز برای عملکرد SDKها در انجام برخی عملیات سیستمی ضروری است، مانند دسترسی به تنظیمات رجیستری، فایل‌های سیستمی و تجزیه فونتها.

چرا دسترسی کامل ضروری است

SDKهای Documentize از کلاس‌های اصلی سیستم .NET استفاده می‌کنند، که اغلب به مجوزهای بالاتر برای دلایل زیر نیاز دارند:

  • دسترسی به رجیستری: برخی عملیات ممکن است به خواندن یا نوشتن در رجیستری سیستم نیاز داشته باشند.
  • فایل‌های سیستمی: ممکن است دسترسی به فایل‌های سیستمی فراتر از دایرکتوری مجازی برنامه برای برخی وظایف، مانند مدیریت فونت‌ها یا انجام عملیات فایل لازم باشد.

محدودیت‌های محیط اعتماد متوسط

در محیط‌های میزبان که امنیت اعتماد متوسط را تحمیل می‌کنند، چندین مجوز مهم محدود یا در دسترس نیست. این امر می‌تواند مانع عملکرد صحیح SDKها در چنین محیط‌هایی شود. محدودیت‌های زیر در زیر اعتماد متوسط اعمال می‌شود:

  • OleDbPermission: نمی‌توان از ارائه‌دهنده داده OLE DB مدیریت‌شده ADO.NET برای دسترسی به پایگاه‌های داده استفاده کرد.
  • EventLogPermission: دسترسی به لاگ رویدادهای ویندوز ممنوع است.
  • ReflectionPermission: استفاده از بازتاب را ممنوع می‌کند، که ممکن است بر برخی عملیات پویا تأثیر بگذارد.
  • RegistryPermission: دسترسی به رجیستری سیستم ممنوع است.
  • WebPermission: ارتباط محدود به آدرس‌ها یا دامنه‌های از پیش تعیین‌شده است که در عنصر <trust> پیکربندی شده‌اند.
  • FileIOPermission: دسترسی به فایل‌ها محدود به فایل‌های موجود در دایرکتوری مجازی برنامه است.
28 دسامبر 2024

محیط غیر ویندوز

SDKهای Documentize از .NET Standard 2.0 پشتیبانی می‌کنند که به آنها اجازه می‌دهد در برنامه‌های .NET Core که بر روی لینوکس یا دیگر محیط‌های غیر ویندوز اجرا می‌شوند، استفاده شوند. برای اطمینان از عملکرد بهینه و رندر متن صحیح، مراحل زیر را دنبال کنید:

راه‌اندازی پیشنهادی برای لینوکس

1. نصب بسته libgdiplus

این بسته قابلیت‌های ضروری GDI+ را فراهم می‌کند که برای رندر و پردازش PDFها حیاتی است. می‌توانید آن را با اجرای دستور زیر در ترمینال خود نصب کنید:

sudo apt-get install libgdiplus

2. نصب فونت‌های سازگار با مایکروسافت

برای رندر صحیح متن، فونت‌های TrueType مایکروسافت را با استفاده از دستور زیر نصب کنید:

sudo apt-get install ttf-mscorefonts-installer

این فونت‌ها باید در دایرکتوری /usr/share/fonts/truetype/msttcorefonts قرار گیرند. اگر سیستم شما فونت‌ها را در دایرکتوری متفاوتی ذخیره می‌کند، قبل از انجام هر گونه عملیات با SDKهای Documentize، مسیر را در کد خود به روز رسانی کنید:

Documentize.Text.FontRepository.Sources.Add(new FolderFontSource("<path to ms fonts>"));

Tip

با اطمینان از اینکه این نصب‌ها کامل شده و مسیر فونت به درستی پیکربندی شده، می‌توانید عملکرد SDKهای Documentize را بر روی لینوکس یا دیگر سیستم‌های غیر ویندوز به حداکثر برسانید.

28 دسامبر 2024

ارزیابی

شما می‌توانید به راحتی SDKهای Documentize را برای اهداف ارزیابی دانلود کنید. نسخه ارزیابی مشابه نسخه خریداری شده است، با تنها تفاوت این که چگونه مجوز را اعمال می‌کنید.

محدودیت‌های نسخه ارزیابی

در حالی که نسخه ارزیابی دسترسی کامل به تمام ویژگی‌ها را فراهم می‌کند، تا زمانی که مجوزی اعمال نشده باشد، شامل محدودیت‌های زیر است:

  • یک واترمارک ارزیابی به تمام اسناد خروجی اضافه می‌شود.
  • تنها چهار صفحه اول هر سند PDF قابل مشاهده یا ویرایش است.

برای حذف این محدودیت‌ها و باز کردن نسخه کامل، به سادگی با افزودن چند خط کد به پروژه‌تان یک مجوز اعمال کنید.

 فارسی