Скриптинг документации Xcode с проблемами DOxygen - PullRequest
Новая
       7

Скриптинг документации Xcode с проблемами DOxygen

1 голос
/ 10 августа 2010

Я пытаюсь использовать следующий скрипт, используя утку (http://www.duckrowing.com/2010/03/18/documenting-objective-c-with-doxygen-part-ii/), для документирования существующего проекта xcode. 

 #
# Build the doxygen documentation for the project and load the docset into Xcode 
#
# Created by Fred McCann on 03/16/2010.
# http://www.duckrowing.com
#
# Based on the build script provided by Apple:
# http://developer.apple.com/tools/creatingdocsetswithdoxygen.html
#
# Set the variable $COMPANY_RDOMAIN_PREFIX equal to the reverse domain name of your comany
# Example: com.duckrowing
#

DOXYGEN_PATH=/Applications/Doxygen.app/Contents/Resources/doxygen
DOCSET_PATH=$SOURCE_ROOT/build/$PRODUCT_NAME.docset

if ! [ -f $SOURCE_ROOT/Doxyfile] 
then 
  echo doxygen config file does not exist
  $DOXYGEN_PATH -g $SOURCE_ROOT/Doxyfile
fi

#  Append the proper input/output directories and docset info to the config file.
#  This works even though values are assigned higher up in the file. Easier than sed.

cp $SOURCE_ROOT/Doxyfile $TEMP_DIR/Doxyfile

echo "INPUT = $SOURCE_ROOT" >> $TEMP_DIR/Doxyfile
echo "OUTPUT_DIRECTORY = $DOCSET_PATH" >> $TEMP_DIR/Doxyfile
echo "RECURSIVE = YES" >> $TEMP_DIR/Doxyfile
echo "EXTRACT_ALL        = YES" >> $TEMP_DIR/Doxyfile
echo "JAVADOC_AUTOBRIEF        = YES" >> $TEMP_DIR/Doxyfile
echo "GENERATE_LATEX        = NO" >> $TEMP_DIR/Doxyfile
echo "GENERATE_DOCSET        = YES" >> $TEMP_DIR/Doxyfile
echo "DOCSET_FEEDNAME = $PRODUCT_NAME Documentation" >> $TEMP_DIR/Doxyfile
echo "DOCSET_BUNDLE_ID       = $COMPANY_RDOMAIN_PREFIX.$PRODUCT_NAME" >> $TEMP_DIR/Doxyfile

#  Run doxygen on the updated config file.
#  Note: doxygen creates a Makefile that does most of the heavy lifting.

$DOXYGEN_PATH $TEMP_DIR/Doxyfile

#  make will invoke docsetutil. Take a look at the Makefile to see how this is done.

make -C $DOCSET_PATH/html install

#  Construct a temporary applescript file to tell Xcode to load a docset.

rm -f $TEMP_DIR/loadDocSet.scpt

echo "tell application \"Xcode\"" >> $TEMP_DIR/loadDocSet.scpt
echo "load documentation set with path \"/Users/$USER/Library/Developer/Shared/Documentation/DocSets/$COMPANY_RDOMAIN_PREFIX.$PRODUCT_NAME.docset\"" >> $TEMP_DIR/loadDocSet.scpt
echo "end tell" >> $TEMP_DIR/loadDocSet.scpt

#  Run the load-docset applescript command.
osascript $TEMP_DIR/loadDocSet.scpt

exit 0

Однако я получаю эти ошибки 

Osascript:/Users/[username]/SVN/trunk/Examples: No such file or directory

Ранее в выводе скрипта (в окне xcode после сборки) я вижу такие сообщения: 

Configuration file '/Users/[username]/SVN/trunk/Examples' created

проблема, я думаю, в том, что полный путь на самом деле 

'/Users/[username]/SVN/trunk/Examples using SDK'

Я работал, предполагая, что пробелы были виновником. Поэтому я попробовал два подхода: 

$SOURCE_ROOT = "/Users/[username]/SVN/trunk/Examples using SDK"
$SOURCE_ROOT = /Users/[username]/SVN/trunk/Examples\ using\ SDK
set $SOURCE_ROOT to quoted form of POSIX path of /Users/$USER/SVN/trunk/Examples\ using\ SDK/

но все выдают ту же ошибку Osascript, что и выше. Кроме того, docset не встроен в запрошенный каталог 

/Users/$USER/Library/Developer/Shared/Documentation/DocSets/$COMPANY_RDOMAIN_PREFIX.$PRODUCT_NAME.docset\

Я почесал голову над этим некоторое время, но не могу понять, в чем проблема. Одна из гипотез состоит в том, что я запускаю Doxygen для проекта, который не является новым. Для обработки этого EXTRACT_ALL установлено значение YES (которое должно удалить все предупреждающие сообщения, но я также получаю 19 предупреждений).

Любая помощь будет высоко ценится

спасибо

Пеймана

Ответы [ 2 ]

1 голос
/ 10 августа 2010

Я предлагаю вам ставить двойные кавычки "$SOURCE_ROOT" везде, где вы используете его в скрипте оболочки.

0 голосов
/ 10 августа 2010

Mouviciel .... я понял это ... нужно поместить всю переменную в скобки, т.е. $ (SOURCE_ROOT).

спасибо за вашу помощь

...