development.apt #1

 ------
 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
------------------------