------ Development ------ Dan Tran ------ 20014-06-10 ------ ~~ NOTE: For help with the syntax of this file, see: ~~ http://maven.apache.org/doxia/references/apt-format.html Introduction Eclipse IDE Setup It is assume that you already have Maven 3.2.x, Eclipse Kepler SR2 with P4Eclipse, AnyEdit installed. Run the following command under a directory thats host your eclipse workspace which must on under the same directory of P4Maven source tree. ------------------------------ mvn mojodev:prepare-eclipse ------------------------------ This hooks up your eclipse workspace with our local Maven and proper Java/XML code styles. Test Setup The following contains one time setup of a local/personal Perforce server (P4D) in order to run P4Maven's TCK and integration test suites * As of this writing, you need to configure P4Maven's parent pom.xml to pick up maven-scm-test-1.10-SNAPSHOT * Install the {{{http://info.perforce.com/software-version-control.html}free Perforce server P4D}}. * Create a Perforce account with username/password as admin/admin. You can create this user on the first access using P4Admin at localhost:1066 * Create new depot and named it as <scmtck> * Configugre your local's settings.xml to contain the following \<server\> element --------------------------------------------- <server> <id>localhost:1666</id> <username>admin</username> <password>admin</password> </server> --------------------------------------------- [] * Add initial data to test server by running the following IT test under p4maven-provider module. --------------------------------------------- mvn clean install -Prun-its -Pinvoker.pom=src/it/initial-data --------------------------------------------- The TCK suite will take longer to run over time since many committed revisions. To speed up the test, obliterate <scmtck> depot, and run this step again. [] Test Suites * To invoke TCK suite --------------------------------------------- mvn -Prun-tck --------------------------------------------- [] * To invoke Integration (IT) suite --------------------------------------------- mvn -Prun-its -------------------------------------------- Setting up Release Automation Prior to cutting P4Maven release, you must have the following done * Install your gpg key using the {{{http://mojo.codehaus.org/development/performing-a-release.html#Making_GPG_Keys}following instructions}} as your guideline * Add your gpg private key's credential to p4maven-release profile under local settings.xml -------------------------------- <profiles> <profile> <id>p4maven-release</id> <!-- donot change this, see p4maven's parent pom for detail --> <properties> <gpg.passphrase>your-pass-phase</gpg.passphrase> </properties> </profile> [...] </profiles> ------------------------------------- [] * Add your Sonatype's deploy Maven repository credential into local settings.xml ------------------------------------- <server> <id>sonatype-nexus-staging</id> <username>your sonatype user name</username> <password>password</password> </server> <server> <id>sonatype-nexus-snapshots</id> <username>your sonatype user name</username> <password>password</password> </server> ------------------------------------- Releasing P4Maven * Run all TCK and IT test suites mentioned in this doc * Run the release plugin ------------------------ mvn -B release:prepare release:perform ------------------------
# | Change | User | Description | Committed | |
---|---|---|---|---|---|
#14 | 11406 | dantran | Remote Maven site, place important user and dev doc at root level instead | ||
#13 | 11286 | dantran | update plugins, and dev doc | ||
#12 | 10675 | dantran | doc fix | ||
#11 | 10047 | dantran | add docs for workshop.perforce.com credential using p4tickets | ||
#10 | 9765 | dantran | pickup maven-scm-1.9.1 | ||
#9 | 9680 | dantran | cleanup | ||
#8 | 9659 | dantran | add p4maven-dev to help with Eclipse IDE development environemnt | ||
#7 | 9653 | dantran | update dev doc | ||
#6 | 9597 | dantran |
- minor cleanup - doc update |
||
#5 | 9590 | dantran |
- add option to fail tag when it already exist - add P4ScmUrl parser test - cleanup |
||
#4 | 9572 | dantran | Introduce run-its-at-release profile so that we can run release automation IT test at release time | ||
#3 | 9570 | dantran | dev doc update | ||
#2 | 9561 | dantran |
- it/release now can be used to test after release:perform - only deploy site during release:perform - more dev and user doc |
||
#1 | 9548 | dantran |
- pickup P4PORT form env and system properties to support multi site using proxy - add development doc - check for error after each action |