|
|
(не показаны 55 промежуточных версий 2 участников) |
Строка 1: |
Строка 1: |
− | Ниже приведена подробная пошаговая инструкция о том, как самостоятельно скомпилировать и запустить платформу Гедымин.
| |
| | | |
− | == Шаг 1 ==
| + | * [[Компиляция платформы Гедымин (Delphi 7)]] |
− | | + | * [[Компиляция платформы Гедымин (Delphi 5)]] |
− | Проверяем операционную систему. Вам понадобится Windows XP с установленным SP2 или SP3.
| + | |
− | | + | |
− | == Шаг 2 ==
| + | |
− | | + | |
− | Устанавливаем и настраиваем компилятор Borland Delphi 5:
| + | |
− | | + | |
− | # Устанавливаем Borland Delphi 5. При указании параметров установки НЕ СТАВИМ Borland Interbase и его клиентскую часть.
| + | |
− | # Устанавливаем Update Pack 1.
| + | |
− | # Запускаем Delphi.
| + | |
− | # Открываем меню Component и выбираем команду Install packages...
| + | |
− | # В списке Design packages отыскиваем позицию Interbase Data Access Components и снимаем галочку напротив нее.
| + | |
− | # Закрываем Delphi.
| + | |
− | # Удаляем из каталога Program Files/Borland/Delphi5/Bin файл DCLIB50.BPL.
| + | |
− | # Удаляем из каталога WINDOWS/SYSTEM32 файл VCLIB50.BPL.
| + | |
− | # Заходим в каталог Program Files/Borland/Delphi5/Source/Vcl и удаляем все файлы по маске IB*.*.
| + | |
− | | + | |
− | == Шаг 3 ==
| + | |
− | | + | |
− | Заходим на сайт [http://www.firebirdsql.org firebirdsql.org] и скачиваем установку сервера Firebird 2.5 (на момент написания данной инструкции была доступна версия 2.5 Beta 1). Запускаем ее и устанавливаем сервер в режиме Super Server.
| + | |
− | | + | |
− | == Шаг 4 ==
| + | |
− | | + | |
− | В зависимости от того, планируете ли Вы в дальнейшем принимать участие в разработке платформы или просто хотите откомпилировать выполняемый файл для себя, существует два варианта получения исходных кодов. Воспользуйтесь одним из них.
| + | |
− | | + | |
− | ==== Или распаковка архива с исходным кодом (компилирую для себя) ====
| + | |
− | | + | |
− | # Создаем каталог на диске. Например, c:\golden (в дальнейшем мы будем считать, что создан каталог именно с таким именем).
| + | |
− | # Скачиваем архив с исходным кодом платформы с сайта [http://gsbelarus.com/gs/modules.php?name=Downloads&d_op=getit&lid=29 Golden Software].
| + | |
− | # Распаковываем в каталог содержимое архива (должно получиться два подкаталога Comp5 и Gedemin).
| + | |
− | | + | |
− | ==== Или подключение к SubVersion (буду участвовать в проекте) ====
| + | |
− | | + | |
− | # Сообщите нам ваш акаунт в системе [http://gmail.com gmail.com] по электронной почте на адрес support[at]gsbelarus.com. Если у вас нет акаунта, то его надо создать.
| + | |
− | # Дождитесь уведомления, что ваш акаунт занесен в список разработчиков. Теперь вы можете скачать исходный код через систему контроля версий SubVersion.
| + | |
− | # Скачайте TortoiseSVN c сайта [http://tortoisesvn.tigris.org/ tortoisesvn.tigris.org]. Необходима версия не ниже 1.6.1. Если нужная версия не доступна на главной странице, то скачайте ее из [http://nightlybuilds.tortoisesvn.net/latest/win32/ раздела пре-релизов]. Установочный файл имеет размер порядка 18-19 Мб.
| + | |
− | # Установите TortoiseSVN.
| + | |
− | # Создайте папку для размещения исходного кода, например, c:\golden. Внимание! Папка должна быть пустой.
| + | |
− | # Выберите созданную папку правой клавишей мыши и вызовите команду SVN Checkout...
| + | |
− | # Заполните параметры диалогового окна, как показано на рисунке ниже:
| + | |
− | | + | |
− | http://gsbelarus.com/gs/images/gs/2008/compile_gedemin_3.png
| + | |
− | | + | |
− | В ответ на запрос, введите имя вашей учетной записи и пароль, который можно получить на [http://code.google.com/p/gedemin/source/checkout этой странице] (Обратите внимание на фразу "When prompted, enter your generated googlecode.com password", которая содержит ссылку для получения пароля).
| + | |
− | | + | |
− | Дополнительные инструкции по настройке клиентской программы и получению исходного кода вы найдете [http://code.google.com/p/gedemin/source/checkout на этой странице].
| + | |
− | | + | |
− | == Шаг 5 ==
| + | |
− | | + | |
− | Компилируем библиотеки и выполняемый файл 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.
| + | |
− | | + | |
− | Запускать Гедымин еще рано! Необходимо сначала создать базу данных.
| + | |
− | | + | |
− | == Шаг 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 ==
| + | |
− | | + | |
− | Запустим Гедымин и подключимся к созданной базе данных.
| + | |
− | | + | |
− | ==== Самый первый запуск на этом компьютере ====
| + | |
− | | + | |
− | При самом первом запуске Гедымин не найдет в реестре информации о базе данных и выведет на экран окно для регистрации. Выберем в нем кнопку Добавить:
| + | |
− | | + | |
− | 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
| + | |
− | | + | |
− | == Шаг 9 (не обязательный) ==
| + | |
− | | + | |
− | На чистую эталонную базу данных можно загрузить прикладные настройки:
| + | |
− | | + | |
− | # Создадим каталог c:\golden\setting.
| + | |
− | # Скачаем [http://gsbelarus.com/gs/modules.php?name=Downloads&d_op=getit&lid=28 архив с настройками] и распакуем его в созданный каталог.
| + | |
− | # Запустим gedemin.exe и подключимся к эталонной базе данных под учетной записью Administrator.
| + | |
− | # Из меню Сервис выберем команду Установить пакеты настроек...
| + | |
− | # Отметим галочками нужные пакеты (например, Банк и касса) и нажмем кнопку Установить.
| + | |
− | # Дождемся успешного завершения выполнения проекта.
| + | |
− | | + | |
− | == Примечания ==
| + | |
− | | + | |
− | ==== Генератор отчетов 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) функций для сервера базы данных.
| + | |