p4x — Perforce versioning tool for Xcode projects

The p4x tool helps speed up common operations for Xcode projects that use the Perforce Software Configuration Management System.

p4x can be used in four different ways:

1. •p4x can print the build version of the Xcode project;
   

2. •p4x can modify the build version before every build in Xcode;
   

3. •p4x can print the market version defined by the CFBundleShortVersionString in the parameter file, or
   

4. •p4x can modify the market version.
   

p4x modifies the values of key parameters in a parameter list file in the project. Any parameter list file can be used in the project, but it is recommended to create a version.plist file that contains the build version and any other versioning information required.

To keep track of a build version, p4x uses Perforce counters. A counter with a unique name is set up in the Perforce database and incremented every time the build version is bumped. If the property list file is not open for editing, p4x syncs the file and opens it for editing. After the file has been edited, the file is submitted to the depot and tagged (if required). If the file is already open for editing, p4x will not submit the file to the depot, unless the -s argument is given.

Copyright © 2012 Slingblade