2. 使用示例


        SDK安装包中自带有几个示例,主要用于指导用户如何使用SDK。这些示例既可以用来练习如何构建和运行自定义代码,也可以在创建新项目时作为参考资料来使用它。这些示例都位于SDK安装目录的examples文件夹中。此外,开发者命令行窗口启动时的默认路径也是指向这里的。
        开发者命令行窗口的主要作用就是编译代码,因此开发实践的第一步就是尝试编译所有示例的代码,有以下几种途径可以完成这项工作。

2.1 构建单个示例

        要构建单个示例,需要使用bmake命令并将项目的make.mke)文件作为参数传递给它。这个过程与构建用户编写的自定义项目所需的过程相同。
        为了演示这个构建过程,在构建ManagedSDKExample项目时,需要输入的命令以及所产生的输出如下图所示:
                 bmake ManagedSDKExample/ManagedSDKExample.mke

从以上输出我们可以看出构建是成功的,所以接下来就可以准备在OpenBridge Modeler中运行它了。
注意:若要调试使用托管SDK编写的示例项目,则需要先使用Visual Studio构建此项目。关于这个话题将在调试托管项目一节中详细介绍。

2.2 构建所有示例

        要构建所有的默认示例,需要运行examples目录下的BuildAllExamples.bat文件。
这个脚本文件会自动遍历并构建SDK安装目录下examples文件夹中的每个项目。

2.3 OpenBridge Modeler中运行自定义项目

        项目在开发者命令行窗口中成功构建后,就可以在OpenBridge Modeler中运行它了。这个过程是通过将项目作为一个keyin加载到系统中完成的。在随后的章节中,我们将会着重讨论如何创建能使用这种方式进行构建和运行的项目,但在这里我们只介绍如何加载其中的一个示例。
        ManagedSDKExample是一个托管的项目,这意味着它是使用托管的SDK编写而成的,并且在构建完成后会输出一个DLL和一个PDB文件,而使用非托管SDK的项目则会输出一个DLL、一个PDB以及一个MA文件。
        在构建成功后,这些输出文件会保存到OpenBridge Modeler安装位置中的Mdlapps文件夹中,这个位置位于:OpenBridge Modeler CONNECT Edition\OpenBridgeModeler\Mdlapps
        将输出文件保存到这个位置后,系统就可以找到这个项目并能将其作为一个keyin加载进来。要加载这个keyin,我们需要先打开OpenBridge Modeler CONNECT Edition应用程序,然后点击Home页签下的keyin菜单:
        加载项目时,需要使用

mdl load keyin,并将项目名称作为参数传递给它。对于加载ManagedSDKExample项目而言,这个要输入的keyin命令应该是:mdl load ManagedSDKExample
        若加载成功,则在应用程序底部的状态栏上会显示
                      
消息“MANAGEDSDKEXAMPLE loaded”。此时keyin已经加载,我们可以使用MANAGEDSDKEXAMPLE命令了,任何在此keyin中指定的命令都可以从上面这个根命令中运行(随后解释这个命令的层次)。