autocodice Xcode e XIB

Question

Esiste uno strumento per documentare i numerosi binding Xcode, le prese e le associazioni IBAction, i collegamenti dei valori chiave, ecc.? Ho esaminato i thread su Doxygen e HeaderDoc, ma questi file di programma di documenti, per descrivere classi ecc., Ma non sembrano coprire l'enorme numero di collegamenti "nascosti" che il trascinamento della selezione Xcode abilita?

Un esempio specifico, posso utilizzare l'editor XIB per creare un IBAction per ogni controllo sulla mia finestra, ai metodi in una o più classi/istanze, definiti in uno o più file - Voglio UN elenco di tutti questi , mostrando il tipo e il nome del controllo, il file sorgente, la classe e il metodo - o una rappresentazione grafica sarebbe ancora meglio. Quindi un elenco simile per il percorso del valore chiave collega a arrayControllers, ecc.

Sono nuovo, quindi se mi è sfuggito qualcosa di ovvio, per favore dimmi.

Grazie.

Answer 1

No, non esiste uno strumento per documentare i file .xib a meno che non si consideri il file stesso come parte della documentazione. (Dopo tutto hai detto "autodocumentazione"). I file .xib sono archiviati come XML, quindi, se vuoi davvero estrarre i dati, è lì per essere fatto.

Le azioni create in IB compaiono nel codice sorgente. È possibile aggiungere commenti che descrivono l'oggetto che invia l'azione, ma che in gran parte mancherebbe il punto di utilizzare un .xib (e azioni) in primo luogo, che è quello di disaccoppiare gli elementi dell'interfaccia utente dal controller.

Se il punto della documentazione è quello di rendere più semplice la comprensione del progetto da parte di altri sviluppatori, potrebbe essere necessario acquisire maggiore esperienza con Objective-C prima di passare a un sacco di problemi nella creazione di uno strumento di documentazione .xib. Dato un file .xib e i relativi file di intestazione, qualsiasi programmatore Obj-C competente dovrebbe essere in grado di dire facilmente quali controlli sono collegati a quali azioni, o di eseguire il debug di problemi in quell'area. Le persone hanno lavorato con file .xib e .nib per oltre 20 anni: la mancanza di uno strumento di documentazione separato potrebbe essere una buona indicazione che una cosa del genere potrebbe non essere così utile come sembra all'inizio.