XuqmGroup db3ec3d377 fix: auto-init XuqmSDK via ContentProvider; remove packageName from update check; fix Jenkinsfile - sdk-core: add XuqmInitializerProvider for auto-init at app startup - sdk-core: register provider in AndroidManifest.xml - sdk-license: remove duplicate XuqmSDK init from LicenseInitializerProvider - sdk-update: awaitInitialization() now uses requireInit() directly (no 30s polling) - Jenkinsfile: replace Windows external commands (findstr/powershell) with Groovy readFile/writeFile Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>		2026-05-23 04:11:32 +08:00
..
src/main	fix: auto-init XuqmSDK via ContentProvider; remove packageName from update check; fix Jenkinsfile	2026-05-23 04:11:32 +08:00
build.gradle.kts	build: 各 SDK 模块独立版本，publish.gradle 改用 project.version	2026-05-21 16:48:10 +08:00
consumer-rules.pro	Add Android license SDK	2026-05-15 21:00:24 +08:00
README.md	Use appKey in license SDK requests	2026-05-15 21:42:27 +08:00

README.md

Xuqm License SDK

Android SDK for device license registration and verification.

Features

Stable Device ID: Uses ANDROID_ID (stable per app signing key + device + user), with UUID fallback
Token Caching: Caches valid status for configurable window (default 10 min) to reduce network calls
Auto Recovery: Automatically re-registers when token is invalid or revoked
Offline Support: Returns cached OK status when network is unavailable
Encrypted License File: Reads assets/xuqm/license.xuqm; the file does not expose appKey or server URL as readable text
AppKey Change Detection: Automatically clears old data when decrypted appKey changes

Integration

dependencies {
    implementation("com.xuqm:sdk-license:0.1.0-SNAPSHOT")
}

Usage

License File

Download the encrypted License file from the tenant platform and place it at:

app/src/main/assets/xuqm/license.xuqm

The SDK also accepts a tenant-platform downloaded file such as app/src/main/assets/xuqm/MyApp.xuqmlicense.

No explicit initialization code is required.

Check License

LicenseSDK.checkLicense { isValid ->
    if (isValid) {
        // allow app usage
    } else {
        // block app usage or show warning
    }
}

Optional user metadata can be uploaded during the same check. All fields are optional.

LicenseSDK.checkLicense(
    userInfo = LicenseUserInfo(
        userId = "u_10001",
        name = "张三",
        email = "zhangsan@example.com",
        phone = "13800000000",
    ),
) { isValid ->
    // allow or block app usage
}

Get Status (no network)

val status = LicenseSDK.getStatus() // OK, DENIED, or UNKNOWN

Re-register (force)

lifecycleScope.launch {
    val result = LicenseSDK.reRegister()
}

Get Device ID

val deviceId = LicenseSDK.getDeviceId()

Configuration

Parameter	Default	Description
`appKey`	from encrypted file	AppKey from tenant platform
`deviceName`	`${MANUFACTURER} ${MODEL}`	Device display name
`baseUrl`	`https://auth.dev.xuqinmin.com/`	License server base URL

Data Storage

All data (device ID, token, status) is stored in EncryptedSharedPreferences with AES-256 encryption.