New-ConfigurationXcodeProjectVersion

Namespace PSPublishModule

Inputs

None

Creates configuration for updating Xcode project version values during a build pipeline.

Remarks

Emits an Xcode project version configuration segment consumed by Invoke-ModuleBuild / Build-Module. Use it when a release pipeline should keep Apple app project versions in sync with the build recipe.

Examples

Authored help example

Set an explicit app version and build number

PS>


New-ConfigurationXcodeProjectVersion -Path .\Tactra.xcodeproj -MarketingVersion 1.0.0 -BuildNumber 4

Updates MARKETING_VERSION and CURRENT_PROJECT_VERSION before the module build is staged.

Use the resolved pipeline version as the app marketing version

PS>


New-ConfigurationXcodeProjectVersion -Path .\Tactra.xcodeproj -UseResolvedVersion -BuildNumber 4

Uses the build pipeline's resolved version for MARKETING_VERSION.

Common Parameters

This command supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.

For more information, see about_CommonParameters.

Syntax

New-ConfigurationXcodeProjectVersion [-BuildNumber <String>] [-Disabled] -MarketingVersion <String> -Path <String> [<CommonParameters>]

Parameter set: ExplicitVersion

Parameters

BuildNumber String optionalposition: namedpipeline: False: Optional value to assign to all CURRENT_PROJECT_VERSION entries.
Disabled SwitchParameter optionalposition: namedpipeline: False: Disable this configuration entry without removing it from a build script.
MarketingVersion String requiredposition: namedpipeline: False: The value to assign to all MARKETING_VERSION entries.
Path String requiredposition: 0pipeline: Falsealiases: FullName, ProjectPath: Path to a .xcodeproj directory or project.pbxproj file. Relative paths resolve from the pipeline project root.

New-ConfigurationXcodeProjectVersion [-BuildNumber <String>] [-Disabled] -Path <String> -UseResolvedVersion [<CommonParameters>]

Parameter set: ResolvedVersion

Parameters

BuildNumber String optionalposition: namedpipeline: False: Optional value to assign to all CURRENT_PROJECT_VERSION entries.
Disabled SwitchParameter optionalposition: namedpipeline: False: Disable this configuration entry without removing it from a build script.
Path String requiredposition: 0pipeline: Falsealiases: FullName, ProjectPath: Path to a .xcodeproj directory or project.pbxproj file. Relative paths resolve from the pipeline project root.
UseResolvedVersion SwitchParameter requiredposition: namedpipeline: False: Uses the pipeline resolved version as the MARKETING_VERSION value.