docs(db-guide,v8-project-guide): дополнительные аргументы платформы

Разбор escape hatch для вызывающего: два параметра по движкам, ключи
v8args/ibcmdargs в реестре проекта, что отклоняется и почему,
маскирование секретов и известные пределы разбора (/Psecret, /@).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Nick Shirokov
2026-07-29 20:44:24 +03:00
co-authored by Claude Opus 5
parent efee7f8f2b
commit 545b32a55f
2 changed files with 63 additions and 0 deletions
+24
View File
@@ -57,6 +57,8 @@
| Поле | Тип | Обяз. | По умолчанию | Описание | Кто заполняет |
|------|-----|:-----:|-------------|----------|---------------|
| `v8path` | string | да | — | Путь к каталогу `bin` платформы 1С (или к файлу `1cv8.exe`/`ibcmd.exe`, см. ниже) | `/db-list add` или руками |
| `v8args` | array | нет | `[]` | Дополнительные аргументы запуска `1cv8.exe` для всех навыков (см. ниже) | Руками |
| `ibcmdargs` | array | нет | `[]` | То же для `ibcmd`, в форме `--ключ=значение` | Руками |
| `databases` | array | да | — | Список баз данных | `/db-list add` |
| `default` | string | нет | — | `id` базы по умолчанию | `/db-list` |
| `editingAllowedCheck` | `"deny"`/`"warn"`/`"off"` | нет | `deny` | Глобальная реакция support-guard на правку объектов на замке (см. ниже) | Руками |
@@ -187,6 +189,28 @@ src/
Через `ibcmd` поддерживаются только файловые базы. Какие именно навыки это умеют — в [руководстве по базам](db-guide.md#движок-1cv8-или-ibcmd).
## Дополнительные аргументы платформы (`v8args`, `ibcmdargs`)
У платформы есть общие ключи запуска, которых нет среди параметров навыков: `/UseHwLicenses+`,
`/L`, `/ClearCache`, `/DebuggerURL` и другие. Их перечисляют в `v8args` — и каждый навык,
запускающий `1cv8.exe`, добавит их в свою командную строку:
```json
{
"v8path": "C:\\Program Files\\1cv8\\8.3.27.2074\\bin",
"v8args": ["/UseHwLicenses+"]
}
```
Типичный случай — машина с аппаратной лицензией: без `/UseHwLicenses+` пакетные запуски падают
с «Не найдена лицензия». Ключ машинно-специфичный, поэтому и задаётся один раз на проект.
`ibcmdargs` — то же самое для `ibcmd`; его ключи пишутся в форме `--ключ=значение`. Списки не
пересекаются: каждый применяется только к своему движку, «чужой» просто не используется. Разово
те же аргументы можно передать параметрами `-AdditionalV8Arguments` / `-AdditionalIbcmdArguments`
— они дописываются после проектных. Подробности и ограничения — в
[руководстве по базам](db-guide.md#дополнительные-аргументы-платформы).
## Минимальный пример
```json