Замена Sample на <%%RESERVED_NAME%%> для проектов на фабрике

This commit is contained in:
2026-01-19 19:25:00 +03:00
parent 4c87ee8325
commit b635941f70
17 changed files with 37 additions and 84 deletions

View File

@ -5,7 +5,7 @@
Для данного проекта можно использовать базу ядра.
Таски запускаются с помощью gradle wrapper. Версия Gradle - 7.6.4.
Таски запускаются с помощью gradle wrapper. Версия Gradle - 9.0.0.
Nix
```bash
@ -55,58 +55,11 @@ gradlew.bat build
```
Названия тасков можно сокращать. Например, вместо 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/[группа проекта]
находятся в ресурсах по следующему пути: META-INF/ncore-product/[product.name]
* В корне проекта обязательно присутствет файл ncore-properties.xml, содержайщий свойство
product.name.
### Создание проекта myproject на основе sample
1. Создать директорию myproject и скопировать в нее содержимое ncore-sample
2. Удалить директорию .git
3. В build.gradle изменить значение group
```
group = 'biz.redsoft.myproject'
```
4. В settings.gradle изменить значение rootProject.name
```
rootProject.name = 'biz.redsoft.myproject'
```
5. В ncore-properties.xml (в папках ./, src/main/webapp/WEB-INF и src/dist/config изменить значение product.name и product.title
```
<entry key="product.name">biz.redsoft.myproject</entry>
<entry key="product.title">MyProject title</entry>
```
6. В файлах starter и starter.bat поменять bin/sample на bin/biz.redsoft.myproject
7. В исходниках пакет biz.redsoft.sample заменить на biz.redsoft.myproject (это можно сделать в IDE)
8. В META-INF/ncore-product изменить имя диектории biz.redsoft.sample на biz.redsoft.myproject
9. Актуальная версия ядра указывается в файле gradle.properties:
```
biz.redsoft.ncore.version=1.10.339.9
```
Запуск толстого клиента осуществляется в собранном дистрибутиве (distTar или distZip) в каталоге bin командой:
start-client.bat (или ./start-client в линуксе)
product.name.