Skip to content
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
284 lines (204 sloc) 10.7 KB

Applivery Logo

Download Language MinSDK Twitter

Quality checks

Build Status

Framework to support Mobile App distribution for Android Apps.

Table of Contents


With Applivery you can massively distribute your Android Apps (both Ad-hoc or In-House/Enterprise) through a customizable distribution site with no need of your users have to be registered in the platform. No matter if your Android Apps are signed using Play Store or debug developer signature, Applivery is perfect not only for beta testing distribute to your QA team, but also for In-House Enterprise distribution for beta testing users, prior to a release, or even for corporative Apps to the employees of a company.


  • Automatic OTA Updates when uploading new versions to Applivery.
  • Force update if App version is lower than the minimum version configured in Applivery.
  • Send feedback. Your test users can report a bug or send improvements feedback by simply taking a screenshot.

Getting Started

First of all, you should create an account on and then add a new Application.

Get your credentials

APP TOKEN: that identifies and grants access to your app in order to use the SDK.

You can get your APP TOKEN in the Settings section.

SDK Installation

Gradle with jCenter dependency


implementation 'com.applivery:applvsdklib:3.0.1'

Gradle with JitPack Maven dependency

Add the following repository to your's root gradle:

  allprojects {
    repositories {
      maven { url "" }

Add the following dependency to your app gradle:

  dependencies {
    compile 'com.github.Applivery:applivery-android-sdk:v3.0.1'

Gradle with Nexus/MavenCentral dependency

Maven Central

add the following dependency to your app gradle:

 compile 'com.applivery:applivery-android-sdk:3.0.1'

Downloading source code

Dowload the zip called Zipped SDK from downloads folder.

Unzip all the content at the same level of your "app" folder.


Go to settings.gradle file:


And include your new module as follows:

include ':app', ':applvsdklib'

Now include this line into your app folder buld.gradle dependencies

compile project(":applvsdklib")

Downloading aar package as a lib

Dowload the zip aar called aar SDK from downloads folder. Now you can import a local aar file using the File --> New --> New Module -->Import .JAR/.AAR Package option in Android Studio and add this dependency to your app build.gradle in this way:

 compile project(":applvsdklib")

Do not forget that using this method you have to import the following libraries that Applivery SDK is using:

  compile ''
  compile 'com.squareup.retrofit2:retrofit:2.0.0'
  compile 'com.squareup.retrofit2:converter-gson:2.0.0'
  compile 'com.squareup.okhttp3:logging-interceptor:3.2.0'
  compile ''
  compile 'com.karumi:dexter:5.0.0'

SDK Setup

Step 1

At your application startup, in a class extending from Application, you must call the init method:

public class AppliveryApplication extends Application{
    @Override public void onCreate() {
      Applivery.init(this, BuildConfig.APP_TOKEN, false);

After that make sure to call the following Applivery public methods:

Applivery.init(this, BuildConfig.APP_TOKEN, false);

This method is intended to initialize the Applivery SDK. The only thing you have to take care about is that this call MUST be performed in App's onCreate() Method.

IMPORTANT: As you can suspect, you should replace the strings APP_TOKEN with you app token. Easy! Don't you think so?

Step 2

Once initialized the SDK and once your App is stable in the Home Screen you have to call proactivelly the following method in order to check for new updates:


About params

  • app: Your app instance.
  • appToken: Your app token from applivery dashboard
  • isStoreRelease: is the last param and the aim of this flag is to mark if the build will be submitted to Store. This is needed to prevent unwanted behavior like prompt to a final user that a new version is available on
    • True: Applivery SDK will not trigger automatic updates anymore. Use this for Play Store
    • False: Applivery SDK will normally. Use this with builds distributed through Applivery.

Advanced concepts


You will find that the following public methods are available:

Manually check for updates:


Check for updates when coming from background


Feedback Reporting

You can either take a screenshot or shake your phone if you want to send activate the Feedback Reproting feature

You can enable or disable the screenshot feedback by using the following methods:


... and the shake event by using:


Bind user

Programatically login a user in Applivery, for example if the app has a custom login and don't want to use Applivery's authentication to track the user in the platform

Applivery.bindUser(@NonNull String email, @Nullable String firstName,
                @Nullable String lastName, @Nullable Collection<String> tags);

Unbind user

Logout a previously binded user


Styling the UI

In order to customize the appearance of the UI, you can make a new resource file called applivery.xml under your res/values folder overwriting the Applivery default attributes.

<?xml version="1.0" encoding="utf-8"?>
  <color name="applivery_primary_color">#ffbb33</color>
  <color name="applivery_secondary_color">#ffffff</color>
  <color name="applivery_primary_font_color">#ffffff</color>
  <color name="applivery_secondary_font_color">#444444</color>
  <color name="applivery_drawing_color">#ffbb33</color>

  <string name="appliveryUpdate">Update!</string>
  <string name="appliveryUpdateMsg">There is a new version available for download! Do you want to update to the latest version?</string>
  <string name="appliveryMustUpdateAppLocked">You must update.</string>
  <string name="appliveryLoginFailDielogTitle">Invalid credentials</string>
  <string name="appliveryLoginFailDielogText">The email or password you entered is not valid</string>


You can also override the following drawable resources:

  • Feedback tab indicator (should be provided as a 9patch png):
  • Feedback close button:
  • Feedback done button:
  • Feedback send button:

Sample App

As a sample integration you can take a look at: our sample app


We would like to mention every open source lib authors:

  • Thank's to Square, we are using several libs they developed (Retrofit 2, OkHttp).
  • Thank's to Google, and Android Dev team, obviously, Android SDK, Support Libs ...
  • Thank's to Karumi for his great contributions to developers community in general. We are using Dexter from Karumi as well.


Copyright (C) 2019 Applivery

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.
You can’t perform that action at this time.