8

我正在使用 Sandcastle Help File Builder 构建 VS 2010 C# 项目的文档。我已将.xml编译器生成的文档和项目的 Visual Studio 解决方案.sln文件添加到Documentation Sources。我还将项目的可执行文件添加.exeReferences。但是,它不是在构建。我收到这些警告和错误:

SHFB:警告 BE0006:无法找到“C:\Users\user\Music\Documents\Visual Studio 2010\Projects\SFML_Platformer\SFML_Platformer.sln”的任何文档源(配置:调试平台:AnyCPU)

SHFB:错误 BE0042:您必须以程序集或 Visual Studio 解决方案/项目文件的形式指定至少一个文档源

有什么问题?

4

4 回答 4

8

您应该只将 XML 文档文件添加为文档源。添加 XML 文件后会自动添加 DLL。

于 2012-08-05T14:57:09.337 回答
2

这里是 Sandcastle Help File Builder 的开发者 Eric aka EWoodruff 的回答。

BE0006 表示找不到基于项目的文档源。BE0042 是次要结果,这意味着它根本没有发现任何可记录的内容。解决方案中有哪些类型的项目?如果它是一个网站项目,请记住,它们通常不会生成在项目中列为输出的任何程序集,也不会生成任何 XML 注释文件。在这种情况下,您需要将 Web 代码提供程序添加到您的项目中以获取 XML 注释并手动添加网站的 .\bin 文件夹作为 SHFB 项目中的文档源。如果是这种情况,在入门部分中有一个关于记录网站的主题。

所有其他项目类型都应该工作。如果一切都失败了,请尝试直接添加程序集和 XML 注释文件。我想 Express 版本可能使用不同的项目类型 ID。如果您可以将解决方案文件和项目文件发送给我,我可以查看它们,看看为什么它没有找到目标。我的电子邮件地址位于独立 GUI 的“关于”框中和帮助文件页面的页脚中。

另一件事是,确保在 SHFB 工具栏中选择的配置和平台设置与用于构建项目的配置和平台设置相匹配(即 Debug/AnyCPU、Release/AnyCPU、Debug/x86 等)。如果没有,那将导致它找不到正确的输出目标。

埃里克

来源

于 2012-12-20T02:21:25.077 回答
0

当我将主应用程序上 VS.NET 中的项目构建DebugRelease. 我认为它再也找不到我指定的用于创建文档的 .dll。我本可以修复映射,但回去Debug工作对我来说很好,可以消除这个错误。

于 2013-08-26T19:16:54.057 回答
0

在 Sandcastle 中运行 Build 之前,不要忘记在清理后重建您的解决方案。

于 2016-03-30T14:27:43.783 回答