Voraussetzungen
- macOS 15 oder neuer.
- iPhone oder iPad: beim ersten Mal ein Kabel, damit das Gerät dem Mac vertraut. Nach der Kopplung geht es auch per WLAN.
- iOS-Simulator: Xcode mit den Command Line Tools (
xcrun simctl helpmuss funktionieren). - Android: die Android Platform Tools (
adb). Tapscope findet adb imPATH, in$ANDROID_HOME/platform-toolsoder in~/Library/Android/sdk/platform-tools. - Chrome DevTools MCP oder Puppeteer: Node.js. Tapscope selbst braucht es nicht.
App installieren
Tapscope.dmgladen.- Das Disk-Image öffnen und Tapscope in den Ordner Programme ziehen.
- Tapscope starten. Die App startet ihren Hintergrunddienst und zeigt in der Seitenleiste angeschlossene iPhones und iPads, gebootete Simulatoren und Android-Geräte.
Die Abschnitte der Seitenleiste lassen sich im Menü Darstellung ein- und ausschalten: iOS-Geräte, Simulatoren, Android-Geräte und Netzwerk-Targets aktivieren.
Kommandozeilenwerkzeug installieren
Der Befehl tapscope steckt in der App. Damit Terminal und Coding Agents ihn finden, legst du einen Link in deinen PATH: in Tapscope Einstellungen › Allgemein › Kommandozeilenwerkzeug installieren, oder einmal direkt aus dem App-Paket:
/Applications/Tapscope.app/Contents/Helpers/tapscope install-cliDer Link landet in /usr/local/bin, wenn der Ordner beschreibbar ist, sonst in ~/.local/bin. Mit --dir <Ordner> wählst du einen anderen Ort. Danach die Installation prüfen:
tapscope version
tapscope doctortapscope doctor prüft Daemon, CDP-Port, DevTools-Frontend, Netzwerk-Targets, Xcode und simctl, adb, den iOS-Gerätedienst und jedes verbundene Gerät und nennt für jedes Problem den nächsten Schritt.
Geräte vorbereiten
- iPhone & iPad: dem Mac vertrauen und Web-Informationen einschalten.
- iOS-Simulator: einen Simulator booten und Safari öffnen.
- Android: USB-Debugging einschalten und den Mac zulassen.
- WebViews deiner App: inspizierbar machen.
- Chrome, Node.js, Electron: mit Debug-Port starten.
Dateien und Hintergrunddienst
Einstellungen und Zustand liegen in ~/.tapscope/:
| Datei | Inhalt |
|---|---|
config.json | Einstellungen: Plattformen an oder aus, adb-Pfad, Netzwerk-Targets, CDP-Port |
daemon.json | Port und Zugangstoken der lokalen Steuerschnittstelle, nur für dich lesbar |
daemon.log | Protokoll des Hintergrunddienstes |
license/ | Lizenz und Nutzungszähler des Free-Tarifs |
screenshots/ | Standardordner von tapscope screenshot |
Der Hintergrunddienst startet mit der App oder dem ersten CLI-Befehl und läuft weiter, wenn du die App beendest, damit Agenten weiterarbeiten können. tapscope stop beendet ihn; nach einem Update ersetzt sich ein älterer Dienst von selbst.
Deinstallieren
tapscope stopausführen.- Tapscope aus Programme löschen, dazu den Link
tapscope(/usr/local/bin/tapscopeoder~/.local/bin/tapscope). ~/.tapscope/löschen, wenn auch Einstellungen und Protokolle weg sollen. Eine bezahlte Lizenz vorher mittapscope logoutfreigeben, wenn du sie auf einem anderen Mac nutzen willst.