Android support (EXPERIMENTAL)

7min
LicenseSpring provides a C++ SDK built using the Android NDK, designed for Android applications. The SDK is compatible with Android devices running Android API Level 24 (Android 7.0 Nougat) or higher.
NDK Version: 27.1.12297006
Minimum Android API Level: 24 (Android 7.0 Nougat)
ABI version: arm64-v8
The SDK provides native C++ functionality and is optimized for performance on supported Android devices.
Important notes
All these issues will be fixed in the official release.
Hardware ID generation
Hardware ID generation is not supported in the current experimental version. You must set it with LicenseSpring::ExtendedOptions::setHardwareId.
Default license file path
The SDK doesn't have a default file path used for saving the license file, and not setting it manually will crash the program. You must set it with LicenseSpring::ExtendedOptions::setLicenseFilePath
Default logging path
Same as license file path. You must set it with LicenseSpring::BaseManager::setDataLocation. 
Code sample
For a Java or Kotlin Android app you need to follow the standard procedure of linking against a C++ library and calling it from managed code.
C++ snippet
C++
// sampleapp.cpp
// Android app is named SampleApp

#include <jni.h>
#include <string>
#include <LicenseSpring/Configuration.h>
#include <LicenseSpring/ExtendedOptions.h>
#include <LicenseSpring/LicenseManager.h>
#include <LicenseSpring/License.h>

extern "C"
JNIEXPORT jstring JNICALL
Java_com_example_sampleapp_MainActivity_stringFromJNI(JNIEnv* env, jobject) {
    try {
        std::string api_key = "api_key_here";
        std::string shared_key = "shared_key_here";
        std::string product_code = "product_code_here";
        std::string license_key = "license_key_here";

        LicenseSpring::ExtendedOptions options;
        options.setLicenseFilePath(L"/data/data/com.example.sampleapp/files/License.key");
        options.setHardwareID("hello from android!");

        auto p_config = LicenseSpring::Configuration::Create(api_key, shared_key, product_code,
                                                             "App name", "APp version", options);
        auto p_license_manager = LicenseSpring::LicenseManager::create(p_config);
        LicenseSpring::LicenseID license_id = LicenseSpring::LicenseID::fromKey(license_key);
        auto license = p_license_manager->getCurrentLicense();
        license = p_license_manager->activateLicense(license_id);
        license->check();
        auto ret = license->deactivate();
        return env->NewStringUTF((ret ? "License deactivated" : "License deactivation failed"));
    } catch (std::exception& e) {
        // pass exception message to managed code
        return env->NewStringUTF(e.what());
    }
}
// sampleapp.cpp
// Android app is named SampleApp

#include <jni.h>
#include <string>
#include <LicenseSpring/Configuration.h>
#include <LicenseSpring/ExtendedOptions.h>
#include <LicenseSpring/LicenseManager.h>
#include <LicenseSpring/License.h>

extern "C"
JNIEXPORT jstring JNICALL
Java_com_example_sampleapp_MainActivity_stringFromJNI(JNIEnv* env, jobject) {
    try {
        std::string api_key = "api_key_here";
        std::string shared_key = "shared_key_here";
        std::string product_code = "product_code_here";
        std::string license_key = "license_key_here";

        LicenseSpring::ExtendedOptions options;
        options.setLicenseFilePath(L"/data/data/com.example.sampleapp/files/License.key");
        options.setHardwareID("hello from android!");

        auto p_config = LicenseSpring::Configuration::Create(api_key, shared_key, product_code,
                                                             "App name", "APp version", options);
        auto p_license_manager = LicenseSpring::LicenseManager::create(p_config);
        LicenseSpring::LicenseID license_id = LicenseSpring::LicenseID::fromKey(license_key);
        auto license = p_license_manager->getCurrentLicense();
        license = p_license_manager->activateLicense(license_id);
        license->check();
        auto ret = license->deactivate();
        return env->NewStringUTF((ret ? "License deactivated" : "License deactivation failed"));
    } catch (std::exception& e) {
        // pass exception message to managed code
        return env->NewStringUTF(e.what());
    }
}
﻿
CMakeLists.txt
Text
# Include headers and link against libLicenseSpring, libcurl and libssp

cmake_minimum_required(VERSION 3.22.1)

project("sampleapp")

include_directories(${CMAKE_SOURCE_DIR}/include)

add_library(${CMAKE_PROJECT_NAME} SHARED sampleapp.cpp)

add_library(ssl SHARED IMPORTED)
set_target_properties(ssl PROPERTIES IMPORTED_LOCATION ${CMAKE_SOURCE_DIR}/../jniLibs/${ANDROID_ABI}/libssl.so)

add_library(curl SHARED IMPORTED)
set_target_properties(curl PROPERTIES IMPORTED_LOCATION ${CMAKE_SOURCE_DIR}/../jniLibs/${ANDROID_ABI}/libcurl.so)

add_library(LicenseSpring SHARED IMPORTED)
set_target_properties(LicenseSpring PROPERTIES IMPORTED_LOCATION ${CMAKE_SOURCE_DIR}/../jniLibs/${ANDROID_ABI}/libLicenseSpring.so)

target_link_libraries(
        ${CMAKE_PROJECT_NAME}
        ssl
        curl
        LicenseSpring
        android
        log)
# Include headers and link against libLicenseSpring, libcurl and libssp

cmake_minimum_required(VERSION 3.22.1)

project("sampleapp")

include_directories(${CMAKE_SOURCE_DIR}/include)

add_library(${CMAKE_PROJECT_NAME} SHARED sampleapp.cpp)

add_library(ssl SHARED IMPORTED)
set_target_properties(ssl PROPERTIES IMPORTED_LOCATION ${CMAKE_SOURCE_DIR}/../jniLibs/${ANDROID_ABI}/libssl.so)

add_library(curl SHARED IMPORTED)
set_target_properties(curl PROPERTIES IMPORTED_LOCATION ${CMAKE_SOURCE_DIR}/../jniLibs/${ANDROID_ABI}/libcurl.so)

add_library(LicenseSpring SHARED IMPORTED)
set_target_properties(LicenseSpring PROPERTIES IMPORTED_LOCATION ${CMAKE_SOURCE_DIR}/../jniLibs/${ANDROID_ABI}/libLicenseSpring.so)

target_link_libraries(
        ${CMAKE_PROJECT_NAME}
        ssl
        curl
        LicenseSpring
        android
        log)
﻿
Kotlin snippet
﻿
Kotlin
class MainActivity : ComponentActivity() {
    // Load the native C++ library
    init {
        System.loadLibrary("sampleapp")
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        enableEdgeToEdge()

        val nativeMessage = stringFromJNI() // get the string from the C++ lib

        setContent {
            SampleAppTheme {
                Scaffold(modifier = Modifier.fillMaxSize()) { innerPadding ->
                    Greeting(
                        name = nativeMessage,
                        modifier = Modifier.padding(innerPadding)
                    )
                }
            }
        }
    }

    external fun stringFromJNI(): String
}
class MainActivity : ComponentActivity() {
    // Load the native C++ library
    init {
        System.loadLibrary("sampleapp")
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        enableEdgeToEdge()

        val nativeMessage = stringFromJNI() // get the string from the C++ lib

        setContent {
            SampleAppTheme {
                Scaffold(modifier = Modifier.fillMaxSize()) { innerPadding ->
                    Greeting(
                        name = nativeMessage,
                        modifier = Modifier.padding(innerPadding)
                    )
                }
            }
        }
    }

    external fun stringFromJNI(): String
}
﻿
﻿
Updated 26 Sep 2024
Did this page help you?
C++
C++ SDK Installation