ArcGIS Runtime SDK for Qt开发环境配置与工程创建指南

关注

VIP免费原创最新推荐文章于 2026-09-24 12:45:12 发布 197 阅读 AI 写同款· GEO 优化 ›

QT 5.15.2 开发地图ArcGIS 100.15.6（ArcGIS Runtime SDK for Qt）步骤4（选择Topographic不需要KEY)步骤5（必须是MSVC2019 64bit！阅读详情

1. 从零开始：认识你的新工具

如果你对地图应用开发感兴趣，或者你的项目需要集成一个功能强大、界面美观的地图组件，那么 ArcGIS Runtime SDK for Qt 绝对是一个值得你投入时间学习的利器。我自己在接触它之前，也用过一些其他的地图库，但要么是功能太简陋，要么是集成过程异常痛苦。直到遇到 ArcGIS Runtime SDK for Qt，我才发现原来在桌面端（Windows、Linux、macOS）甚至移动端（Android、iOS）构建一个专业级的地图应用，可以如此顺畅。

简单来说，ArcGIS Runtime SDK for Qt 是 Esri 公司（地理信息系统领域的巨头）专门为 Qt 框架打造的一套开发工具包。它把 Esri 在 GIS（地理信息系统）领域几十年的积累，封装成了 Qt 风格的 C++ 类库和 QML 组件。这意味着，你可以用写普通 Qt 程序的方式，去调用世界级的在线地图服务、处理复杂的空间数据、进行地理编码和路径分析，甚至渲染漂亮的三维场景。它不是一个独立的软件，而是一套需要集成到你 Qt 项目中的 SDK（软件开发工具包）。

这里有个关键点需要厘清，也是很多新手一开始会困惑的地方：Esri 目前为 Qt 提供了两套主要的 SDK。一套就是我们今天要讲的 ArcGIS Runtime SDK for Qt，它的版本号是 100.15.x，这是一个长期支持版本，非常稳定，官方主要进行 bug 修复和小版本维护。它完美支持 Qt 5，如果你的项目因为历史原因还停留在 Qt 5，那它就是你的不二之选。另一套是 ArcGIS Maps SDK for Qt，你可以把它看作是 Runtime SDK 的“完全体”或下一代产品，它基于更现代的架构，功能更丰富，并且完全基于 Qt 6 构建，是官方目前主推的方向。所以，如果你的项目已经使用 Qt 6，并且希望用到最新最炫的功能，比如更流畅的 3D 体验、更先进的离线数据格式支持，那么应该选择 ArcGIS Maps SDK。

对于我们入门来说，从 ArcGIS Runtime SDK for Qt 开始是个绝佳的选择。它的安装配置过程与 Maps SDK 大同小异，但文档和社区资源对于 100.15 这个长期支持版本更为成熟，踩坑时更容易找到解决方案。今天这篇指南，我就带你手把手在 Windows 上，用最常见的 Visual Studio + Qt 组合，把 ArcGIS Runtime SDK for Qt 的开发环境搭起来，并创建你的第一个能显示离线地图的桌面程序。整个过程我会把我自己踩过的坑和验证过的技巧都告诉你，保证你跟着做一遍就能成功。

2. 兵马未动，粮草先行：搭建基础开发环境

在请出我们的主角 ArcGIS SDK 之前，得先把它的“舞台”——也就是基础的 Qt 开发环境给搭结实了。这一步看似与 ArcGIS 无关，实则至关重要。一个稳定、配置正确的 Qt 环境是后续一切工作的基石。我见过不少朋友卡在奇怪的问题上，最后追根溯源都是基础环境没弄对。

2.1 核心三件套的选择与安装

我们的目标是：Visual Studio 2022 + Qt 5.15.2 + ArcGIS Runtime SDK for Qt 100.15.3。这个组合是我和团队在多个实际生产项目中验证过的“黄金组合”，兼容性非常好。

第一件，Visual Studio 2022：这是我们的 C++ 编译器和 IDE。去微软官网下载 Community 版本即可，完全免费且功能强大。在安装时，记得勾选“使用 C++ 的桌面开发”这个工作负载。里面包含的 MSVC 编译器是 Qt 官方推荐在 Windows 上使用的。我建议把 Windows 10/11 SDK 也选上，版本选最新的稳定版就行。安装过程可能需要一些时间和磁盘空间，泡杯茶等待一下。

第二件，Qt 5.15.2：这是 Qt 框架本身。为什么选 5.15.2？因为它是 Qt 5 系列的最后一个长期支持版本，非常稳定，并且与我们要用的 ArcGIS Runtime SDK 100.15.x 版本完美匹配。你需要去 Qt 官网的下载页面，找到 Qt 5.15.2 的在线安装程序。运行安装程序时，关键步骤在于组件选择。我强烈建议你至少勾选以下组件：

MSVC 2019 64-bit：这个对应 Visual Studio 2022 的编译器。虽然 VS 是 2022，但它使用的编译器工具链版本是 MSVC 2019 的，所以选这个。
Qt Charts、Qt Data Visualization 等可选，但 Qt Script 建议勾选，某些老项目可能会用到。
Qt Creator 这个 IDE 可以装，但我们主要用 VS，所以不装也行。

安装路径我习惯用 C:\Qt\5.15.2 这样的，清晰明了。安装完成后，你需要将 Qt 的 bin 目录（例如 C:\Qt\5.15.2\msvc2019_64\bin）添加到系统的 PATH 环境变量里，这样在命令行也能调用 Qt 的工具。

第三件，环境变量与验证：装好 VS 和