To add monitoring to a
mobile app, you
must embed Aternity's monitoring into the app itself, before it is
encrypted.
With the Mobile SDK you can insert API calls to fine-tune the monitoring, by
dynamically setting properties (like the device name, location),
or tag events for use in some types of custom activities, or you can use APIs to report
breadcrumbs for later troubleshooting of
crashes.
A custom activity for mobile
apps starts and ends when the app reports specific events which match the events
of an activity's signature file. If Aternity already reports these
events by default, you do not need to add manual API calls. However, for some
custom activities, you must manually tag and report those events using API calls.
For example, to
measure the response time between the start of a sign in and its
response, if those events are not automatically reported, insert
an API to tag the sign in action, and add another API call to
tag its response. When you report each tag to Aternity, it matches them to the custom activity already in place, and then reports
the response time in the dashboards. To create your own
custom activities, contact Customer Services.
To activate the Aternity Android Mobile SDK, you must
integrate it into your development environment and add the init
method to initialize it.
The Aternity Android SDK is
a zip archive of several files which you add to your development environment and
then rebuild the app. The instructions in this section use Android Studio as the
example development environment, but it is compatible with other Android development
environments like Eclipse. The Aternity Android SDK includes
the following files:
-
A plain text configuration file, aternity.conf which defines the
monitoring settings locally in the app
-
A library file called aternity_sdk.jar.
Before you begin
Ensure your app
compiles and builds cleanly with no errors, and runs on a simulator or a mobile
device.
Before embedding Aternity's
monitoring into an Android mobile app, verify your device conforms to the
following minimum system requirements (Aternity Android Wrapper or
Aternity Android Mobile SDK):
Attribute |
Requirement (Android Wrapper and Aternity Android SDK) |
Operating system
|
Android 4.4 or later.
|
Java Developer Kit
|
JDK 1.8 or later.
|
Programming environment
|
Google Android Studio or a standalone Android SDK.
Using the SDK Manager, install the latest Android SDK tools
(platform tools and build tools) for SDK Platform API level 19
or newer.
|
Connectivity
|
Internet access.
|
App resource usage
|
When you add Aternity functionality to an Android app:
|
To run a monitored app, the device must have
the following operating systems:
Attribute |
Requirement |
Android operating system of monitored device
|
Android 4.4 and up to Android 9.
|