To add the library to the project put an aar file in libs catalog and modify gradle.Build file
Parameter ‘name’ in the ‘compile’ section should be named the same as the library file without the extension.

repositories {
        flatDir {
            dirs 'libs'
        }
    }
    dependencies {
        compile(name:'appmanagolibrary-release', ext:'aar')
    }

For other tools configuration check how to add the external library to the project in their documentation.

  androidx.appcompat:appcompat:1.0.0
  androidx.legacy:legacy-support-v4:1.0.0
  androidx.media:media:1.0.0
  com.google.firebase:firebase-messaging:21.1.0
  com.google.firebase:firebase-core:18.0.3
  com.google.android.gms:play-services-location:16.0.0
  com.google.android.gms:play-services-base:16.1.0
  androidx.constraintlayout:constraintlayout:1.1.3
  com.squareup.picasso:picasso:2.5.2
  com.google.code.gson:gson:2.8.2

In the strings.xml file of integrated application add the following entries:

• appmanago_launch_time
  It defines the time interval between successive uses of the module/function after which we
  assume that the application was restarted. The value is given in minutes.

   

  <string name="appmanago_launch_time">30</string>

  For 30 – launch event will be registered when the application has been inactive for 30 minutes and then resumed.

• appmanago_sync_meantime
  It/ Variable/ The entry defines how often the platform should make an attempt to synchronize events, which took place when there was no Internet connection. The value is given in minutes.

   

  <string name="appmanago_sync_meantime">360</string>

  In the example application will try to synchronize every 360 minutes.

• appmanago_endpoint
  It/ Variable/ The entry defines the endpoint. Default endpoint for APPmanago is

   

  <string name="appmanago_endpoint">https://api.appmanago.com</string>

• appmanago_vendor_id
  Vendor identificator; itan be found after logging in to the APPmanago panel Settings -> Account.

   

  <string name="appmanago_vendor_id">VENDOR_ID</string>

• appmanago_application_id
  Simple ID of the application.The ID is created when you add a new application to Create app panel.

   

  <string name="appmanago_application_id">APPLICATION_SIMPLE_ID</string>

• appmanago_gps_sync_time
  Minimal interval between sending GPS coordinates (in minutes).

   

  <string name="appmanago_gps_sync_time">1</string>

• appmanago_gps_front_available
  Flag determining whether the location should be updated continuously or only when the application is active (0 – still, 1 – only when the application is active).

   

  <string name="appmanago_gps_front_available">0</string>

• appmanago_gps_accuracy
  Accuracy of location determination and also battery consumption:
  – HIGH – high accuracy, the device will determine the most accurate location,
  – BALANCED – (recommended) – accuracy up to 100m with the best ratio of performance to battery consumption,
  – LOW – accuracy up to 10km, low battery consumption,
  – PASSIVE – passive mode, the application is waiting for the location to be updated by other applications, it does not use energy to determine it,
  (to avoid battery drain, location system has 10s timeout – if within 10 second location is not resolved, process will be canceled)

   

  <string name="appmanago_gps_accuracy">HIGH</string>

Communication of events is carried out by the object of AmMonitor class.

Initiation of that object can be set as in below example. It can take place in onCreate() method.

    private AmMonitoring amMonitor;
    amMonitor = AmMonitor.initLibrary(getApplicationContext());

objects should be created ‘per activity’ as they contain components responsible for measuring time spent in a module.

One must override methods onResume() and onPause()

        @Override
        protected void onResume() {
            super.onResume();
            amMonitor.eventStarted(ACTIVITY_NAME, new AmProperties());
        }
    
    
        @Override
        protected void onPause() {
            super.onPause();
            amMonitor.eventEnded(ACTIVITY_NAME, new AmProperties());
        }

To add FCM to the application one must execute client’s manual on Google page:
https://firebase.google.com/docs/cloud-messaging/android/client

In order to receive Server API Key and Sender ID one should register the application. Then, add API and ID to the GCM account in APPmanago. Those values can be found in Settings -> Cloud Messaging after logging in to the project in the Firebase console. One should also integrate the android project with FCM using the ready tool in Android Studio Tools -> Firebase -> Cloud Messaging.

The next step is adding the permissions and services to AndroidManisfest.xml:

        <service
            android:name="com.appmanago.lib.fcm.AmFirebaseListenerService">
            <intent-filter>
                <action android:name="com.google.firebase.MESSAGING_EVENT" />
            </intent-filter>
        </service>

Additionally, check the Google Api service for onCreate() method.

        if (checkPlayServices()) {
            amMonitor.resolveRegistrationToken();
        }

Implementation is as follows:

       private boolean checkPlayServices() {
        GoogleApiAvailability apiAvailability = GoogleApiAvailability.getInstance();
        int resultCode = apiAvailability.isGooglePlayServicesAvailable(this);
        if (resultCode != ConnectionResult.SUCCESS) {
            if (apiAvailability.isUserResolvableError(resultCode)) {
                apiAvailability.getErrorDialog(this, resultCode, 9000)
                        .show();
            } else {
                Log.i(Constants.LOG_TAG, "This device is not supported.");
                finish();
            }
            return false;
        }
        return true;
      }