Installing Documentize via NuGet

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

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

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

2. Откройте консоль диспетчера пакетов:

   • Выберите Tools > NuGet Package Manager > Package Manager Console.

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

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

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

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

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

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

2. Откройте консоль диспетчера пакетов:

   • Выберите Tools > NuGet Package Manager > Package Manager Console.

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

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

Как установить через графический интерфейс NuGet Package Manager

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

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

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

   • В меню Project выберите Manage NuGet Packages.

3. Найдите Documentize:

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

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

   • Нажмите Install/Update рядом с последней версией Documentize.
   • Подтвердите, нажав Accept в появившемся окне.

Преимущества использования NuGet

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

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

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

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

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

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

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

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

Недостатки использования NuGet

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

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

• Возможные конфликты версий:

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

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

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

• Сложность в больших проектах:

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

Installing Documentize via ZIP

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

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

   • Нажмите v26.11 ZIP чтобы загрузить последнюю версию Documentize в формате архива.

2. Распаковать содержимое:

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

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

   • Откройте проект в вашей IDE (например, Visual Studio).
   • Перейдите в Project > Add Reference > Browse и navigate to the directory where you extracted the DLLs.
   • Выберите нужные файлы DLL и добавьте их в качестве ссылок к проекту.

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

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

Преимущества использования ZIP‑архива

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

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

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

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

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

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

Недостатки использования ZIP‑архива

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

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

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

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

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

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

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

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

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

   • Нажмите v26.11 MSI, чтобы загрузить MSI‑установщик последней версии Documentize.

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

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

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

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

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

   • После завершения установки DLL‑файлы Documentize будут размещены в Global Assembly Cache (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. Управление такими конфликтами может потребовать дополнительной конфигурации или очистки.

Среда без Windows

Работа с DLL‑файлами .NET Core в среде без Windows

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

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

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