BuildConfigurations._expandTemplateBuildConfigurations() method

Expands a template build configuration into multiple configurations.

Signature

protected _expandTemplateBuildConfigurations(input: {
        buildConfigurationName: string;
        jsonBuildConfigurationTemplate: JsonBuildConfigurationTemplate;
    }): Promise<Map<string, BuildConfiguration>>;

Parameters

Parameter	Type	Description
{ buildConfigurationName, jsonBuildConfigurationTemplate, }	(not declared)
input	{ buildConfigurationName: string; jsonBuildConfigurationTemplate: JsonBuildConfigurationTemplate; }

Returns

Promise<Map<string, BuildConfiguration>>

A promise that resolves to a map of expanded configuration names to their corresponding instances.

Exceptions

ConfigurationError If the matrix structure is invalid or substitution fails.

Remarks

This method uses the TemplateExpander to compute the Cartesian product of matrix parameter values and creates a configuration for each combination, substituting matrix values into both the configuration name and content.

Processing steps:

1. Validates matrix and template structure.
2. Delegates to TemplateExpander for matrix processing and name expansion.
3. Creates configuration instances via factory callback for each combination.

Matrix variables are scoped to individual configurations and accessible via the matrix namespace during property, dependency, and action evaluation.

---

Generated via tsdoc2docusaurus 1.3.2 by API Extractor/Documenter 7.57.2.