Try Out SAP Cloud Platform SDK for Android Wizard

Open Android Studio.

Choose Start a new SAP Cloud Platform Android project.

The wizard can save the server connection details for multiple servers. Fill in the required fields as shown below.

Ensure you have completed the prerequisites for this tutorial before continuing.

Go to the SAP Cloud Platform Mobile Services website and under Important Links, both URLs will be present

Click Next on the Server Connection tab.

On the Cloud Configuration tab select Create and provide the required information.

Click Next to configure the OData Services.

The SAP Cloud Platform Mobile Services provides a sample backend destination named com.sap.edm.sampleservice.v2 that is being used here to provide data for the application. It contains product categories, product, supplier, customer and sales order data. Since you are creating a new application, add com.sap.edm.sampleservice.v2.

Click Next to continue to the project configuration.

On the Android Studio Project tab provide the following configuration data.

On the Project Features tab, provide the following configuration data.

If you would like to add push notification support to your application, proceed to Step 2 which describes how to acquire a google-services.json file needed for push messaging. Otherwise, uncheck Enable Push, click Finish and proceed to Step 3.

When the Enable Push checkbox is checked, an error message is shown explaining that you need to specify a google-services.json file. We will obtain this file from the Cloud Messaging feature in Google Firebase.

Open the Firebase console and click on Add project.

Access Project Settings for the newly created project.

Add Firebase to your app.

The Android package name must match the Project Namespace used when creating the app in Android Studio. In our example, the Android package name is com.sap.wizapp.

Download the google-services.json file.

Now browse for the google-services.json file in the wizard. This file is placed into the app folder of the generated project and helps enable the app to work with Google Firebase notifications.

The push configuration on the server will be added in the tutorial Send notifications to your application.

Click Finish.

Wait for the build to finish.

Click the Run toolbar icon.

Choose the emulator to run the app on.

For more information on creating Virtual Devices that run in the Android Emulator, see here.

The welcome screen is shown the first time the app is run.

Sign in with your credentials.

The entered credentials, are securely stored by the app, and do not need to be re-entered the next time the app is opened.

The passcode (or fingerprint if enabled) screen provides an additional layer of security for your app.

The passcode policy can be modified in the Mobile Service Cockpit under Client Policies feature. The passcode screen will not be shown if the Enable Passcode Policy is not checked.

As usage reporting was enabled, this screen can be used to show details of how the collected data will be used. Usage is covered in a later tutorial in this mission.

The first screen of the app shows the different entities that are in the sample OData service.

Tap on Products to reach the below list screen.

Tap on a list item to show an editable detail screen.

Further information on the generate application can be found at Running the Wizard.

Congratulations! You have created your first Android app using the SAP Cloud Platform SDK for Android!