Эта статья будет полезна всем, кто использует 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.