ios - 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