Troubleshooting

Los popups no aparecen nunca

Comprueba:

que initialize(...) o init(...) se llamó una sola vez sobre una instancia nueva
que hay un publicKey válido
que se llamó a attachContext(...) con un contexto de plataforma válido
que setPath(...) coincide con los paths que espera la segmentación del popup
que autoLaunch está activado, o que se llama a autoLaunch() tras la inicialización

Los popups no cargan

Comprueba:

que el entorno de runtime apunta a la URL base del backend esperada
que el backend tiene definiciones de popup para el publicKey dado
que la app provee los valores de idioma y path esperados

Los triggers de scroll o de evento no se disparan

Comprueba:

que la app host realmente reenvía el porcentaje de scroll a través de onScroll(...)
que los eventos personalizados se envían con triggerEvent(...)
que los flujos basados en click usan triggerClick(...)

Problemas al renderizar la encuesta

La encuesta se pinta dentro de una web view nativa, que carga el script y la hoja de estilos de la encuesta desde el CDN de jsDelivr (cdn.jsdelivr.net) y la encuesta desde la API de Deepdots.

Comprueba:

que el dispositivo tiene red y que ningún proxy, VPN o firewall bloquea cdn.jsdelivr.net
que la encuesta está publicada y pertenece al mismo entorno que el publicKey
los logs del SDK con debug = true (Logcat / consola de Xcode) por si hay errores de la web view

Comprueba que el Info.plist de la app tiene CADisableMinimumFrameDurationOnPhone a true. El popup se pinta con Compose Multiplatform, que la necesita en dispositivos ProMotion (120 Hz). Consulta Installation.

Errores de validación o de envío en los flujos de encuesta

El código maneja tanto errores de validación como de envío y los muestra en la UI. Si la encuesta se queda bloqueada:

inspecciona los logs del WebView de Android
inspecciona la salida de consola de iOS y los mensajes del puente
confirma que el payload de la encuesta contiene los valores de progreso y total esperados

Problemas de compilación o resolución del paquete binario en iOS

Comprueba:

que el XCFramework local o alojado existe
que spm/Package.swift apunta al ZIP de release y al checksum correctos
que la demo de iOS ha resuelto las dependencias del paquete tras regenerar el binario local si hacía falta

Troubleshooting

Troubleshooting

Los popups no aparecen nunca

Los popups no cargan

Los triggers de scroll o de evento no se disparan

Problemas al renderizar la encuesta

La app se cierra al abrir un popup en iOS

Errores de validación o de envío en los flujos de encuesta

Problemas de compilación o resolución del paquete binario en iOS