DOKUMENTATION / FEHLERBEHEBUNG
iPhone & iPad
Tapscope erreicht Safari und inspizierbare WebViews auf deinem Gerät per USB oder WLAN. Das Gerät muss diesem Mac vertrauen, entsperrt bleiben und den Web-Inspektor eingeschaltet haben.
Gerätedienst nicht erreichbar
Anzeige in Tapscope usbmuxd nicht erreichbar
macOS spricht mit iPhone und iPad über einen Systemdienst namens usbmuxd. Tapscope nutzt denselben Dienst und sieht kein Gerät, solange er nicht läuft.
- Schließe das Gerät per Kabel an und prüfe, ob es in der Finder-Seitenleiste erscheint.
- Starte den Dienst mit dem ersten Befehl unten neu (fragt nach deinem Mac-Passwort) oder starte den Mac neu.
- Führe tapscope doctor aus. Die Zeile zu usbmuxd sollte jetzt melden, dass der Socket vorhanden ist.
sudo launchctl kickstart -k system/com.apple.usbmuxd
tapscope doctorDiesem Mac vertrauen
Anzeige in Tapscope Noch nicht vertraut · Auf dem Gerät „Vertrauen“ tippen
Ein iPhone oder iPad gibt einem Computer nichts frei, dem es nicht vertraut. Das Vertrauen wird einmal pro Mac eingerichtet, immer per Kabel.
- Entsperre das Gerät und schließe es per Kabel an den Mac an.
- Fragt das Gerät „Diesem Computer vertrauen?“, tippe auf „Vertrauen“ und gib den Gerätecode ein.
- Kein Dialog? Wähle das Gerät in der Finder-Seitenleiste aus, dann fragt macOS erneut.
- Tapscope verbindet sich automatisch, sobald das Vertrauen besteht.
Gerät gesperrt
Anzeige in Tapscope Gerät gesperrt
Ein gesperrtes Gerät lehnt neue Debug-Verbindungen ab.
- Entsperre das Gerät mit seinem Code. Tapscope verbindet sich automatisch.
- Für längere Sitzungen stelle Einstellungen › Anzeige & Helligkeit › Automatische Sperre auf „Nie“ und danach wieder zurück.
Kopplung nicht mehr gültig
Anzeige in Tapscope Kopplung nicht mehr gültig
Das Gerät akzeptiert die auf diesem Mac gespeicherte Kopplung nicht mehr, etwa nach einem Zurücksetzen oder nach „Nicht vertrauen“.
- Öffne auf dem Gerät Einstellungen › Allgemein › iPhone übertragen/zurücksetzen › Zurücksetzen › Standort & Datenschutz zurücksetzen. Dabei werden auch die Standort- und Datenschutzfreigaben deiner Apps zurückgesetzt.
- Schließe das Gerät erneut per Kabel an und tippe auf „Vertrauen“.
- Lass das Gerät entsperrt, bis es mit seinen Seiten in Tapscope erscheint.
Keine inspizierbaren Seiten
Anzeige in Tapscope Keine inspizierbaren Seiten
Das Gerät ist verbunden, bietet aber nichts zum Debuggen an. Safari gibt seine Tabs nur bei eingeschaltetem Web-Inspektor frei, Apps nur WebViews, die sie als inspizierbar markieren.
- Schalte Einstellungen › Apps › Safari › Erweitert › Web-Inspektor ein. Bei älteren iOS-Versionen: Einstellungen › Safari › Erweitert.
- Öffne eine Seite in Safari und lass Safari im Vordergrund. Hast du den Web-Inspektor gerade erst eingeschaltet, beende Safari einmal oder starte das Gerät neu.
- Eigene App: Installiere sie aus Xcode und setze isInspectable an der WebView (ab iOS 16.4), wie in der Zeile unten.
- Apps aus dem App Store oder aus TestFlight lassen sich nicht inspizieren; Apple erlaubt das nicht.
webView.isInspectable = trueWeb-Inspektor nicht erreichbar
Anzeige in Tapscope Web-Inspektor nicht erreichbar
Das Gerät ist bekannt, aber sein Web-Inspektor-Dienst hat nicht geantwortet.
- Entsperre das Gerät und lass Safari oder deine App im Vordergrund.
- Zieh das Kabel ab und steck es wieder ein. Per WLAN: Prüfe, ob Mac und Gerät im selben Netz sind.
- Immer noch nichts: Beende Safari auf dem Gerät oder starte das Gerät neu.
- Führe tapscope doctor aus; die Zeile zu deinem Gerät zeigt den letzten Fehler.
tapscope doctorÜber WLAN debuggen
Anzeige in Tapscope Gerät erscheint ohne Kabel
Nach einer einmaligen Einrichtung erreicht Tapscope das Gerät auch über WLAN.
- Schließe das Gerät einmal per Kabel an und vertraue diesem Mac.
- Schalte in Safari auf dem Mac Einstellungen › Erweitert › „Funktionen für Webentwickler anzeigen“ ein.
- Wähle Entwickler › dein Gerät › „Über Netzwerk verbinden“ und zieh danach das Kabel ab.
- Lass Mac und Gerät im selben Netz. Tapscope wechselt selbst zwischen Kabel und WLAN.
Seite antwortet nicht
Anzeige in Tapscope Seite reagiert nicht
iOS pausiert Seiten, die nicht sichtbar sind. Ein Tab im Hintergrund oder ein gesperrter Bildschirm antwortet dem Debugger nicht mehr.
- Entsperre das Gerät und hol den Tab oder die App in den Vordergrund.
- Klicke in Tapscope auf „Erneut verbinden“.
- Damit es nicht wieder passiert, stelle die automatische Sperre beim Debuggen auf „Nie“.
Klappt es immer noch nicht?
Starte die Diagnose im Terminal. Sie prüft jede Verbindung, die Tapscope braucht, und nennt zu jedem Problem den nächsten Schritt.
tapscope doctorSchick uns die Ausgabe, wir helfen weiter: support@tapscope.ch