You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Current »

This document covers the configuration of Maven repositories for Atlassian projects built using Maven 2. This includes:

  • Confluence 2.3 or later
  • Confluence dependencies such as atlassian-user, seraph, atlassian-renderer
  • many recent Confluence plugins
  • any other Atlassian project with a pom.xml file in the top folder.

Creating a personal Maven configuration file

Create a file in the following location which will include your personal settings for Maven 2:

~/.m2/settings.xml

For Windows users, this means C:\Documents and Settings\<username>\.m2\settings.xml.

The following file contains the required repositories for building Atlassian's software and contributed plugins. If you already have a settings.xml file, you need to update your pluginGroups settings and add the repositories below to an active profile.

<settings>
  <pluginGroups>
    <pluginGroup>com.atlassian.maven.plugins</pluginGroup>
    <pluginGroup>org.apache.maven.plugins</pluginGroup>
  </pluginGroups>
  <profiles>
    <profile>
      <id>default-profile</id>
      <activation>
        <activeByDefault>true</activeByDefault>
      </activation>
      <repositories>
        <repository>
          <id>atlassian-m2-repository</id>
          <name>Atlassian Maven 2 Repository</name>
          <url>http://repository.atlassian.com/maven2</url>
          <snapshots>
            <enabled>false</enabled>
          </snapshots>
        </repository>
        <repository>
          <id>atlassian-m2-contrib</id>
          <name>Atlassian Maven 2 Contributor Repository</name>
          <url>http://svn.atlassian.com/svn/public/contrib/repository/maven2</url>
          <snapshots>
            <enabled>false</enabled>
          </snapshots>
        </repository>
        <repository>
          <id>atlassian-m1</id>
          <url>http://repository.atlassian.com</url>
          <layout>legacy</layout>
        </repository>
      </repositories>
    </profile>
  </profiles>
</settings>

Installing non-distributable libraries

Building some projects will require the Java Transaction API (JTA), which cannot be distributed by Atlassian. You need to download this from the Sun website, and install it with:

mvn install:install-file \
  -Dfile=./jta-1_0_1B-classes.zip \
  -DgroupId=javax.transaction \
  -DartifactId=jta -Dversion=1.0.1B \
  -Dpackaging=jar

What next?

Continue with the Initial development environment setup.

  • No labels

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.