`$commonSettings` — Общие настройки

`$selectiveExecutions` — Выборочные выполнения

Обязательное

Нет

Тип

Объект типа «ассоциативный массив»

Значения ассоциативного массива

Тип: ProjectBuildingCommonSettings__FromFile__RawValid.SelectiveExecution

Минимум вхождений

Объект типа «ассоциативный массив», с помощью которого осуществляется определение выборочных выполнений.

Через ключи указываются идентификаторы выборочных выполнений:

$projectBuilding:

  $commonSettings:

    $selectiveExecutions:

      StaticPreview:

        # Конфигурация выборочного выполнения «StaticPreview» (подробности см. далее)

      Application:

        # Конфигурация выборочного выполнения «Application» (подробности см. далее)

После того, как валидные настройки выборочных выполнений определены , при вызове консольной утилиты yda через опцию --selectiveExecution можно указать один из объявленных в файле конфигурации идентификаторов выборочного выполнения, например:

yda build --selectiveExecution Application --mode LOCAL_DEVELOPMENT

Значения же ассоциативного массива $selectiveExecutions должны быть указаны в соответствие с приведёнными далее правилами.

Настройки каждого выборочного выполнения

ProjectBuildingCommonSettings__FromFile__RawValid.SelectiveExecution

Настройки конкретного выборочного выполнения

{

$tasksAndSourceFilesSelection

Русскоязычное наименование

Выборка задач и исходных файлов

Обязательное

Да

Тип

ProjectBuildingCommonSettings__FromFile__RawValid.ProjectBuilderTasksAndSourceFilesSelection

Значения ассоциативного массива

Тип: Индексный массив

Допустимые ключи

$markupProcessing
$stylesProcessing
$ECMA_ScriptLogicProcessing
$imagesProcessing
$fontsProcessing
$audiosProcessing
$videosProcessing
$plainCopying

$browserLiveReloadingSetupID

Русскоязычное наименование: ID пресета автоматической перезагрузки браузера
Обязательное: Нет
Тип: string

$distributablePackageJSON_Generating

Русскоязычное наименование: Генерация файла "package.json" для дистрибутива
Обязательное: Нет
Тип: boolean

}

`$tasksAndSourceFilesSelection` — выборка задачи и исходных файлов

Обязательное

Да

Тип

Объект типа «ассоциативный массив»

Значения ассоциативного массива

Тип: Индексный массив

Допустимые ключи

$markupProcessing
$stylesProcessing
$ECMA_ScriptLogicProcessing
$imagesProcessing
$fontsProcessing
$audiosProcessing
$videosProcessing
$plainCopying

Объект типа «ассоциативный массив», ключами которого являются названия задач (но не всех, а только упомянутых выше), а значениями — массивы имён групп точек входа (в случае задач обработки исходного кода) или группы ассетов (в случае задач обработки ассетов или простого копирования файлов). При этом, все задачи и группы точек входа или ассетов упомянутые в выборочном выполнении должны быть объявлены в том же файле конфигурации:

$projectBuilding:

  $commonSettings:

    $selectiveExecutions:

      StaticPreview:

        $tasksAndSourceFilesSelection:

          $markupProcessing: [ StaticPreviewAnywherePage, Pages ]
          $stylesProcessing: [ Shared, Layouts, Pages ]

      Application:

        $tasksAndSourceFilesSelection:

          $markupProcessing: [ Pages, MVC_Fragments ]
          $stylesProcessing: [ Shared, Layouts, Pages ]

Если используются выборочные выполнения, то для каждого из них по умолчанию не выбирается ничего, поэтому даже если набор групп точек входа или ассетов такой же, как и в другом выборочном выполнении, его всё равно необходимо явно указать.

          $ECMA_ScriptLogicProcessing: [ Pages, FrontServerEntryPoint, TypeORM_Configuration ]

