This repository contains Android Studio projects illustrating the use of the SAS SDK for Android which enables Android developers to build customized apps that include content from SAS® Visual Analytics. The SAS SDK lets you build mobile apps that you can personalize, preconfigure, customize, and manage to meet your exact requirements.
-
Access and download the maven repository (mavenrepo.zip) from the [developer.sas.com Mobile SDK site] (https://developer.sas.com/guides/mobile-sdk.html).
-
Unzip mavenrepo.zip to a location such as: /tmp/mavenrepo.
-
Define an environment variable that points to the location:
export MOBILEBI_MAVEN_REPO_URL=/tmp/mavenrepo
-
Please view the SAS SDK release notes for a rundown on new features and changes.
With Android Studio: "Open An Existing Android Studio Project" or "File" > "Open", then navigate to and select project's build.gradle file.
You should be able to build and run the example projects on an emulator or device right away.
The first step app developers using the SAS SDK may want to take is to personalize the existing SAS Visual Analytics app by building a mobile app that uses their app name and icon. This can be done by creating a project with just resource files for your app name, icon and other assets. You can also pre-configure the connections to the SAS Visual Analytics server and the reports that you would like to be downloaded in a connections.json file under the assets folder.
No code is necessary for these use cases.
Example: PersonalizedApp
Creating a fully customized mobile app lets you include both SAS Visual Analytics reports and any other content and capabilities that tie into your organizational goals, processes, and projects. An example of a custom mobile app built with the SAS SDK is GatherIQ, a free app that is part of the SAS Data for Good program. This app is available in the App Store and Google Play.
http://developer.sas.com/sdk/mobile/android/doc/current/toolkit/alltypes/index.html
Examples:
If you manage and secure your mobile devices with a Mobile Device Management (MDM) solution, you can integrate your mobile apps with your MDM solution by using the SAS SDK. This is done by providing custom implementations of the various interfaces in SASManagerContext, namely:
The SAS SDK assumes a Material theme (e.g. Theme.MaterialComponents.*, Theme.Material3.*, etc.). If your app uses a non-Material theme, the standard material color attributes should still be defined.
com.sas.android.visualanalytics.report.view.ReportView
.
See the full list of defined color attributes and ensure they are defined for your theme.
Connections to SAS Visual Analytics servers are subject to the network security configuration defined by the application. Namely, starting with Android 9 (API level 28), cleartext (HTTP) connections are disabled (by Android) by default.
It is recommended that all SAS Visual Analytics servers be set up to allow only secure (HTTPS) connections. However, in situations where your app must connect to a server via HTTP, a less restrictive network security configuration can be put in place:
<network-security-config
xmlns:tools="http://schemas.android.com/tools"
>
<!--
* Allow HTTP connections
* Use <domain-config> for a more precise policy
-->
<base-config
cleartextTrafficPermitted="true"
/>
</network-security-config>
This file must be referenced from AndroidManifest.xml.
Note that such a configuration reduces the overall security throughout the app, and should be avoided if possible.
This project is licensed under this commercial license.
For information, advice, and questions on the use of SAS Mobile SDKs please start with the SAS Visual Analytics online community.