thecr3w-dev/docs/ANDROID-SDK.md

THECR3W-DEV — ANDROID UPDATE SDK

Wersja: 1.0.0 | Data: 2026-10-31

---

1. Przegląd Biblioteki

thecr3w-update-sdk to biblioteka w Kotlinie dla aplikacji Android (API 26+) realizująca bezpieczny proces aktualizacji w pełnej zgodności z architekturą bezpieczeństwa Androida:

• Sprawdzanie wydań w tle z wykorzystaniem Jetpack WorkManager.
• Bezpośrednie pobieranie APK z Cloudflare R2 przez Pre-signed URLs.
• Rygorystyczna weryfikacja sumy kontrolnej SHA256 pliku APK przed przekazaniem do instalatora.
• Weryfikacja cyfrowa metadanych Ed25519.
• Wywołanie systemowego instalatora pakietów przez FileProvider z jawną zgodą użytkownika (brak prób omijania zabezpieczeń systemu operacyjnego).

---

2. Przykład Użycia w Kotlinie

val updater = TheCr3wUpdater(
    context = applicationContext,
    apiBaseUrl = "https://app.thecr3wnet.com",
    appId = "com.thecr3w.app",
    currentVersion = BuildConfig.VERSION_NAME,
    currentVersionCode = BuildConfig.VERSION_CODE,
    channel = "stable",
    architecture = "arm64-v8a",
    trustedPublicKeyHex = "..."
)

CoroutineScope(Dispatchers.IO).launch {
    val update = updater.checkForUpdate()
    if (update.updateAvailable) {
        // Pobranie i weryfikacja SHA256
        val apkFile = updater.downloadAndVerify(update) { progress ->
            Log.d("TheCr3w", "Pobieranie APK: ${(progress * 100).toInt()}%")
        }

        // Wyświetlenie systemowego instalatora pakietu
        withContext(Dispatchers.Main) {
            updater.promptInstall(apkFile)
        }
    }
}