Developer

Getting Started with Client Hub Application Installation and Initialization

Install and initialize the Client Hub application.

Installing the Client Hub Application

Install Client Hub.

Procedure

  1. Install SAP Mobile Platform Native SDK - Client Hub component.
    By default, SAP Mobile Platform SDK components are installed in the ..\SAP\MobileSDK<XXX> directory. In this guide, <SDK_HOME> represents the SAP Mobile Platform SDK installation directory, down to the MobileSDK<XXX> folder.
    Client Hub gets installed under the ClientHub directory, where the project files for Client Hub applications, used for registering applications on Android devices is available.
  2. Ensure that you  unzip the ClientHub.zip file before importing the Client Hub project into Eclipse.

Setting Up the Development Environment

The Client Hub application is shipped as a source code project. Set up the Android Development Environment before registering your application using Client Hub.

Procedure

  1. Download the Java Standard Edition (6 Update 24 and above versions) Development Kit (JDK) from http://www.oracle.com/technetwork/java/javase/downloads/index.htmlInformation published on non-SAP site.
  2. Download the Android Developer Tool (ADT) from http://developer.android.com/sdk/index.html#downloadInformation published on non-SAP site. This includes essential Android SDK components and a version of the Eclipse IDE with built-in ADT. For more information on setting up the ADT Bundle, see http://developer.android.com/sdk/installing/bundle.htmlInformation published on non-SAP site.
    For more information on supported Google Android development environment in SAP Mobile Platform 3.0, see https://support.sap.com/release-upgrade-maintenance/pam.htmlInformation published on SAP site.

Importing Client Hub Project into Eclipse

Import the project from the SDK installation directory.

Procedure

  1. Open Eclipse WorkSpace.
  2. Click File > Import... > Android > Existing Android Code Into Workspace. Click Next.
  3. In the Root Directory, click Browse..., select C:\SAP\MobileSDK<XXX> directory\ClientHub. Click OK.
    The Client Hub project is selected by default.
  4. Click Finish. The ClientHub folder is displayed in your Eclipse Package Explorer.

Client Hub Application Signing

Build the Client Hub application, cosigning with the same developer certificate as the application.

Procedure

  1. Right-click ClientHub folder in the package explorer. Navigate to Android Tools > Export Signed Application Package.
  2. In the Export Android Application wizard, the ClientHub project appears. Click Next.
  3. In the Keystore selection window, select:
    Option Description
    Select existing keystore if you already have a keystore:
    1. Enter the location of the existing keystore.
    2. Enter the password.
    3. Click Next.
    4. Choose Use existing key. Enter the alias and password, then click Next.
    Select new keystore to create a new keystore.
    1. Enter the location where the new keystore should be created.
    2. Enter the password, then reenter the password for confirmation.
    3. Click Next.
    4. In the Key Creation window, enter the details. Click Next.
  4. In the Destination and key/certificate checks window, enter the destination APK file name.
  5. Click Finish.

Results

This process creates an Android Client Hub executable (.apk) that can be deployed on the device or emulator.

Customizing or Branding the Client Hub User Interface

After importing the ClientHub project, you can customize the look and feel of the Client Hub application.

For example: the splash or welcome screen can be customized to include your company logo or image. Browse through the ClientHub > res folder and replace the resource files as per your requirement.

Setting the SSO Passcode in Client Hub Application

You must set your SSO passcode in the Client Hub application and use this passcode in all your applications.

Context

By default, the SSO passcode must have least eight characters, and contains at least one uppercase, lowercase, and numeric character. You can modify the minimum passcode length before compiling the Client Hub application by changing the MinLength value in the ClientHubPolicy.properties.

Procedure

  1. Launch the Client Hub application on your device.
    The Create SSO Passcode window displays.
  2. Enter the SSO passcode, then reenter the passcode to confirm the change.
  3. Click Submit.
    A success message is displayed if the passcode is accepted and set correctly. Use this SSO passcode for all the applications.
  4. Exit the Client Hub application.

Resetting the Client Hub SSO Passcode

If you forget the SSO passcode, platform security prevents you from using the applications. You must reset your SSO passcode in the Client Hub application, and use the new passcode in all your applications. Resetting the passcode deletes all data from the secure store.

Procedure

  1. Click Reset, then click OK to confirm.
    An alert box is displayed for confirmation. If you click OK, you are redirected to the Set passcode screen.
  2. In the Create SSO Passcode screen, enter the new passcode, then reenter the passcode to confirm the change.
  3. Click Submit.

Next Steps

Use this new passcode for all the applications.