JarCasting
Quality checks
Framework to support Applivery.com Mobile App distribution for Android Apps.
Table of Contents
Overview
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.
Features
- 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.
Support
Applivery SDK is fully compatible with Android v5.0 (API 21) and higher versions. However it will build properly from Android 4.1 (API 16) but the with limited functionality.
Getting Started
First of all, you should create an account on Applivery.io 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 your App -> Settings -> Integrations section.
SDK Installation
Gradle with jCenter dependency
implementation 'com.applivery:applivery-sdk:3.3'
Gradle with JitPack Maven dependency
Add the following repository to your's root gradle:
allprojects {
repositories {
maven { url "https://jitpack.io" }
}
}
Add the following dependency to your app gradle:
dependencies {
implementation 'com.github.Applivery:applivery-android-sdk:v3.3'
}
Gradle with Nexus/MavenCentral dependency
add the following dependency to your app gradle:
compile 'com.applivery:applivery-android-sdk:3.3'
SDK Setup
Step 1
At your application startup, in a class extending from Application, you must call the Applivery.init() method:
class AppliveryApplication : Application() {
override fun onCreate() {
super.onCreate()
if (BuildConfig.BUILD_TYPE != "release") {
Applivery.init(this, BuildConfig.APPLIVERY_APP_TOKEN)
}
}
}
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: Don't init Applivery on release builds
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:
Applivery.checkForUpdates()
About params
- app: Your app instance.
- appToken: Your app token from applivery dashboard
Advanced concepts
Updates
You will find that the following public methods are available:
Manually check for updates:
Applivery.checkForUpdates()
Check for updates when coming from background
Applivery.setCheckForUpdatesBackground(true)
Start the download of the last app version:
Applivery.update()
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:
Applivery.enableScreenshotFeedback();
Applivery.disableScreenshotFeedback();
... and the shake event by using:
Applivery.enableShakeFeedback();
Applivery.disableShakeFeedback();
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
Applivery.unbindUser();
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"?>
<resources>
<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 downloadInfo! 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>
</resources>
res/values/applivery.xml
You can also override the following drawable resources:
- Feedback tab indicator (should be provided as a 9patch png):
applivery_selected_tab_button - Feedback close button:
applivery_close
applivery_close_pressed - Feedback done button:
applivery_done
applivery_done_pressed - Feedback send button:
applivery_send
applivery_send_pressed
Sample App
As a sample integration you can take a look at our sample app
Acknowledgements
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.
License
Copyright (C) 2020 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
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
