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.