You should have Perforce client installed on the build machine. Contact http://www.perforce.com for licensing information. Here is the list of properties you need to configure in order to set up a Perforce repository using template
The Perforce port in the format of <port>, or <servername>:<port>, where <servername> and <port> will be replaced by the actual Perforce server name and the port number.
User name to access the above Perforce server. This user should have the rights to create and edit client specifications and to checkout and label code.
Password for the above user. Can be blank, if your Perforce server does not use password based security.
Specify name of the Perforce client which will be used as template for this repository. When checkout, QuickBuild will create a new client with the specification, options and line ending the same as the client template specified here. But the root directory will be choosed by QuickBuild internally based on settings of the active configuration. Name of the new client is also determined by QuickBuild (see below property).
Optionally specify name of the client which will be created by QuickBuild to check out code for build. If not specified, this name will be generated automatically.
![]() | Warning |
|---|---|
It is suggested that you leave this value empty here to let QuickBuild determines the client name based on current checkouts directory to avoid potential conflicts. | |
Specify the label or change number to checkout. If not specified, head revision of specified template client will be retrieved.
Specifies options when create Perforce client. Valid options are: allwrite, clobber, compress, locked, modtime, rmdir. Different options should be separated by spaces.
Set line ending character(s) for client text files. The following values are possible:
| local: use mode native to the client |
| unix: UNIX style |
| mac: Macintosh style |
| win: Windows style |
| share: writes UNIX style but reads UNIX, Mac or Windows style |
This property is optional. If not specified, the value will default to "local".
Specifies whether or not to ignore existing label spec when the label created by QuickBuild is already exist in Perfoce depot. If this value is set "yes", existing label spec will be discarded when apply new label spec; otherwise, new client spec will be appended to existing label spec.
![]() | Note |
|---|---|
This property only takes effect when QuickBuild tries to create label on this repository (though the label step). | |
Specifies whether or not to check the lock option when create label in Perforce depot.
![]() | Note |
|---|---|
This property only takes effect when QuickBuild tries to create label on this repository (through the label step). | |
Specify path to your p4 executable file, for example: /usr/local/bin/p4. It should be specified here, if it does not exist in the system path.
Specify version of the build since which the revision log will be retrieved. If left empty, revision log will not be retrieved.
Number of seconds the current repository should be quiet (without checkins) before QuickBuild decides to check out the code from this repository for a build. This is used to avoid checking out the code in the middle of some other checkins. This property is optional. When set as 0, quiet period will not be used before checking out the code to build.
Choose login mapping for this repository. Login mapping is used to map repository login to QuickBuild user. It can be configured at "login mappings" tab of the configuration.