Android Feature Flags

Supported on: Android SDK 1.0.33+

The feature flags module lets you enable or disable features remotely from the AppDNA Console. Flags are evaluated locally from cached config — no network call, no latency.

Check a Flag

if (AppDNA.features.isEnabled("dark_mode")) {
    enableDarkMode()
}

isEnabled() returns false by default if the flag does not exist or config has not loaded. The top-level convenience method AppDNA.isFeatureEnabled("dark_mode") is equivalent.

Read a Variant Value

Some flags carry a typed payload beyond on/off (e.g., a tier name or rollout percentage). Read the value with getVariant:

val tier = AppDNA.features.getVariant("pricing_tier") as? String
val percentage = (AppDNA.features.getVariant("rollout_percent") as? Number)?.toInt()

Returns Any? (string, number, boolean, list, or map). Cast to the type the Console stored.

Module Access

val features = AppDNA.features

Module Methods

Method	Signature	Description
`isEnabled`	`isEnabled(flag: String): Boolean`	Check if a feature flag is enabled
`getVariant`	`getVariant(flag: String): Any?`	Get the typed value for a flag (string/number/bool/map)
`onChanged`	`onChanged(callback: (Map<String, Boolean>) -> Unit)`	Register a callback that runs after each config fetch (also when nothing changed)

Listen for Changes

Register a callback that receives every flag’s current isEnabled value each time the SDK applies feature-flag or in-app-message configuration fetched from the server — at configure(), on each scheduled refresh (the config TTL and the background refresh worker), and on AppDNA.remoteConfig.refresh(). It fires after every such fetch even when no flag changed, and usually more than once per fetch (once for each flag or message document the SDK reads, and once when it prunes removed ones), so compare with the values you last acted on:

AppDNA.features.onChanged { flags ->
    if (flags["maintenance_mode"] == true) {
        showMaintenanceScreen()
    }
}

The callback receives every flag, each with its isEnabled value, as a Map<String, Boolean> — not just changed keys. Re-read whichever flags you care about and react accordingly. Callbacks add up: each one you register fires. You can register before configure, and a callback stays registered after shutdown() and fires again once configure runs.

Using Flags with Experiments

Feature flags and experiments work together. Gate a feature behind a flag, then run an experiment to test its impact:

if (AppDNA.features.isEnabled("new_workout_ui")) {
    val variant = AppDNA.experiments.getVariant("workout_ui_test")

    when (variant) {
        "compact" -> showCompactWorkoutUI()
        "detailed" -> showDetailedWorkoutUI()
        else -> showDefaultWorkoutUI()
    }
} else {
    showLegacyWorkoutUI()
}

Full Example

import ai.appdna.sdk.AppDNA
import ai.appdna.sdk.paywalls.PaywallContext
import android.app.Activity

class FeatureGate(private val activity: Activity) {

    fun checkAccess(feature: String, onLocked: () -> Unit, onUnlocked: () -> Unit) {
        if (AppDNA.features.isEnabled(feature)) {
            onUnlocked()
        } else {
            onLocked()
        }
    }
}

// Usage
val gate = FeatureGate(activity)

gate.checkAccess(
    feature = "ai_suggestions",
    onLocked = {
        AppDNA.presentPaywall(
            activity = activity,
            id = "premium_paywall",
            context = PaywallContext(placement = "feature_gate"),
        )
    },
    onUnlocked = {
        showAiSuggestions()
    },
)

Feature flags are managed in the Console under Settings → Feature Flags. Toggle a flag on or off and it takes effect at the next SDK config fetch — when the TTL elapses (default 1 hour), at the background refresh every 15 minutes, or at AppDNA.remoteConfig.refresh() / AppDNA.forceRefreshConfig(). The SDK does not listen for flag changes in real time.

Next Steps

Combine with Experiments for A/B-tested rollouts
Use Remote Config for richer value shapes
Configure Offline Support for cache TTL behavior

​Check a Flag

​Read a Variant Value

​Module Access

​Module Methods

​Listen for Changes

​Using Flags with Experiments

​Full Example

​Next Steps

Check a Flag

Read a Variant Value

Module Access

Module Methods

Listen for Changes

Using Flags with Experiments

Full Example

Next Steps