Appledoc無法在Xcode中運行

Question

因此，我正在按照本教程進行appledoc生成（ http://objcsharp.wordpress.com/2013/09/24/how-to-generate-beautiful-apple-style-documentation-in-xcode-5/ ）。 構建后沒有任何反應。 這是腳本：

#if [ ${CONFIGURATION} == "Release" ]; then
APPLEDOC_PATH=`which appledoc`
if [ $APPLEDOC_PATH ]; then
$APPLEDOC_PATH \
--project-name ${PRODUCT_NAME} \
--project-company "Your Name" \
--company-id "com.yourcompany" \
--output ${PRODUCT_NAME}Docs \
--keep-undocumented-objects \
--keep-undocumented-members \
--keep-intermediate-files \
--no-repeat-first-par \
--no-warn-invalid-crossref \
--exit-threshold 2 \
${PROJECT_DIR}/${PRODUCT_NAME}
fi;
#fi; 

為了確保我正確安裝了appledoc，我在終端上進行了以下操作，文檔顯示正常。

appledoc --project-name BabelCPP --project-company "My Name" --company-id com.mycompany --no-create-docset --output ./doc/ ./CaterpillarCount/CaterpillarCount

我是否缺少Xcode中的任何關鍵步驟或設置？ 似乎以下部分未正確執行，這是終止此運行腳本的原因：

APPLEDOC_PATH=`which appledoc`
if [ $APPLEDOC_PATH ]; then
$APPLEDOC_PATH \

Answer 1

OSX上的默認路徑是/usr/bin:/bin:/usr/sbin:/sbin ，如果按照說明進行操作，則應將其復制到/usr/local/bin 。

XCode不會考慮您對.bash_profile文件等所做的更改，因此從它啟動的任何內容都不會具有路徑（這包括您發布的運行腳本）。

您可以在APPLEDOC_PATH=...行之前的行上添加PATH=$PATH:/usr/local/bin ，這將允許找到它。

其次，您需要進行適當的測試：

if [ -n "$APPLEDOC_PATH" -a -x "$APPLEDOC_PATH" ]; then

即測試是否設置了變量，並確定文件是否可執行。

因此，總共：

PATH=$PATH:/usr/local/bin
APPLEDOC_PATH=`which appledoc`
if [ -n "$APPLEDOC_PATH" -a -x "$APPLEDOC_PATH" ]; then