Hopper Debugger
Ziel: Hopper über mcporter als abfragbaren Disassembler nutzen, dann das Ergebnis mit lokalem Quellcode, LLDB, Logs und fokussierten Reproduktionen kombinieren.
Schnellstart
MCP-Server validieren:
MCPORTER_LIST_TIMEOUT=15000 timeout 20 mcporter list hopper --brief
Offene Hopper-Dokumente auflisten:
MCPORTER_CALL_TIMEOUT=20000 timeout 30 mcporter call hopper.list_documents --output json
Falls kein Dokument geöffnet ist, die Binärdatei/das Framework zuerst in Hopper öffnen:
open -a "Hopper Disassembler" /path/to/Binary
Hopper zeigt möglicherweise einen Ersteinrichtungs-/Importdialog. Lassen Sie den Benutzer auf den Bestätigungsbutton klicken und wiederholen Sie dann den MCP-Aufruf. Vermeiden Sie parallele Hopper-MCP-Aufrufe; der Server kann die Verbindung schließen oder Hopper zum Absturz bringen, während der Import noch läuft.
Apple Frameworks
Bevorzugen Sie bereits extrahierte dyld-Cache-Framework-Binärdateien, wenn vorhanden:
/tmp/dsc-appkit/System/Library/Frameworks/AppKit.framework/Versions/C/AppKit
/tmp/dsc-appkit/System/Library/Frameworks/SwiftUI.framework/Versions/A/SwiftUI
Öffnen Sie eine nach der anderen, wenn Sie Probleme an der SwiftUI/AppKit-Grenze debuggen:
open -a "Hopper Disassembler" /tmp/dsc-appkit/System/Library/Frameworks/AppKit.framework/Versions/C/AppKit
mcporter call hopper.list_documents --output json
open -a "Hopper Disassembler" /tmp/dsc-appkit/System/Library/Frameworks/SwiftUI.framework/Versions/A/SwiftUI
mcporter call hopper.list_documents --output json
Zugriff überprüfen:
mcporter call hopper.list_documents --output json
mcporter call hopper.current_document --output json
mcporter call hopper.search_strings pattern=SwiftUI --output json
mcporter call hopper.search_strings pattern=NSStatusItem --output json
Dokumentnamen können mit Untitled beginnen; wiederholen Sie den Vorgang, nachdem Hopper den Import abgeschlossen hat. Verwenden Sie current_document, Symbol-/Zeichenfolgensuchen und Änderungen des Fenstertitels, um AppKit von SwiftUI zu unterscheiden.
Abfrage-Workflow
- Beginnen Sie mit dem lokalen Quellpfad oder dem Laufzeitsymbol, das Sie erklären möchten.
- Suchen Sie nach Namen/Prozeduren/Zeichenfolgen:
mcporter call hopper.search_procedures pattern='NSStatusBar' --output json
mcporter call hopper.search_name pattern='NSStatusBarButtonCell' --output json
mcporter call hopper.search_strings pattern='NSStatusItem' --output json
- Untersuchen Sie ein kleines Ziel nach dem anderen:
mcporter call hopper.procedure_info procedure='<symbol>' --output json
mcporter call hopper.procedure_assembly procedure='<symbol>' --output json
mcporter call hopper.procedure_pseudo_code procedure='<symbol>' --output json
mcporter call hopper.procedure_callers procedure='<symbol>' --output json
mcporter call hopper.procedure_callees procedure='<symbol>' --output json
mcporter call hopper.xrefs address=0x12345678 --output json
- Fassen Sie den relevanten Kontrollfluss zusammen; fügen Sie keine großen Dekompilierungen ein.
- Validieren Sie die Hypothese mit LLDB/Logging/Reproduktion, bevor Sie App-Code ändern.
Status-Item / Menu-Klick-Fehler
Nützliche AppKit/SwiftUI-Suchen:
mcporter call hopper.search_strings pattern='NSStatusItem_Private_ForSwiftUI' --output json
mcporter call hopper.search_procedures pattern='popUpStatusBarMenu' --output json
mcporter call hopper.search_procedures pattern='trackMouse' --output json
mcporter call hopper.search_name pattern='NSStatusBarButtonCell' --output json
mcporter call hopper.search_name pattern='NSStatusItem' --output json
Symbole, die bei nicht funktionierenden Menüleistenklicks zu untersuchen sind:
-[NSStatusBarButtonCell trackMouse:inRect:ofView:untilMouseUp:]-[NSStatusBarButtonCell _sendActionFrom:]-[NSStatusItem popUpStatusBarMenu:]-[NSApplication sendAction:to:from:]- SwiftUI-Status/Menü-Symbole, die auf
NSStatusItem_Private_ForSwiftUIverweisen
Vergleichen Sie die Disassemblierung mit dem Laufzeitzustand:
pgrep -af "App.app/Contents/MacOS/App"
lldb /path/to/debug/Binary
Bei gehärteten signierten Apps kann das Anhängen ohne get-task-allow fehlschlagen; starten Sie das rohe Debug-Binary bei Bedarf unter LLDB.
Fehlerbehandlung
- Umgeben Sie Hopper-Aufrufe mit
timeout; ein modaler Dialog/Import oder ein geschlossenes Dokument kann den Transport hängen lassen. - Senden Sie keine gleichzeitigen Hopper-MCP-Anfragen während des Imports. Wenn eine Abfrage aufwändig ist, warten Sie, bis sie abgeschlossen ist, bevor Sie eine andere starten.
- Wenn Aufrufe
Connection closedmelden, prüfen Sie auf einen Hopper-Dialog, und wiederholen Sie den Vorgang nach der Bestätigung. - Wenn Hopper abstürzt, öffnen Sie ein einzelnes Dokument erneut, warten Sie auf Import/Analyse, und führen Sie
list_documentserneut aus, bevor Sie tiefer gehende Suchen durchführen. - Wenn mcporter festhängt, überprüfen Sie die Prozesse, bevor Sie etwas beenden:
pgrep -af 'mcporter|HopperMCPServer|Hopper Disassembler'
- Bevorzugen Sie den Neustart des mcporter-Daemons gegenüber großflächigen Prozessbeendigungen:
mcporter daemon stop
mcporter daemon start