wiki:build

avalon / инструкция по сборке

инструкция по сборке для Linux

После установки Qt, настройки MySQL и установки/настройки Highlight.js (и/или GNU Source-highlight, Colorer, Enscript) необходимо скачать требуемую версию исходного кода или загрузить ее из репозитория. Например:

$ svn checkout svn://opensvn.ru/avalon/trunk

Все скрипты, необходимые для установки находятся в директории dev проекта.

создание хранилища mysql

Для создания хранилища на базе MySQL запустите на выполнение скрипт avalon.mysql.sql:

$ mysql -u root -p --execute="source avalon.sql;"

При этом будет создана база данных с именем `avalon` и необходимые таблицы.

После этого, необходимо таким же образом последовательно установить патчи вида avalon.mysql.xxx.sql (где xxx - последовательный номер патча), если таковые имеются:

$ mysql -u root -p --execute="source avalon.mysql.000.sql;"
$ mysql -u root -p --execute="source avalon.mysql.001.sql;"
...
$ mysql -u root -p --execute="source avalon.mysql.xxx.sql;"

Если хранилище уже установлено и производится обновление версии, то необходимо проверить версию хранилища:

$ mysql -u root -p --execute='USE `avalon`; SELECT `value` FROM `version` WHERE `key` = "version";'

или установленные патчи:

$ mysql -u root -p --execute='USE `avalon`; SELECT `key` as `patch`, `value` as `date` FROM `version` WHERE `key` <> "version" ORDER BY `key`;'

После чего установить все патчи с номерами выше установленного как описано ранее.

В целях сохранности данных, патчи проектируются таким образом, чтобы было невозможно установить один и тот же патч дважды. Однако, остается возможность их непоследовательного наложения. В дальнейшем планируется автоматизировать данную операцию (см. #12).

Внимание!!! До версии 1.0 предполагается, что база меняется без патчей в связи с интенсивностью разработки.

После создания хранилища, если требуется, можно добавить пользователя для доступа к базе данных (см. инструкцию по настройке MySQL).

Поскольку имя базы жестко указано в SQL скриптах, если планируется использовать другую базу данных, необходимо исправить все вхождения `avalon` на имя вашей базы. В дальнейшем, это так же планируется делать автоматически (см #12).

Если MySQL сервер находится на другом хосте, необходимо добавление имени хоста:

$ mysql -u root -p -h 127.0.0.1 ...

Более подробную справку по ключам консоли можно получить выполнив:

$ mysql --help

создание хранилища sqlite

Для создания хранилища на базе SQLite запустите на выполнение скрипт avalon.sqlite.sql.

$ sqlite3 avalon.db < avalon.sqlite.sql

После выполнения скрипта будет создан файл avalon.db, путь к которому нужно будет указать в настройках avalon.

Файл sqlite3.exe для windows можно скачать на  странице загрузки sqlite.

сборка

Для сборки проекта служит скрипт build.sh. В скрипте предполагается, что Qt >= 4.4 установлена по пути /usr/lib/qt4. Если это не так, необходимо или исправить в скрипте значение переменной QT_PATH или сделать симлинк на существующую директорию:

# ln -s /<путь_до_qt> /usr/lib/qt4

После чего, можно собрать проект запуском скрипта.

P.S. На данный момент инструкция по сборке выглядит ужасной и бесчеловечной, но над этим предполагается работать ;)