Sandcastle ResolveReferenceLinksComponent警告

Question

我想通过sandcastle创建一个文档。 因此，我需要引用不应记录的DevExpress。

我在项目的引用和DevExpress资源文件夹下添加了DevExpress dll。

我尝试了几种不同的设置，但无法解决。

现在Sandcastle多次显示此警告：

BuildAssembler : warning : ResolveReferenceLinksComponent: [T:test.DEVEXPRESS] Unknown reference link target 'P:DevExpress.XtraEditors.BaseStyleControl.Appearance'. [G:\test\test\test\Testing\Working\BuildReferenceTopics.proj]

我该如何解决这个问题？

Answer 1

我现在已经面临同样的问题一段时间了，而我正在研究它。

Sandcastle构建包含可点击引用链接的文档。但有些参考文献可能无法解决，因为 它们来自外部程序集（依赖项）。这将在构建输出中引发警告。如果你对它没问题，那就忽略它，因为没有任何伤害。但是，如果您有强迫症（如我），请按照以下说明禁止警告。

说明

1. 创建一个虚拟Sandcastle项目。
   • 它不需要包含在解决方案中，但我发现它在设置过程中很有用。
2. 禁止构建项目。 （建议因为构建可能会失败。）
3. 将 ResolveReferenceLinksComponent 警告中提到的程序集添加到文档源。
4. 尝试构建它。它可能会因“未解决的程序集”错误而失败。 （也许是依赖关系的依赖。）
5. 如果未在项目中直接引用“未解析的程序集”，则可以使用程序集绑定重定向插件忽略它。
   • 否则也将所需的引用程序集添加到文档源。
   • 您还可以将其添加到项目参考。
6. 使用其他参考链接插件将虚拟Sandcastle项目添加到主文档项目中。
   • 确保配置插件，以便将所有链接类型设置为无。

注意：更新依赖项时，虚拟Sandcastle项目的文档源和引用也需要 要被更新。 [TODO]：找到一种自动化的方法。的NuGet？

注意： Sandcastle会对虚拟项目进行部分构建，以收集类型信息（通过反射）。虚拟项目 没有必要成功构建，但它必须通过 TransformReflectionInfo 阶段才能使插件工作。

参考

• GitHub Issue #67
• Documentation Q&A
• Additional Reference Links Plug-In
• Assembly Binding Redirection Plug-In

IMO这不是我希望的解决方案，因为它不必要地增加了另一个项目，但是因为我有很多警告他们正在掩盖真正的问题。我想这更好的是两个邪恶。