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

Материал из GedeminWiki
(Различия между версиями)
Перейти к: навигация, поиск
(Самый первый запуск на этом компьютере)
(Шаг 9)
Строка 128: Строка 128:
 
   gedemin.exe /sn localhost:c:\golden\base\etalon.fdb /user Administrator /password Administrator
 
   gedemin.exe /sn localhost:c:\golden\base\etalon.fdb /user Administrator /password Administrator
  
== Шаг 9 ==
+
== Шаг 9 (не обязательный) ==
  
 
На чистую эталонную базу данных можно загрузить прикладные настройки:  
 
На чистую эталонную базу данных можно загрузить прикладные настройки:  

Версия 17:21, 9 апреля 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. Скачиваем архив с исходным кодом платформы с сайта Golden Software.
  3. Распаковываем в каталог содержимое архива (должно получиться два подкаталога Comp5 и Gedemin).

Или подключение к SubVersion (буду участвовать в проекте)

  1. Сообщите нам ваш акаунт в системе gmail.com по электронной почте на адрес support[at]gsbelarus.com. Если у вас нет акаунта, то его надо создать.
  2. Дождитесь уведомления, что ваш акаунт занесен в список разработчиков. Теперь вы можете скачать исходный код через систему контроля версий SubVersion.
  3. Скачайте TortoiseSVN c сайта tortoisesvn.tigris.org. Необходима версия не ниже 1.6.1. Если нужная версия не доступна на главной странице, то скачайте ее из раздела пре-релизов. Установочный файл имеет размер порядка 18-19 Мб.
  4. Установите TortoiseSVN.
  5. Создайте папку для размещения исходного кода, например, c:\golden. Внимание! Папка должна быть пустой.
  6. Выберите созданную папку правой клавишей мыши и вызовите команду SVN Checkout...
  7. Заполните параметры диалогового окна, как показано на рисунке ниже:

compile_gedemin_3.png

В ответ на запрос, введите имя вашей учетной записи и пароль, который можно получить на этой странице (Обратите внимание на фразу "When prompted, enter your generated googlecode.com password", которая содержит ссылку для получения пароля).

Дополнительные инструкции по настройке клиентской программы и получению исходного кода вы найдете на этой странице.

Шаг 5

Компилируем библиотеки и выполняемый файл gedemin.exe:

  1. Запустим Delphi.
  2. Откроем группу проектов c:/golden/gedemin/gedemin.bpg.
  3. Поочередно, для каждого модуля из списка выполним команды Build и Install (обе команды вызываются из контекстного меню, как показано на этом рисунке):
    1. SynEdit_D5.bpl
    2. tb2k_d5.bpl
    3. tb2kdsgn_d5.bpl
    4. fr5.bpl
    5. greference.bpl
  4. Выполним команду Build для:
    1. gedemin.exe
    2. gudf.dll

В некоторых случаях, при выполнении команды Install для библиотеки tb2kdsgn_d5.bpl возникает ошибка. В этом случае следует повторно выполнить команды Build и Install для модулей tb2k_d5.bpl и tb2kdsgn_d5.bpl.

Файлы, получившиеся в результате компиляции, располагаются в следующих подкаталогах каталога c:\golden\gedemin:

  • DCU -- откомпилированные юниты.
  • BPL -- откомпилированные библиотеки.
  • EXE -- файлы gedemin.exe и gudf.dll.

Запускать Гедымин еще рано! Необходимо сначала создать базу данных.

Шаг 6

Откомпилированный файл GUDF.DLL копируем в подкаталог UDF сервера Firebird. Если вы не меняли пути по-умолчанию при установке последнего, то это будет папка c:\Program Files\Firebird\UDF.

Шаг 7

  • Создайте каталог для размещения файла базы данных, например, c:\golden\base.
  • Перейдите в режим командной строки (Пуск -> Выполнить... -> cmd).
  • Перейдите в папку c:\golden\gedemin\sql
 c:
 cd \golden\gedemin\sql
  • Запустите команду cr.bat в качестве параметров указав имя сервера (localhost) и полное имя файла базы данных в созданной вами папке:
 cr.bat localhost c:\golden\base\etalon.fdb

Дождитесь окончания выполнения. В случае успеха на экране должны появиться две строчки:

 c:\golden\gedemin\SQL>cr.bat localhost c:\golden\base\etalon.fdb
 Use CONNECT or CREATE DATABASE to specify a database
 Use CONNECT or CREATE DATABASE to specify a database

Шаг 8

Запустим Гедымин и подключимся к созданной базе данных.

Самый первый запуск на этом компьютере

При самом первом запуске Гедымин не найдет в реестре информации о базе данных и выведет на экран окно для регистрации. Выберем в нем кнопку Добавить:

compile_gedemin_1.png

Заполним поля с псевдонимом базы данных и полным путем к файлу базы данных (находятся в нижней части окна), как показано на рисунке ниже:

compile_gedemin_2.png

Нажмем кнопку Сохранить, а затем кнопку Выбрать.

При первом подключении к серверу должна быть выполнена его настройка. Она выполняется автоматически, при этом Гедымин может запросить пароль учетной записи SYSDBA сервера Firebird. Если Вы не меняли пароль по-умолчанию, то это -- masterkey. Не путайте учетную запись сервера Firebird и учетную запись платформы Гедымин.

Учетная запись для подключения к базе данных -- Administrator. Пароль Administrator.

Если Гедымин был уже установлен на этом компьютере

Если до этого Гедымин уже был установлен на данном компьютере, то на экране откроется окно ввода имени пользователя и пароля. Для регистрации созданной нами базы данных в таком случае, надо выбрать команду <Зарегистрировать> из выпадающего списка баз данных.

Запуск с указанием параметров командной строки

Перейдем в папку c:\golden\gedemin\exe и выполним следующую команду:

 gedemin.exe /sn localhost:c:\golden\base\etalon.fdb /user Administrator /password Administrator

Шаг 9 (не обязательный)

На чистую эталонную базу данных можно загрузить прикладные настройки:

  1. Создадим каталог c:\golden\setting.
  2. Скачаем архив с настройками и распакуем его в созданный каталог.
  3. Запустим gedemin.exe и подключимся к эталонной базе данных под учетной записью Administrator.
  4. Из меню Сервис выберем команду Установить пакеты настроек...
  5. Отметим галочками нужные пакеты (например, Банк и касса) и нажмем кнопку Установить.
  6. Дождемся успешного завершения выполнения проекта.

Примечания

Генератор отчетов FastReport

Информацию о генераторе отчетов FastReport можно получить на сайте http://fastreport.ru. Не устанавливайте полученный с сайта самостоятельно дистрибутив поверх файлов, входящих в проект Гедымин, так как в них были внесены некоторые изменения, которых нет в оригинальной поставке.

Список библиотек

  1. SynEdit_D5.bpl — визуальные компоненты редактора программного кода с подсветкой синтаксиса;
  2. tb2k_d5.bpl — набор визуальных компонентов Toolbar 2000;
  3. tb2kdsgn_d5.bpl — набор визуальных компонентов Toolbar 2000 (design package);
  4. fr5.bpl — генератор отчетов FastReport.
  5. greference.bpl — библиотека визуальных компонентов компании Golden Software, используемых проектом Гедымин;
  6. gudf.dll — библиотека UDF (User Defined Function) функций для сервера базы данных.
Персональные инструменты
Пространства имён

Варианты
Действия
Навигация
Инструменты