Sandcastle 团队经理辟谣项目终止传言

  • Abel Avram
  • 张龙

2009 年 1 月 23 日

话题:.NET开源DevOps语言 & 开发架构文化 & 方法

微软开发部门组长 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 发布后,团队将把精力集中到新的特性集和修复上:

1. 配合.NET Framework 4.0 的版本号

2. 支持 F# 语法

3. XSD 文档

4. 支持 Microsoft Help 3 viewer 的属性。

Sandcastle 基于Microsoft Public License (Ms-PL)

查看英文原文:Sandcastle’s Team Manager Dismisses Rumors About Project Termination

.NET开源DevOps语言 & 开发架构文化 & 方法