Introduction

Glia Android SDK allows to add engagement functionality to your native Android app.

System Requirements

  • Android API Level 24 (Nougat) or higher

  • Java 8 (see Use Java 8 to enable Java 8 support)

Installing

Add Glia Maven repository to a list of repositories in build.gradle:

maven {
url "https://glia.bintray.com/maven"
credentials {
username '<USERNAME>'
password '<API_KEY>'
}
}

Contact your success manager to receive <USERNAME> and <API_KEY>.

Add Glia SDK to the list of dependencies:

implementation 'com.glia:android-sdk:0.11.0'

Required User Permissions

Glia SDK requires some system permissions. However the SDK is distributed as AAR library with all required permissions included within it so there is no need to explicitly specify them in your manifest file as they will be included automatically. This are the permissions that will be added:

<!-- Internet access -->
<uses-permission android:name="android.permission.INTERNET" />
<!-- Access to network state to know when Visitor reconnects to the Internet -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!-- Permission to draw on top of other apps, used for annotations during screen
sharing. Visitor must also explicitly grant this permission to the app through a
permission management screen during the screen sharing session.
-->
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW"/>

ProGuard Rules

The SDK is provided as aar library with all the required rules already defined. There is no need to add any rules manually.

3rd Party Dependencies

All third party dependencies are fetched automatically together with the Android Glia SDK if the SDK was integrated as specified in in step Installing. List of dependencies that are used by our SDK:

HTTP and WebSockets

com.squareup.retrofit2:retrofit
com.squareup.okhttp3:okhttp
io.socket:socket.io-client
com.github.dsrees:JavaPhoenixClient

JSON marshalling/unmarshalling

com.google.code.gson:gson
com.squareup.retrofit2:converter-gson

App lifecycle

android.arch.lifecycle:extensions
android.arch.lifecycle:compiler

WebRTC - video, audio, screen sharing

org.webrtc:google-webrtc

Annotations

com.caverock:androidsvg-aar

Event processing

io.reactivex.rxjava2:rxjava
io.reactivex.rxjava2:rxandroid

Standard library

com.google.guava:guava

The dependencies are listed for informational purposes. There is no need to add them to your dependency list.

Licence

Glia Android SDK is available under the MIT license.