Prerequisites

An Android application with minimum API 21 or later
Android compile SDK 35 for the current integration baseline
Java 11 bytecode compatibility
A physical device whose ABI list contains arm64-v8a
A Nosmai licence key bound to the application ID

Requirement details

AAR is the Android library file added to the app.
API level identifies an Android version and the system features available to the app. Minimum API 21 means Android 5.0 is the oldest supported Android version for this native integration.
Compile SDK 35 means the project builds against Android's API 35 tools; it does not mean every user must run Android 15.
ABI describes native processor compatibility. arm64-v8a is the current supported 64-bit ARM target and requires a compatible physical device.
Java 11 compatibility is a project build setting required by this release.

Download and verify the AAR

Create the application library directory:

mkdir -p app/libs

Download the native release and checksums from the official Android v3.0.4 release:

A checksum is a digital fingerprint used to confirm that the downloaded file is complete and unchanged. SHA-256 is the method used to create it.

curl -L \
  -o app/libs/nosmai-sdk-3.0.4.aar \
  https://github.com/nosmai/nosmai_effects_sdk_android/releases/download/v3.0.4/nosmai-sdk-3.0.4.aar

curl -L \
  -o SHA256SUMS \
  https://github.com/nosmai/nosmai_effects_sdk_android/releases/download/v3.0.4/SHA256SUMS

Verify the release:

shasum -a 256 -c SHA256SUMS

The expected AAR SHA-256 is:

4804fc5bf502ca7aff46285562b8d0318d7d14f6ada8a9cb3112fc2188804284

Do not rename or use an artifact that fails verification.

Configure the app module

For Kotlin DSL:

android {
    compileSdk = 35

    defaultConfig {
        minSdk = 21

        ndk {
            abiFilters += listOf("arm64-v8a")
        }
    }

    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_11
        targetCompatibility = JavaVersion.VERSION_11
    }
}

dependencies {
    implementation(files("libs/nosmai-sdk-3.0.4.aar"))
}

For Groovy DSL:

android {
  compileSdkVersion 35

  defaultConfig {
    minSdkVersion 21
    ndk {
      abiFilters 'arm64-v8a'
    }
  }

  compileOptions {
    sourceCompatibility JavaVersion.VERSION_11
    targetCompatibility JavaVersion.VERSION_11
  }
}

dependencies {
  implementation files('libs/nosmai-sdk-3.0.4.aar')
}

The AAR contains consumer R8 rules for the public API, JNI entry points, frame callbacks, and cloud response types. Keep the app's normal release minification configuration and inspect the merged rules when adding custom shrinking rules.

Add Android permissions

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <uses-permission android:name="android.permission.CAMERA" />
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.RECORD_AUDIO" />

    <application
        android:allowBackup="true"
        android:label="CameraApp"
        android:theme="@style/Theme.CameraApp" />
</manifest>

Request CAMERA at runtime before opening Camera2. Request RECORD_AUDIO only before recording audio. Internet access is used for licence verification and Cloud Filters.

AAR size

The 3.0.4 AAR is 53,876,984 bytes, about 51.4 MiB. This is not the final Play Store download increase. App Bundle ABI delivery, compression, existing shared dependencies, and symbols affect the result.

Build a signed release App Bundle and inspect its device-specific download size in Play Console before publishing.

Verify it worked

Add a version log after application startup:

import android.util.Log;
import com.nosmai.effect.api.NosmaiSDK;

Log.i("CameraApp", "Nosmai version: " + NosmaiSDK.getVersion());

Build and install on an ARM64 device. A successful launch with version 3.0.4 confirms Java classes and native libraries are packaged. Continue to the Android quickstart to initialize, connect Camera2, and apply skin smoothing.

Common errors

Error	Cause	Fix
`Could not find com.nosmai` or `package com.nosmai.effect.api does not exist`	App module does not reference the AAR path	Put the verified file in `app/libs` and add `implementation(files("libs/nosmai-sdk-3.0.4.aar"))`
`INSTALL_FAILED_NO_MATCHING_ABIS`	Device or build does not support `arm64-v8a`	Use an ARM64 physical device and retain the ABI filter
`UnsatisfiedLinkError`	AAR is missing, corrupted, duplicated, or stripped incorrectly	Verify SHA-256, keep one AAR copy, and inspect the packaged native libraries
`License key cannot be null or empty`	Build configuration did not supply the licence key	Provide the app-bound key before `NosmaiSDK.initialize`
`Cleartext HTTP traffic not permitted`	App is loading a development asset over HTTP	Use HTTPS or an explicit development-only network security configuration

Install the Nosmai Effects SDK on Android