Permissions & Setup
Before integrating the Cycle SDK, you must configure your Android project with the required permissions and dependencies.
Android Permissions
Minimum API Level: 19+
The following permissions must be added to your AndroidManifest.xml:
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" />BLUETOOTH_CONNECT and BLUETOOTH_SCAN are required for Android 12+ compliance.
SDK Integration
To integrate the Cycle SDK into your Android project, follow these two steps.
1. Add Cycle Maven Repository
In your project-level build.gradle:
allprojects {
repositories {
google()
jcenter()
maven { url 'https://maven.cyclebitgroup.com' }
}
}2. Add SDK Dependency
In your app-level build.gradle:
dependencies {
implementation 'com.mpos:sdk:2.1.0'
}