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, the system 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 Mac 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
|
Mac OS X 10.10 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 |
iOS operating system of monitored device
|
iOS 10 or later.
|
Android operating system of monitored device
|
Android 4.4 or later.
|