Skip to main content
The remote config module delivers key-value pairs from the AppDNA Console to your app. Values are set in the Console and synced to the SDK automatically. All reads are synchronous from an in-memory cache — they never block the UI thread or require a network call.

​
Get Config Values

Read values using the get method. Returns Any? — you cast to the expected type on your side. 
let welcome = AppDNA.remoteConfig.get("welcome_message") as? String ?? "Hello!"
let maxRetries = AppDNA.remoteConfig.get("max_retries") as? Int ?? 3
let discount = AppDNA.remoteConfig.get("discount_rate") as? Double ?? 0.1
let promoEnabled = AppDNA.remoteConfig.get("show_promo") as? Bool ?? false
To retrieve all config values at once: 
let allConfig = AppDNA.remoteConfig.getAll()
// Returns [String: Any] -- all currently cached config key-value pairs

​
Module Access

let remoteConfig = AppDNA.remoteConfig

​
Module Methods

MethodSignatureDescription
getget(_ key: String) -> Any?Get a config value
getAllgetAll() -> [String: Any]Get all config values
refreshrefresh()Force refresh from server
onChangedonChanged(_ handler: @escaping () -> Void)Register change callback

​
When Config Refreshes

The SDK refreshes remote config automatically:
  • On app launch — if the cached config has expired (default TTL: 1 hour)
  • On return from background — same TTL check
  • Background fetch — the SDK checks for updates periodically
You can also force a refresh manually with AppDNA.remoteConfig.refresh(). If the fetch fails (no connectivity, timeout), the SDK continues using the cached values. On first launch with no connectivity, bundled config defaults are used.
The config TTL is configurable via AppDNAOptions(configTTL: 7200) (in seconds). The default is 3600 seconds (1 hour).

​
Listen for Config Changes

Register a closure to be notified when remote config values change after a refresh: 
AppDNA.remoteConfig.onChanged {
    // Config values were updated -- re-read any values you need
    let newValue = AppDNA.remoteConfig.get("feature_limit")
}

​
Full Example

import AppDNASDK

class HomeViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()

        AppDNA.remoteConfig.onChanged { [weak self] in
            // Refresh UI when config changes in the background
            DispatchQueue.main.async {
                self?.configureUI()
            }
        }

        configureUI()
    }

    func configureUI() {
        // Read values -- always synchronous, always available
        let title = AppDNA.remoteConfig.get("home_title") as? String ?? "Welcome"
        let showBanner = AppDNA.remoteConfig.get("show_promo_banner") as? Bool ?? false
        let bannerText = AppDNA.remoteConfig.get("promo_banner_text") as? String ?? ""

        titleLabel.text = title

        if showBanner {
            promoBanner.text = bannerText
            promoBanner.isHidden = false
        }
    }
}
Remote config values are managed in the Console under Settings > Remote Config. Changes take effect on the next SDK config refresh (within the TTL window).