Disclaimer:

This blog post is only applicable for the latest version 2 of the SAP Cloud SDK. You can find an updated tutorial for version 3 over at our tutorial page.

In this blog post, we go through the steps required to install the SDK and corresponding tools to use it for the development of your SAP Cloud Platform application.

Note: This post is part of a series. For a complete overview visit the SAP Cloud SDK Overview.

Prepare the Infrastructure

You need to have Maven and JDK 8 installed. In case you do not have them, conduct the following steps.

Windows (Windows 7+ / Windows Server 2003+)

Execute the following steps in a command line window as administrator.

1. Install Chocolatey (a package manager for Windows)

   @powershell -NoProfile -ExecutionPolicy Bypass -Command "iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin"

   For more information on Chocolatey and how to use it, visit the following page.

2. Install OpenJDK 8, if not yet available on your machine.
   • Option 1: Get the source code from here: https://openjdk.java.net/, and build yourself.
   • Option 2: Download an existing, publicly available OpenJDK 8 build, corresponding to your system. You may choose from:
     • https://adoptopenjdk.net/, or
     • https://jdk.java.net/8/, or
     • <any other source you prefer>

   (Please note that SAP shall not be responsible for any downloads from these portals).

3. Install Maven

   choco install maven

Mac

1. Install Homebrew (Mac Packetmanager to help with the remaining installation)

   /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

2. Install OpenJDK 8, if not yet available on your machine.
   • Option 1: Get the source code from here: https://openjdk.java.net/, and build yourself.
   • Option 2: Download an existing, publicly available OpenJDK 8 build, corresponding to your system. You may choose from:
     • https://adoptopenjdk.net/, or (In this case you may also use Homebrew, by running the following commands on Terminal).

       brew update
       brew tap AdoptOpenJDK/openjdk
       brew cask install adoptopenjdk8​

     • https://jdk.java.net/8/, or
     • <any other source you prefer>

   (Please note that SAP shall not be responsible for any downloads from these portals).
3. Install Maven

   brew update
   brew install maven

To validate that everything is installed correctly, you can use the command javac -version and mvn -version, the output should look similar to the following (you may have the newer version of the software, though):

> javac -version
javac 1.8.0_72

> mvn -version
Apache Maven 3.5.0 (ff8f5e7444045639af65f6095c62210b5713f426; 2017-04-03T21:39:06+02:00)
Maven home: C:\Program Files\path\to\maven\bin\..
Java version: 1.8.0_72, vendor: Oracle Corporation
Java home: C:\Program Files\path\to\java\jdk1.8.0_72\jre
...

Check that the environment variable JAVA_HOME points to the path of your JDK installation, e.g., C:\Program Files\path\to\java\jdk1.8.0_72.

Install IDE

To develop your first “Hello World” application with SAP Cloud SDK, you can just use your command line and a simple text editor. However, for bigger development projects, you can work with the IDE of your choice.

We recommend to use Intellij IDEA or Eclipse. Follow the installation instructions of corresponding tools to prepare your IDE. In case you use Eclipse, make sure that the maven plugin for Eclipse is installed (this should be the case for the JavaEE edition).

Troubleshooting with Corporate Proxies

Corporate proxies cause a lot of pain for developers. Some of the steps in the upcoming tutorial blogs will fail, if you sit behind a corporate proxy. If you cannot escape the proxy, you need to tell Maven where your proxy is located.
To do this, you need to cd to your ~/.m2 directory (e.g., Windows: C:/Users/<username>/.m2) and create a file called settings.xml. Then you paste the following content.

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                      http://maven.apache.org/xsd/settings-1.0.0.xsd">
  <proxies>
    <proxy>
      <id>my_corp_proxy</id>
      <active>true</active>
      <protocol>http</protocol>
      <host>proxy</host>
      <port>8080</port>
      <username></username>
      <password></password>
      <nonProxyHosts>localhost|127.0.0.1</nonProxyHosts>
    </proxy>
  </proxies>
</settings>

After finishing these steps, you are ready to start the development of your SAP Cloud Platform applications with SAP Cloud SDK. If you are interested to learn more, stay tuned for the upcoming development topics that we will cover in the following posts: available project templates in the SDK, setting up the communication with SAP S/4HANA, deployment on Cloud Foundry, etc.

See the next tutorial in the series here: Step 2 with SAP Cloud SDK: HelloWorld on SCP Neo.