docs(epf-build, erf-build): проверка перед сборкой — про действия, без externalCheck

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Nick Shirokov
2026-09-25 21:27:30 +03:00
co-authored by Claude Opus 5.5
parent 636344666d
commit d44da2704e
2 changed files with 21 additions and 27 deletions
+10 -13
View File
@@ -25,8 +25,8 @@ allowed-tools:
## Параметры подключения (опционально)
Предпочтительно использовать конкретную базу — это надёжнее. Временная база всё равно поднимается
под проверку исходников, если она не отключена.
Предпочтительно использовать конкретную базу: сборка надёжнее, а `configSrc` базы из
`.v8-project.json` даёт проверке исходников общие модули конфигурации.
1. Прочитай `.v8-project.json` из корня проекта и разреши базу:
2. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
@@ -66,18 +66,15 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-build.ps1" <п
## Проверка перед сборкой
Перед сборкой исходники проверяет платформа — синтаксис модулей и наличие обработчиков форм.
Если она нашла проблемы, сборка отменяется и файл не создаётся; в выводе — сообщение
платформы со строкой и колонкой и путь к файлу исходника. Отключается `-Checks off`
или ключом `"externalCheck": false` в `.v8-project.json`.
Перед сборкой платформа проверяет исходники: синтаксис модулей и наличие обработчиков форм.
Если есть ошибки, файл не создаётся, а в выводе — сообщение платформы со строкой и колонкой
и путь к файлу исходника. Собрать без проверки — `-Checks off`.
Проверка идёт на отдельной временной базе, даже если база указана: чужую конфигурацию навык не трогает.
Общие модули конфигурации (`ОбщегоНазначения`, `УправлениеПечатью` и т.п.) проверка видит только
при известной выгрузке конфигурации — `-ConfigSrc` или `configSrc` базы в `.v8-project.json`.
Без неё обращения к ним — ошибка «Переменная не определена»; тогда укажи выгрузку или собери
с `-Checks off`. Методы глобальных общих модулей, вызванные без имени модуля, проверка не видит
и с выгрузкой — для такого кода остаётся `-Checks off`.
Если код обращается к общим модулям конфигурации (`ОбщегоНазначения`, `УправлениеПечатью` и т.п.),
проверке нужна выгрузка этой конфигурации. По умолчанию берётся `configSrc` указанной базы из
`.v8-project.json`; если его нет — передай каталог выгрузки в `-ConfigSrc`, а если выгрузки нет
совсем — собирай с `-Checks off`. Код, который вызывает методы глобальных общих модулей без
имени модуля, проверку не пройдёт и с выгрузкой — его тоже собирай с `-Checks off`.
## Примеры
+11 -14
View File
@@ -25,8 +25,8 @@ allowed-tools:
## Параметры подключения (опционально)
Предпочтительно использовать конкретную базу — это надёжнее. Временная база всё равно поднимается
под проверку исходников, если она не отключена.
Предпочтительно использовать конкретную базу: сборка надёжнее, а `configSrc` базы из
`.v8-project.json` даёт проверке исходников общие модули конфигурации.
1. Прочитай `.v8-project.json` из корня проекта и разреши базу:
2. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
@@ -50,7 +50,7 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-build/scripts/epf-bu
| Параметр | Обязательный | Описание |
|----------|:------------:|----------|
| `-V8Path <путь>` | нет | Каталог bin платформы (или полный путь к 1cv8.exe) |
| `-V8Path <путь>` | нет | Каталог bin платформы, или полный путь к `1cv8.exe` / `ibcmd.exe` |
| `-InfoBasePath <путь>` | * | Файловая база |
| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
@@ -68,18 +68,15 @@ powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-build/scripts/epf-bu
## Проверка перед сборкой
Перед сборкой исходники проверяет платформа — синтаксис модулей и наличие обработчиков форм.
Если она нашла проблемы, сборка отменяется и файл не создаётся; в выводе — сообщение
платформы со строкой и колонкой и путь к файлу исходника. Отключается `-Checks off`
или ключом `"externalCheck": false` в `.v8-project.json`.
Перед сборкой платформа проверяет исходники: синтаксис модулей и наличие обработчиков форм.
Если есть ошибки, файл не создаётся, а в выводе — сообщение платформы со строкой и колонкой
и путь к файлу исходника. Собрать без проверки — `-Checks off`.
Проверка идёт на отдельной временной базе, даже если база указана: чужую конфигурацию навык не трогает.
Общие модули конфигурации (`ОбщегоНазначения`, `УправлениеПечатью` и т.п.) проверка видит только
при известной выгрузке конфигурации — `-ConfigSrc` или `configSrc` базы в `.v8-project.json`.
Без неё обращения к ним — ошибка «Переменная не определена»; тогда укажи выгрузку или собери
с `-Checks off`. Методы глобальных общих модулей, вызванные без имени модуля, проверка не видит
и с выгрузкой — для такого кода остаётся `-Checks off`.
Если код обращается к общим модулям конфигурации (`ОбщегоНазначения`, `УправлениеПечатью` и т.п.),
проверке нужна выгрузка этой конфигурации. По умолчанию берётся `configSrc` указанной базы из
`.v8-project.json`; если его нет — передай каталог выгрузки в `-ConfigSrc`, а если выгрузки нет
совсем — собирай с `-Checks off`. Код, который вызывает методы глобальных общих модулей без
имени модуля, проверку не пройдёт и с выгрузкой — его тоже собирай с `-Checks off`.
## Примеры