当我用Ctrl-Cmd-Shift-D在Xcode中构建文档时,它包括我的.docc
目录。当我从命令行运行xcodebuild docbuild
时,它没有。
为什么会这样?是否有可能告诉xcodebuild使用特定的.docc
目录而不仅仅是文档注释?
我正在尝试自动化Swift包的文档构建过程,但如果它需要在Xcode中按一个按钮,我就不能。因为它是一个包,所以我没有项目文件或工作空间可以指向或修改。
是的,可以使用文档目录从命令行构建文档。
对于Swift包,将文档目录与目标相关联的方式是将文档目录与目标的源文件放在同一个文件夹中,如" documentation apps, frameworks, and packages "文档中所述。
注意,要在Swift包中使用文档目录,无论它是在Xcode中还是在xcodebuild
中,包清单的Swift工具版本需要是5.5或更高。
在Xcode中的"Build Documentation"菜单项和xcodebuild docbuild
动作之间不应该有任何区别。您可以通过检查两种情况下的构建日志来确认文档目录是否传递给DocC,以查看传递给docc
可执行文件的参数。