Swift in Maguyva: Code-Graphen für iOS und macOS

Warum Swift mehr braucht als eine Dateisuche

Swift verteilt einen Typ auf viele Stellen. Ein Struct wird in einer Datei deklariert, erhält Verhalten aus Extensions in drei anderen und entspricht Protokollen, die in einem Paket definiert sind. Zustandsänderungen verstecken sich in berechneten Properties und willSet / didSet-Observern. Ein Agent, der eine Datei nach der anderen liest, übersieht das meiste davon.

Maguyva indexiert die Struktur, sodass ein Agent die Member, Protokollkonformitäten und Aufrufer eines Typs zusammen sehen kann.

Was Maguyva in Swift extrahiert

Maguyva deckt .swift ab. Zu den aufrufbaren Symbolen gehören Funktionen, init und deinit, Subscripts, Getter und Setter berechneter Properties sowie willSet / didSet-Observer. Zustandsändernder Code ist damit als Symbol durchsuchbar, statt in Property-Rümpfen zu verschwinden.

Member, die in Structs, Enums, Protokollen und Extensions deklariert sind, werden mit ihrem besitzenden Typ qualifiziert (zum Beispiel CartStore.add), und in einer Extension hinzugefügte Member werden dem erweiterten Typ zugeordnet. Bei Definitionsnamen werden generische Parameter, Listen der Protokollkonformität und die Suffixe ? / ! entfernt, sodass Abfragen den schlichten Namen verwenden. Aufrufe behalten self. und die Klassenqualifizierung, und Trailing Closures zählen zur Aufrufarität.

Der Graph erfasst Aufrufe, Protokollkonformität, Vererbung, Overrides, Instanziierung, Attribute, Typreferenzen, Lese- und Schreibzugriffe sowie throw-Kanten.

Beispiel-Prompts für Agenten

• „Welche Typen entsprechen PaymentProvider, und wo wird jeder davon erzeugt?“ (dependency_search)
• „Wer ruft CartStore.add auf, und aus welchen Views?“ (find_symbol, dann dependency_search incoming)
• „Erkläre, wie eine Push-Benachrichtigung den Posteingang-Bildschirm erreicht.“ (get_task_context)

Bekannte Grenzen

• Nur .swift-Quelltext ist zugeordnet. Storyboard- und XIB-Dateien stehen nicht in der Liste der Dateiendungen, daher liegen Interface-Builder-Verbindungen außerhalb des Graphen.
• Aufrufe der Standardbibliothek und von Foundation wie print, debugPrint, NSLog und Assertions werden aus den Beziehungen gefiltert und sind daher keine Graphkanten. Verwende dafür text_pattern_search.

Nächste Schritte

Verbinde ein Repository über den Schnellstart und prüfe dann die Unterstützungsmatrix auf der Kompatibilitätsseite. Wenn du dasselbe Produkt auch für Android auslieferst, lies den Kotlin-Leitfaden.