Troubleshooting

Aucun provider detecte

• Verifier que l'environnement hote est bien actif (iframe, WebView, bridge natif).
• Verifier que l'action HOTSPOT_GET est implementee cote host.
• Confirmer que le statut du store est unsupported et non error.

Timeout au demarrage

• Le bootstrap utilise un timeout de lecture hotspot.
• Si l'hote repond lentement, augmenter readTimeoutMs dans initializeHotspotAtStartup().
• Confirmer dans les logs HotspotBootstrap et perf:nav:layout.

HOTSPOT_SET en erreur

• Verifier que le host Android supporte bien le contrat principal: HOTSPOT_SET avec params.subAction (start|stop|restart).
• Le client applique un fallback legacy (isEnabled) en second essai. Ce fallback est deprecie.
• En mode ?debugHotspot=true, verifier dans les logs hotspotSetMode et fallbackUsed.

Loader "En attente de demarrage" qui persiste

• Cela signifie en general que HOTSPOT_GET repond mais que HOTSPOT_SET echoue (autostart impossible).
• Verifier les erreurs host renvoyees dans la reponse bridge (Bridge error: HOTSPOT_SET).
• Le systeme passe en retry background avec backoff; confirmer Scheduling hotspot background retry dans les logs.

Etat stale en UI

• Verifier que l'UI lit hotspotStore et pas uniquement hotspotMode.
• Forcer un refresh via HotspotManager.getCredentials() depuis le menu hotspot.

---

Retour au README