variant-sources-plugin.md
159 lines
| 4.6 KiB
| text/x-minidsrc
|
MarkdownLexer
/ common / variant-sources-plugin.md
cin
|
r26 | # Variant Sources Plugin | ||
| ## NAME | ||||
| `VariantsSourcesPlugin` и extension `variantSources`. | ||||
| ## SYNOPSIS | ||||
| ```groovy | ||||
| plugins { | ||||
| id 'org.implab.gradle-variants-sources' | ||||
| } | ||||
| variants { | ||||
| layer('main') | ||||
| variant('browser') { | ||||
| role('main') { layers('main') } | ||||
| } | ||||
| variant('node') { | ||||
| role('main') { layers('main') } | ||||
| } | ||||
| } | ||||
| variantSources { | ||||
| bind('main').sourceSetNamePattern = '{layer}' | ||||
| bind('main') { | ||||
| configureSourceSet { | ||||
| declareOutputs('compiled') | ||||
| } | ||||
| } | ||||
| whenRegistered { sourceSetName() } | ||||
| whenBound('browser') { roleName() } | ||||
| } | ||||
| ``` | ||||
| ## DESCRIPTION | ||||
| `VariantsSourcesPlugin` применяет `VariantsPlugin` и `SourcesPlugin`, затем | ||||
|
cin
|
r27 | регистрирует source sets из модели `variants`. | ||
|
cin
|
r26 | |||
|
cin
|
r27 | Точка запуска registration: | ||
|
cin
|
r26 | |||
| - `variants.whenFinalized(model -> registerSourceSets(...))` | ||||
|
cin
|
r27 | ### registration | ||
|
cin
|
r26 | |||
| Для каждой usage-связки `variant/role/layer` вычисляется имя source set, | ||||
| регистрируется `GenericSourceSet` (если он еще не существует), затем | ||||
| вызываются callbacks. | ||||
| ### binding | ||||
|
cin
|
r38 | `bind('<layer>')` возвращает `LayerBindingSpec` и задает policy для этого | ||
|
cin
|
r26 | слоя: | ||
| - как именовать source set; | ||||
| - как конфигурировать source set; | ||||
| - какие callbacks вызвать на registration/binding. | ||||
| ### sourceSetNamePattern | ||||
|
cin
|
r27 | `sourceSetNamePattern` определяет naming policy зарегистрированного source set. | ||
|
cin
|
r26 | |||
| Default: | ||||
| - `{variant}{layerCap}` | ||||
| Tokens: | ||||
| - `{variant}`, `{variantCap}` | ||||
| - `{role}`, `{roleCap}` | ||||
| - `{layer}`, `{layerCap}` | ||||
| Имя санитизируется (`[^A-Za-z0-9_.-] -> _`). | ||||
| Ограничение: | ||||
| - один `sourceSetName` не может быть порожден разными слоями. | ||||
| ## EVENTS | ||||
| ### whenRegistered | ||||
| - callback на новый уникальный source set; | ||||
| - replayable; | ||||
| - при shared source set срабатывает один раз. | ||||
| ### whenBound | ||||
| - callback на каждую usage-связку `variant/role/layer`; | ||||
| - replayable; | ||||
| - подходит для per-usage логики. | ||||
| ### variant filter | ||||
|
cin
|
r31 | Фильтр по варианту поддерживает только usage-binding: | ||
|
cin
|
r26 | |||
| - `whenBound(String variantName, ...)` | ||||
|
cin
|
r31 | ## PAYLOAD TYPES | ||
| `SourceSetRegistration` содержит: | ||||
|
cin
|
r26 | |||
|
cin
|
r31 | - `layerName`, `sourceSetName`; | ||
| - `sourceSet` (`NamedDomainObjectProvider<GenericSourceSet>`). | ||||
| Sugar: | ||||
| - `configureSourceSet(Action|Closure)`. | ||||
| `SourceSetUsageBinding` содержит: | ||||
|
cin
|
r26 | |||
| - `variantName`, `roleName`, `layerName`, `sourceSetName`; | ||||
| - `sourceSet` (`NamedDomainObjectProvider<GenericSourceSet>`). | ||||
| Sugar: | ||||
| - `configureSourceSet(Action|Closure)`. | ||||
| ## API | ||||
| ### VariantSourcesExtension | ||||
|
cin
|
r38 | - `bind(BuildLayer)` — получить/создать binding для canonical layer identity. | ||
|
cin
|
r26 | - `bind(String)` — получить/создать binding по имени слоя. | ||
| - `bind(String, Action|Closure)` — сконфигурировать binding. | ||||
|
cin
|
r38 | - `bind(BuildLayer, Action|Closure)` — сконфигурировать binding по `BuildLayer`. | ||
| - `getBindings()` — read-only snapshot текущих bindings. | ||||
|
cin
|
r26 | - `whenRegistered(...)` — глобальные callbacks регистрации source set. | ||
| - `whenBound(...)` — глобальные callbacks usage-binding. | ||||
|
cin
|
r31 | - `whenBound(String variantName, ...)` — usage-binding callbacks с variant-filter. | ||
|
cin
|
r26 | |||
|
cin
|
r38 | ### LayerBindingSpec | ||
|
cin
|
r26 | |||
| - `sourceSetNamePattern` — naming policy для source set слоя. | ||||
| - `configureSourceSet(...)` — слойная конфигурация `GenericSourceSet`. | ||||
| - `whenRegistered(...)` — callbacks регистрации в рамках слоя. | ||||
| - `whenBound(...)` — callbacks usage-binding в рамках слоя. | ||||
| ## KEY CLASSES | ||||
| - `VariantsSourcesPlugin` — точка входа plugin adapter. | ||||
| - `VariantSourcesExtension` — глобальный DSL bind/events. | ||||
|
cin
|
r38 | - `LayerBindingSpec` — публичный DSL-contract layer-local policy/callbacks. | ||
|
cin
|
r31 | - `SourceSetRegistration` — payload регистрации source set. | ||
| - `SourceSetUsageBinding` — payload usage-binding. | ||||
|
cin
|
r26 | |||
| ## NOTES | ||||
|
cin
|
r27 | - `sourceSetNamePattern` фиксируется при первом чтении в registration | ||
|
cin
|
r26 | (`finalizeValueOnRead`). | ||
|
cin
|
r38 | - runtime state bindings скрыт внутри adapter implementation (`LayerBinding`). | ||
| - name-based bindings резолвятся к canonical `BuildLayer` через registry `variants`. | ||||
|
cin
|
r26 | - Closure callbacks используют delegate-first. | ||
| - Для вложенных closure лучше явный параметр (`ctx -> ...`). | ||||