Как устранить наиболее частые проблемы при установке FastReport VCL
Для установки FastReport VCL и его компонентов используется программа FastReport Online Installer. Программа обладает простым, интуитивно понятным интерфейсом. Настоятельно рекомендуем вам использовать последнюю версию установщика. Скачать её можно по этой ссылке.
Однако в некоторых случаях в процессе установки возникают проблемы. В этой статье мы как раз рассмотрим, как эти проблемы можно решить или предотвратить. Подробное описание процесса установки находится здесь.
При запуске FastReport Online Installer автоматически начинает проверять установщик на наличие обновлений и предлагает загрузить новую версию.
Далее с помощью браузера (выбранного в системе по умолчанию) происходит проверка вашего аккаунта на наличие уже купленных компонентов FastReport. Если на вашем аккаунте нет купленных продуктов, то вам будет доступен только демоцентр с Trial версиями FastReport.
Внимание! Учетная запись (почта), на которую произведена покупка Вашего экземпляра FastReport, должна совпадать с учетной записью, которую вы использовали при входе в личный кабинет «Быстрые отчеты». Если у вас возникают проблемы со входом под нужной учетной записью, то попробуйте очистить кэш запущенного браузера и попробовать войти в систему вновь.
Если ваша лицензия разрешает установку на несколько компьютеров (например, Team, Site, OEM), то вы должны войти в личный кабинет «Быстрые отчеты» под пользователем, на которого приобретена лицензия на каждом компьютере.
Либо вы можете воспользоваться альтернативным способом с передачей прав доступа. Для этого вам необходимо в личном кабинете зайти в Настройки -> Профиль и на вкладке Accesses добавить пользователю доступ к требуемым продуктам и их версиям. Затем нажмите на кнопку «Добавить доступ к лицензии». В появившемся окне укажите e-mail пользователя, нужный продукт, а также выберите необходимую версию из списка доступных.
При установке инсталлятор предложит вам закрыть все запущенные в данный момент IDE. Если какая-нибудь из IDE открыта, то у вас появится следующее окно:
Мануальная регистрация
Если вы по каким-то причинам не можете воспользоваться онлайн идентификацией, то вам доступна мануальная регистрация. Чтобы получить ваш регистрационный код, скопируйте текст из поля «Регистрационная информация» и отправьте его по адресу support@fastreport.ru. Если вы хотите получить регистрационный код для электронной почты, отличающейся от той, с которой пишете это письмо, то укажите, пожалуйста, в теле письма E-mail используемый для входа в личный кабинет клиента.
Не закрывайте установщик, пока не получите регистрационный код с dat-файлами в ответном письме. Затем разместите dat-файлы в одной папке с установщиком и продолжайте установку.
Есть ещё третий способ установки компонентов FastReport. Начните онлайн установку на устройстве, подключенному к сети. Затем перенесите dat–файлы и инсталлятор на компьютер, у которого нет доступа к сети и закончите выполнять установку на этом компьютере. Предварительно запросите регистрационный код в технической поддержке как было описано ранее в статье.
Следует помнить, что закрывать Online Installer до получения регистрационного кода нельзя!
*dat – файлы можно переносить между компьютерами, при условии, что установка будет происходит для одного и того же пользователя (на один и тот же адрес электронной почты). Причем dat файлы можно переносить на другой компьютер и при онлайн установке (также для одного пользователя), тем самым сэкономить время на их скачивание.
Процесс установки компонентов
Далее у вас есть возможность «Установить» (Install) или «Модифицировать» (Modify) если продукты уже установлены на вашем компьютере, «Перекомпилировать» (Recompile), «Починить» (Repair), и «Удалить» (Remove) FastReport компоненты.
«Перекомпилировать» означает переустановку библиотеки FastReport на вашем компьютере. Это может понадобиться, когда вы внесли изменения в исходный код библиотеки и требуется ее переустановка в IDE.
«Починить» позволяет переустановить FastReport на вашем компьютере с текущими выбранными параметрами. Эта функция может работать без подключения к интернету.
«Удалить» полностью деинсталлирует библиотеку с вашего компьютера.
«Установить» или «Модифицировать» – при выборе этой опции в следующем окне показываются IDE, в которые можно установить FastReport. Вы выбираете компоненты, которые необходимо установить, а также тип установки Trial или Source. Набор доступных компонентов зависит от купленной вами лицензии.
Обратите внимание, что на вашем компьютере должна быть установлена хотя бы одна IDE, в которую можно установить FastReport.
Это может быть Delphi начиная с версии 2010 или Lazarus последних версий. Список версий Delphi, поддерживаемых FastReport, можно просмотреть здесь. Если вам необходима старая версия FastReport, например, для Delphi 7, пожалуйста, обратитесь в техническую поддержку. Установщик может установить разные версии FastReport для каждой установленной IDE.
Предварительная установка дополнительных компонентов
Внимание! Перед установкой FastReport вы должны установить дополнительные компоненты, которые вы собираетесь использовать вместе с FastReport.
Например, если вы собираетесь использовать в FastReport компоненты BDE, то перед установкой у вас уже должен быть установлен BDE в вашей IDE. Иначе установщик просто не сможет собрать пакеты FastReport, которые используют BDE. Для других компонентов вам аналогично нужно предварительно установить FIB, TeeChart и так далее.
Мы настоятельно рекомендуем перед началом установки удалить из ваших IDE все старые версии FastReport, а также FastReport Embarcadero Edition. Это необходимо для нормальной работы инсталлятора. Также необходимо удалить файлы формата «.bpl» для старых версий FastReport. Если установщик их обнаружит, то он не сможет дальше продолжить свою работу.
Такие файлы могут находиться, например в следующих папках:
C:\Users\Public\Documents\Embarcadero\Studio\23.0\Bpl\
C:\Users\Your_User_Name\AppData\Local\VirtualStore
C:\Windows\SysWOW64
Bpl файлы имеют следующий вид (где XX - число в названии зависит от версии IDE, которая у вас установлена):
- fr*XX.bpl,
- fs*XX.bpl,
- fqb*XX.bpl .
Таблицу с зависимостями версии IDE Delphi, компилятора и версии пакетов можно найти здесь.
Если в системе остались bpl файлы старых версий, и инсталлятор их по какой-то причине не нашел, то при запуске IDE возможно появление следующей ошибки:
В этом случае все старые bpl следует удалить.
Инсталлятор ищет установленные версии IDE в реестре. Если при установке IDE произошли ошибки и/или ключи реестра отсутствуют, то для этой IDE установка невозможна! Также эта IDE будет отсутствовать в списке доступных к установке.
Ошибка «Не найдена bpl удаленной версии»
Иногда инсталлятор некорректно удаляет старую версию FastReport. Файлы удаляются, но ссылки в реестре на bpl остаются. В этом случае при запуске Delphi будут появляться окна следующего вида:
Для решения этой проблемы нажмите кнопку «Отмена» в каждом окне или клавишу «Escape». Тем самым эти окна больше появляться не будут. Если номер версии bpl в ошибке совпадает с номером версии, которую вы хотели установить, то данная ошибка не связана с bpl. Чаще всего подобные сообщения об ошибках могут возникать при отсутствии установленных Steema, TeeChart или Interbase Express (IBX) Components.
Иногда происходят ситуации, когда для установки выбраны компоненты FastReport, но после установки они не отображаются в палитре компонентов. В этом случае может помочь функция Repair в установщике.
Если этот способ вам не помог, то следует проверить выбраны ли эти компоненты в окне IDE Components -> Install Packages. Также можно попробовать установить эти f*.bpl файлы вручную. Они находятся (при установке по умолчанию) по следующему пути:
«C:\Program Files (x86)\FastReport VCL\<FRVersion>\Sources\LibRS<CompilerVersion>\VCL\Win32\»
Ошибка при компиляции и установке пакетов в IDE
Если установщик смог загрузить библиотеку FastReport, но по каким-то причинам не смог скомпилировать и установить пакеты в IDE, то можно попробовать скомпилировать и загрузить их вручную. Для этого используйте инструкцию по установке по этой ссылке и документацию Embarcadero по этой ссылке.
Убедитесь, что пути к этим библиотекам находятся в переменной PATH IDE, и пути к исходным кодам FastReport настроены правильно. Также необходимо проверить наличие переменной IDE FRL. По умолчанию там должен быть путь примерно следующего вида:
«C:\Program Files (x86)\Fast Reports VCL\2024.2.6\Sources»
Проверить как прошла компиляция библиотек можно при помощи запуска логирования при установке. Для этого в свойствах ярлыка установщика впишите ключ «–log».
VCLOnlineInstaller.exe -log:"c:\test.log".
При использовании этого параметра мы настоятельно рекомендуем использовать абсолютный путь, чтобы в дальнейшем не искать файл полученного лога.
Если при установке необходимо задать дополнительные каталоги, в которых располагаются библиотеки необходимые для компиляции FastReport, то можно запустить инсталлятор с параметром "-addCustomPaths".
VCLOnlineInstaller.exe -addCustomPaths
При этом после выбора компонентов FastReport появится окно, в котором можно задать пути поиска библиотек для компилятора.
Также в процессе установки может возникнуть такая ситуация, что после установки в IDE вообще нет компонентов FastReport. Для устранения этой проблемы вам необходимо проверить наличие *.dat файлов установщика. При их отсутствии или маленьком размере (самый маленький должен быть более 280Кб) перезапустите установку при отключенном брандмауэре и антивирусе (или добавьте установщик в исключения).
Полезная информация
Следует заметить, что при обновлении FastReport возможна ситуация, при которой отчет, сохраненный в новой версии, вы не сможете открыть в старой. Это происходит по причине добавления новых свойств компонентов отчета, а также самих новых компонентов. Старым версиям про эти свойства и компоненты ничего не известно. В целом устаревшие отчеты формата .fr3 в новых версиях FastReport должны открываться нормально.
Если вы хотите установить бесплатную редакцию FastReport Embarcadero Edition, то это можно сделать с помощью GetIT в IDE Delphi.
Для установки перейдите в Tools->GetIt Package Manager и выберите FastReport Embarcadero Edition.
Но имейте в виду, что эту версию FastReport нельзя установить в Delphi CE.
Также обратите внимание, что в комплект поставки входит множество примеров применения FastReport. По умолчанию они устанавливаются в папку "C:\Users\Public\Documents\Fast Reports VCL\2024.2.6\Sources\". Там же находится и оффлайн документация. В комплект поставки входит и Демоцентр (вы можете установить его отдельно), с помощью которого вы можете ознакомиться с некоторыми возможностями FastReport, не устанавливая его себе на компьютер.
FastReport постоянно развивается, в нём добавляются новые возможности и функции. Если у вас возникают вопросы по их использованию, то вы всегда можете обратиться в нашу техническую поддержку!
