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 S/4HANA 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+)
- 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.
- Install Java Development Kit, if not yet availableInstall a specific JDK (e.g., JDK 8)
choco install jdk8
- Install Maven
choco install maven
- Install Homebrew (Mac Packetmanager to help with the remaining installation)
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
- Install Java Development Kit, if not yet available
brew update brew cask install java
Tip: Install a specific JDK if you like with (e.g., JDK 8)
brew cask install caskroom/versions/java8
- Install Maven
brew update brew install maven
To develop your first “Hello World” application with SAP S/4HANA 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 to install the maven plugin for Eclipse.
Download and Install SAP S/4HANA Cloud SDK (Beta)
Please note that this entire step will vanish in the future and is only valid with the Beta version that you download from SAP Service Marketplace.
Once you have completed the prerequisites, you need to download the Beta SDK as a Zip from Service Marketplace and install all artifacts to your local repository.
If you have downloaded the zip file, unzip the file to <location> and open a command line interface.
If you type the commands below, the SDK artifacts will be installed to your local Maven repository so that you can work with them as they would come from a central Maven repository.
cd <location> installSDK.bat
cd <location> ./installSDK.sh
Troubleshooting with Corporate Proxies
Corporate proxies cause a lot of pain for developers. The above mentioned commands may 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>
You can verify the correctness of your proxy settings when you repeat the commands or run mvn clean install.
After finishing these steps, you are ready to start the development of your SAP Cloud Platform applications with SAP S/4HANA 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.