0

因此，我正在关注本教程的 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 \
4

1 回答 1

2

OSX 上的默认路径是/usr/bin:/bin:/usr/sbin:/sbin，如果您按照说明操作，您会将其复制到/usr/local/bin.

XCode 不会考虑您对.bash_profile文件等进行的更改，因此从它启动的任何内容都没有路径（这包括您发布的运行脚本）。

您可以PATH=$PATH:/usr/local/bin在该行之前添加该APPLEDOC_PATH=...行，这应该可以找到它。

其次，您需要进行适当的测试：

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
于 2014-12-03T00:08:08.283 回答