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

Материал из GedeminWiki
Версия от 13:31, 3 августа 2017; SYSDBA (обсуждение | вклад)

(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)
Перейти к: навигация, поиск

Для компиляции Гедымина необходимы:

  1. Операционная система не хуже Windows XP SP2 или Windows Server 2003.
  2. Дистрибутив Delphi 5 и Update Pack 1 к нему.
  3. Дистрибутив Firebird 2.5 32-bit.
  4. Установленный git (чтобы работать не через командную строку мы рекомендуем оболочку Tortoise Git, хотя у вас могут быть и свои предпочтения).
  5. Учетная запись на github.com, если вы планируете вносить изменения в исходники.

Простейший способ откомпилировать Гедымин — воспользоваться готовой виртуальной машиной в формате Virtual Box. При желании, вы можете самостоятельно установить необходимое программное обеспечение, скачать исходный код и собрать из него выполняемый модуль gedemin.exe. Ниже приведена подробная пошаговая инструкция:

Шаг 1

Проверяем версию операционной системы.

Шаг 2

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

  1. Устанавливаем Borland Delphi 5. При указании параметров установки НЕ СТАВИМ Borland Interbase и его клиентскую часть.
  2. Устанавливаем Update Pack 1 (под Windows 7 и выше обновление Delphi следует запускать в режиме совместимости с Windows XP SP2).
  3. Запускаем Delphi.
    1. Под Windows 7 и выше при возникновении ошибок в процессе загрузки и работы Delphi следует установить в ярлыке запуск в режиме совместимости с Windows XP SP2, с правами Администратора.
    2. Если ошибки будут продолжаться следует отключить DEP (Data execute prevention) в параметрах операционной системы)
    3. При запуске Delphi под Windows 2008 Server и Windows 2012 Server возможно появление ошибки в процессе загрузки библиотеки dclite50.bpl. В этом случае следует удалить данную библиотеку из списка в окне Install packages...
  4. Открываем меню Component и выбираем команду Install packages...
  5. В списке Design packages отыскиваем позицию Interbase Data Access Components и снимаем галочку напротив нее.
  6. Закрываем Delphi.
  7. Удаляем из каталога Program Files/Borland/Delphi5/Bin файл DCLIB50.BPL (под Windows x64 каталог Program Files (x86)/Borland/Delphi5/Bin).
  8. Удаляем из каталога WINDOWS/SYSTEM32 файл VCLIB50.BPL (под Windows x64 каталог Windows/SysWOW64).
  9. Заходим в каталог Program Files/Borland/Delphi5/Source/Vcl и удаляем все файлы по маске IB*.* (под Windows x64 каталог Program Files (x86)/Borland/Delphi5/Source/Vcl).

Шаг 3

  • Заходим на сайт firebirdsql.org и скачиваем установку сервера Firebird 2.5 32-bit.
  • Запускаем ее.
  • В процессе установки вам будет предложено указать путь для размещения файлов сервера:

compile_gedemin_5.png

Путь, предлагаемый по-умолчанию, c:\Program Files\Firebird\Firebird_2_5.

  • Выбираем тип установки:

compile_gedemin_6.png

  • и параметры:

compile_gedemin_7.png

  • Завершаем установку.
  • В глобальную переменную окружения Path добавим путь к папке bin сервера Firebird -- "c:\program files\firebird\firebird_2_5\bin"

Шаг 4

Для работы с исходниками под Windows удобнее всего установить TortoiseGit:

  1. Скачиваем инстолятор в соответствии с разрядностью ОС.
  2. Устанавливаем.
  3. Скачиваем новейшую установку Git для Windows.
  4. Устанавливаем:
    1. В списке устанавливаемых компонент снимаем галку Windows Explorer integration (все равно мы будем обращаться к Git через оболочку TortoiseGit).
    2. Для обработки символов конца строки устанавливаем галку Checkout Windows style, commit Unix style. Эта опция выбрана по умолчанию в инстоляторе.
    3. Если будет предложено, перезагружаем компьютер.
  5. Создаем папку для размещения исходников. Например, c:\golden.
  6. Жмем правой кнопкой на нее и из меню выбираем Git Clone...
  7. Прописываем в поле URL: https://github.com/GoldenSoftwareLtd/gedemin-private.git (Внимание! данный репозиторий приватный. Чтобы получить доступ, сообщите нам свой акаунт на github и мы добавим вас в списки).
  8. В поле Directory: проверяем, чтобы был указан нужный нам каталог.
  9. Жмем Ок. При необходимости вводим свою учетную запись на github и пароль. Ждем.

Git распределенная система контроля версий. На каждой машине хранится полная история всех изменений проекта, с которой можно работать автономно, даже при отсутствии подключения к сети. Передавать изменения между разработчиками можно как напрямую, так и через централизованный сервер. В сети присутствует огромное количество документации по Git. Для быстрого старта понадобятся всего несколько команд, которые вызываются из контекстного меню TortoiseGit в исследователе Windows (кликаем правой кнопкой мыши на папке с исходниками):

   Получить последнюю версию файлов с сервера -- Pull...
   Записать сделанные изменения -- Git Commit... (по правой кнопке мыши на файле в диалоговом окне можно посмотреть что было изменено). 
     Важно! Перед выполнением Git Commit всегда выполняйте команду Pull, чтобы сохранять линейную последовательность версий исходного кода.
   Переслать изменения на сервер -- Push... (система потребует ввести логин, как правило имя вашего почтового ящика gmail, и пароль, который можно получить залогинившись в проект и перейдя по этой ссылке).
   Посмотреть историю изменения файла -- Show log... (по правой кнопке мыши можно сравнить любые две ревизии между собой).

Все действия можно сделать из одного окна, вызываемого командой Git sync...

Шаг 5

  • Находим и выполняем в папке Gedemin команду prepare_sources.bat
  • Находим и выполняем в папке Comp5 команду prepare_sources.bat

Шаг 6

Компилируем библиотеки и выполняемый файл 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.

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

Шаг 7

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

Шаг 8

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

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

 Use CONNECT or CREATE DATABASE to specify a database
 Обработана таблица: AC_ACCOUNT...
 Обработана таблица: AC_TRANSACTION...
 Обработана таблица: EVT_MACROSGROUP...
 Обработана таблица: EVT_OBJECT...
 Обработана таблица: GD_CONTACT...
 Обработана таблица: GD_DOCUMENTTYPE...
 Обработана таблица: GD_FILE...
 Обработана таблица: GD_GOODGROUP...
 Обработана таблица: GD_PLACE...
 Обработана таблица: MSG_BOX...
 Обработана таблица: RP_REPORTGROUP...
 Use CONNECT or CREATE DATABASE to specify a database

Обратите внимание, что файл cr.bat удаляет существующую базу данных с заданным именем, перед формированием новой.

Примечание: для выполнения команды cr.bat в системной переменной окружения должен быть указан путь к папке bin сервера Firebird.

Шаг 9

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

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

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

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

Подключение к чистой базе данных

Чтобы каждый раз не заполнять все реквизиты при первом подключении к чистой базе данных просто дважды щелкните по полю с наименованием организации.

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

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

Примечания

Генератор отчетов 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) функций для сервера базы данных.

См. также

Персональные инструменты
Пространства имён

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