微软开发部门组长 Anand Raman 就 Sandcastle 项目的当前状态发布了一个更新说明,以此对该项目将要终止的传言进行辟谣。Sandcastle 是一个通过.NET 项目源码生成类似于 MSDN 文档的工具。
6 个月前 Sandcastle 的源码发布在 CodePlex 上,这是为了满足大家的需要,因为该项目最初发布时并不带源码。之后,Anand 说到团队正在引入 VS 2008 SP1 的 MSDN Library。当前,其计划是到 1 月底发布一系列的修复。
我并没有为该项目提供 SLN 文件。你可以创建自己的,但如果在源代码中提供一个那就太方便了。
对于之前的源码所创建的 SLN 文件,当进行构建时用户遇到了如下问题:
- 每个项目都有 TFS 源码控制信息,而这对于团队外的人来说是无效的。在发布的源码中要删除这些信息。
- 大多数项目都会指定一个包中不存在的强名字键文件(strong name key file)。项目文件应该禁用签名或是提供一个虚拟的 key.snk。
- MoreComponents 项目构建失败,报告的错误为:“Microsoft.Ddue.Tools.BuildComponent’ does not contain a constructor that takes ‘1’ arguments”。 在我看来这并不是一个重要的项目,压根就不应该包含进来。
- MrefBuilderStatic 项目构建失败,报告的错误为:“The type or namespace name ‘RootFilter’ could not be found (are you missing a using directive or an assembly reference?)” 。该项目将被移除。
- BuildAssemblerConsole 以错误的路径引用了 CommandLine 项目。
- BuildAssembler 和 BuildAssemblerConsole 项目有些重复而且 BuildAssemblerConsole 构建失败。
在卸载了有问题的项目后,用户可以成功构建了。遗憾的是,构建过程出现了 115 个警告。我们应该修复这些警告。
有很多的代码分析(FxCop)警告。我们应该从发布的源码中消除这些警告,以此树立一个好榜样。
有很多文件隶属于 NT 构建系统,我们应该将其从源码中排除掉(makefile、makefile.inc、placefile 等等)。
Anand 说在 VS 2010 Beta 1 发布后,团队将把精力集中到新的特性集和修复上:
配合.NET Framework 4.0 的版本号 2. 支持 F#语法
XSD 文档
支持 Microsoft Help 3 viewer 的属性。
Sandcastle 基于 Microsoft Public License (Ms-PL) 。
查看英文原文: Sandcastle’s Team Manager Dismisses Rumors About Project Termination
评论