Skip to Content

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

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(''))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin"

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

  2. Install Java Development Kit, if not yet availableInstall a specific JDK (e.g., JDK 8)
    choco install jdk8
  3. Install Maven
    choco install maven


  1. Install Homebrew (Mac Packetmanager to help with the remaining installation)
    /usr/bin/ruby -e "$(curl -fsSL"
  2. 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
  3. Install Maven
    brew update
    brew install maven


Install IDE

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

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.

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

To report this post you need to login first.


You must be Logged on to comment or reply to a post.

  1. Emmanuel Dacosta


    Great post.

    In the product page, it is noted the sdk can be used to develop apps for S4Cloud and S4onPre.

    I think the S4 server must be set in the Intellij IDEA or Eclipse options. Could you provide any step-by-step ?

    What is the difference between using the S4hana Cloud SDK in Eclipse IDE and the WEBIde for sap hana included in SAP HANA DB ?


    Emmanuel Da Costa



    1. Ekaterina Gavrilova
      Post author

      Hello Emmanuel,

      thanks a lot for your feedback. We are currently working on additional step by step scenarios for SAP S/4HANA Cloud SDK. You can always refer to the overview blog post for the full list of currently available tutorials. In particular, here is the blog post describing, how you can connect SAP S/4HANA and read the data via OData Service.

      With regard to the WEBIde support, the topic is currently in our roadmap and we will provide more information soon, after the SDK is generally available.

      Best regards,


  2. Former Member

    Hi Ekatarina,


    Thanks for the detailed step-by-step documentation.

    Under “Install IDE”, could you please specify which version you recommend?
    I selected “Eclipse IDE for Java Developers” but I’m not sure that’s the right version.

    Could you please confirm?


  3. Michael Bauer

    Thank you for the article! In my opinion, it would be good to have a little button at the end of the page linking you to the next article of the series.

    Best regards,


  4. Former Member


    I think I am missing a step somewhere.  In the maven build process it appears to be looking at but in my .m2 directory I only have up to 1.1.2.

    Here is in the error:  “The project (C:\dev\Proggies\Cost-Center-Creation-Neo\pom.xml) has 1 error
    [ERROR] Non-resolvable import POM: Could not find artifact @ line 16, column 25”

    Is the SDK supposed to update on its own?  I have downloaded the latest SDK but it doesn’t appear to be updating in the local repository which seems to be used to complete the maven clean / build operations.

    Any guidance is appreciated.





    1. Ekaterina Kruse
      Post author

      Hello Darren,

      we recommend to update to the version 1.7.1 of the SDK if you are working in Neo environment, see the release blog post for details. Just update the version manually in your application pom.xml and rebuild the project, the dependencies will be updated in m2 folder.

      We are now regularly releasing release blogs (bi-weekly), where we write about “what is new” in the latest SDK version and how to update. Check out our Overview Blog (part “Releases”) for details.

      Feel free to reach out to us also in StackOverflow for questions like this (tag s4sdk), we monitor this tag very actively.

      Hope this helps and best regards,

      Ekaterina Kruse

      1. Former Member


        Thanks Ekaterina.  For those who need explicit instructions go to pom.xml and update the following:



        Then right click the pom.xml and select Run as… Maven Build

  5. Vipin Nagpal

    Hi Expert,

    I got below error during Maven Build


    [ERROR] The build could not read 1 project -> [Help 1]
    org.apache.maven.project.ProjectBuildingException: Some problems were encountered while processing the POMs:
    [ERROR] ‘dependencies.dependency.version’ for org.jboss.arquillian.junit:arquillian-junit-container:jar is missing. @ line 75, column 21

    I am using 1.7.1 SDK.


    1. Ekaterina Kruse
      Post author

      Hi Vipin,

      we recommend to upgrade to the newest SDK version, could you please try to execute the build with the latest version of the SDK (1.10.0)? What archetype do you use?

      Also, for your information: we are maintaining the s4sdk tag in StackOverflow for the SDK related technical questions and issues, you might want to check this resource out.


Leave a Reply