Device

See how to configure the Properties, Preferences, Plugins and more in the Device tab of your Mobile Client

Properties

In the Properties you add configuration specific for the mobile client. Some properties are general for all device types, some specific for each platform.

App ID

Your mobile client must have a unique ID, so that it can be distributed and installed without conflicts with existing mobile clients.. Should follow the reverse domain name notation,

com.company.app.

Author

Developer’s name

Download all apps from server after login

If your mobile client will be used mostly in offline mode, it can be a good idea to download all the applications open login. So that they are ready to use the first time they are launched, even without Internet connection. You need to add functionality to your mobile client to initialize all the data the users need if you plan to use this approach.

Export all apps into ZIP file

To take the above approach further, you can export all applications into a .zip file. This option is useful when your mobile client primarily operates offline. By adding tilegroups to the mobile client that contain tiles with attached actions, you can direct the attached event to a Neptune application.

Ordinarily, these applications are fetched online and rendered on the device, which is a significant benefit of the Neptune DXP - SAP Edition. Whenever an application change is transported to the production system, it is immediately updated on the mobile device.

However, by exporting all Neptune applications into the .zip file, the applications will not be updated automatically when changes are made in the SAP system. The advantage of exporting the applications is that they will be available without requiring an internet connection.

Device Preferences

When constructing mobile clients, the target platform is Cordova. The Preferences section provides control over the Cordova build settings.

Device Orientation: Possible to lock device orientation.
Full screen Mode: Run applications in fullscreen on the device.
Content Loading Splash Screen: Your mobile client will use a static splash screen image when the mobile client loads. The Content loading splash screen is used inside the mobile client whenever a heavy load is done. Like unlocking the device. You can use the splash screen in your own coding.

Splash screen snippet

neptune.Splash.show();

iOS

Target a Specific Device: Select Device if you have specific device requirement, Universal is the default setup.
Prerender Icon: Prevents iOS from applying its default gloss effect to the app’s home screen icon.
Detect Data Type: Controls whether text patterns such as phone numbers and dates are automatically converted into links handled by various iOS services.
Exit on Suspend: Exit on suspend

Android

Install Location: Install location
Target SDK Version: Target the SDK Version
Minimum SDK Version: An integer designating the minimum API Level required for the application to run. The Android system will prevent the user from installing the application if the system’s API Level is lower than the value specified in this attribute. You should always declare this attribute. Click here for available Android SDK versions.
Maximum SDK Version: An integer designating the maximum API Level on which the application is designed to run.
Window Soft Input Mode: Android has the so-called Input Method Framework to support different input methods, e.g. keyboard, soft keyboard, handwriting etc. If the soft-keyboard is used it is displayed at the bottom of the screen once the user selects a textview to edit it.
Send device UDID to SAP (log & auth check): Each mobile client will get a new UUID each time the mobile client is installed on a device. The UDID on the other hand is device specific and will never change. Apple does not allow the app developer to collect the UDID, but on Android you can.

Windows 10

Media

To ensure optimal functionality, your mobile client should contain a variety of graphics. It is important to include a variety of icons and splash screens for each platform for which you are building. Icons will be added to the device’s home screen and will be used to launch your mobile client. A mobile client splash screen is a static image that will be displayed while the mobile client loads. It is important not to confuse the mobile client’s static splash screen with the content loading splash screen used inside the mobile client.

You create dedicated media packs that can be used in multiple mobile clients. A media pack includes all the icons and splash screens you need for a mobile client targeting Android, iOS & Windows. Read more about how to create a Media Pack

Plugins

When you build a mobile client, Neptune adds all the plugins you need as a minimum, you only need to add plugins if you have special needs.

Add Plugin: Add new plugin to the list. You’ll find all the plugins you need on the Cordova Plugin Page
Library: Neptune has collected a set of most used plugins, choose the ones you need from the list

Push Notification

Push notifications let your application notify a user of new messages or events even when the user is not actively using an application. When a device that is configured to receive push notifications receives a push notification, your application’s icon and a message appear in the status bar.

Config.xml

When you build your mobile client, Neptune creates a config.xml document with all the configuration and preferences you added. The config.xml document is used as a basis when building with Cordova and the Neptune Mobile Build Service.

You can add additional lines to the config.xml document, for instance extra plugins, or you can choose to replace the entire config.xml document.