Quick Help для своего кода в XCode 5

[risik]

Да наконец-то!

Сам лично перешел на AppCode для работы с кодом. Она такое поддерживала еще, как минимум год назад.

Надо сказать, что вообще, Apple в Xcode5 сделала много правильных шагов. Например, XIBы стали гораздо проще, прозрачнее и понятнее. Теперь задача мержа двух XIBов из разных веток видится уже более или менее реальной.

И тот факт, что в Xcode5 появилась поддержка режима CI сервера для Apple является огромным шагом вдогонку современным технологиям. Я для CI использую Jenkins + скрипты и xcode plugin в для прогона тестов. Но этот плагин меня не полностью устраивает.

[corristo]

А не подскажете, какой формат документации наиболее «правильный» для AppCode? А то с JavaDoc-подобным иногда косяки бывают.

[risik]

Что-то похожее на JavaDoc (но не полный, например, не работает return). Думаю, что теперь, поскольку этот функционал заработал в Xcode, JetBrains приведет его в соответствие с вариантом от Apple.

[corristo]

Вот да, с return и проблемы как раз. Спасибо за ответ!

[Agent_Smith]

CI в Xcode5 мягко говоря, очень убог и абсолютно не кастомизируем.

[risik]

Ну я, надеюсь, что это у них только первый шаг. Впрочем, меня сейчас почти полность устраивает Jenkins.

[dimakey]

> Я для CI использую Jenkins + скрипты и xcode plugin в для прогона тестов.

А тесты для OS X или iOS? Так и не нашел варианта для запуска тестов iOS — все портит необходимость запускать сперва симулятор, а потом в нем запускать приложение.

[risik]

Модульные тесты для iOS. Вообще прогнать модульные тесты на симуляторе проблем нет. xcode-build все умеет. Лично для меня плагин нужен только для того, чтобы распарсить полученный выхлоп в формат, понятный Jenkins'у.

[corristo]

у xctool вывод поприятнее будет :)

[1101_debian]

Вот эта вещь может вам пригодиться.

[dimakey]

Благодарю.

[gribozavr]

Также можно включить флаг -Wdocumentation и будет проверяться соответствие комментария объявлению, насколько это возможно автоматически. Например, будет выдаваться предупреждение при @param для несуществующего параметра функции.

[TimReset]

А как раньше код документировался в XCode? Были какие-то стандарты? Я, собственно, почему спрашиваю — в Java есть JavaDoc, который идёт «из коробки». А тут получается ничего подобного не было?

[Stam]

HeaderDoc: developer.apple.com/library/mac/documentation/DeveloperTools/Conceptual/HeaderDoc/intro/intro.html

[skeeet]

А разве информация о XCode 5 пока не под NDA?

[Yan169]

Информация о том, что Quick Help теперь поддерживает документирующие комментарии, доступна на открытой странице developer.apple.com/technologies/tools/features.html:

Quick Help
Displays shortened API documentation while your are programming, including comments that you write for your own code.

[skeeet]

Вот оно как.
Извиняюсь, не знал.

[gavrix]

Стоит так же упомянуть о замечательном плагине упрощающем писать такую документацию github.com/onevcat/VVDocumenter-Xcode

[backmeupplz]

Недавно как-раз на эту тему задавал хабра-вопрос :)

[SegaZero]

Совсем недавно смотрел видео с последней WWDC и видел отсылку к Doxygen. (Xcode Core Concepts, 29:50), так что скорее всего его и юзают

[corristo]

У Clang какой-то свой парсер документации AFAIK