Release Notes for
P4Ant, the Perforce Ant Tasks
Version 2010.1
Introduction
These notes include release-specific information about the Perforce Ant
Tasks. For details about installing, configuring and using this product,
consult the P4Ant user guide, installation notes and Javadoc included in
the distribution zip file.
- docs/INSTALL.txt
- docs/manual/OptionalTasks/p4tasks.html
- docs/javadoc
P4Ant tasks implement Perforce commands using the Perforce Java API. These
tasks are intended for build automation with Ant.
Requirements
* Perforce Java API 2010.1+
* Perforce server 2005.2+
* Apache Ant 1.7.0+
* Java: full standard JDK 6 or later, or JDK 5 with file helper class.
implementation as discussed in "Known Limitations" below.
* Supported Platforms:
* Windows XP, 2003, Vista, 7, 2008 Intel (x86, x86_64)
* Linux 2.6 Intel (x86, x86_64)
* Mac OS X 10.5, 10.6 (Mac/Carbon)
Known Limitations
* P4Java is limited to working in JDK 6 or later environments unless
you supply a suitable implementation of the P4Java
com.perforce.p4java.impl.generic.sys.P4JSystemFileCommandsHelper
interface as described in the P4Java User Guide and associated
Javadoc documents.
Installation
To install and configure P4Ant, perform the following steps.
1. Download the P4Ant zip file.
2. Unzip the content unto a directory.
/home/username/p4ant/...
3. Create an Ant script as you would normally do.
...
...
...
4. Import the P4Ant tasks into your Ant script.
...
...
...
...
...
...
5. Add a P4Ant task to the Ant script's target.
...
...
...
...
...
...
6. Run the Ant script as you would normally do.
ant -f p4ant-job.xml
The following is a full example:
Create an ANT script (XML) named "p4ant-job.xml" with the following content.
Replace the classpath with the path of your own Perforce Ant tasks
installation. Also, replace the variable values with your own Perforce
settings (i.e. port, user, passwd, etc.).
Perforce task test
Run the above script with the command: "ant -f p4ant-job.xml"
Known Limitations
Please see the Perforce Java API release notes.
Capabilities beyond the standard Apache Ant distribution
P4Ant provides the following Perforce tasks in addition to the
tasks that can be found in the standard Apache Ant distribution:
changes, diff2, files, fix, rep, job, jobs, lock, unlock, move, shelve,
unshelve, and tag.
--------------------------------------------------------------------------------
Major new functionality in 2010.1
#... (Bug #...)
Added P4Ant tasks for add, change, changes, counter, delete, diff2,
edit, files, fix, fstat, grep, have, integrate, job, jobs, label,
labelsync, lock, move, reopen, resolve, revert, shelve, submit, sync,
tag, unlock, unshelve.
Minor new functionality in 2010.1
#... (Bug #...)
Added support for loading of Perforce server protocol-specific and usage
properties from properties files.
Bugs fixed in 2010.1
#291294 (Bug #43834)
Tasks fail when P4CHARSET (or p4.charset) is set to any value; message
is "Not currently connected to a Perforce".
#291294 (Bug #43058)
Don't logout after task. A P4Ant task will run a 'p4 logout' as it
finishes, which deletes the users ticket.