Для того, чтобы указанные выше настройки работали, все упомянутые выше задачи и группы ресурсов должны быть объявлены.

  $markupProcessing: # См. документацию по настройке обработки разметки
  
    $entryPointsGroups:
  
      StaticPreviewAnywherePage: # ...
  
      Pages: # ...
  
      MVC_Fragments: # ...
  
  $stylesProcessing: # См. документацию по настройке обработки стилей
  
    $entryPointsGroups:
  
      Shared: # ...
  
      Layouts: # ...
  
      Pages: # ...
  
  $ECMA_ScriptLogicProcessing: # См. документацию по настройке обработки ECMAScript-логики
  
    $entryPointsGroups:
  
      Pages: # ...
  
      FrontServerEntryPoint: # ...
  
      TypeORM_Configuration: # ...

`$browserLiveReloadingSetupID` — ID настроек автоматической перезагрузки вкладки браузера

Русскоязычное наименование: ID пресета автоматической перезагрузки браузера
Обязательное: Нет
Тип: string

Имеет отношение к функциональности автоматической перезагрузки браузера. API этой функциональности позволяет определить несколько пресетов, при этом каждому из них необходимо задать идентификатор. Тогда, если в конкретном выборочном выполнении затребована функциональность автоматической перезагрузки браузера, то требуется указать через свойство $browserLiveReloadingSetupID идентификатор нужного пресета:

$projectBuilding:

  $commonSettings:

    $selectiveExecutions:

      StaticPreview:

        $tasksAndSourceFilesSelection:

          # См. выше

        $browserLiveReloadingSetupID: StaticPreview

      Application:

        $tasksAndSourceFilesSelection:

          # См. выше

        $browserLiveReloadingSetupID: Application

  $browserLiveReloading:

    $setups:

      StaticPreview:

        # См. документацию по настройке автоматической перезагрузки браузера

      Application:

        # См. документацию по настройке автоматической перезагрузки браузера

`$distributablePackageJSON_Generating` — Генерация файла «package.json» для дистрибутива

Русскоязычное наименование: Генерация файла "package.json" для дистрибутива
Обязательное: Нет
Тип: boolean

Имеет отношение к функциональности генерации package.json для дистрибутива. Данный булевский флаг устанавливает, нужно ли для данного выборочного выполнения его генерировать, хотя если если не нужно, то можно просто не указывать эту опцию. Если же этот флаг установлен в значение true, то необходимо определить настройки одноимённой группы $distributablePackageJSON_Generating:

$projectBuilding:

  $commonSettings:

    $selectiveExecutions:

      Application:

        $distributablePackageJSON_Generating: true


  $distributablePackageJSON_Generating:

    # См. документацию по настройки выходного файла package.json

Имеет отношение к функциональности вычисления указателей на ресурсы. Для того, чтобы вычислить укороченный абсолютный путь (невозможно для режима сборки статического превью) необходимо указать, на какой директории соответствует корень укороченного абсолютного пути. Эту директорию необходимо указать в виде пути, относительного уже директории проекта.

$commonSettings — Общие настройки

$selectiveExecutions — Выборочные выполнения

Настройки каждого выборочного выполнения

$tasksAndSourceFilesSelection — выборка задачи и исходных файлов

$browserLiveReloadingSetupID — ID настроек автоматической перезагрузки вкладки браузера

$distributablePackageJSON_Generating — Генерация файла «package.json» для дистрибутива

$publicDirectoriesRelativePaths — Относительные пути публичных директорий

`$commonSettings` — Общие настройки

`$selectiveExecutions` — Выборочные выполнения

`$tasksAndSourceFilesSelection` — выборка задачи и исходных файлов

`$browserLiveReloadingSetupID` — ID настроек автоматической перезагрузки вкладки браузера

`$distributablePackageJSON_Generating` — Генерация файла «package.json» для дистрибутива

`$publicDirectoriesRelativePaths` — Относительные пути публичных директорий