Create an Android Project that Imports the SAP Flows Library

Dan van Leeuwen

05/21/2019

Beginner

10 min.

Create an Android project that imports the SAP Flows library which provides a higher-level API enabling onboarding with SAP Cloud Platform Mobile Services using screens from the SAP onboarding UI.

You will learn

How to create a project in Android Studio without using SAP Cloud Platform SDK for Android wizard
How to import SAP libraries such as foundation, flows, onboarding, and SAP Fiori into the project

The Flows library is a new feature of the SAP Cloud Platform SDK for Android 2.0. It can reduce and simplify the code in an application related to onboarding and exchanging client policy data with Mobile Services. A great overview is provided by Britt Womelsdorf at A Closer Look at Android Flows.

Step 1: Create the project

Open Android Studio.

Choose Start a new Android Studio project.

Choose Empty Activity and click Next.

Provide the below values and click Finish.

Field	Value
Name	Flows
Package Name	`com.sap.flows`
Language	Java

Done

Log on to answer question

Step 2: Configure app in Mobile Services

The app configuration with an ID of com.sap.wizapp was created in Try Out SAP Cloud Platform SDK for Android Wizard and will be used in this tutorial.

Further details on how to access the Mobile Services cockpit are provided at Enable SAP Cloud Platform Mobile Services.

This tutorial assumes that Basic is selected as the apps Security Configuration.

Done

Log on to answer question

Step 3: Add SAP Cloud Platform SDK for Android libraries to the project

View Full Instructions

Open the project’s gradle.properties file.

Add a new gradle setting sdkVersion=2.1.1 to specify the version of the SAP Cloud Platform SDK for Android being used as shown below.

Open the project’s build.gradle file.

Specify the location where the SAP Cloud Platform SDK libraries can be located by adding mavenLocal() to the allProjects > repositories block as shown below.

The value mavenLocal() will resolve to the folder C:\Users\user_name\.m2\repository on Windows or to /Users/user/.m2/repository on a Mac.

Specify the libraries to include by adding the below libraries to the app’s build.gradle file in the dependencies block as shown below.

// Logging dependency
implementation 'org.slf4j:slf4j-api:1.7.25'
implementation 'com.github.tony19:logback-android:1.3.0-3'

// SAP Cloud Android SDK dependencies
implementation group: 'com.sap.cloud.android', name: 'foundation', version :sdkVersion
implementation group: 'com.sap.cloud.android', name: 'onboarding', version :sdkVersion
implementation group: 'com.sap.cloud.android', name: 'google-vision', version :sdkVersion
implementation group: 'com.sap.cloud.android', name: 'flows', version :sdkVersion
implementation group: 'com.sap.cloud.android', name: 'onboardingflows-basicauth', version :sdkVersion
implementation group: 'com.sap.cloud.android', name: 'onboardingflows-storemanager', version :sdkVersion
implementation group: 'com.sap.cloud.android', name: 'onboardingflows-welcomescreen', version :sdkVersion
implementation group: 'com.sap.cloud.android', name: 'onboardingflows-eulascreen', version :sdkVersion
implementation group: 'com.sap.cloud.android', name: 'onboardingflows-logging', version :sdkVersion // Supported in version 2.1.0 and higher
implementation group: 'com.sap.cloud.android', name: 'qrcodereader', version :sdkVersion

Press Sync Now on either of the two build.gradle files.