Установка Documentize через NuGet

Как установить через консоль менеджера пакетов NuGet

1. Откройте свой проект:

   • Запустите Visual Studio и откройте свое .NET приложение.

2. Доступ к консоли менеджера пакетов:

   • Перейдите в Справка > Менеджер пакетов NuGet > Консоль менеджера пакетов.

3. Установите пакет:

   • Чтобы установить последнюю полную версию, введите команду Install-Package Documentize.
   • Чтобы установить последнюю версию, включая исправления, используйте Install-Package Documentize -prerelease.
   • Нажмите Enter, чтобы выполнить команду.

Как обновить пакет через консоль менеджера пакетов NuGet

Если вы уже установили Documentize через NuGet и хотите обновить до последней версии:

1. Откройте свой проект:

   • Запустите Visual Studio и откройте свое .NET приложение.

2. Доступ к консоли менеджера пакетов:

   • Перейдите в Справка > Менеджер пакетов NuGet > Консоль менеджера пакетов.

3. Обновите пакет:

   • Чтобы обновить до последней полной версии, введите Update-Package Documentize.
   • Чтобы обновить до последней версии, включая исправления, используйте Update-Package Documentize -prerelease.
   • Нажмите Enter, чтобы выполнить команду.

Как установить через графический интерфейс менеджера пакетов NuGet

1. Откройте свой проект:

   • Запустите Visual Studio и откройте свое .NET приложение.

2. Перейдите к управлению пакетами NuGet:

   • В меню Проект выберите Управление пакетами NuGet.

3. Найдите Documentize:

   • Перейдите на вкладку Обзор и введите Documentize в строку поиска.

4. Установите пакет:

   • Нажмите Установить/Обновить рядом с последней версией Documentize.
   • Подтвердите, нажав Принять в появившемся окне.

Плюсы использования NuGet

• Автоматическое управление зависимостями:

  • NuGet автоматически управляет зависимостями, обеспечивая правильное включение и обновление всех необходимых библиотек. Это снижает риск отсутствия или несовместимости зависимостей.

• Упрощенные обновления:

  • Обновление пакетов с помощью NuGet довольно простое, как через консоль менеджера пакетов, так и через графический интерфейс. Это упрощает поддержку ваших библиотек в актуальном состоянии с последними возможностями и исправлениями.

• Интеграция с Visual Studio:

  • NuGet бесшовно интегрирован с Visual Studio, предоставляя удобный интерфейс для управления пакетами, не покидая среду разработки.

• Версионирование:

  • NuGet позволяет указывать и управлять различными версиями библиотек, что позволяет легко возвращаться к предыдущим версиям или тестировать новые релизы без нарушения процесса разработки.

Минусы использования NuGet

• Ограничено Visual Studio:

  • NuGet в первую очередь разработан для использования в Visual Studio. Хотя его можно использовать в других средах, интеграция наиболее robust в Visual Studio.

• Потенциальные конфликты версий:

  • В крупных проектах с множеством зависимостей управление версиями и разрешение конфликтов могут стать сложными. NuGet предоставляет инструменты для управления этим, но это требует внимательного подхода.

• Зависимость от сети:

  • Установка и обновление пакетов требуют подключения к интернету. Если вы работаете в среде с ограниченным или отсутствующим интернет-доступом, вам, возможно, придется использовать оффлайн-методы или заранее загрузить пакеты.

• Сложность для крупных проектов:

  • Для очень крупных проектов с расширенными деревьями зависимостей управление пакетами через NuGet может стать обременительным. В таких случаях могут потребоваться дополнительные инструменты или стратегии для эффективного управления зависимостями.

Установка Documentize с помощью MSI

Как установить с помощью MSI-установщика

1. Скачайте MSI-установщик:

   • Нажмите на v24.12 MSI, чтобы скачать MSI-установщик последней версии Documentize.

2. Запустите установщик:

   • Дважды щелкните на загруженный MSI-файл, чтобы открыть мастер установки.

3. Следуйте инструкциям мастера установки:

   • Следуйте указаниям на экране, предоставленным установщиком. Возможно, вам потребуется согласиться на лицензионное соглашение и выбрать параметры установки.

4. Завершите установку:

   • После завершения установки DLL-файлы Documentize будут установлены в глобальный кэш сборок (GAC) вашей системы или в другое указанное место.

5. Проверьте установку:

   • Убедитесь, что DLL-файлы установлены корректно, проверив их наличие в указанной директории установки или GAC.

Плюсы использования MSI-установщика

• Простота использования:

  • MSI-установщик предоставляет простой и понятный процесс установки. Он обрабатывает все необходимые настройки и размещает DLL-файлы в централизованном месте, что упрощает использование Documentize в нескольких проектах.

• Установка на уровне системы:

  • Метод MSI устанавливает Documentize в глобальный кэш сборок (GAC) системы или другое центральное место. Это позволяет любому приложению в системе обращаться к DLL-файлам без необходимости указывать их отдельно в каждом проекте.

