1.概述

本教程适用于Bentley 的MicroStation，OpenRoad, OpenRail等系列软件的C#语言的开发环境配置。通过本教程大家可以很快的运行SDK安装包里的C#（Manager）的例子。

重要的事情说三遍 本文只适用于C#的开发环境配置 本文只适用于C#的开发环境配置 本文只适用于C#的开发环境配置

请把WIN10更新到最新版 请把WIN10更新到最新版 请把WIN10更新到最新版

2.程序安装包

我们需要安装

  1. 主程序 和 SDK
    1. 对于MicroStation的开发者需要安装MicroStation程序和对应的SDK
    2. 对于OpenRoad, OpenRail的开发者需要安装OpenRoad, OpenRail的程序和对应的SDK
  2. VS开发工具安装
    1. 没有购买的可以安装 VS2017及以上版本的 社区版
    2. 购买过的可以安装 VS2017及以上版本的商业版
  3. 辅助工具
    1. 文本编辑器 notepad++ ，这是一个相当方便的文本编辑器，对于开发很有帮助 (下载地址 https://notepad-plus-plus.org/downloads/v8.2/)
    2. everything 是一个强大的搜索工具，这个工具可以帮助我们很快的查找文件，特别方便。（下载地址 https://www.voidtools.com/zh-cn/）

image.png

image.png

3.操作步骤

1.下载主程序和SDK安装包

注意：主程序和SDK一定要在同一个盘符下，例如都安装在C盘或者D盘

1.1 MicroStation的下载

官网下载：

1.登录下载网站
https://softwaredownloads.bentley.com/
image.png
image.png
image.png
image.png

2.选择主程序并下载
image.png

下载完成后，可以看到一个exe的可执行程序，如下图
image.png

3.选择SDK安装包，并下载
image.png

下载完成后可以获得一个sdk的安装文件，如下图
image.png

百度网盘下载

大家也可以通过下面的链接从百度网盘下载

链接：https://pan.baidu.com/s/1ZcInu7Mi4LgNwVftKTi1wQ 提取码：1234 —来自百度网盘超级会员V5的分享

image.png
image.png

image.png
离线版安装包如下
image.png
安装的时候选择
image.png
注意 安装前删除这个文件
image.png

OpenRoad, OpenRail的下载

官网下载：

1.登录下载网站
https://softwaredownloads.bentley.com/
image.png

2.选择主程序并下载
image.png
下载完成后，可以看到一个exe的可执行程序，如下图

3.选择SDK安装包，并下载
image.png

2.安装主程序和SDK

注意：主程序和SDK一定要在同一个盘符下，例如都安装在C盘或者D盘

MicroStation和SDK的安装

1.主程序的安装
右键点击下载好的exe安装文件
image.png

进如安装程序
image.png
image.png
image.png

image.png

image.png

image.png

点击安装后程序自动开始安装
image.png
image.png

安装成功后可以在安装目录下查看安装的内容如下图所示
image.png

3.选择SDK安装包并下载 （注意和主程序的版本配套）
右键点击sdk的安装程序msi 文件
image.png
点击安装（Install）, 进入安装界面
image.png

image.png
image.png
image.png

image.png

image.png
image.png

安装成功后可以在安装目录下查看安装的内容如下图所示
image.png

OpenRoad, OpenRail和SDK的安装

与MS的基本相同
安装成功后如下

OpenRoads的安装结果如下：

image.png
image.png

ORD SDK中的例子没有MS的全，都是ORD自身的专业例子，缺少MS的基础例子

image.png

ORD SDK中的帮助文档没有MS的全

OpenRoads 中国版SDK的安装结果如下：

image.png
image.png
image.png

ORD 中国版SDK中的帮助文档没有MS的全

3.VS的下载和安装

1.打开官网

官网地址 https://visualstudio.microsoft.com/
image.png

2.进入到下载VS的界面

如果没有购买VS的话，选择社区版的VS
地址：https://visualstudio.microsoft.com/zh-hans/thank-you-downloading-visual-studio/?sku=Community&rel=17
image.png

image.png
下载完成后可以看到一个exe的安装包，如下图
image.png

3.安装主程序

右键点击exe，选择管理院模式运行，如图
image.png
启动安装主界面，如图

image.pngimage.png

1212.png

进入安装界面后若使用C#语言进行开发，需勾选.NET桌面开发，若使用C++语言进行开发，则需勾选使用C++的桌面开发。您可根据您的实际情况按需安装，同时后续也可在Visual Studio中继续添加模块。

建议C#和C++的都选择

模块选择如下图所示：
2222.png
因为Bentley二次开发基于.NET Framework4.6.2，因此，若您安装的Visual Studio版本为2017，请注意勾选.NET Framework 4.6.2开发工具。
image.png

image.png

3333.png
image.png
（可选）也可以在单个组件中确定选择的内容，如图
image.png
image.png
image.png
image.png
image.png
image.png
image.png
image.png

image.png

image.png

选择完后开始安装
5555.png

安装完成后，设置账号和常用开发环境
Bentley C# SDK 开发环境配置方法 - 图69
Bentley C# SDK 开发环境配置方法 - 图70
image.png

Bentley C# SDK 开发环境配置方法 - 图72
大家也可以尝试着创建一个新项目。

4.设置环境变量

默认情况下，安装包里的example 例子是通过批处理文件来运行的，但是这种方式对于初学者不是很友好，本文通过设置环境变量的方式让初学者可以很方便的运行并调试C#的例子

4.1 Microstation的开发环境变量

对于安装了Microstation的用户：
首先创建一个MS_EVN.bat 的批处理文件 （批处理文件的名字大家可以任意起名）
image.png
然后在文件中输入如下内容：

  2. rem  "MS" "这里需要填写自己的主程序安装目录，同时注意结尾是 双斜杠 \\ " /m
  3. setx "MS" "C:\Program Files\Bentley\MicroStation CONNECT Edition\MicroStation\\" /m
  5. rem  "MSMDE" "这里需要填写自己的SDK安装目录，同时注意结尾是 双斜杠 \\ " /m
  6. setx "MSMDE" "C:\Program Files\Bentley\MicroStationCONNECTSDK\\" /m
  8. rem  "MSMDE_OUTPUT" "这里需要填写自己的程序输出目录，同时注意结尾是 双斜杠 \\ " /m
  9. setx "MSMDE_OUTPUT" "C:\Program Files\Bentley\MicroStation CONNECT Edition\MicroStation\Mdlapps\\" /m

然后右键点击MS_EVN.bat，选择管理员模式运行
image.png

运行后便成功设置了环境变量

（下面步骤是为了确认是否设置正确，可以选择跳过）

然后打开我的电脑，右键点击“我的电脑”，选择属性（Properties）
image.png
在弹出的设置（setting） 对话框中 选择 高级系统设置（Advanced system setting）
image.png
在弹出的对话框中，选择环境变量

image.png

然后就可以在弹出的对话框中，查看是否正确设置了环境变量，如下图所示

image.png

4.2 OpenRoad, OpenRail的开发环境变量

对于安装了OpenRoad, OpenRail的用户：
首先创建一个ORD_EVN.bat 的批处理文件 （批处理文件的名字大家可以任意起名）
image.png
然后在文件中输入如下内容：


rem  "ORD" "这里需要填写自己的主程序安装目录，同时注意结尾是 双斜杠 \\ " /m
setx "ORD" "C:\Program Files\Bentley\OpenRoads Designer CONNECT Edition\OpenRoadsDesigner\\" /m

rem  "ORDE" "这里需要填写自己的SDK安装目录，同时注意结尾是 双斜杠 \\ " /m
setx "ORDE" "C:\Program Files\Bentley\OpenRoadsDesignerCONNECTSDK\\" /m

rem  "ORDE_OUTPUT" "这里需要填写自己的程序输出目录，同时注意结尾是 双斜杠 \\ " /m
setx "ORDE_OUTPUT" "C:\Program Files\Bentley\OpenRoads Designer CONNECT Edition\OpenRoadsDesigner\Mdlapps\\" /m

然后右键点击ORD_EVN.bat，选择管理员模式运行
Bentley C# SDK 开发环境配置方法 - 图80

运行后便成功设置了环境变量

（下面步骤是为了确认是否设置正确，可以选择跳过）

然后打开我的电脑，右键点击“我的电脑”，选择属性（Properties）
image.png
在弹出的设置（setting） 对话框中 选择 高级系统设置（Advanced system setting）
image.png
在弹出的对话框中，选择环境变量

image.png

然后就可以在弹出的对话框中，查看是否正确设置了环境变量，如下图所示

image.png

5.打开C#例子

1.打开VS程序

管理员方式打开VS程序 （由于SDK的例子默认安装到C盘所有授权先控制，需要用管理院方式打开）

2.选择打开项目

image.png

3.选择SDK的安装目录

默认是C:\Program Files\Bentley\MicroStationCONNECTSDK\
如下图选择ManagedToolsExample的C#例子
image.png
4.找到C#的例子的.sln或者.project 文件
image.png

5.选择项目文件，打开程序

image.png

查看是否有红色的库，如果有的话，证明环境变量没有设置成功

6.编译例子

1.右键点击项目

image.png

2.选择编译 Build

image.png

3.完成编译

image.png
上图中可以看到项目已经编译通过，并生成了DLL到指定目录中
1> ManagedToolsExample -> C:\Program Files\Bentley\MicroStation CONNECT Edition\MicroStation\mdlapps\ManagedToolsExample.dll

4.编译失败

如果编译失败，请查看.net framework的版本是否时4.6.2

如果不是请按照下面方式修改

修改方式 1

修改方式以直接在VS中修改，如下图：
image.png
右键点击项目，然后选择属性 properties
image.png
在应用面板中修改Target framework 为4.6.2

修改方式 2

如果直接修改失败，可以通过修改文件的方式进行修改
首先找到例子所在的目录，例如C:\Program Files\Bentley\MicroStationCONNECTSDK\examples\Elements\ManagedToolsExample
image.png

找到.csproj文件，用记事本打开（建议用notepad++ 这个软件打开编辑，下载地址是：https://notepad-plus-plus.org/downloads/v8.2/）
image.png
image.png

在下图的位置中插入v4.6.2
image.png
点击保存
image.png

回到VS程序，这时程序会提示如下图
image.png
点击 Reload All
image.png
如上图已经修改，课重新编译
image.png
上图中可以看到项目已经编译通过，并生成了DLL到指定目录中
1> ManagedToolsExample -> C:\Program Files\Bentley\MicroStation CONNECT Edition\MicroStation\mdlapps\ManagedToolsExample.dll

7.运行例子

下面我们可以在主程序中运行刚才编译的例子，操作方式如下：

1.打开 Microstation 或者 OpenRoad/OpenRail

image.png

2.选择任意文件，进入程序

image.png

3.通过MDL加载例子

image.png

选择浏览

image.png

找到编译的dll

image.png

加载成功后，在程序信息框提示加载成功，如图：

image.png

在keyin窗体键入keyin命令，如图

image.png

image.png

或者在ribbion控件上选择keyin命令弹出框

image.png
image.pngimage.png

输入命令”toolsexample simpletool tool”

image.png

使用 回车键，开始运行

4.运行keyin命令 执行例子的功能

程序进入工具状态，可以根据左下角的提示操作命令
image.png
image.png

4.产品开发生态群

如果您对开发感兴趣可以加入到我们的开发生态微信群
微信请联系： 15221636320 请备注 “参加开发直播课程”