Connect your Gateway Android app via SUP server in only 3 steps

[michal_keidar]

Hi, I'm Michal Keidar and I'm part of the development team of SAP NetWeaver Gateway plug-in for Eclipse.

This post will help you connect to work using SUP even when you're on vacation in Thailand…

* Me, in Thailand, without SUP.

Let's say you've developed a great Android app using our plug-in, in which you can directly connect to SAP NetWeaver Gateway and consume its services, and now you would like to integrate it with Sybase Unwired Platform (SUP) server.

Why use the SUP server?
From SUP's documentation: "Sybase Unwired Platform acts as the hub that connects the back-end enterprise systems and data sources to mobile devices. Features for mobile application development, deployment, security, and ongoing device and application management provide a complete end-to-end solution" (See this link for full documentation).

So what are the prerequisites?

• SUP server installed and configured.
• A user with permissions to work in SAP NetWeaver Gateway.
• Information about the SUP server:
  • The host and port number of your SUP server.
  • The ID of your application on the server.
  • The Farm ID of your application on the server (default 0).
  • The name of your application's security configuration on the server.

All of these details can be configrued via the Sybase Control Center (SCC) - see this blog for more details and screen shots.

If you've made it up to here - good

Now comes the real deal, 3 steps you need to do in your app:

1. Add SUP's server libraries to the build path of your Android project (by using "Add External JARs...").
   You can find the libraries in your file system in the folder, for example, <SUPUnwiredPlatform_InstallDir>\MobileSDK\OData\Android\libraries\:
   1. ClientLib.jar
   2. sup-json.jar
   3. SUPProxyClient-<Version_Number>.jar
      
      

          Now select the tab, Order and Export, and export the SUP server libraries specified above.

               

  2. Uncomment the relevant parts of the code in "SupHelper" (the entire class) and "LoginActivity" class, organize imports and save.

  3. Add your SUP server details in the <service>.properties file (under res -> raw).

You can see a live example - in this video.

So just run your app and that's it!

I would love to see your response and comments.

#SAPGateway blogs and updates please follow us @shirilevil

Useful links:

1. See this great blog regarding "Developing Mobile Apps with Sybase Unwired Platform 2.1 and SAP NetWeaver Gateway 2.0".

2. And this great blog regarding "Developing SAP Android Apps is just a Few Clicks Away".

3. SAP NetWeaver Gateway plug-in for Eclipse.