• Автоматические обновления:

  • Если Documentize предоставляет обновленный установщик, вы можете легко обновить свою установку, запустив новый MSI-файл, который обычно обрабатывает процесс обновления гладко.

• Согласованность:

  • Использование MSI-установщика гарантирует, что все необходимые файлы установлены корректно и согласованно в разных средах, уменьшая риск отсутствующих или неправильно размещенных DLL-файлов.

Минусы использования MSI-установщика

• Ограниченная гибкость:

  • MSI-установщик устанавливает Documentize в системное место, что может быть не подходящим для всех сред разработки. Ему может не хватать гибкости для учета конфигураций или версий, специфичных для проекта.

• Потенциальные накладные расходы:

  • Установка DLL-файлов в GAC может ввести накладные расходы и сложность, особенно в сценариях, когда одновременно могут потребоваться несколько версий Documentize.

• Ручное удаление:

  • Если вам нужно удалить Documentize, вы должны использовать средство удаления, предоставляемое MSI, которое может оставить остаточные файлы или конфигурации, если не будет правильно управляться.

• Конфликты версий:

  • Установки на уровне системы могут привести к конфликтам версий, если разные проекты требуют различных версий Documentize. Управление этими конфликтами может потребовать дополнительной настройки или очистки.

Установка Documentize через ZIP

Как установить через ZIP-архив

1. Скачать ZIP-архив:

   • Нажмите на v24.12 ZIP, чтобы скачать последнюю версию Documentize в архивном формате.

2. Извлечь содержимое:

   • После загрузки распакуйте содержимое ZIP-файла в каталог по вашему выбору. Вы можете выбрать, сохранить эти файлы в общем каталоге или внутри структуры вашего проекта.

3. Добавить ссылки на ваш проект:

   • Откройте ваш проект в вашей IDE (например, Visual Studio).
   • Перейдите в Проект > Добавить ссылку > Обзор и перейдите в каталог, где вы извлекли DLL-файлы.
   • Выберите соответствующие DLL-файлы и добавьте их в качестве ссылок на ваш проект.

4. Ручные обновления:

   • Если новая версия Documentize будет выпущена, вам нужно будет вручную скачать обновленный ZIP-архив и заменить старые DLL-файлы в вашем проекте на новые.

Плюсы использования ZIP-архива

• Полный контроль:

  • У вас есть полный контроль над тем, где и как DLL-файлы хранятся и ссылаются в вашем проекте. Это может быть полезно, если вы предпочитаете индивидуальную настройку или вам нужно управлять зависимостями вручную.

• Нет зависимости от менеджеров пакетов:

  • В отличие от NuGet, вы не зависите от менеджера пакетов для обработки установок. Это может быть выгодно в средах, где менеджеры пакетов недоступны или нежелательны.

• Портативность:

  • ZIP-архив можно легко передавать и перемещать между различными системами, что делает его идеальным для проектов, которые должны быть портативными или распространяемыми без зависимости от внешних инструментов.

Минусы использования ZIP-архива

• Ручное управление:

  • В отличие от NuGet, где обновления и управление зависимостями автоматизированы, с ZIP-архивом вам необходимо вручную управлять обновлениями и следить за тем, чтобы все необходимые DLL были правильно подключены.

• Риск конфликтов версий:

  • Если вы управляете несколькими проектами или работаете в команде, существует риск конфликтов версий, если разные проекты используют разные версии DLL. Это требует тщательного отслеживания версий между проектами.

• Нет автоматических обновлений:

  • Вы не получите автоматических обновлений или уведомлений, когда будет доступна новая версия. Это может привести к использованию устаревших библиотек, если вы не будете регулярно проверять наличие обновлений.

Невиндоусная среда

Работа с .NET Core DLL в невиндоусной среде

Поскольку Documentize для .NET поддерживает .NET Standard 2.0 ( .NET Core 2.0), его можно использовать в ядре приложений, работающих в операционных системах, подобных Linux. Мы постоянно работаем над улучшением поддержки .NET Core в нашем API. Тем не менее, есть некоторые операции, которые мы рекомендуем нашим клиентам выполнять, чтобы добиться лучших результатов при использовании функций Documentize для .NET. Пожалуйста, установите:

• пакет libgdiplus
• пакет с шрифтами, совместимыми с Microsoft: ttf-mscorefonts-installer (например, sudo apt-get install ttf-mscorefonts-installer). Эти шрифты должны быть размещены в директории /usr/share/fonts/truetype/msttcorefonts, так как Documentize для .NET сканирует эту папку в операционных системах, подобных Linux. В случае, если операционная система имеет другую папку/директорию по умолчанию для шрифтов, вы должны использовать следующую строку кода перед выполнением любой операции с использованием Documentize:

  Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<путь пользователя к шрифтам ms>"));