Rate this page:
On this page, you install the SDK on your Linux or Mac system. You also configure your operating system to recognize the SDK commands in your environment.
Verify that you have JAVA_HOME set in your system by running echo $JAVA_HOME from the terminal
1 2
host:~ test$ echo $JAVA_HOME
/Library/Java/JavaVirtualMachines/jdk1.8.0_65.jdk/Contents/Home
If the output resembles the above skip ahead to Step 2: Download and Install the SDK
The JAVA_HOME
environment variable specifies the location of the JDK on your system. On Mac OS X, if you accepted the defaults when you installed the JDK, this is /Library/Java/JavaVirtualMachines/1.8.0.jdk/Contents/Home
. On Linux, it may be /usr/local/jdk
, or a similar location. You should add the JDK's bin
directory to your PATH
environment variable as well. This ensures your environment is configured and can locate the javac
command.
To set your PATH
and JAVA_HOME
variables:
Edit the .bashrc
file in your home directory using your favourite editor (we use vi in this example).
1
host:~ test$ vi ~/.bash_profile
Add the following lines at the end of the file:
1 2 3
JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0.0_91.jdk/Contents/Home
export JAVA_HOME
export PATH=$PATH:$JAVA_HOME/bin
Save and close the file.
Enter the following at the command line to pick up your changes:
1
host:~ test$ source ~/.bash_profile
Verify you are now seeing the correct result when you enter the command javac -version
in terminal
1 2
host:~ test$ javac -version
javac 1.8.0_91
There are native installers for a number of operating systems available, as well as a TGZ (GZipped tar file) which can be used for manual installation.
PKG File
Open a Terminal window and add the Atlassian "Tap" to your Brew using the command:
1
brew tap atlassian/tap
Then install the SDK using the atlassian/tap command:
1
brew install atlassian/tap/atlassian-plugin-sdk
On a Debian-based Linux system like Ubuntu, you can install the SDK using apt-get
or aptitude
:
First, set up the Atlassian SDK repositories:
1
sudo sh -c 'echo "deb https://packages.atlassian.com/debian/atlassian-sdk-deb/ stable contrib" >>/etc/apt/sources.list'
Download the public key using curl
or wget
:
1
wget https://packages.atlassian.com/api/gpg/key/public
Add the public key to apt
to verify the package signatures automatically:
1
sudo apt-key add public
Then, run the install:
1 2
sudo apt-get update
sudo apt-get install atlassian-plugin-sdk
To install on systems that use the Yum package manager:
Create the repo file in your /etc/yum.repos.d/ folder:
1
sudo vi /etc/yum.repos.d/artifactory.repo
Configure the repository details:
1 2 3 4 5
[Artifactory]
name=Artifactory
baseurl=https://packages.atlassian.com/yum/atlassian-sdk-rpm/
enabled=1
gpgcheck=0
Install the SDK:
1 2 3
sudo yum clean all
sudo yum updateinfo metadata
sudo yum install atlassian-plugin-sdk
To install the latest version of SDK, do the following:
Extract the file to your local directory.
1
sudo tar -xvzf atlassian-plugin-sdk-4.0.tar.gz -C /opt
Rename the extracted folder to atlassian-plugin-sdk
.
1
sudo mv /opt/atlassian-plugin-sdk-4.0 /opt/atlassian-plugin-sdk
If you are comfortable working with symbolic links, you can set up a symbolic link instead of renaming the directory.
Open a terminal window and run the following command:
1
atlas-version
You should see something similar to:
1 2 3 4 5 6 7 8 9 10 11 12 13 14
ATLAS Version: 6.2.9
ATLAS Home: /usr/local/Cellar/atlassian-plugin-sdk/6.2.4/libexec
ATLAS Scripts: /usr/local/Cellar/atlassian-plugin-sdk/6.2.4/libexec/bin
ATLAS Maven Home: /usr/local/Cellar/atlassian-plugin-sdk/6.2.4/libexec/apache-maven-3.2.1
AMPS Version: 6.2.6
--------
Executing: /usr/local/Cellar/atlassian-plugin-sdk/6.2.4/libexec/apache-maven-3.2.1/bin/mvn --version -gs /usr/local/Cellar/atlassian-plugin-sdk/6.2.4/libexec/apache-maven-3.2.1/conf/settings.xml
Java HotSpot(TM) 64-Bit Server VM warning: ignoring option MaxPermSize=256M; support was removed in 8.0
Apache Maven 3.2.1 (ea8b2b07643dbb1b84b6d16e1f08391b666bc1e9; 2014-02-15T04:37:52+10:00)
Maven home: /usr/local/Cellar/atlassian-plugin-sdk/6.2.4/libexec/apache-maven-3.2.1
Java version: 1.8.0_45, vendor: Oracle Corporation
Java home: /Library/Java/JavaVirtualMachines/jdk1.8.0_45.jdk/Contents/Home/jre
Default locale: en_US, platform encoding: UTF-8
OS name: "mac os x", version: "10.11.6", arch: "x86_64", family: "mac"
You now have a local development environment configured for the Atlassian SDK and you're ready to build your first plugin!
Need help? Request support at Developer Technical Support Portal
Rate this page: