Setting Up the Development Environment

• Verify that you can access SAP Mobile Platform Server from your machine
• If you are using Windows, download and extract Apache Ant and add it to the system variable path, PATH=%PATH%;C:\apache-ant-<version>\bin. See http://ant.apache.org.

See https://support.sap.com/release-upgrade-maintenance/pam.html to verify that you are using the supported versions for the Hybrid SDK (Kapsel) development environment.

To build Hybrid SDK (Kapsel) apps for Windows 8.1, you need:

• Microsoft Visual Studio 2013 (latest update)

Android tools run on Windows, Linux, and OS X. To build Hybrid SDK (Kapsel) apps for Android, you need:

• Java Development Kit (JDK) 7 or later
• Android Studio

See the Apache Cordova documentation at http://cordova.apache.org/docs/en/5.1.1/guide/platforms/android/index.html for more information about getting started with Android.

Download the Java Standard Edition Development Kit from http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html.

After installing the JDK, define the JAVA_HOME environment variable according to the JDK installation path (for example, C:\Program Files\Java\jdk1.7.0_75).

Android Studio includes the Android Studio IDE and the Android SDK tools.

1. Confirm that your system meets the requirements at http://developer.android.com/sdk/requirements.html.
2. Download and install Android Studio from https://developer.android.com/sdk/index.html
3. Add the Android SDK to your PATH environment variable:

   On Windows, add <Android SDK Location>\tools to the PATH environment variable

   On OS X, the command is: export PATH=$PATH:<path to Android SDK>/tools

4. Launch the Android SDK Manager and download the latest tools:
   • Open the Tools directory and select: SDK Tools, SDK Platform-tools, and the highest version of the SDK Build-tools.
   • Open the Android X.X folder (the latest version) and select: SDK Platform and a system emulator such as ARM EABI v7a System Image.
5. Download any additional packages. See http://developer.android.com/sdk/installing/adding-packages.html.
6. Install the packages.

The Google USB Driver for Windows is as an optional SDK component you need only if you are developing on Windows and want to connect a Google Android-powered device (such as a Nexus 7) to your development environment over USB.

Download the Google USB driver package from http://developer.android.com/sdk/win-usb.html.

To build Hybrid SDK (Kapsel) apps for iOS, you need:

• Mac OS X
• Xcode and Xcode command line tools
• For testing on iOS devices (not the simulator), you need:
  • An Apple Developer account
  • iOS development certificate
  • Provisioning files for each device you are testing with

See the Apache Cordova documentation at http://cordova.apache.org/docs/en/5.1.1/guide/platforms/ios/index.html for more information about getting started with iOS.

Download and install Xcode from the Apple Developers Web site.

1. Go to http://developer.apple.com/downloads/.
   Note You must be a paying member of the iOS Developer Program. Free members cannot download the supported version.
2. Log in using your Apple Developer credentials.
3. (Optional) To narrow the search scope, unselect all Categories except Developer Tools.
4. Download the appropriate Xcode and SDK combination.

See http://git-scm.com/book/en/Getting-Started-Installing-Git.

git config --global http.proxy http://proxy:8080 
 git config --global https.proxy http://proxy:8080 

sudo git config --global http.proxy http://proxy:8080 
 sudo git config --global https.proxy http://proxy:8080 

Use Node.js v0.10.11 and later, and its package manager, npm, to install Apache Cordova. See http://nodejs.org/. You can see the version installed by using the node command: node –v.

You must add the Node.js folder to your system PATH.

npm config set proxy  http://proxy_host:port 
npm config set https-proxy http://proxy_host:port

sudo npm config set proxy  http://proxy_host:port 
sudo npm config set https-proxy http://proxy_host:port

1. Create a .gradle directory in your home directory.
2. Open/Create the file gradle.properties in this directory.
3. Add the following settings:

   systemProp.http.proxyHost=proxy
   systemProp.http.proxyPort=8080
   systemProp.http.nonProxyHosts=*.sap.corp|localhost
   systemProp.https.proxyHost=proxy
   systemProp.https.proxyPort=8080
   systemProp.https.nonProxyHosts=*.sap.corp|localhost

1. Click Android Studio in the top right and then on Preferences.
2. Under IDE Settings click HTTP Proxy.
3. Select Auto-detect proxy settings.
4. Check Automatic proxy configuration URL and enter http://proxy:8083.

See http://cordova.apache.org/docs/en/5.1.1/guide/cli/index.html. Follow all of the steps in the Cordova command line interface readme.md.

1. Open a command prompt window, and enter:

   On Windows: npm install -g cordova@<latest_supported_version>

   On Mac: sudo npm install -g cordova@<latest_supported_version>

   The supported version of Cordova CLI for SAP Mobile Platform SDK 3.0 SP10 is 5.2.0. To install this Cordova command line interface version, enter:

   npm install -g cordova@5.2.0

   -g indicates that Apache Cordova should be installed globally.

   Note If you are installing on Mac and you see a warning message that you are installing globally into a root-only directory, run this command to change the owner of the command line interface installation folder:

   sudo chown -R user_name /usr/local/lib/node_modules/cordova

   You can copy the command text from the error message and paste it in at the command prompt at the bottom of the terminal window.

2. On Mac, when prompted, enter your root user password.
3. Verify the Cordova installation by entering this command at the command prompt, or in the terminal window:cordova –v

   The output shows the Cordova version installed, for example, 5.2.0.

   You should also scroll back through the entire installation history shown in the terminal and look for errors to verify the installation was successful.

To allow the Cordova command line to start the iOS simulator on Mac, you must install ios-sim.

1. Download the ios-sim tool files from https://github.com/phonegap/ios-sim.
2. Open a terminal window, and enter: sudo npm install -g ios-sim
3. When prompted, enter your root user password.
4. Verify the ios-sim installation by entering this command in the terminal window: ios-sim --version

   The output shows the ios-sim version installed, for example, 1.8.2.