This public repository is read-only and no longer maintained. For the latest sample code repositories, visit the SAP Samples organization.
This application demonstrates how to utilize the Chart Cards views in the SAP Fiori UI library. The app is intended to provide an example implementation of these controls with a real network API data source, i.e. the COVID Tracking APIs, so that users can understand how to use the SAP Fiori Chart Cards views to expand the functionality of their own applications.
If you are new to the SAP Cloud Platform SDK for Android, Get Started with SAP Cloud Platform SDK for Android, Step by Step with the SAP Cloud Platform SDK for Android series, and the SAP Cloud Platform SDK for Android Learning Journey are great places to start.
The app makes HTTP requests to the COVID Tracking APIs to retrieve US Daily and States Current COVID-19 data. Then the data is transformed into ChartCardDataModel objects which are displayed in the Chart Cards view from the SAP Fiori UI library. In case the network service is unavailable, an offline mode allows retrieval of COVID-19 data from locally stored JSON documents.
 |
|---|
| US Daily COVID-19 Data in Base Cards |
 |
|---|
| States Current COVID-19 Data in Scrollable Cards |
 |
|---|
| Total COVID-19 Cases by States in Column Chart View |
- Android Studio version 3.6
- SAP Cloud Platform SDK for Android from Trial Downloads or SAP Cloud Platform SDK for Android from Software Downloads version 3.1.3 or higher.
The blog Step by Step with the SAP Cloud Platform SDK for Android contains additional details on how to setup and install the SDK.
There is a dedicated section in the Fiori for Android Design Guidelines which explains the Chart and Chart Card components.
SAP Cloud Platform Mobile Services Documentation provides more technical details on how to use the Chart Cards component in an Android application.
In order to run the project properly, you need to follow the configuration steps below:
- Open the project in Android Studio.
- To successfully run the application, the
sdkVersionvariable in thegradle.propertiesfile needs to be set correctly. Depending on which version of the SDK you have installed (e.g.3.1.3), change the variable as shown in the screenshot below.
- Run the project to deploy it onto an emulator or device.
There are no known issues at this time.
If you have questions/comments/suggestions regarding this app please post them using the tag SAP Cloud Platform SDK for Android or if you encounter an issue, you can create a ticket.
Currently this project is only being updated and maintained by SAP employees.
Copyright (c) 2020 SAP SE or an SAP affiliate company. All rights reserved. This project is licensed under the Apache Software License, v. 2 except as noted otherwise in the License file.
The COVID Tracking APIs used in this project is taken from The COVID Tracking Project which is "a volunteer organization launched from The Atlantic and dedicated to collecting and publishing the data required to understand the COVID-19 outbreak in the United States."
The COVID Tracking Project at The Atlantic’s data and website content is published under a Creative Commons CC BY 4.0 license. The data APIs are used in this project without any modifications.