这个系列我们介绍一下ArcGIS Pro SDK for Microsoft .NET的开发,本文是此系列的第一篇文章,我们先来介绍下基础环境的搭建,并创建第一个Demo。
写在前面
ArcGIS Pro SDK for Microsoft .NET的开发环境配置其实很简单,它不用像配置前端开发环境那样安装nodeJS啥的,我们只需要安装一个Visual Studio就可以了。
电脑已有环境
- windows 10
- ArcGIS Pro 2.5
操作步骤
1、到网站(https://visualstudio.microsoft.com/zh-hans/downloads/
)下载VS,目前VS2017和VS2019的社区版是免费的,所以我们直接下载社区版安装即可,如下:
2、安装包下载完成后鼠标双击安装即可,安装过程中选择安装目录,然后在【工作负载】面板记得勾选”.NET 桌面开发”和”通用windows平台开发”两个模块,其他的模块暂时不用安装,如果后期有需求再返回来安装即可,如下:
3、安装完成后打开VS,第一次打开时会有一些主题设置啊什么的,大家根据情况自己设置即可,然后后续每次打开时VS都会默认打开项目创建面板,但是我们目前为止仅仅安装了VS,并没有安装ArcGIS Pro SDK for Microsoft .NET开发包,所以接下来要安装Pro SDK的开发包。
4、ArcGIS Pro SDK for Microsoft .NET的开发包安装分为两种方式:
- 如果你的机子上安装的是最新版的ArcGIS Pro,那么ArcGIS Pro SDK for Microsoft .NET开发包就可以直接在VS里面安装;
- 如果你的机子上安装的不是最新版的ArcGIS Pro,那么ArcGIS Pro SDK for Microsoft .NET的开发包我们先要到GitHub去下载,下载到相应版本的开发包之后鼠标双击开发包安装。
接下来我们分别介绍下两种安装方式。
A、VS里面直接安装
4.1、我们打开VS时会看到项目创建面板,如下所示:
4.2、点击上图中的”继续”字样,然后进入到无代码状态的VS中,接下来我们就安装ArcGIS Pro SDK for Microsoft .NET开发包。依次点击VS顶部菜单中的【扩展 | 管理扩展】菜单,然后会打开管理扩展界面,在管理扩展界面我们点击左侧如下图所示的子菜单,然后在右上角搜索框中输入”ArcGIS Pro SDK”来搜索要安装的开发包:
4.3、由上图可看到,我们已经找到了想要的开发包,就是搜索结果最顶部的那两个开发包,依次点击每一项后面的”安装”按钮之后,它会将这两个开发包加入到下载安装任务列表,此时我们只需要关闭这个界面,并且关闭VS即可,然后会自动启动开发包的下载和安装界面,等到下载安装完成后我们重新打开VS即可,如下图所示:
4.4、以上就是在VS中直接安装ArcGIS Pro SDK for Microsoft .NET的过程。
B、下载不是最新版本的ArcGIS Pro SDK for Microsoft .NET开发包安装
4.1、这种安装情况其实很常见,因为我们机子上的Pro并不能保证它是最新版本,所以在不升级Pro的情况下如果还想做ArcGIS Pro SDK for Microsoft .NET的开发的话,那么ArcGIS Pro SDK for Microsoft .NET开发包的安装就只能通过这种方式。
4.2、首先我们先到网站(https://github.com/esri/arcgis-pro-sdk/wiki#resources
)找到与自己机子上安装的Pro版本相对应的开发包,然后点击进去相应的页面,在每个版本开发包的页面最底部有开发包下载链接,如下(在这里我机子上是Pro 2.5,所以我选择了2.5版本的开发包):
4.3、将上图中所示的两个开发包下载之后,鼠标双击就会进入开发包的自动安装界面,它会自动地将安装包安装到我们机子上的VS中。到目前为止,两种安装方式已经介绍完毕,接下来我们就开发创建一个demo。
5、不管是用哪种方式安装的开发包,我们安装完成之后千万不要忘记:要去掉ArcGIS Pro SDK for Microsoft .NET开发包的自动更新!!!!去除开发包的更新其实很简单,只需要依次点击VS顶部菜单的【工具 | 选项】之后,在选项面板左侧选择”扩展”,然后在右侧取消如图所示的勾选即可,如下:
6、接下来我们创建第一个demo。重新打开VS,然后在项目创建面板选择【创建新项目】,在新项目创建面板选择【ArcGIS Pro SDK】,然后选择【ArcGIS Pro管理配置】,如下图所示:
7、然后在接下来的界面填入项目名称、选择项目存放路径即可,如下所示:
如果你的机子上没有.NET Framework框架的话,上图中红色框选那部分会报错,这个时候我们只需要去微软官网下载一个.NET Framework的框架安装包安装即可,具体的.NET Framework框架版本和ArcGIS Pro SDK for Microsoft .NET开发包的版本对应关系可以到ArcGIS Pro SDK的官网页面查看,此处就不做过多描述。
8、项目创建完成之后,我们点击VS顶部菜单的【运行】按钮即可启动项目,项目具体如下图所示:
项目代码结构如下图所示:
9、至此,我们ArcGIS Pro SDK for Microsoft .NET的开发环境已经安装成功,并且创建了一个demo,后续我们继续在这个demo上增加其他功能。