Сборка наборов документов в Xcode 4 с использованием Doxygen

#xcode4 #doxygen

#xcode4 #doxygen

Вопрос:

Как мне создать наборы документов в Xcode 4 с помощью Doxygen?

Документация Apple ссылается на Xcode 3 и, похоже, не применима к Xcode 4.

Я думаю, что, возможно, придется использовать schemas (схемы?), А не targets, Но я не уверен на 100%.

Заранее спасибо…

Ответ №1:

Вы можете создавать документацию как часть выделенного целевого объекта:

  • В навигаторе проекта щелкните по проекту.
  • На правой панели добавьте новый целевой объект aggregate (в MacOSX / Other) и назовите его Documentation
  • В этом целевом объекте добавьте новую фазу сборки запуска скрипта
  • На этом этапе сборки вызовите командную строку Doxygen:

/Приложения/Doxygen.app/Содержимое/Ресурсы/doxygen

  • Как только набор документов будет собран, скопируйте его в /Users/<YourName>/Library/Developer/Shared/Documentation/DocSets папку.
  • Новый набор документов должен появиться в браузере справки.

Ответ №2:

Кажется, документация для Xcode 3 отлично работает с Xcode 4. Я следовал инструкциям (см. Использование Doxygen для создания наборов документации Xcode в Documentation), и все в порядке, Xcode не загружает совершенно новый набор документов.

Затем я проверил команду AppleScript в данном сценарии запуска и протестировал ее в редакторе AppleScript: результат выполнения был ложным. Ошибка заключалась в том, что имя файла docset отсутствовало.

При добавлении имени файла docset скрипт AppleScript успешно запускается, и набор документов правильно вставляется в документацию :

Перед :

 echo "load documentation set with path "/Users/$USER/Library/Developer/Shared/Documentation/DocSets/""
  

После :

 echo "load documentation set with path "/Users/$USER/Library/Developer/Shared/Documentation/DocSets/com.mycompany.DoxygenExample.docset""
  

Комментарии:

1. Если вы создадите пользовательский параметр сборки APPLICATION_IDENTIFIER и установите для него идентификатор приложения, затем замените com.mycompany. DoxygenExample с ${APPLICATION_IDENTIFIER} вы также получаете гораздо более обобщаемый скрипт. 🙂