Make your first
local security check.

// settings.gradle.kts — dependencyResolutionManagement.repositories
mavenCentral()

// app/build.gradle.kts — dependencies
implementation("io.github.jimmyleonardo:aegis-guardian:3.2.0")

// Set minSdk = 24 or higher and JVM target = 17 in your app.
// Sync Gradle after adding the dependency.

import android.app.Activity
import android.os.Bundle
import android.widget.TextView
import com.jimmyleonardo.guardian.AegisGuardian
import com.jimmyleonardo.guardian.SecurityCheck
import java.util.concurrent.Executors

// Example Activity: inspect off the UI thread, then display the result.
class GuardianExampleActivity : Activity() {
    private val worker = Executors.newSingleThreadExecutor()

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        val output = TextView(this).apply { text = "Checking device…" }
        setContentView(output)

        val guardian = AegisGuardian.Builder(applicationContext)
            .setRequiredChecks(setOf(
                SecurityCheck.ROOT,
                SecurityCheck.EMULATOR,
                SecurityCheck.HOOKING
            ))
            .build() // No Sentinel configuration or credentials.

        worker.execute {
            val message = try {
                val report = guardian.inspect()
                val decision = guardian.securityPolicy.evaluate(report)
                val summary = report.checks.joinToString("\n") {
                    "${it.check}: ${it.status}"
                }
                val result = if (decision.allowed) "Selected checks passed"
                    else "Pause action: ${decision.blockedChecks}"
                "$result\n\n$summary"
            } catch (error: Exception) {
                "Inspection failed. Pause the sensitive action."
            }
            runOnUiThread {
                if (!isDestroyed) output.text = message
            }
        }
    }

    override fun onDestroy() {
        worker.shutdown()
        super.onDestroy()
    }
}

// Register this Activity in AndroidManifest.xml to open the example.
// In production, put the selected-check decision before your sensitive flow.

// Replace this with your own release signing certificate SHA-256.
// This is a local certificate comparison, not server verification.
val report = guardian.inspect(expectedSignatureSha256 = releaseFingerprint)

// Inside an Activity, on the UI thread, before sensitive content is shown:
val guardian = AegisGuardian.Builder(applicationContext)
    .enableScreenProtection()
    .build()
val protection = guardian.protectScreen(this)
if (protection.isFailure) {
    // Keep sensitive content hidden and handle the error.
    return
}
// Display your sensitive screen after protection succeeds.