Компиляция платформы Гедымин

Версия 17:15, 8 апреля 2009

Ниже приведена подробная пошаговая инструкция о том, как самостоятельно скомпилировать и запустить платформу Гедымин.

Шаг 1

Проверяем операционную систему. Вам понадобится Windows XP с установленным SP2 или SP3.

Шаг 2

Устанавливаем и настраиваем компилятор Borland Delphi 5:

1. Устанавливаем Borland Delphi 5. При указании параметров установки НЕ СТАВИМ Borland Interbase и его клиентскую часть.
2. Устанавливаем Update Pack 1.
3. Запускаем Delphi.
4. Открываем меню Component и выбираем команду Install packages...
5. В списке Design packages отыскиваем позицию Interbase Data Access Components и снимаем галочку напротив нее.
6. Закрываем Delphi.
7. Удаляем из каталога Program Files/Borland/Delphi5/Bin файл DCLIB50.BPL.
8. Удаляем из каталога WINDOWS/SYSTEM32 файл VCLIB50.BPL.
9. Заходим в каталог Program Files/Borland/Delphi5/Source/Vcl и удаляем все файлы по маске IB*.*.

Шаг 3

Заходим на сайт firebirdsql.org и скачиваем установку сервера Firebird 2.5 (на момент написания данной инструкции была доступна версия 2.5 Beta 1). Запускаем ее и устанавливаем сервер в режиме Super Server.

Шаг 4

Разворачиваем исходный код платформы:

1. Создаем каталог на диске. Например, c:\golden.
2. Скачиваем архив с исходным кодом платформы по этой ссылке.
3. Распаковываем в каталог содержимое архива (должно получиться два подкаталога Comp5 и Gedemin).

Шаг 5

Исходные коды последней версии платформы Гедымин можно получить с официального сайта компании http://gsbelarus.com по <a href="http://gsbelarus.com/gs/modules.php?name=Downloads&d_op=getit&lid=29">этой ссылке</a>. Для компиляции выполняемого модуля вам потребуется персональный компьютер с установленной операционной системой Windows 2000, Windows XP или более поздней версией. Желательно наличие хотя бы 256 Мб оперативной памяти.

Стоит заметить, что для запуска и проверки в действии откомпилированного файла, вам потребуется три составляющие части:

• 1. собственно, сам выполняемый модуль gedemin.exe;
• 2. файл базы данных к которому вы будете подключаться;
• 3. установленный и настроенный сервер базы данных.

Мы рекомендуем, перед компиляцией платформы, скачать с сайта компании один из дистрибутивов, например, <a href="http://gsbelarus.com/gs/modules.php?name=Downloads&d_op=getit&lid=43">Гедымин Разработчик</a> и установить его у себя на компьютере. Таким образом, вы получите настроенный и работающий сервер базы данных и установленный файл базы данных. <p/> Ниже приводится пошаговый процесс сборки исполняемого модуля gedemin.exe из исходных кодов.

1. Установка Delphi 5

На компьютере должен быть установлен компилятор Borland Delphi 5 и (обязательно!) Update Pack 1 к нему. Файл динамической библиотеки midas.dll, необходимый для работы Гедымина, устанавливается в процессе инсталяции компилятора.

2. Установка GDS32.DLL

Динамическая библиотека GDS32.DLL должна находиться в каталоге WINDOWS/SYSTEM32 (Здесь и далее заменяйте обратные слэши на прямые!) или в любом другом каталоге, перечисленном в перменной окружения PATH. Данная библиотека является клиентской частью сервера базы данных Interbase/Firebird/Yaffil. Если вы воспользовались ранее предложенным советом и установили дистрибутив Гедымин Разработчик, то нужный файл находится в папке c:/program files/golden software/gedemin/local.

3. Отключение компонент IBX

Так как Гедымин использует модифицированные компоненты IBX (Interbase Express), стандартные компоненты, входящие в поставку Delphi следует отключить. Для этого необходимо:

• 1. открыть Delphi, открыть меню Component и выбрать команду “Install packages…”.
• 2. В списке “Design packages” следует отыскать позицию “Interbase Data Access Components” и снять галочку напротив нее.
• 3. Далее, закрываем Delphi и удаляем из каталога “Program FilesBorlandDelphi5Bin” файл DCLIB50.BPL.
• 4. Из каталога “WINDOWS/SYSTEM32” удаляем файл VCLIB50.BPL.
• 5. Заходим в каталог «Program Files/Borland/Delphi5/Source/Vcl» и удаляем все файлы по маске IB*.*.

