Beginner
Use SAP Wizard to Create Your First Android Application
2018-11-30
15 min.
Create an Android application that will be connected to an OData backend.
You will learn
- How to create an Android app using the Android Studio integrated SAP Wizard
Make the most of your time at TechEd!
Running this Tutorial series requires a number of locally installed tools to support mobile development. You can download and install those separately after the show has ended. These prerequisite tools are all described at Installing the SAP Cloud Platform SDK for Android.
Be aware: If you do install those tools while at the show and run into any unforeseen issue, unfortunately, we don’t have the resources to help you diagnose your personal machine on the show floor (although, we’re always happy to take such questions on the SAP Community Q&A).
To save time, find us at the TechEd Developer Garage and use one of our preconfigured development machines to step right into the Android SDK experience. See you here!
Step 1: Set up development tools
If Android Studio is running, close it.
If there is an existing project at C:\AndroidStudioProjects\WizApp, delete it.
If there is an emulator running and an app on it named Wiz App, delete it (Long press, App info, then UNINSTALL).
Check if the emulator has airplane mode enabled.
If so, turn it off by swiping down from the top of the emulator and clicking the airplane icon.
All set, let’s begin!
Step 2: Create and run the project
Open Android Studio.
Choose Start a new SAP Cloud Platform Android project.
The SAP Cloud Platform SDK has been pre-installed on this machine from Trial Downloads. For further installation details see Installing the SAP Cloud Platform SDK for Android.
The wizard can save the server connection details for multiple servers. A preconfigured account has been provided.
If the values are missing, the following values can be used:
| Field | Value |
|---|---|
| Account Name | SAP Cloud Platform Mobile Services Trial |
| Admin API URL | https://hcpms-p2000464045trial.hanatrial.ondemand.com/ |
| Admin UI URL | https://hcpmsadmin-p2000464045trial.dispatcher.hanatrial.ondemand.com/?hc_reset |
| Username | p2000464045 |
| Password | SCP!2pwd |
On the Cloud Configuration tab, select Use Existing and set the Application ID to com.sap.wizapp.
The application configuration page for the com.sap.wizapp is shown below that is referenced from the above screen of the wizard. It has already been created and has added multiple features of the SAP Cloud Platform Mobile 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.
On the Project Configuration tab, provide the following configuration data:
| Field | Value |
|---|---|
| Project Name | Wiz App |
| Project Namespace | com.sap.wizapp |
| Project Location | C:\AndroidStudioProjects\WizApp |
| Use Discovery Service for Application bootstrapping | uncheck |
| Generate Master-Detail Application | check |
| Enable Logging | check |
| Enable Upload | check |
| Enable Push | check and browse to C:\AndroidStudioProjects\google-services.json |
If for some reason this file is missing, it can be downloaded from google-services.json.
After clicking Finish, a project is created.
Click the Run toolbar icon.
Choose the emulator to run the app on.
Step 3: Explore the app
The welcome screen is shown the first time the app is run.
Sign in with the following credentials:
| Field | Value |
|---|---|
| User Name | p2000464045 |
| Password | SCP!2pwd |
The credentials are used to authenticate against the SAP Cloud Platform Identity Service, are securely stored by the app, and do not need to be re-entered.
The passcode (or fingerprint if enabled) screen provides an additional layer of security for your app.
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.
Congratulations! You have created your first Android app using the SAP Cloud Platform SDK for Android!
×
Navigate tutorial steps