Troubleshooting

// 1. Check initialization
if (!StringProvider.isInitialized()) {
    StringbootExtensions.autoInitialize(this)
}

// 2. Trigger manual sync
lifecycleScope.launch {
    val success = StringProvider.refreshFromNetwork("en")
    Log.i("Stringboot", "Sync success: $success")
}

// 3. Verify key exists in dashboard
// 4. Check API token in AndroidManifest.xml

// 1. Check if SDK is ready
if !stringProvider.isReady {
    print("SDK not ready")
}

// 2. Check for initialization errors
if let error = stringProvider.initializationError {
    print("Init error: \(error)")
}

// 3. Trigger manual sync
Task {
    await stringProvider.refreshFromNetwork(
        lang: "en",
        forceRefresh: true
    )
}

// In Application.onCreate()
runBlocking {
    val locale = StringProvider.deviceLocale()
    StringProvider.preloadLanguage(locale, maxStrings = 500)
}

// In App init
StringProvider.shared.initialize(...)

// Restore saved language before showing UI
let savedLang = UserDefaults.standard.string(
    forKey: "com.stringboot.currentLanguage"
) ?? StringProvider.shared.deviceLocale()

StringProvider.shared.setLocale(savedLang)

// Use hooks instead of manual state
function Component() {
  const title = useString('app_title'); // Auto-updates!
  return <h1>{title}</h1>;
}

// Re-apply tags after language change
private fun switchLanguage(newLang: String) {
    lifecycleScope.launch {
        StringProvider.setLocale(newLang)
        StringProvider.preloadLanguage(newLang, 500)

        // Must re-apply tags!
        withContext(Dispatchers.Main) {
            binding.root.applyStringbootTags()
        }
    }
}

// Use @ObservedObject
@ObservedObject var stringProvider = StringProvider.shared

// Or use SBText which updates automatically
SBText("welcome_message")

Picker("Language", selection: $selectedLanguage) {
    // ...
}
.disabled(stringProvider.isChangingLanguage) // Disable during change