Command

New-ConfigurationXcodeProjectVersion

Module: PSPublishModule
Inputs: None

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

Syntax

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

Parameter set: ExplicitVersion

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

Parameter set: ResolvedVersion

Description

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

Set an explicit app version and build number

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

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

Uses the build pipeline's resolved version for MARKETING_VERSION.

Parameters

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

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.