Компиляция платформы Гедымин
SYSDBA (обсуждение | вклад) (→Шаг 4) |
SYSDBA (обсуждение | вклад) (→Шаг 10 (не обязательный)) |
||
(не показана 41 промежуточная версия 2 участников) | |||
Строка 1: | Строка 1: | ||
− | Ниже приведена подробная пошаговая инструкция | + | Для компиляции Гедымина необходимы: |
+ | |||
+ | # Операционная система не хуже Windows XP SP2 или Windows Server 2003. | ||
+ | # Дистрибутив Delphi 5 и Update Pack 1 к нему. | ||
+ | # Дистрибутив Firebird 2.5 32-bit. | ||
+ | # Установленный git (чтобы работать не через командную строку мы рекомендуем оболочку Tortoise Git, хотя у вас могут быть и свои предпочтения). | ||
+ | # Учетная запись на github.com, если вы планируете вносить изменения в исходники. | ||
+ | |||
+ | Простейший способ откомпилировать Гедымин — воспользоваться готовой [http://gedemin.blogspot.com/2012/08/blog-post.html виртуальной машиной] в формате Virtual Box. При желании, вы можете самостоятельно установить необходимое программное обеспечение, скачать исходный код и собрать из него выполняемый модуль gedemin.exe. Ниже приведена подробная пошаговая инструкция: | ||
== Шаг 1 == | == Шаг 1 == | ||
− | Проверяем | + | Проверяем версию операционной системы. |
== Шаг 2 == | == Шаг 2 == | ||
Строка 9: | Строка 17: | ||
Устанавливаем и настраиваем компилятор Borland Delphi 5: | Устанавливаем и настраиваем компилятор Borland Delphi 5: | ||
− | # Устанавливаем Borland Delphi 5. При указании параметров установки НЕ СТАВИМ Borland Interbase и его клиентскую часть. | + | # Устанавливаем Borland Delphi 5. При указании параметров установки '''НЕ СТАВИМ''' Borland Interbase и его клиентскую часть. |
− | # Устанавливаем Update Pack 1. | + | # Устанавливаем Update Pack 1 (под Windows 7 и выше обновление Delphi следует запускать в режиме совместимости с Windows XP SP2). |
− | # Запускаем Delphi. | + | # Запускаем Delphi. |
+ | ## Под Windows 7 и выше при возникновении ошибок в процессе загрузки и работы Delphi следует установить в ярлыке запуск в режиме совместимости с Windows XP SP2, с правами Администратора. | ||
+ | ## Если ошибки будут продолжаться следует отключить DEP (Data execute prevention) в параметрах операционной системы) | ||
+ | ## При запуске Delphi под Windows 2008 Server и Windows 2012 Server возможно появление ошибки в процессе загрузки библиотеки dclite50.bpl. В этом случае следует удалить данную библиотеку из списка в окне Install packages... | ||
# Открываем меню Component и выбираем команду Install packages... | # Открываем меню Component и выбираем команду Install packages... | ||
# В списке Design packages отыскиваем позицию Interbase Data Access Components и снимаем галочку напротив нее. | # В списке Design packages отыскиваем позицию Interbase Data Access Components и снимаем галочку напротив нее. | ||
# Закрываем Delphi. | # Закрываем Delphi. | ||
− | # Удаляем из каталога Program Files/Borland/Delphi5/Bin файл DCLIB50.BPL. | + | # Удаляем из каталога Program Files/Borland/Delphi5/Bin файл DCLIB50.BPL (под Windows x64 каталог Program Files (x86)/Borland/Delphi5/Bin). |
− | # Удаляем из каталога WINDOWS/SYSTEM32 файл VCLIB50.BPL. | + | # Удаляем из каталога WINDOWS/SYSTEM32 файл VCLIB50.BPL (под Windows x64 каталог Windows/SysWOW64). |
− | # Заходим в каталог Program Files/Borland/Delphi5/Source/Vcl и удаляем все файлы по маске IB*.*. | + | # Заходим в каталог Program Files/Borland/Delphi5/Source/Vcl и удаляем все файлы по маске IB*.* (под Windows x64 каталог Program Files (x86)/Borland/Delphi5/Source/Vcl). |
== Шаг 3 == | == Шаг 3 == | ||
− | * Заходим на сайт [http://www.firebirdsql.org firebirdsql.org] и скачиваем установку сервера Firebird 2.5 | + | * Заходим на сайт [http://www.firebirdsql.org firebirdsql.org] и скачиваем установку сервера Firebird 2.5 32-bit. |
* Запускаем ее. | * Запускаем ее. | ||
* В процессе установки вам будет предложено указать путь для размещения файлов сервера: | * В процессе установки вам будет предложено указать путь для размещения файлов сервера: | ||
Строка 38: | Строка 49: | ||
* Завершаем установку. | * Завершаем установку. | ||
+ | * В глобальную переменную окружения Path добавим путь к папке bin сервера Firebird -- "c:\program files\firebird\firebird_2_5\bin" | ||
== Шаг 4 == | == Шаг 4 == | ||
− | + | Для работы с исходниками под Windows удобнее всего установить '''TortoiseGit''': | |
− | + | # Скачиваем [https://tortoisegit.org/download/ инстолятор] в соответствии с разрядностью ОС. | |
+ | # Устанавливаем. | ||
+ | # Скачиваем новейшую [https://git-scm.com/download/win установку Git] для Windows. | ||
+ | # Устанавливаем: | ||
+ | ## В списке устанавливаемых компонент снимаем галку '''Windows Explorer integration''' (все равно мы будем обращаться к Git через оболочку TortoiseGit). | ||
+ | ## Для обработки символов конца строки устанавливаем галку '''Checkout Windows style, commit Unix style'''. Эта опция выбрана по умолчанию в инстоляторе. | ||
+ | ## Если будет предложено, перезагружаем компьютер. | ||
+ | # Создаем папку для размещения исходников. Например, c:\golden. | ||
+ | # Жмем правой кнопкой на нее и из меню выбираем '''Git Clone...''' | ||
+ | # Прописываем в поле URL: ''https://github.com/GoldenSoftwareLtd/gedemin-private.git'' (Внимание! данный репозиторий приватный. Чтобы получить доступ, сообщите нам свой акаунт на github и мы добавим вас в списки). | ||
+ | # В поле Directory: проверяем, чтобы был указан нужный нам каталог. | ||
+ | # Жмем Ок. При необходимости вводим свою учетную запись на [http://github.com 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: | Компилируем библиотеки и выполняемый файл gedemin.exe: | ||
Строка 91: | Строка 109: | ||
Запускать Гедымин еще рано! Необходимо сначала создать базу данных. | Запускать Гедымин еще рано! Необходимо сначала создать базу данных. | ||
− | == Шаг | + | == Шаг 7 == |
− | Откомпилированный файл GUDF.DLL копируем в подкаталог UDF сервера Firebird. Если вы не меняли пути по-умолчанию при установке последнего, то это будет папка c:\Program Files\Firebird\UDF. | + | Откомпилированный файл GUDF.DLL (находится в папке \Golden\Gedemin\EXE) копируем в подкаталог UDF сервера Firebird. Если вы не меняли пути по-умолчанию при установке последнего, то это будет папка c:\Program Files\Firebird\UDF. |
− | == Шаг | + | == Шаг 8 == |
* Создайте каталог для размещения файла базы данных, например, c:\golden\base. | * Создайте каталог для размещения файла базы данных, например, c:\golden\base. | ||
Строка 104: | Строка 122: | ||
cd \golden\gedemin\sql | cd \golden\gedemin\sql | ||
− | * Запустите команду cr.bat в качестве параметров указав имя сервера (localhost) | + | * Запустите команду cr.bat в качестве параметров указав имя сервера (localhost), полное имя файла базы данных в созданной вами папке и путь к каталогу с сервером Firebird: |
− | cr.bat localhost c:\golden\base\etalon.fdb | + | 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 | ||
+ | Обработана таблица: 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 | Use CONNECT or CREATE DATABASE to specify a database | ||
− | == Шаг | + | Обратите внимание, что файл cr.bat удаляет существующую базу данных с заданным именем, перед формированием новой. |
+ | |||
+ | Примечание: для выполнения команды cr.bat в системной переменной окружения должен быть указан путь к папке bin сервера Firebird. | ||
+ | |||
+ | == Шаг 9 == | ||
Запустим Гедымин и подключимся к созданной базе данных. | Запустим Гедымин и подключимся к созданной базе данных. | ||
Строка 144: | Строка 176: | ||
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 | ||
− | == | + | ==== Подключение к чистой базе данных ==== |
− | + | Чтобы каждый раз не заполнять все реквизиты при первом подключении к чистой базе данных просто дважды щелкните по полю с наименованием организации. | |
− | + | == Шаг 10 (не обязательный) == | |
− | + | ||
− | + | На чистую эталонную базу данных можно [[Установка прикладного решения|загрузить пространства имен]] с прикладными решениями. | |
− | + | ||
− | + | ||
− | + | ||
== Примечания == | == Примечания == | ||
Строка 169: | Строка 198: | ||
# greference.bpl — библиотека визуальных компонентов компании Golden Software, используемых проектом Гедымин; | # greference.bpl — библиотека визуальных компонентов компании Golden Software, используемых проектом Гедымин; | ||
# gudf.dll — библиотека UDF (User Defined Function) функций для сервера базы данных. | # gudf.dll — библиотека UDF (User Defined Function) функций для сервера базы данных. | ||
+ | |||
+ | == См. также == | ||
+ | |||
+ | * [[Символы условной компиляции gedemin.exe]] | ||
+ | |||
+ | [[Category:Руководство разработчика]] | ||
+ | |||
+ | __NOTOC__ |
Версия 10:31, 3 августа 2017
Для компиляции Гедымина необходимы:
- Операционная система не хуже Windows XP SP2 или Windows Server 2003.
- Дистрибутив Delphi 5 и Update Pack 1 к нему.
- Дистрибутив Firebird 2.5 32-bit.
- Установленный git (чтобы работать не через командную строку мы рекомендуем оболочку Tortoise Git, хотя у вас могут быть и свои предпочтения).
- Учетная запись на github.com, если вы планируете вносить изменения в исходники.
Простейший способ откомпилировать Гедымин — воспользоваться готовой виртуальной машиной в формате Virtual Box. При желании, вы можете самостоятельно установить необходимое программное обеспечение, скачать исходный код и собрать из него выполняемый модуль gedemin.exe. Ниже приведена подробная пошаговая инструкция:
Шаг 1
Проверяем версию операционной системы.
Шаг 2
Устанавливаем и настраиваем компилятор Borland Delphi 5:
- Устанавливаем Borland Delphi 5. При указании параметров установки НЕ СТАВИМ Borland Interbase и его клиентскую часть.
- Устанавливаем Update Pack 1 (под Windows 7 и выше обновление Delphi следует запускать в режиме совместимости с Windows XP SP2).
- Запускаем Delphi.
- Под Windows 7 и выше при возникновении ошибок в процессе загрузки и работы Delphi следует установить в ярлыке запуск в режиме совместимости с Windows XP SP2, с правами Администратора.
- Если ошибки будут продолжаться следует отключить DEP (Data execute prevention) в параметрах операционной системы)
- При запуске Delphi под Windows 2008 Server и Windows 2012 Server возможно появление ошибки в процессе загрузки библиотеки dclite50.bpl. В этом случае следует удалить данную библиотеку из списка в окне Install packages...
- Открываем меню Component и выбираем команду Install packages...
- В списке Design packages отыскиваем позицию Interbase Data Access Components и снимаем галочку напротив нее.
- Закрываем Delphi.
- Удаляем из каталога Program Files/Borland/Delphi5/Bin файл DCLIB50.BPL (под Windows x64 каталог Program Files (x86)/Borland/Delphi5/Bin).
- Удаляем из каталога WINDOWS/SYSTEM32 файл VCLIB50.BPL (под Windows x64 каталог Windows/SysWOW64).
- Заходим в каталог Program Files/Borland/Delphi5/Source/Vcl и удаляем все файлы по маске IB*.* (под Windows x64 каталог Program Files (x86)/Borland/Delphi5/Source/Vcl).
Шаг 3
- Заходим на сайт firebirdsql.org и скачиваем установку сервера Firebird 2.5 32-bit.
- Запускаем ее.
- В процессе установки вам будет предложено указать путь для размещения файлов сервера:
Путь, предлагаемый по-умолчанию, c:\Program Files\Firebird\Firebird_2_5.
- Выбираем тип установки:
- и параметры:
- Завершаем установку.
- В глобальную переменную окружения Path добавим путь к папке bin сервера Firebird -- "c:\program files\firebird\firebird_2_5\bin"
Шаг 4
Для работы с исходниками под Windows удобнее всего установить TortoiseGit:
- Скачиваем инстолятор в соответствии с разрядностью ОС.
- Устанавливаем.
- Скачиваем новейшую установку Git для Windows.
- Устанавливаем:
- В списке устанавливаемых компонент снимаем галку Windows Explorer integration (все равно мы будем обращаться к Git через оболочку TortoiseGit).
- Для обработки символов конца строки устанавливаем галку Checkout Windows style, commit Unix style. Эта опция выбрана по умолчанию в инстоляторе.
- Если будет предложено, перезагружаем компьютер.
- Создаем папку для размещения исходников. Например, c:\golden.
- Жмем правой кнопкой на нее и из меню выбираем Git Clone...
- Прописываем в поле URL: https://github.com/GoldenSoftwareLtd/gedemin-private.git (Внимание! данный репозиторий приватный. Чтобы получить доступ, сообщите нам свой акаунт на github и мы добавим вас в списки).
- В поле Directory: проверяем, чтобы был указан нужный нам каталог.
- Жмем Ок. При необходимости вводим свою учетную запись на 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:
- Запустим Delphi.
- Откроем группу проектов c:/golden/gedemin/gedemin.bpg.
- Поочередно, для каждого модуля из списка выполним команды Build и Install (обе команды вызываются из контекстного меню, как показано на этом рисунке):
- SynEdit_D5.bpl
- tb2k_d5.bpl
- tb2kdsgn_d5.bpl
- fr5.bpl
- greference.bpl
- Выполним команду Build для:
- gedemin.exe
- 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
Запустим Гедымин и подключимся к созданной базе данных.
Самый первый запуск на этом компьютере
При самом первом запуске Гедымин не найдет в реестре информации о базе данных и выведет на экран окно для регистрации. Выберем в нем кнопку Добавить:
Заполним поля с псевдонимом базы данных и полным путем к файлу базы данных (находятся в нижней части окна), как показано на рисунке ниже:
Нажмем кнопку Сохранить, а затем кнопку Выбрать.
При первом подключении к серверу должна быть выполнена его настройка. Она выполняется автоматически, при этом Гедымин может запросить пароль учетной записи 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. Не устанавливайте полученный с сайта самостоятельно дистрибутив поверх файлов, входящих в проект Гедымин, так как в них были внесены некоторые изменения, которых нет в оригинальной поставке.
Список библиотек
- SynEdit_D5.bpl — визуальные компоненты редактора программного кода с подсветкой синтаксиса;
- tb2k_d5.bpl — набор визуальных компонентов Toolbar 2000;
- tb2kdsgn_d5.bpl — набор визуальных компонентов Toolbar 2000 (design package);
- fr5.bpl — генератор отчетов FastReport.
- greference.bpl — библиотека визуальных компонентов компании Golden Software, используемых проектом Гедымин;
- gudf.dll — библиотека UDF (User Defined Function) функций для сервера базы данных.