Fehlerbehebung

Diagnose ausführen

tapscope doctor

Jede Zeile ist ok, info, warn oder fail mit einem Hinweis. Mit --json ist das Ergebnis für Agenten maschinenlesbar. In der App verlinken die Zustände in der Seitenleiste auf die passende Anleitung.

Ein Gerät fehlt

• iPhone oder iPad: siehe iPhone & iPad – Vertrauen, Entsperren, Web-Informationen und WLAN-Kopplung.
• Simulator: Es erscheinen nur gebootete Simulatoren; siehe iOS-Simulator.
• Android: adb devices -l und die Autorisierungsabfrage prüfen; siehe Android.
• Ganzer Abschnitt fehlt: Er ist vielleicht im Menü Darstellung ausgeschaltet.

Gerät da, aber keine Seiten

• Die Seite in Safari oder Chrome auf dem Gerät öffnen; ein leerer Browser bietet nichts zum Untersuchen.
• iOS: Einstellungen › Apps › Safari › Erweitert › Web-Informationen einschalten.
• Eigene App: Ihre WebView muss inspizierbar sein, siehe iOS-WebViews oder Android-WebViews.

Die Seite antwortet nicht

Gerät entsperren und die Seite nach vorn holen. Bleibt der Hinweis, die Web-Informationen aus- und wieder einschalten oder den Tab neu öffnen. In der CLI erscheint das als PAGE_NOT_RESPONDING. Mehr in der iPhone-Anleitung.

Im Simulator antwortet Safari gelegentlich gar nicht mehr auf den Debugger. Dann Safari beenden und die Seite neu öffnen:

xcrun simctl terminate booted com.apple.mobilesafari
xcrun simctl openurl booted https://example.com

Port 9222 ist belegt

Nutzt ein anderes Programm schon Port 9222, weicht Tapscope auf 9223 oder den nächsten freien Port aus und zeigt die Adresse unten in der Seitenleiste. tapscope status gibt sie aus, tapscope cdp nennt die genauen URLs. Richte deine MCP- oder Puppeteer-Konfiguration auf diesen Port aus, oder gib 9222 frei und starte den Hintergrunddienst neu.

Hintergrunddienst

App und CLI teilen sich einen Hintergrunddienst. Scheint etwas zu hängen:

tapscope stop
tapscope status

status startet einen frischen Dienst. Sein Protokoll liegt in ~/.tapscope/daemon.log. Nach einem Update wird ein älterer Dienst von selbst ersetzt.

Freie Sitzungen aufgebraucht

Die App zeigt, wann die nächste freie Sitzung möglich ist, und die CLI meldet SUBSCRIPTION_REQUIRED. Geräte und Seiten auflisten geht weiterhin. Siehe Tarife und Abrechnung.

Hilfe bekommen

Schick die Ausgabe von tapscope doctor und eine kurze Beschreibung an support@tapscope.ch.