Документация по Xcode и XIB

Есть ли инструмент для документирования множества привязок Xcode, выходов и IBAction привязок, привязок значений ключей и т.д.? Я посмотрел на темы на Doxygen и HeaderDoc, но эти файлы программ документов, чтобы описать классы и т.д., но, похоже, не покрывают огромное количество "скрытых" связей, которые позволяет перетаскивать Xcode?

В конкретном примере я могу использовать редактор XIB для создания IBAction для каждого элемента управления в моем окне, для методов в одном или нескольких классах/экземплярах, определенных в одном или нескольких файлах. Я хочу ОДИН список всех они, показывая тип и имя элемента управления, исходный файл, класс и метод, или графическое представление будет еще лучше. Затем аналогичный список для ключевого пути значения ссылается на arrayControllers и т.д.

Я ЕСМЬ новый, поэтому, если я пропустил что-то очевидное, скажите, пожалуйста.

Спасибо.

Ответ 1

Нет, нет инструмента для документирования файлов .xib, если вы не рассматриваете сам файл как часть вашей документации. (В конце концов, вы действительно сказали "самодокументирование".).xibs хранятся как XML, однако, если вы действительно хотите извлечь данные, они там должны быть.

Действия, которые вы создаете в IB, отображаются в исходном коде. Вы могли бы добавлять комментарии там, описывающие объект, который отправляет действие, но это в значительной степени пропустило бы пункт использования .xib(и действий) в первую очередь, что должно отделить элементы пользовательского интерфейса от контроллера.

Если точка документации позволит сделать ваш проект более понятным для других разработчиков, вам может понадобиться получить больше опыта работы с Objective-C, прежде чем вы столкнетесь с множеством проблем с созданием инструмента для документирования .xib. Учитывая .xib и соответствующие файлы заголовков, любой компетентный программист Obj-C должен быть в состоянии легко сказать, какие элементы управления подключены к каким действиям, или для отладки проблем в этой области. Люди работают с файлами .xib и .nib в течение более 20 лет - отсутствие отдельного инструмента документации может быть хорошим показателем того, что такая вещь может быть не так полезна, как кажется сначала.