|
|
| Строка 1: |
Строка 1: |
| | | | |
| | * [[Компиляция платформы Гедымин (Delphi 7)]] | | * [[Компиляция платформы Гедымин (Delphi 7)]] |
| − |
| |
| − | Для компиляции Гедымина необходимы:
| |
| − |
| |
| − | # Операционная система не хуже Windows XP SP2 или Windows Server 2003.
| |
| − | # Дистрибутив Delphi 5 и Update Pack 1 к нему.
| |
| − | # Дистрибутив Firebird 2.5 32-bit.
| |
| − | # Установленный git. Если вы предпочитаете работать через графический интерфейс, а не через командную строку -- мы рекомендуем оболочку Tortoise Git.
| |
| − | # Учетная запись на github.com, если вы планируете вносить изменения в исходники.
| |
| − | # Для компиляции gedemin.exe с помощью скрипта '''update_gedemin.bat''' понадобится утилита '''editbin''' из комплекта '''MSVC Build Tools'''.
| |
| − |
| |
| − | Простейший способ откомпилировать Гедымин — воспользоваться готовой [http://gedemin.blogspot.com/2012/08/blog-post.html виртуальной машиной] в формате Virtual Box. При желании, вы можете самостоятельно установить необходимое программное обеспечение, скачать исходный код и собрать из него выполняемый модуль gedemin.exe. Ниже приведена подробная пошаговая инструкция:
| |
| − |
| |
| − | == Шаг 1 ==
| |
| − |
| |
| − | Проверяем версию операционной системы.
| |
| − |
| |
| − | == Шаг 2 ==
| |
| − |
| |
| − | ''ВНИМАНИЕ! На некоторых версиях Windows 10 инстолятор Delphi 5 может зависать при запуске. В этом случае следует загрузить компьютер в режиме Safe Boot с минимальным набором драйверов и базовым видео. После установки Delphi и обновления к нему следует перевести режим загрузки в нормальный.''
| |
| − |
| |
| − | Устанавливаем и настраиваем компилятор Borland Delphi 5:
| |
| − |
| |
| − | # Устанавливаем Borland Delphi 5 в папку с коротким именем в корне диска (например, c:\D5 или c:\DELPHI5). При указании параметров установки '''НЕ СТАВИМ''' 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 ==
| |
| − |
| |
| − | * Заходим на сайт [http://www.firebirdsql.org firebirdsql.org] и скачиваем установку сервера Firebird 2.5 32-bit.
| |
| − | * Запускаем ее.
| |
| − | * В процессе установки вам будет предложено указать путь для размещения файлов сервера:
| |
| − |
| |
| − | http://gsbelarus.com/gs/images/gs/2008/compile_gedemin_5.png
| |
| − |
| |
| − | Путь, предлагаемый по-умолчанию, c:\Program Files\Firebird\Firebird_2_5.
| |
| − |
| |
| − | * Выбираем тип установки:
| |
| − |
| |
| − | http://gsbelarus.com/gs/images/gs/2008/compile_gedemin_6.png
| |
| − |
| |
| − | * и параметры:
| |
| − |
| |
| − | http://gsbelarus.com/gs/images/gs/2008/compile_gedemin_7.png
| |
| − |
| |
| − | * Завершаем установку.
| |
| − | * В глобальную переменную окружения Path добавим путь к папке bin сервера Firebird -- "c:\program files\firebird\firebird_2_5\bin"
| |
| − |
| |
| − | == Шаг 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'''
| |
| − |
| |
| − | ВНИМАНИЕ! В файлах .cfg и .dof, которые получатся после выполнения вышеуказанных пакетных файлов, надо проверить и при необходимости скорректировать путь к папке, где установлена система Delphi5.
| |
| − |
| |
| − | == Шаг 6 ==
| |
| − |
| |
| − | Компилируем библиотеки и выполняемый файл gedemin.exe:
| |
| − |
| |
| − | # Запустим Delphi.
| |
| − | # Откроем группу проектов c:/golden/gedemin/gedemin.bpg.
| |
| − | # Поочередно, для каждого модуля из списка выполним команды Build и Install (обе команды вызываются из контекстного меню, как показано на [http://gsbelarus.com/gs/images/gs/2008/compile_gedemin_4.png этом рисунке]):
| |
| − | ## 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 ==
| |
| − |
| |
| − | Запустим Гедымин и подключимся к созданной базе данных.
| |
| − |
| |
| − | ==== Самый первый запуск на этом компьютере ====
| |
| − |
| |
| − | При самом первом запуске Гедымин не найдет в реестре информации о базе данных и выведет на экран окно для регистрации. Выберем в нем кнопку Добавить:
| |
| − |
| |
| − | http://gsbelarus.com/gs/images/gs/2008/compile_gedemin_1.png
| |
| − |
| |
| − | Заполним поля с псевдонимом базы данных и полным путем к файлу базы данных (находятся в нижней части окна), как показано на рисунке ниже:
| |
| − |
| |
| − | http://gsbelarus.com/gs/images/gs/2008/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. Не устанавливайте полученный с сайта самостоятельно дистрибутив поверх файлов, входящих в проект Гедымин, так как в них были внесены некоторые изменения, которых нет в оригинальной поставке.
| |
| − |
| |
| − | ==== Список библиотек ====
| |
| − |
| |
| − | # 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) функций для сервера базы данных.
| |
| − |
| |
| − | == См. также ==
| |
| − |
| |
| − | * [[Символы условной компиляции gedemin.exe]]
| |
| − | * [[Список файлов дистрибутива платформы Гедымин]]
| |
| − |
| |
| − | [[Category:Руководство разработчика]]
| |
| − |
| |
| − | __NOTOC__
| |
