Пример проекта на платформе ncore
Здесь представлена стандартная структура проекта с основными конфигурационными файлами и классами, а также настройки IDE (Intellij Idea) и настройки SCM (git).
Для данного проекта можно использовать базу ядра.
Таски запускаются с помощью gradle wrapper. Версия Gradle - 2.3.
Nix
./gradlew build
Win
gradlew.bat build
Основные таски
- ncoreLoadPatches (или path) - загрузка патчей
- ncoreApplyPatches (или update) - применение патчей
- ncoreUpdateDb - загрузка и применение патчей
- generateSources (или codemaker) - генерация исходников
- classes - компиляция
- build - компиляция, выполнение проверок (тесты)
- distZip - генерация zip-архива дистрибутива толстого клиента (build/distributions)
- war - генерация war-архива тонкого клиента (build/libs)
- release - выпуск сборки
- run - запуск клиента (обычно при запуске исключают этап генерации кода - generateSources)
Если нужно выполнить таск, но при этом не выполнять определенные такси из его зависимостей, то можно воспользоваться ключом -x.
Компиляция классов:
./gradlew classes -x generateSources
Запуск клиента:
./gradlew run -x generateSources
Названия тасков можно сокращать. Например, вместо generateSources можно указать gS, вместо ncoreLoadPatches nLP и т.д.
Intellij Idea
Синхронизация настроек - Ctrl+Shift+A, далее выбрать пункт "Refresh All External Projects", или в окне Gradle нажать кнопку Refresh.
Для зависимостей создаются библиотеки с префиксом "Gradle__". По данному префиксу можно лего создть шаблоны для svn:ignore или .gitignore.
Таски можно запускать прямо из Idea. В конфигурациях запуска имеется соответствующий тип.
В Idea 14.1 появилось дейтсвие "Execute Gradle Task", которое позволяет выполнять такси без указания конфигурации запуска.
Основные соглашения
- Группа проекта в gradle-скрипте сообтветсует основному пакету
- Основной пакет содержит классы Product и Version
- Файлы с версией (version.properties) и переопределенными классами (register.json) находятся в ресурсах по след. пути META-INF/ncore-product/[группа проекта]
- В корне проекта обязательно присутствет файл ncore-properties.xml, содержайший свойство product.name.
Создание проекта myproject на основе sample
-
Создать директорию myproject и скопировать в нее содержимое ncore-sample
-
Удалить директорию .git
-
В build.gradle изменить значение group
group = 'biz.redsoft.myproject'
- В settings.gradle изменить значение rootProject.name
rootProject.name = 'myproject'
- В ncore-properties.xml изменить значение product.name
<entry key="product.name">myproject</entry>
-
В исходниках пакет biz.redsoft.sample заменить на biz.redsoft.myproject (это можно сделать в IDE)
-
В META-INF/ncore-product изменить имя диектории biz.redsoft.sample на biz.redsoft.myproject