Документация
Docs/ru/reference/packages/index.md
Сгенерированный интерфейс пакетов
Сгенерированный справочник. Не редактируйте эту страницу напрямую. Обновите
BuildTools/PackageInterface.jsonилиBuildTools/package.py, затем выполнитеpython BuildTools/docs_package.py --write.
| Индекс | Объявление | Матрица | Содержимое | CLI | Канонический JSON |
Этот справочник связывает объявление пакета CMake с контрактом упаковщика, который используется во время выполнения. Он описывает возможности движка, а не матрицу релиза встраивающего проекта.
Этот сгенерированный интерфейс пакетов является точкой входа для грамматики DefinePackage, целей package.py, платформ, pack tokens и эффектов payload.
Решение между контрактами
Используйте следующую cross-contract последовательность:
- Формулируйте package boundary явно: фиксируйте точную ревизию Engine и используйте
BuildTools/PackageInterface.jsonкакinternalpackage contract; не заменяйте это утверждение общим revision-pinned заголовком. - Считайте допустимые dimensions package.py и payload effects только capability. Package matrices встраивающего проекта, release policy, secret provisioning, deployment topology и credentials подписи установщика остаются исключёнными и принадлежат проекту.
- Рассматривайте support отдельно:
build_gated,smoke_gated,source_capableиnot_in_public_matrixявляются разными состояниями. - Для каждого примера сообщайте вместе source status, visibility/state remote, наблюдённые required checks, точный Engine pin, политику update delivery и соответствующий Contract digest. Свидетельством публикации является только source со статусом
published, remotepublic/publishedи наблюдёнными checkspassing; private, reserved, source-staged, planned или unobserved repository им не является.
Статус контракта
| Поле | Значение |
|---|---|
| Stability | internal |
| Since | Не объявлено |
| Support policy | Версионируемая линия поддержки пакетов не объявлена; встраивающие проекты должны фиксировать ревизию движка. |
| Manifest | BuildTools/PackageInterface.json |
| Packager | BuildTools/package.py |
| Contract digest | 13ad77ab5b1a53bc20e8c3a701043aebcc6c6c27dcc3e03b9d0fa696c6602b2f |
Покрытие
| Справочник | Записи | Назначение |
|---|---|---|
| Declaration | 2 | CMake clauses and per-binary modifiers. |
| Targets/platforms/packs | 6 / 6 / 19 | Accepted runtime dimensions and support status. |
| Payloads and artifacts | 8 | Implemented output-producing pack tokens. |
| Packager CLI | 17 | Exact internal package.py invocation contract. |
Граница ответственности
Включено:
- DefinePackage declaration clauses and the per-binary POSTFIX modifier
- package.py targets, platforms, architecture keys, pack tokens, and payload effects
- implemented, placeholder, and unsupported package boundaries
Не входит в этот раздел:
- embedding-project package matrices and release policy
- project configuration key schema and secret provisioning
- resource-pack content selection and deployment topology
- installer signing credentials and external tool operation