Xcode и XIB самостоятельная документация

Question

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

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

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

Благодарю.

Answer 1

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

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

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