openSAP - Introduction to Mobile Solution Development for the Enterprise
This document will guide you through the process of setting up the systems and installations required for performing the actual development work shown during the openSAP Introduction to Mobile Solution Development for the Enterprise course. You don’t need to try out the coding to complete or even to pass the course, but it will help to reinforce your learning and to give you more practical knowledge if you do. Some of these elements are required from week 1 onwards, others are only used later in the course.
Notes on using this guide
The tools and software that are used during the course are a mixture of well-known third-party software development tools and plug-ins, and trial versions or free developer editions of SAP software. All of these are available free of charge; just follow the links provided here, select the appropriate version for your operating system, and download and install them as described here. In most cases, the software version is not so important but where we indicate that a particular release is required then you should ensure that you use that one.
Some of the tools and trial versions you’ll need are hosted here on the Developer Center, which is part of SCN. If you have an SCN account, then click Login at the top of this page. If you aren’t already an SCN user, then you need to register for an SCN account. Use the Register link at the top of this page. Once you activate your account, then you can log in to SCN.
Trial versions and developer editions
Now that you are logged on to SCN, you can sign up for the free software that SAP provides to developers. You don’t need to use any of the trial versions yet, but it makes sense to register for them now. Once you have completed the steps for each product, proceed to the next trial version.
SAP NetWeaver Gateway Service Consumption:
This allows a backend enterprise system to integrate the mobile application that will be developed during the course, and to provide OData services.
- Use the URL above and accept the user license agreement
- Once you have submitted the form you will receive an email with your username and initial password.
You can use this WebGUI: https://sapes1.sapdevcenter.com/webgui to log on to the system and change your password.
- We recommend using a browser other than Google Chrome for this step, as issues have been reported previously.
- There is more information on Service Consumption here: Sign up and get started with the SAP Gateway - Demo Consumption System.
SAP Mobile Platform, enterprise edition, cloud version:
This provides enterprise enablement for your mobile applications.
- Choose the Cockpit link and accept the license agreement.
- Choose SAP HANA as the database type.
- The SAP HANA Cloud Platform Cockpit will appear.
- Choose Services on the left, and you can then access the SAP Mobile Platform.
SAP NetWeaver Application Server ABAP 7.4 Trial:
Please find out more about this offer at
Or the direct link to the store at
This is an optional trial version for ABAP developers who want to develop their own OData services.
Update: the country restrictions that affected some participants who wanted to use the ABAP 7.4 trial have now been removed.
SAP UI 5:
Although SAP UI 5 is used in this course it is not treated in much depth. For a more in-depth treatment of SAP UI 5 in the context of this course please use the following SCN page which takes one of the courses examples and applies SAP UI 5 best practices.
Thank you DJ Adams!
Download your software
All of the following software is required for the development work during the course. You should accept any license agreements, and download the version appropriate for your operating system. Full documentation is available from the relevant download sites.
Note: The Recommended Installation Order section provides instructions and the recommended order for the software installations.
Java SE Development Kit 7u25
Java is a prerequisite for installing Eclipse; if you don't have a version of Java already installed, we suggest downloading the appropriate version from the link above.
Eclipse Juno for Java EE Developers
Eclipse Juno is used as the main development environment during the course. It is important that you install the Juno, and not the Kepler version, of Eclipse.
The Android SDK provides several elements used to create and test mobile applications for the Android platform. We recommend installing the SDK Tools only, rather than the ADT Bundle. You can find the link to download the SDK Tools for Windows by clicking ‘Use an Existing IDE’. Click ‘Download for Other Platforms’ for links to all the download options.
Ant is a well known build tool that is required by the Apache Cordova create and build commands.
Recommended Installation Order
Once you have downloaded all the required software, you can install everything in the order below.
You should install the software with the default installation options.
1. It is important that you install the Java SDK first, since it is a prerequisite for Eclipse.
2. Next, you should install Eclipse Juno, followed by the Android SDK.
3. At the end of the Android SDK installation, you will be asked if you want to run the SDK Manager. You should choose ‘No’ at this point.
4. Follow the instructions below for adding the Android Developer Tools to Eclipse.
5. Now you can run the Android SDK Manager, which will update any packages that require it.
6. You can now add the SAP tools to Eclipse, using the procedure below.
7. Ant is required by the Cordova build tools so this should be installed before Cordova
8. To complete the process, install Google Chrome and Apache Cordova.
The documentation for all these programs is available at the following links:
Java SDK installation: http://docs.oracle.com/javase/7/docs/webnotes/install/index.html
Android SDK installation: http://developer.android.com/sdk/installing/index.html - note the procedure for installing the SDK and the Eclipse plugin.
Add your Eclipse Plug-Ins
Now that you have Eclipse Juno installed, you can add additional tools directly to your development environment:
1. Open Eclipse, and then choose Help -> Install New Software. A new window will appear, choose Add… next to the Work with field.
2. Enter ADT Plugin as the name, enter https://dl-ssl.google.com/android/eclipse/ as the location, and then choose OK.
3. A list of available tools should appear: select only the Developer Tools checkbox and choose Next.
4. Review the Install Details on the next screen, and choose Next again.
5. Read and accept the license agreement, and choose Finish. The tools will be installed.
6. Accept any security warnings with OK.
7. After installation is completed, you will be asked if you want to restart Eclipse now. Choose No.
After installing the ADT Plugin tools and running the Android SDK Manager, you need to add the SAP Plug-ins for Eclipse:
1. Choose Help -> Install New Software again, enter SAP Plugins as the name, enter https://tools.hana.ondemand.com/juno as the location, and choose OK.
2. Select the checkboxes for the SAP NetWeaver Gateway Productivity Accelerator (GWPA) and UI Development Toolkit for HTML5, and then choose Next.
3. Proceed with the installation just as you did for the ADT plug-in. Once the installation is complete, choose Yes to restart Eclipse.
- Eclipse and the Android SDK Manager give the message 'Error: missing platform tools':
This issue is usually caused by your corporate firewall blocking the download of the extra tools. If you are connecting from your workplace, change the network connection you are using and try again.
- My Android Emulator won't connect to the internet:
If you are working in a corporate network you may need to adjust the startup parameters of the Android Emulator to include Proxy Settings and DNS settings for your corporate environment.
- When using RESTClient I get a communication failure:
If you are working in a corporate environment you may need to set up the Proxy Settings for RESTClient.
- When using Google Chrome to execute the examples I get a cross domain error:
Google Chrome has an unsupported command line option --disable-web-security that will allow you to run the examples and overcome the cross domain error, however some Google Chrome extensions prevent this option from working.
- The Trial version of SAP Mobile Platform has limits:
When using the SAP Mobile Platform Cloud version, you are limited to testing 5 applications and 10 application connections. If you want to test further applications or devices, then you need to remove an existing application or application connection first.
[NOTE: As of the 10/09/2013 these restrictions have been lifted and this will remain so for the duration of this course!]
- Android SDK Tools cannot find Java JDK:
Please ensure you have the JAVA_HOME environment variable set to the the root path of your JDK installation.
- Android SDK Manager does not launch directly from the Windows 7 start menu:
In the sub folder of your Android installation you will need to run [.\android-sdk]\tools\android.bat with Administrator Rights. Please note however that if you have installed the ADT plugin for eclipse you will be able to run the SDK Manager from the Windows drop down while in the Java perspective.
- Cordova create gives error "Cannot locate ant.bat using PATH environment Variable"
Ant is a required install for Cordova, the path to the ant.bat file needs to be included in the environment system path