MicroStation CE SDK Update17.0发布了!

MicroStation SDK(软件开发包)团队高兴地宣布:MicroStation CONNECT版SDK Update17.0(10.17.00.118)可供下载了!

该新版本提供了如下一些增强功能。

1、概述

  • 微软Visual Studio2019专业版(或企业版)为默认工具集
  • 由于新的默认工具集要求,需要重新编译现有的MDL应用程序
  • 增量更新:API、文档、例子和eula.pdf(终端用户授权协议PDF文档)

2、安装要求:

  • 本机代码(C/C++)和托管代码(.NET)的开发需要:
    • 微软Visual Studio2019专业版(或企业版)
    • 微软.NET框架4.6.2运行时
    • 微软8.3格式支持(对于带有空格的路径或文件名需要能表达成无空格的8.3格式,这是对磁盘格式的要求)
  • Bentley VS向导(用于快速搭建一个开发项目)
  • 微软VS配置建议
    • .NET桌面开发
    • C++桌面开发(提供了DIA SDK
    • 通用Windows平台开发(提供了Windows10 SDK)
    • 下图是英文版VS界面,安装时勾选了上述三项。为了节省磁盘空间,其它项目可以不勾选

3、发行说明

  • 需要重新编译本机代码和C++/CLI混合编程代码
  • 这一版SDK中遗失了某些不重要的chm帮助文档
  • 建议修改桌面或开始菜单中的MicroStation SDK快捷方式为“以管理员运行”。这能保证在任何Windows保护的位置能创建和修改文件
  • MicroStation CE SDK通常会在MicroStation产品相应版本发布后的两周内发布
  • 为最大限度确保应用程序的兼容性和稳定性
    • 确保使用最新版本的MicroStation CONNECT版SDK和最匹配的MicroStation产品
    • 对于每个新的MicroStation产品和SDK更新,强烈推荐重编译现有的应用程序
  • 查看MicroStation每一版解决的问题:MicroStation CONNECT Edition Update xx - Resolved Issues

4、变化

  • MicroStation开发环境(Developer Shell)
    • MicroStationDeveloperShell.bat做了很小的改变
    • 更新库:Microsoft.Build.*.dll, VisualStudio.*.dll, System.*.dll
    • SDKCommon.bat变化:
      • 通过.NET session和openfiles检查启动环境的级别以提高LUA的兼容性
      • 改进对Visual Studio版本的识别能力
      • 改进对SDK产品的工作空间的识别能力
    • SDKMacros.bat的变化:提供DefineLegacyMacros以有效替换脚本builddemo.bat和opensln.bat
  • 帮助文档(临时移除如下文档)
    • Bentley.Exceptions.chm
    • ecobjects.chm
    • ecplugins.chm
    • ecservices.chm
    • 这些临时移除的文档可从SDKHelp网页中下载到。
  • 例子
    • 更新了examples\DgnEC\PickListProviderExample\ManagedExample和NativeExample中的PickListConditionalProvider功能
    • 新增examples\DgnEC\ReportCalculatedColumnExample
    • 新增examples\DgnEC\ReportSrNoColumnExample  (注:SrNo是“Serial Number”的缩写)
  • 头文件(SDK的include文件夹下):
    • Constraint2d\Constraint2dCoreAPI.h :更新了Constraint2dData
    • DgnGeoCoord\DgnGeoCoord.h :新增BaseGCSCartesianFromUors和GetLinearTransformToBaseGCS
    • DgnIModel\publish\IModelPublisherOptions.h:新增GetIsPublishOnlyOperation和SetIsPublishOnlyOperation
    • DgnPlatform\Tcb\toolset.r.h:新增useReferenceScale
    • DgnPlatform\CustomItemType.h:新增GetValueFromContext
    • DgnPlatform\DgnECManager.h:
      • 新增RegisterSrNoProvider、UnRegisterSrNoProvider和GetNextPriorityValueForSrNo
      • 新增IsSchemaContainedWithinFile (参数: includeReferenceAttachments)
    • DgnPlatform\DgnPlatform.h
      • 新增IConstraintTopology和ISrNoProvider
      • 新增TextTableStyle和TextTableStyleLibrary
      • 新增 STRING_LINKAGE_KEY_TPFFileName
    • DgnPlatform\DgnPlatform.r.h
      • 新增枚举 (DEFDGNDWGDXF_ID, DEFTPFFILE_ID, DEFDGNWSFILE_ID)
      • 新增ViewFlags.itemtypetext
    • DgnPlatform\DgnPlatformErrors.r.h:新增DGNOPEN_STATUS_BadIfcFile
    • DgnPlatform\DisplayFilter.h:新增ViewFlag_ItemTypeText和CreateViewActiveACSTest
    • DgnPlatform\DisplayFilterManager.h:新增DisplayFilterOpCode_ViewActiveACS
    • DgnPlatform\ECReportNode.h
      • 新增CalculatedColumnDefinitionNode和SummaryAggregateOptions
      • 新增GetExpression、GetExpressionFailValue、GetExpressionUnit和GetExpressionType
      • 新增SetExpression、SetSrNoColumnFormat、GetColumnSummaryOption和SetColumnSummaryOption
      • 新增IsGroupBySet、SetGroupBy、GetColumnAggregateOption和SetColumnAggregateOption
      • 新增IsColumnVisible、SetVisibility、SrNoFormats和SrNoColumnDefinitionNode
      • 新增GetSummaryRow和GetFilteredSummaryRow
      • 移除ReportResultOption
    • DgnPlatform\IAuxCoordSys.h:新增ACSFlags::ShowGeometry
    • DgnPlatform\LevelCache.h:新增SetByLevelLineStyle
    • DgnPlatform\Light.h:新增GetShadowDensity和SetShadowDensity
    • DgnPlatform\ParametricModeling.h:新增ParameterCsvSection:: (Min, Max, Folder)
    • 新增头文件DgnPlatform\SrNoProviders.h
    • DgnPlatform\TextTableHandler.h:新增TableSymbologyValues::CopyTo
    • 新增头文件DgnPlatform\TextTableStyle.h
    • 新增头文件DgnPlatform\ViewportDrawnCellHandler.h
    • DgnView\DgnRegionElementTool.h:新增Add: ValidateRegionParams和GetRegionPointsCount
    • ECObjects\ECExpressions.h:新增ExpressionStatus和MethodSymbol::Create
    • GeoCoord\BaseGeoCoord.h
      • 重构BENTLEY_GEOCOORD_PP_NAMESPACE到命名空间GeoCoordinates
      • 新增ClearConverterCache、InitFromWellKnownText、SetUnitByKeyname和SetVerticalDatumByKey
      • 新增GetDistanceInMeters和UsesAGeocentricMethod
    • GeoCoord\GCSLibrary.h:重构编译器选项
    • Geom\ClipPlane.h:新增GetLocalToWorldTransform
    • Geom\ClipPlaneSet.h
      • 新增PolyfaceIndexedHeapRangeTree和ConvexClipPlaneSet
      • 新增ClipPlaneSet::FromSweepBetweenCompatibleConvexPolygons和ClipPlaneSet::FromSweepBetweenCompatiblePolygons
      • 新增ClipPlaneSetIntersectPolyface.distanceTolerance
      • 新增ClipPlaneSetIntersectPolyface和ClipPlaneSetIntersectPolyface
    • Geom\CurveDetails.h:新增EvaluateConsistentFrames
    • Geom\CurveVector.h:微小的文档修正
    • Geom\dellipse3d.h:新增FromZPlaneInRanges
    • Geom\DPoint3dOps.h:新增IsColinear、SplitToConvexPartsXY和FixupAndTriangulateProjectedLoopsWithSplits
    • Geom\MSInterpolationCurve.h:新增Populate
    • Geom\Polyface.h
      • 新增CompareA、CompareAWithTolerance、InOutClassificationFromHits和TryGetIntColorAtReadIndex
      • 新增Compress、CloneWithMaximalPlanarFacetsExt、枚举ComputeSingleSheetOption、ComputeSingleSheetCutFill
      • 新增EnsureIntColor、AppendDRay3dIntersectionFacetLocationDetails和CollectdDRay3dIntersectionFacetLocationDetailsAtCandidates
    • Geom\transform.h:新增FromRangeMapping
    • Mstn\Constraint2dElement\ConstraintHandlerBase.h
      • 新增_GetIsAnchor、_SetIsAnchor和_GetElementRefs
      • 新增GetElementRefs和_FindReferencesByVariableName
    • Mstn\MdlApi\dlogids.r.h
      • 新增DIALOGID_SheetIndexCreate和PULLDOWNMENUID_AutoUpdateModes
      • 新增MENUSEARCHID_AutoUpdateAlways、MENUSEARCHID_AutoUpdateNever和MENUSEARCHID_AutoUpdateAsk
    • Mstn\MdlApi\helpids.r.h:新增HELPID_PULLDOWN_CellSub_AutoUpdate
    • Mstn\MdlApi\msdim.fdf:新增文档——在标注元素中替换标注文字字符串
    • Mstn\MdlApi\userpref.r.h
      • 新增enableItemTypePropagation、confirmLocalEllipsoidVerticalDatum、sortAllVariables和sortAllVariablesDoNotShow
      • 新增constraintRemoveVariables、constraintRemoveVariablesDoNotShow和updateAllVariations
    • Mstn\PSolid\mssolid.fdf :更新mspsolid.lib为所需要的链接库
    • Mstn\SmartFeature\SmartFeatureAPI.h:新增ExtrudeAlongSettings和CreateExtrudeAlongFeature
    • Mstn\cmdlist.r.h:移除CMD_SAVE_AS_V7和CMD_EXPORT_V7
    • PointCloud\PointCloud.h:新增PointCloudContextStatus、PointCloudFormat、PointCloudContextStatus GetContextStatus和PointCloudFormat GetFormat
    • PointCloud\PointCloudImportExport.h:新增GetNumExporterPasses、SetPass和SetExporterByExtension
  • 库:增量API更新
  • 移植工具:无变化
  • mki文件
    • 多个mki文件做了变化
    • 下一步工作:多个VS2022框架更新——命令、宏、规则、工具和版本

5、相关资源