4. Распаковка архива

На диске d: создаем каталог с именем GOLDEN. Распаковываем в него содержимое архива с исходным кодом платформы. <p/> В принципе, можно использовать любую букву диска и любое имя каталога, но в этом случае, будьте готовы внести соответствующие изменения во все DPK, DPR, BPG файлы.

5. Создание каталогов

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

• d:/golden/b�pl — библиотеки компонентов;
• z:/dcu — DCU файлы;
• z:/ — откомпилированный файл gedemin.exe.

С созданием каталога d:/golden/b�pl особых проблем возникнуть не должно. <p/> Если у вас нет диска с именем z:, то следует, либо переименовать существующий физический диск, либо использовать утилиту subst. Например, создать папку c:/temp/dcu, открыть системный реестр с помощью утилиты regedit.exe и в ключе «HKEY_LOCAL_MACHINE/SOFTWARE/Microsoft/Windows/CurrentVersion/Run» добавить строковый параметр SUBST с содержимым «SUBST z:/ c:/temp/dcu». После чего следует перезагрузить компьютер.

6. Компиляция

После того, как необходимая структура каталогов создана, откроем в Delphi группу проектов d:/golden/gedemin/gedemin.bpg, которая содержит следующие файлы:

• SynEdit_D5.bpl — визуальные компоненты редактора программного кода с подсветкой синтаксиса;
• tb2k_d5.bpl — набор визуальных компонентов Toolbar 2000;
• tb2kdsgn_d5.bpl — набор визуальных компонентов Toolbar 2000 (design package);
• fr5.bpl — генератор отчетов FastReport. Внимание! Компоненты FastReport являются платным программным продуктом. Лицензию на их использование необходимо приобретать отдельно. Информацию можно получить на сайте http://fastreport.ru. Только не устанавливайте приобретенный самостоятельно дистрибутив поверх файлов, входящих в проект Гедымин, так как в них были внесены некоторые изменения, которых нет в оригинальной поставке;
• djcl50_2.bpl — библиотека компонентов JCL (JEDI Code Library);
• greference.bpl — библиотека визуальных компонентов компании Golden Software, используемых проектом Гедымин;
• gedemin.exe — исполняемый модуль платформы;
• upgrade.exe — утилита обновления базы данных;
• gudf.dll — библиотека UDF (User Defined Function) функций для сервера базы данных.

Поочередно перестроим (команда Build) каждый проект . Библиотеки компонентов следует установить — команда Install, вызываемая из контекстного меню в дереве проектов. <p/> После компиляции, файл gudf.dll следует перенести из каталога d:goldengedemingudf в UDF каталог сервера базы данных. Обычно, это каталог c:/program files/yaffil/udf на том компьютере, где установлен сервер.

7. Подключение к базе данных

После выполнения предыдущего шага, в каталоге z:, будет находиться скомпилированный файл gedemin.exe. Прежде чем запускать его следует установить базу данных из дистрибутива или собрать ее. <p/> Первый вариант — более простой. Для установки базы данных следует скачать с сайта компании Golden Software один из дистрибутивов Гедымина и установить его на компьютере. После этого можно запускать скомпилированный модуль и подключаться к установленной базе данных. <p/> Второй вариант заключается в том, чтобы собрать чистую (эталонную) базу данных. Необходимые SQL скрипты находятся в каталоге d:/golden/gedemin/sql. Там же находится пакетный файл create.bat, с помощью которого вы сможете собрать базу.

8. Установка настроек

Воспользовавшись одним из имеющихся на сайте дистрибутивов вы получите базу данных с установленными прикладными решениями. Но, если вы создали чистую эталонную базу из SQL скриптов, прикладные настройки необходимо установить вручную. Для этого:

• 1. скачайте соответствующий архив с сайта компании и распакуйте его в произвольный каталог;
• 2. запустите gedemin.exe и подключитесь к эталонной базе данных;
• 3. из меню «Сервис» выберите команду «Установить пакеты настроек…»;
• 4. отметьте галочками нужные пакеты и нажмите кнопку «Установить».