Cycle Logo

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'
}