这里的一系列文章，会给大家介绍ABD（最新名称叫做OBD） SDK相关的使用方法。由浅入深，逐步掌握开发ABD应用的方法。大家注意，这一系列的文章，假设大家已经有MicroStation相应的开发基础，如果不熟悉相关的内容，请参考：

• 一步步学习MicroStation CE Addin开发
• 一步步学习MicroStation CE MDL开发

ABD是Bentley公司的旗舰产品:AECOsim Building Designer的简称（OBD是OpenBuilding Designer的简称）。这里介绍的SDK是在ABD CONNECT版本中，重新开发的供开发人员使用的编程接口。主要提供了关于建筑行业解决方案相关的基础功能，例如几何，工程数据等接口函数。SDK还包含了接口函数的说明文档，以及接口函数使用的例子。

开发环境

ABD是一款运行在Windows下的软件。开发工具主要是微软的Visual Studio系列软件。而SDK本身是和对应的ABD版本一同编译的，因此他们使用同一个版本的Visual Studio作为开发环境。具体可以参看SDK的发行说明文档。目前ABD CE update3 使用的是Visual Studio 2015（OBD-Update8需要使用VS2017）。针对不同的用户开发流程，SDK提供了一个Bentley风格的开发环境，作为参考。用户可以根据这个环境的设置，修改并完善自己的开发环境和流程。

开发流程

ABD是一款支持丰富的工程信息建模功能的软件，并且具备非常强的可定制性。在ABD上面开发扩展应用，首先要了解ABD本身的功能，如果能够通过定制化解决用户的需求，就可以省去编写代码的步骤。因此在开发应用的时候，需求分析阶段要针对现有的功能做出详尽的分析，找出可以定制化的部分和需要编写代码的部分，然后再进一步进行详细的设计和开发。

在进行软件的详细设计的时候，首先要考虑ABD提供的建筑构件和工程信息是否足够，如果不够，需要增加新的构件，比如新类型的门，窗等部件。如果需求中需要给构件增加新的工程信息，那么就需要定制化新的DataGroup。这一步并不需要编写代码和使用ABD SDK。主要是要对ABD软件本身和要开发的软件的需求分析详细，合理。

在明确了工程属性，构件等需求的定制之后，就是涉及到代码的架构设计和编写部分了。针对ABD的应用的开发，首先界面部分是使用MicroStation SDK提供相应的接口。ABD SDK主要是提供和ABD本身有关的接口。其次是命令设计，针对需求，提炼出合理的功能模块，每个小模块可以在一个命令中实现。这些命令可以在用户界面中重复使用，便于组织合理的操作流程。最后是针对具体的功能，使用ABD SDK提供的接口进行实现。

本教程会先从一个简单的例子开始，介绍怎么使用ABD SDK中的功能来创建一个简单的命令，之后会分别介绍最重要的几个接口函数类别。每个类别的介绍，都会有一个简单的例子来给大家演示最基本的工作流程。更加详细的和其他函数的使用，可以参考ABD SDK提供的文档。

开发语言

ABD软件本身使用了 C/C++、C#等语言进行开发的。ABD SDK也提供了C/C++和C#(支持其他基于.NET的语言)两种开发接口。由于ABD SDK同时需要MicroStation SDK的支持，因此在选择编程语言时也要考虑所需要的功能，如果在C#中没有提供，那么就需要使用C/C++来编写，再和C#混合使用。如果您的软件设计是基于命令的模式，那么每个命令可以使用任何的语言，这样就会提供非常灵活的设计。

安装目录介绍

• ABDSDK ABD SDK所在的目录，包括了头文件，链接库文件，文档等。
• bin MciroStation SDK使用的二进制文件。
• doc MciroStation SDK提供的CHM文档。
• Documentation MciroStation SDK提供的html格式的文档。
• examples MciroStation SDK提供的例子。
• include MciroStation SDK提供的包含头文件。
• library MciroStation SDK提供的链接库文件。
• MigrationTools MciroStation SDK提供的移植旧的mdl程序的工具。
• mki MciroStation SDK提供的编译辅助文件。

在ABDSDK目录下，存放的是ABD SDK相关的文件。

• doc ABD SDK提供的CHM文档。最新的OBD SDK该文件夹下提供的几个chm文档说明如下：
  • ComponentAPI.chm -- OBD中暖通部分的C++形式的API说明文档
  • ComponentApiNet.chm -- OBD中暖通部分的.NET形式的API说明文档
  • OpenBuildingsDesignerAPI.chm -- OBD通用部分的C++形式的API说明文档，比如DataGroup相关的C++ API
  • stfcdoc.chm -- OBD中结构部分的C形式的API说明文档
  • tfcdoc.chm -- OBD中建筑部分的C形式的API说明文档
• Documentation ABD SDK提供的html格式的文档。
• examples ABD SDK提供的例子。
• include ABD SDK提供的包含头文件。
• library ABD SDK提供的链接库文件。

注意事项

• ABD SDK默认的安装目录和ABD的安装目录是在C盘。在indows系统中，默认的快捷方式会启动一个命令行窗口，由于编译过程中会在ABD安装目录中增加新的文件，因此这个命令行窗口需要使用管理员权限运行。
• Update 3 版本的ABD SDK缺少一个环境变量的缺省设置。在命令窗口中执行：set MSMDE_OUTPUT=%TEMP%\ （最新的OBD SDK中已经解决了该Bug）