appledoc 例外：至少一个目录答案

【问题标题】：appledoc Exception: at least one directoryappledoc 例外：至少一个目录
【发布时间】：2012-03-28 10:50:17
【问题描述】：

在浪费了一些时间弄清楚出了什么问题之后，我终于不得不寻求帮助。我想使用来自 Gentle Bytes 的 appledocs。我按照快速安装指南的每一步操作，但无法编译项目。

这是我所做的： 1. 从 git://github.com/tomaz/appledoc.git 克隆它 2. 将模板安装到 ~/Library/Application Support/appledoc 3.尝试编译项目

每次我尝试编译时，都会出现以下错误： 错误：AppledocException：至少需要一个目录或文件名路径，请使用 'appledoc --help'

我现在该怎么办？

【问题讨论】：

【解决方案1】：

听起来你已经编译好了，现在正在运行程序。如果它是命令行程序，请尝试在 Xcode 中使用 command-option-R 来提供一些参数（即您要处理的文件的名称）。

【讨论】：

好的，当我构建项目时，它说我的帖子中显示了错误。当我使用参数“--help”时，我会在控制台窗口中看到帮助。但是当我切换到终端时，它说没有找到命令。我对此真的很陌生，我什至不明白这是怎么回事......
在终端中找不到命令，因为该程序不在您的 $PATH 中。您可以将包含您的程序的目录添加到您的 $PATH，或者将程序移动到您的 $PATH 中位于的位置，或者使用其完整路径名指定程序。换句话说，您的问题不在于构建程序，而在于有效地使用您的 shell。
这解释了为什么它使用参数。所以我必须更多地了解shell。非常感谢！
查看项目中的 Products 文件夹以找到构建的程序。按住 Control 键单击该程序并选择“在 Finder 中显示”。打开终端窗口并在提示符下键入“mv”（不返回）。将您的程序拖到终端窗口中，以便它的完整路径出现在命令行上。例如，使用“/usr/local/bin”将您的程序移动到 /usr/local/bin，这可能在您的 PATH 中。按回车。现在你应该可以在命令行运行程序了。如果没有，请尝试 echo $PATH 显示您的 PATH，并确保它包含 /usr/local/bin。
这很好奇：我已经完成了link 上提供的所有步骤，但没有任何帮助。我已将构建移至我的 $PATH ，但它不起作用。在终端它总是说：找不到命令。这里出了点问题。

【解决方案2】：

错误意味着你没有给它源路径：在所有切换之后，你必须给它至少一个源文件的路径。可以是文件或目录。在以后的情况下，它将递归扫描目录。这是一个例子

appledoc <options> ~/MyProject

以上示例将使用 ~/MyProject 目录作为源。您还可以添加多个源路径。请注意，您需要为该工具提供一些选项，请参阅this page 了解最小命令行和其他使用示例。

您必须按照 Caleb 的建议将 appledoc 可执行文件复制到路径中的目录之一，或者在调用时使用完整路径（例如：/path/to/appledoc）

【讨论】：

感谢您的回复！问题不是它不会编译，问题是我不能使用输出文件。我已经将输出文件移动到我的 $PATH 中，但无论我在终端中给 appledoc 文件提供哪个参数，它都不会工作。它总是说：找不到命令
我的一个小错误，还有一些需要学习的东西：我将可执行文件移动到 ur/local/bin - 我想。它被移动但重命名为“bin”。所以感谢所有的帮助，我必须学习很多关于 Unix 和 shell 等的知识！