Update Thryve SDK and module configs

After the SDK is initialized with getOrCreate, you can change credentials, locale, identity, or module settings without restarting the app.

There are two APIs:

API	Use when
updateSDKConfig	You need to change top-level SDK fields and/or multiple modules together
updateModuleConfig	You only need to update one module (for example device events listener, Shen AI listener, or observability).

updateSDKConfig treats the config as authoritative. Always pass a full ThryveSDKConfig that still includes every module you want to keep active. Omitting a module config (for example Garmin Companion license) can tear that module down at runtime.

ThryveGarminCompanionConfig can not be updated at runtime. It can only be updated after re-intialization using getOrCreate during a restart of your application.

updateModuleConfig does not support updating ThryveObservability configuration in the Thryve Android SDK

Update ThryveSDKConfig at runtime using updateSDKConfig

iOS

private func makeFullSDKConfig(endUserId: String?, endUserAlias: String?) -> ThryveSDKConfig {
    let credentials = partnerInfo.resolvedCredentialPair()
    let backgroundSyncEnabled = UserDefaults.standard.bool(forKey: AppleHealthViewModel.bgSyncKey)
    return ThryveSDKConfig(
        authId: credentials.authId,
        authSecret: credentials.authSecret,
        endUserAlias: endUserAlias,
        endUserId: endUserId,
        locale: partnerInfo.language == "none" ? nil : partnerInfo.language,
        configs: [
            ThryveAppleHealthConfig(
                dataTypes: ThryveAppleHealthDataType.allConnectorTypes,
                enableBackgroundSync: backgroundSyncEnabled
            ),
            ThryveShenAIConfig(apiKey: Environment.shenAIApiKey)
        ],
        observability: ObservabilityConfig(
            tracingEnabled: observabilityEnabled,
            crashReportingEnabled: crashReportingEnabled
        )
    )
}

//Apply updated fields without recreating the SDK using the function above
let updatedConfig = makeFullSDKConfig(
        endUserId: endUserId,
        endUserAlias: endUserAlias
    )
    ThryveSDK.get().updateSDKConfig(
        thryveSDKConfig: updatedConfig,
        callback: completion
    )

Android

fun buildSDKConfig(
    endUserId: String? = null,
    endUserAlias: String,
): ThryveSDKConfig {
    return ThryveSDKConfig(
        authId = authId,
        authSecret = authSecret,
        endUserAlias = endUserAlias,
        endUserId = endUserId,
        locale = locale,
        healthConnectConfig = ThryveHealthConnectConfig(
            dataTypes = healthConnectPermissions,
            enableBackgroundSync = true,
            enableReadHealthDataHistory = true,
        ),
        samsungHealthConfig = currentSamsungHealthConfig(),
        shenAIConfig = ThryveShenAIConfig(
            apiKey = "SHEN_AI_API_KEY",
            eventsListener = shenAIEventListener,
        ),
        observabilityConfig = ThryveObservabilityConfig(
            tracingEnabled = tracingEnabled,
            crashReportingEnabled = crashReportingEnabled,
        ),
    )
}

//Apply updated fields without recreating the SDK using the function above and shared state

//Apply updated locale
sharedState.locale = selectedLanguage
ThryveSDK.get().updateSDKConfig(sharedState.buildSDKConfig())

//Apply updated ThryveHealthConnect data types
sharedState.healthConnectPermissions = updatedDataTypes
ThryveSDK.get().updateSDKConfig(sharedState.buildSDKConfig())

//Apply updated ThryveSamsungHealth data types
sharedState.samsungHealthPermissions = updated
ThryveSDK.get().updateSDKConfig(sharedState.buildSDKConfig())

UpdateModuleConfig at runtime

iOS

// Apply Cbservability configuration changes
 ThryveSDK.get().updateModuleConfig(
    config: ObservabilityConfig(
        tracingEnabled: tracingEnabled,
        crashReportingEnabled: crashReportingEnabled
    )
)

// Apply ShenAI configuration changes
let configWithListener = ThryveShenAIConfig(
    apiKey: Environment.shenAIApiKey,
    eventsListener: self
)
ThryveSDK.get().updateModuleConfig(config: configWithListener)

Android

// Apply Health Connect configuration changes
ThryveSDK.get().updateModuleConfig(
    source = Source.HEALTH_CONNECT,
    config = ThryveHealthConnectConfig(
        dataTypes = updatedHealthConnectTypes,
        enableBackgroundSync = true,
        enableReadHealthDataHistory = true,
    ),
)

Which API should I call?

1. Changing locale, auth, end-user identity, or several modules → updateSDKConfig(fullConfig)

2. Changing one module listener / one module setting → updateModuleConfig(...)

3. Changing end-user identity in a way that requires a clean re-init → getOrCreate(fullConfig) again