Android

Getting started

1. Add the Akiles Maven repo to repositories{} in settings.gradle or build.gradle.

Kotlin (build.gradle.kts):

repositories {
    maven {
        url = uri("https://maven.akiles.app/release")
    }
}

Groovy (build.gradle):

repositories {
    maven {
        url = uri("https://maven.akiles.app/release")
    }
}

2. Add a dependency on the Akiles SDK in build.gradle for your application module.

Kotlin (build.gradle.kts):

dependencies {
    implementation("app.akiles:sdk:2.1.0")
}

Groovy (build.gradle):

dependencies {
    implementation 'app.akiles:sdk:2.1.0'
}

Finally, click “Sync Now” in Android Studio to sync the Gradle build.

Permissions

From your Activity, propagate calls to onRequestPermissionsResult to the Akiles SDK.

@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    akiles.onRequestPermissionsResult(requestCode, permissions, grantResults);
}

Card emulation

The SDK can do NFC card emulation to allow opening doors via holding it in front of an NFC-enabled Akiles device.

Setup

First, create an AID for your application:

• Go to the Developer Center
• select your application
• go to “Card emulation AIDs”
• Create one

Add the following inside the <manifest> tag in AndroidManifest.xml:

<uses-feature android:name="android.hardware.nfc.hce" android:required="false" />

Add the following inside the <application> tag in AndroidManifest.xml:

<service android:name="app.akiles.sdk.AkHostApduService" android:exported="true"
    android:permission="android.permission.BIND_NFC_SERVICE">
    <intent-filter>
        <action android:name="android.nfc.cardemulation.action.HOST_APDU_SERVICE"/>
    </intent-filter>
    <meta-data android:name="android.nfc.cardemulation.host_apdu_service"
        android:resource="@xml/akilesapduservice"/>
</service>

Add a new file res/xml/akilesapduservice.xml with the following contents:

<?xml version="1.0" encoding="utf-8"?>
<host-apdu-service xmlns:android="http://schemas.android.com/apk/res/android"
    android:description="@string/akiles_hce_service_desc"
    android:requireDeviceUnlock="false"
    android:requireDeviceScreenOn="false">
    <aid-group android:description="@string/akiles_hce_aid_desc"
        android:category="other">
        <aid-filter android:name="F37ABDC6xxxx" />
    </aid-group>
</host-apdu-service>

Add a new file res/values/strings.xml with the following contents:

<resources>
    <string name="akiles_hce_service_desc">Akiles HCE Service</string>
    <string name="akiles_hce_aid_desc">Akiles AID group</string>
</resources>

Replace the AID F37ABDC6xxxx with the AID provided to you by Akiles Support.

Usage

• Ensure you’ve added a member session with addSession().
• Hold the phone in front of the Akiles device. No need to unlock the phone or open your app!

If you have added multiple sessions to the SDK, all of them are automatically checked when tapping the phone to the Akiles device.

• If at least one of them has permissions the device will do the action.
• If none has permissions the device will do an error beep.
• If multiple have permissions only one of them will appear in the event logs, it’s not guaranteed which.

Android versions

The SDK supports Android API level 23 (Android 6) or higher.

Bluetooth requires API level 29 (Android 10) and higher. On lower versions, Bluetooth operations always fail with error code BLUETOOTH_NOT_AVAILABLE, but the rest of the SDK still works. For example, doing gadget actions still works, but only via internet.

Demo app

The SDK demo app showcases all major SDK features:

• Session management: Add/remove member sessions using tokens
• Gadget actions: Open doors and control devices via internet or Bluetooth
• Hardware scanning: Discover nearby Akiles devices via Bluetooth
• Hardware sync: Update device firmware and configuration
• NFC card scanning: Read and update Akiles cards

The app displays real-time status updates for both internet and Bluetooth operations, making it easy to test different scenarios.