# P4 Plugin Jenkins plugin for a Perforce Helix Versioning Engine (P4D). ## Contents * [Release notes](https://github.com/jenkinsci/p4-plugin/blob/master/RELEASE.md) * [FreeStyle setup guide](https://github.com/jenkinsci/p4-plugin/blob/master/SETUP.md) * [Pipeline setup guide](https://github.com/jenkinsci/p4-plugin/blob/master/WORKFLOW.md) * [Pipeline libraries](https://github.com/jenkinsci/p4-plugin/blob/master/LIBRARY.md) * [MultiBranch guide](https://github.com/jenkinsci/p4-plugin/blob/master/MULTI.md) * [Advanced scripting](https://github.com/jenkinsci/p4-plugin/blob/master/P4GROOVY.md) * [Notes page](https://github.com/jenkinsci/p4-plugin/blob/master/NOTES.md) * [Jenkins page](https://plugins.jenkins.io/p4) ## Requirements * Jenkins 1.642.3 or greater. * Helix Versioning Engine 2016.1 or greater. * Minimum Perforce Protection of `open` for the Jenkins user. * Review Build feature requires Swarm 2016.2 or greater. ## Install 1. Open Jenkins in a browser; e.g. http://jenkins_host:8080 2. Browse to 'Manage Jenkins' --> 'Manage Plugins' and Select the 'Available' tab. 3. Find the 'P4 Plugin' or use the Filter if needed 4. Check the box and press the 'Install without restart' button If you are unable to find the plugin, you may need to refresh the Update site. 1. Select the 'Advanced' tab (under 'Manage Plugins') 2. Press the 'Check now' button at the bottom of the page. 3. When 'Done' go back to the update centre and try again. ## Building To build the plugin and run the tests use the following: mvn package Note: for the tests to run you must have p4d in your PATH, to skip tests use the -DskipTests flag. Lastest SNAPSHOT builds available [here](https://ci.jenkins.io/blue/organizations/jenkins/Plugins%2Fp4-plugin/branches). ## Manual install 1. Open Jenkins in a browser; e.g. http://jenkins_host:8080 2. Browse to 'Manage Jenkins' --> 'Manage Plugins’ and Select the 'Advanced' tab. 3. Press the 'Choose File' button under the 'Upload Plugin' section 4. Find the location of the 'p4.hpi' file and Select Upload 5. Choose the 'Download now and install after restart' button (this might be different on the newer version)