What's New in 3.0¶
Notable new or changed features for the SAP Cloud Platform SDK for Android version 3.0.
Upgrading to the Latest Version of the SDK¶
Extract the contents of the SAP Cloud Platform SDK for Android software update file to a folder on your computer and run the installation script. The installation script copies the SDK libraries to the local Maven repository and reinstalls the Android Studio plugin.
The installation script does not overwrite older versions of the SDK libraries. These are still present in the local Maven repository after the upgrade. This ensures applications referencing the older SDK will continue to compile.
For existing applications, manually update the SDK version in your Gradle files to the new one.
Tip
You can update the SDK version for your Wizard projects using the sdkVersion
property in the gradle.properties
file at the root of the generated project.
Foundation Library¶
New features:
-
Automatic upload for logging and usage
- Upload when the app is started, or a certain size is reached (e.g. 100KB of log size)
- Try three times if an upload fails, with an increasing delay between attempts
- Upload only when the device is online
New methods to existing APIs:
-
New methods for Logging class
- New upload methods for
Logging
class - New method to add upload listener for
Logging
class - New method to remove upload listener for
Logging
class
- New upload methods for
-
Support multiple listeners for
AppUsageUploader
class.A list of listeners is defined for
AppUsageUploader
instead of a single listener, and two new methods are added to register and unregister a usage listener. -
For several upload methods in
UsageBroker
class that includeAppUsageUploader.UploadListener
as an input parameter, the listener is actually not restricted to a single upload call, but defined globally forAppUsageUploader
. So it's confusing to includeAppUsageUploader.UploadListener
input parameter in upload methods.Add new upload methods without
AppUsageUploader.UploadListener
input parameter forUsageBroker
class.
New API:
Add a static initializer to make it easier for client code to initialize the SDK features, providing the following functions:
- Add an SDK facade with an
initialize
method that acceptsSettingsParameters
,OkHttpClient
, and a list of SDK components to initialize. - When logging and/or usage are listed as SDK features, the initializer will do the initialization and automatically upload the data.
- The initializer will automatically download client policies, storage service data, user roles, and client resources.
- The initializer will automatically upload the Firebase token to Mobile Services for push registration.
Fiori UI¶
New Chart Cards Component¶
Fiori UI now provides a Chart Cards to concisely display chart plots and associated metadata.
New Consent Support¶
Fiori UI now provides support for a multi-step Consent Form to obtain consent from the end user, supporting both optional and mandatory steps.
New Optical Character Recognition (OCR) Support¶
Fiori UI now provides an OCR control to scan and parse blocks of text.
New Column Chart Component¶
Fiori UI now supports the ColumnChart
control.
New Banner Control¶
Fiori UI now supports a Banner
control to prominently display important information when a response is needed from the user.
KPI Component¶
A new KPI Component is now provided to display Key Progress Indicators (KPI), including optional graphical elements and progress indicators.
Enhancements to Map Controls¶
The Map Controls have been enhanced to support right-to-left (RTL) locales as well as offline map tiles.
Enhanced Biometric Support¶
The biometric capabilities of the Onboarding component have been enhanced to provide basic support for biometrics in addition to fingerprint.
Enhancements to ObjectCell¶
The ObjectCell
has been enhanced to provide support for selection modes.
Enhancements to GridObjectCell¶
The GridObjectCell
has been enhanced to provide improved icon stack mapping.
Support for Additional Languages¶
- Support added for Dutch, Hebrew, Italian, Malay, Polish, Serbo-Croatian, Slovak, and Slovenian.
SAP Cloud Platform SDK for Android Wizard¶
- Update the application generated by the Android Wizard to reference new Foundation APIs.