PluginForPHPHowToBuild
How To Build the Plugin for PHP in the NetBeans Trunk
The main goal of this page is defining the optimal set of actions a developer has to take to create an appropriate environment for developing the Plugin for PHP.
Note: These instructions are updated sporadically as the build infrastructure is enhanced. See also these NB instructions.
Contents |
Get Basic Tools
- Install Java SE 5 update 6 or later -> http://java.sun.com and set the JAVA_HOME environment variable
- Install ANT 1.7.0 --> http://ant.apache.org/. Recommended options for the ANT_OPTS environment variable: -Xmx512m
- Install CVS client --> http://cvshome.org for Windows --> http://ftp.gnu.org/non-gnu/cvs/binary/stable/x86-woe versions 1.11.17 - 1.11.22
- Put java, ant, and cvs in your path
Access to the CVS Server
- Define the CVSROOT environment variable:
CVSROOT=:pserver:USER@cvs.netbeans.org:/cvs
where
- USER
- the actual user name that can be either your NetBeans account user id or 'anoncvs'
- Login to the CVS Server
cvs -d $CVSROOT login
Checkout Source & Build
cd WORKING_DIR cvs co nbbuild echo cluster.config=php>> nbbuild/user.build.properties ant -l ant.checkout.log -f nbbuild/build.xml checkout ant -l ant.build.log -f nbbuild/build.xml
where:
- WORKING_DIR
- the path to your local working directory, e.g. 'C:\NB.PluginForPHP' on the Windows host
Trouble Shooting Tips
- It is preferable to check out in an empty dir. Updating an old repository often leads to multiple errors while building the sources.
- If you are periodically getting the following error while checking out:
cvs [CheckoutAborted]: cannot rename file CVS/Entries.Backup to CVS/Entries: Permission denied
The most likely reason for this error to occur is that the antivirus software worked in the real time file protection mode (examples of software that may cause such errors are Symantec AntiVirus and TortoiseSVN Client)
- If the last version of CVS hangs while executing the 'login' command, use an older version (1.11.9 for example)