Rider 2024.2.3配置ArcGIS Maps(Runtime) .NET SDK 200.5环境详细步骤
ArcGIS SDK的环境配置有多种选择、多种方法，本文只是记录笔者所采用的一种方法，不同版本的开发平台、软件工具之间差异较大，请留意本文所使用的版本。
1 概述
本文记录了笔者使用Rider配置ArcGIS Maps .NET SDK 200.5的过程，如需查看Visual Studio的环境配置方法请访问下面的链接
由于电脑原有环境不同，您的配置过程可能与笔者有所差异，如有疑问，欢迎提供必要信息在文末留言讨论，同时也欢迎各位读者批评指正。
读者朋友可以通过目录快速跳转和全览本文。
由于课程当中老师推荐的集成开发环境（IDE）是Visual Studio，因此本文所述的Rider将会在保证易读性的前提下适当简略。
2 安装Rider
2.1 主程序安装
访问Rider官网（https://www.jetbrains.com/rider/），点击Download下载，下载完成后双击打开
欢迎页面，点击Next
选择安装位置，并点击Next，注意剩余空间是否足够
按实际需要勾选安装选项，如果不理解可以参考下图暂时进行设置，点击Next
点击Install
等待安装，点击show details可以查看详细的安装环节
勾选I want to manually reboot later，点击finish
2.2 破解激活
访问PeterFile共享文件库，下载Rider激活工具（注意：整个rider文件夹下载，访问PeterFile后右键单击文件夹，点击“下载”），并解压缩下载得到的压缩包
双击运行双击运行Rider激活.vbs文件，即可激活成功
2.3 软件配置
启动桌面上的Rider软件后可以导入其它编辑器的设置项，如果以前用习惯了Idea、Clion等编辑器可以导入其设置，笔者点击Skip Import
主题选择黑暗、IDEA主题
快捷键选择JetBrains的那一套，JetBrains还是比较顺手一些，读者可根据实际情况选择，例如可以选择Visual Studio以便于教材、老师同步
下面这个页面有一些推荐的插件，算是半个广告页面吧，可以不管它，也可以试用一下JetBrains AI Assistant，是一个智能写代码的AI
若是此时弹出了提示激活的弹窗，则关闭Rider，重新运行一次2.2 破解激活中所说的vbs文件
3 ArcGIS Runtime环境配置
SDK配置
点击新建解决方案
按照如图所示设置新建一个WPF应用程序，可以自行设置解决方案名称和项目名称、存储位置等，在.NET中，解决方案是层级上高于项目的一个概念，即一个解决方案当中可以包含多个项目。若是初次安装，您的界面中应该不会有图中打码的部分。点击Create创建。
此时即进入Rider主界面
点击顶部菜单栏Tools>NuGet>Manage NuGet Packages for Solution打开NuGet管理面板
在NuGet面板中，解决方案处选择当前的解决方案，②feeds选择nuget.org，③搜索Esri
①点击需要安装的包，然后在右侧点击项目旁的②加号安装到项目中，需要安装下面两个包：
Esri.ArcGISRuntime
Esri.ArcGISRuntime.WPF
项目模板配置
打开终端，输入以下命令并按回车执行
dotnet new --install Esri.ArcGISRuntime.ProjectTemplates
安装完成后关闭Rider并重新打开，点击New Solution，创建新的解决方案，在自定义模板处选择ArcGIS Maps SDK .NET WPF App，配置好参数后点击Create创建
此时项目已经新建成功，点击运行（图1）可以看到弹出的MainWindow（图2）
4 在线服务接入
通过上述步骤我们已经能够接入基础的ArcGIS Runtime服务，但是无法调用ArcGIS的在线地图，需要申请API KEY并进行一定配置。
4.1 API KEY申请
进入ArcGIS Developer官网，点击右上角Sign In登录
在弹出窗口中点击Sign in to ArcGIS Location Platform
若是第一次登录需要点击创建ArcGIS Location Platform账户进行注册
注册时的First Name和Last Name可以不为真实姓名，Email需要使用外国邮箱(例如：Gmail、Outlook、Foxmail等)，随后按照提示填写各项信息，并在邮箱中点击链接激活账户，说明一处：
Your Portal URL可以理解为你个人主页的地址，可以起个简单的网址以便自己后续访问，例如：
https://xiaoming.maps.arcgis.com因笔者已注册过账号，部分过程无法复现，且步骤较为简单，此处不再赘述，直接进入登录页面，输入账号密码，点击登录
进入控制台Dashboard后点击Create a developer credential创建开发者凭据
点击新建项目
点击开发者凭据
选择API密钥凭据，点击下一步
设置到期日期，ArcGIS最长可设置一年的密钥有效期，Referrer URL留空，点击下一步
打开定位服务总开关，点击下一步
点击跳过
可以设置该API KEY的标题、标签、文件夹、摘要等，以便以后管理多个KEY，设置完成后点击下一步
确认各项信息无误后点击下一步
选择生成API密钥并进入项目详情页面......，点击下一步
API KEY创建成功，点击复制按钮将API KEY复制下来并保存好，一旦关闭此窗口API KEY就再也无法找到
4.2 应用API KEY调用在线地图
回到Rider中，展开App.xaml，打开里面的App.xaml.cs代码文件，找到UseApiKey(......)这一行，去掉注释，将双引号里面的内容替换为刚刚复制的API KEY
双击打开MapViewModel.cs代码文件，找到Basemap = new Basemap(xxx)这一行，去掉注释
点击运行，可以看到弹出的窗口中在线地图已经加载成功，可以通过鼠标拖拽或缩放地图。由于ESRI的服务器在国外，此过程可能稍慢，打开窗口显示白色时可以先耐心等几分钟，若无反应再去查找原因，地图不立即显示属于正常情况。
本文只实现了一个基本的在线地图显示能力，如需其它更多ArcGIS Runtime功能，仅凭本文的组件、方法可能还不够，详情请参阅ArcGIS官方文档(https://developers.arcgis.com/documentation/)，如有错漏或更好的方法，欢迎读者批评指正。
