Распространение FastReport.Net совместно с приложением

Эта статья будет полезна всем, кто использует FastReport.Net в своем приложении.

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

Какие библиотеки доступны:

• FastReport.dll - основная библиотека FastReport.Net;
• FastReport.Web.dll - библиотека для работы в ASP.Net, содержит компонент WebReport;
• FastReport.Bars.dll - библиотека для организации плавающих окон, панелей инструментов и меню;
• FastReport.Editor.dll - редактор кода с подсветкой синтаксиса. Эта библиотека не нужна, если ваше приложение не использует дизайнер отчетов;
• FastReport.xml - комментарии к классам, свойствам и методам FastReport. Этот файл используется в редакторе кода, а также в панелях подсказки (когда вы выбираете функцию в окне "Данные" или любое свойство в окне "Свойства"). Этот файл распространять не обязательно;
• FastReport.Service.dll – библиотека для реализации WCF сервисов;
• FastReport.VSDesign.dll – служебная библиотека для организации работы с FastReport из среды Visual Studio.

Кроме того, вам необходимо распространять файлы отчетов (если отчеты хранятся в файлах, а не в ресурсах приложения).

Что означает распространять библиотеки? Это означает, что библиотеки должны быть расположены в одной директории .exe файлом приложения, либо должны быть зарегистрированы в GAC.

GAC (Global Assembly Cache) – общеизвестный каталог сборок, предназначенных для совместного использования несколькими приложениями. Среда CLR автоматически проверяет этот каталог обнаружив ссылку на сборку.

 Следует использовать специальные утилиты для размещения сборок в GAC, например – GACUtil. Для Framework 2.0 нужно использовать gacutil.exe. А для 4.0 – gacutil4.exe.

Вот пример запуска консольной утилиты для регистрации библиотеки FastReport в GAC: gacutil4.exe /i FastReport.dll.

В зависимости от версии Windows и Visual Studio gacutil4.exe можно найти в одном из путей:

C:\Program Files\Microsoft SDKs\Windows\v7.0A\bin\NETFX 4.0 Tools

C:\Program Files (x86)\Microsoft SDKs\Windows\v8.0A\bin\NETFX 4.0 Tools

Итак, вместе с приложением для Windows нужно распространять следующие библиотеки: FastReport.dll, FastReport.Bars.dll, FastReport.Editor.dll. Обязательной из них является FastReport.dl.

FastReport.Bars.dll и FastReport.Editor.dll потребуются, только если вы использовали компоненты из этих библиотек.

Для Web приложений размещаем библиотеки: FastReport.dll, FastReport.Web.dll. Обе обязательны.

Вместе с сервисными WCF приложениями распространяем библиотеки: FastReport.dll, FastReport.Service.dll;

Тут нужно учесть, что библиотеки FastReport.Net отличаются для версий Framework 2.0 и 4.0. Учитывайте это при распространении. Копируйте файлы библиотек из инсталляции для соответсвующей версии Framework.

Для работы с диаграммами в FastReport.Net должен быть установлен Microsoft Chart Control https://www.microsoft.com/en-gb/download/details.aspx?id=14422

Если вы хотите распространять отчеты с диаграммами, придется включить в пакет программы библиотеку System.Windows.Forms.DataVisualization.dll (можно найти в дистрибутиве FastReport.Net). Это также актуально и для Web приложений.

В списке библиотек FastReport.Net я указал FastReport.VSDesign.dll. Она нужна только для работы с FastReport.Net в Visual Studio и её распространять совместно с приложением не надо.

Еще одна такая служебная библиотека - FastReport.Install.dll.