Skip to content

Configuring and Building Apps

Use the cloud build service to configure and build clients in Mobile Services cockpit, and enable them to use the SAP Mobile Platform SDK.

Identify the icons to implement. The file size of the application splash screen and the launch icon can't exceed 1 MB.

  • Application launch: 152 by 152 pixels

  • Splash screen: portrait mode (1536 by 2048 pixels)

  • Splash screen: landscape mode (2048 by 1536 pixels)

  • (Neo and Android only) Notification icon: push notification (192 by 192 pixels). This option only appears if you upload a google-services.json file, which is an indication that you plan to use android notification.

Create signing profiles needed for each platform type. See Manage Signing Profiles.

Mobile Card Kit client only:

Go to the Apple Developer site and enable app groups for your app ID. See SAP Mobile Cards: Build Mobile card kit clients using the cloud build service and Enable app services.

Mobile Card Kit clients for the iOS platform built using cloud build service support iMessage and Today Screen extensions. To build a client containing these extensions, create individual signing profiles for each extension.

Mobile Development Kit client only: requires App Update feature. Please upload the bundle file to App Update feature, and deploy.

Cloud build service in Mobile Services cockpit supports the following:

  • Mobile Card Kit client

  • Mobile Development Kit client

For information about the different client types and required packaging details, see Supported Client Types, Packaging Details, and Build Options.

Note

These apps are automatically added to App Lab, which makes it easy for developers and testers to install and use during the development cycle, and for administrators to store the binaries. The App Lab process that runs in the background sends an event log at the INFO level when everything works fine, or at the ERROR level when processing fails. If you don't see an app you expect, or want more information, navigate to Analytics > Logs and view Event Logs.

You can also rebuild an existing binary using different build options.

After building the app, you can download the app binary and build logs or enable over-the-air (OTA) installation for the binary.

  1. In Mobile Services cockpit, select Mobile Applications > Native/Hybrid or SAP Mobile Cards.

  2. Select an application, then select Cloud Build under Assigned Features (or add it first); or select Features > Cloud Build for Mobile Card Kit.

  3. On Build Jobs, view a list of available build jobs for the selected application.

    Build Job Properties

    Property Description
    ID The generated build job identifier. This ID can be useful for searching the logs for information in a troubleshooting situation.
    Build Job Name The name assigned to the build job, such as "Cordova Test App".
    Status The current status of the build job, such as "Build Completed" or "Building" or "Build Failed".
    Signing Profile The signing profiles used for the platforms included in the build job, in the format<Platform>:<signing_profile_name>. For example: Android:AndroidProfileKey0 or iOS:CBSComSapFioriWildcard.
    Version The version assigned to the build, such as 1.0.
    Actions The actions you can perform, such as build, install, edit, and delete.
    • Create Build Job ‒ create a new build job. See Creating a Build Job.

    • Edit ‒ edit the selected build job. See Editing a Build Job.

    • Delete ‒ delete the selected build job.

  4. (Optional) Under Actions, select Build to run the selected build job. Check the Status column to view progress.

  5. (Optional) Under Actions, select Install to obtain the link to install the app on a device, if a binary is available. You can do one of the following:

    • Scan the QR code with a device.

    • Copy the URL to the clipboard.

      To install the binary, paste and access the URL.

  6. You can select each cloud build history row to view its current state, install, and download binaries.

    Cloud Build History

    Item Description
    State Current state of the build, such as Building, Build Failed, and Build Complete.
    Project State (Neo) (Custom SAP Fiori Client only) Indicates the current project state. Status includes "NA" when the project is not available, "Generating …" when a project is generating, and "Generation Complete" when the project is ready to download after the cloud build completes.
    Debug Enabled Whether the debugging tool is enabled.
    Operating System The operating system of the build, such as iOS or Android.
    Form Factor The device type, such as tablet or phone.
    Version / Version Name The application version.
    Build / Version Code The build version.
    Built On The date of the build, in the format YYYY-MM-DD HH:MM (local or UTC).
    Certificate Expiration The date the certificate expires, in the format YYYY-MM-DD HH:MM (local or UTC).
    Actions Actions you can take, if any, including Install and Download Binary (only if a binary is available).
  7. (Optional) Under Actions, click Download Binary to download the binary to a local directory. Choose Open to download and open the binary or Save to download and save it. When ready, you can post the binary to a download site.

  8. (Optional) Select a specific build job history row to view build details.

    • Under Build Logs, you can view the live build logs as the build progresses. The log includes a summary of build attributes appropriate for the platform, such as the client type, tool set versions, plugins, Cordova versions, and SAP UI5:

      • iOS ‒ platform, application version number, type, Kapsel version, node information, Cordova and Xcode versions, and the selected operating system.

      • Android ‒ platform, type, application version number, Kapsel version, node information, Cordova versions, NodeJS, Gradle, Java, and SDK tool versions, and the selected operating system.

      • SAP UI5 ‒ applies to iOS and Android builds for Mobile Card Kit clients and packaged apps.

        You can select download and download the logs to a local directory, if required. Use the logs to troubleshoot problems.

    The following options are also available:

    • Download Binary to download the binary.

    • Delete to delete the binaries. Any binary that was added to App Lab is automatically be deleted as well.

  9. Select the Info tab to view feature details.

Supported Client Types, Packaging Details, and Build Options

Create a Signing Profile

Purge Cloud Build Artifacts


Last update: September 29, 2020