Creating Custom Clients¶
Build and run the Mobile Development Kit client to connect to your SAP Cloud Platform mobile application. You can also package your app so that it can be posted to the Apple App Store, iOS Enterprise App Store or Google Play.
Before building your Mobile Development Kit client, you must install the SDK dependencies.
For Android development, go back to the zip file that you downloaded from Software downloads,
MDK_SDK-<version number>-Universal.zip and browse to the MDKClient_SDK.zip and extract it to a local folder. Navigate to that folder and open a command prompt. Run
For iOS development, use terminal or finder to run the
create-client.command file appears in the SDK directory.
BrandedSettings.jsonfiles to specify information like application connection, passcode policy settings, application icon, and so forth. It is recommended that you copy the
template.mdkprojectfolder to another location to use it for future builds. Retain the
.mdkprojectextension to prevent the create-client script from failing.
- To know more about how you can brand your app, see Branding Your Customized App.
Place your app definition files in the application.definitions folder. If you do not have a default bundled app, a script is provided to generate an app from your application definitions.
Create the SDK client by running the
./create-client.commandcommand. You must provide the path to a valid
To get help on using the create-client command, run ./create-client.command -h .
A new folder with the same name as the value set for
Navigate to the app name folder, in
tns build <device>.
tns build androidfor Android
tns build ios foriOS
To run the app on an Android emulator, use the
tns run android --emulatorcommand. Make sure that you have created a virtual device in Android Studio prior to running this command. To run the app on the iOS Simulator, use the
tns run ios --emulatorcommand.
To run the app on an Android device, use the
tns run android --device <device identifier>command. To run the app on an iOS device, use the
tns run ios --device <device identifier>command You can find the value of the device identifier by attaching the device to your Windows system and running the
tns device androidcommand. You can find the value of the device identifier by attaching the device to your Mac system and running the
tns device ioscommand.
See Building Custom Client For Release for details on how to build and package client for release.