Appledoc 无法在 Xcode 中运行答案

【问题标题】：Appledoc can't run in XcodeAppledoc 无法在 Xcode 中运行
【发布时间】：2014-12-02 21:39:51
【问题描述】：

所以我正在关注本教程的 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 \

【问题讨论】：

标签： ios xcode bash shell appledoc

【解决方案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

【讨论】：