当前位置： 首页 > article >正文

从零开始：ArcGIS Pro二次开发环境搭建与首个模块加载项实战

article 2026/4/12 1:52:35
1. 环境准备从零搭建ArcGIS Pro开发环境第一次接触ArcGIS Pro二次开发时我花了整整两天时间才把环境配置好。现在回想起来其实只要抓住几个关键点就能避开那些坑。首先需要确认的是软件版本匹配问题——这是新手最容易翻车的地方。根据我的实测目前最稳定的组合是ArcGIS Pro 2.8 Visual Studio 2019这个组合的SDK文档最全社区支持也最好。安装.NET组件时有个细节特别重要打开Visual Studio Installer后在已安装界面点击修改时一定要确保VS已经完全关闭。我有次安装失败就是因为后台还挂着VS的更新进程。勾选.NET桌面开发时记得把.NET Framework 4.8开发工具也选上这是ArcGIS Pro SDK的隐藏依赖项官方文档里都没明确提过。提示如果安装过程中遇到系统缺少Windows 10 SDK报错可以在VS Installer的单个组件选项卡中搜索并安装版本号为10.0.18362.0的Windows 10 SDK。2. SDK安装的三大陷阱与解决方案从GitHub下载ArcGIS Pro 2.8 SDK时新手常会遇到三个典型问题。首先是下载速度慢建议早上8点前下载这时候GitHub的国内镜像节点响应最快。其次是安装顺序一定要先装proapp-sdk-templates.vsix再装utilities我有次反着安装导致VS模板全部加载失败。最坑的是版本兼容性问题。去年有个学员拿着ArcGIS Pro 3.0的SDK配VS2019各种奇怪的编译错误层出不穷。后来发现Pro 3.x必须用VS2022而Pro 2.x系列才是配VS2019的黄金组合。安装完成后可以通过VS的扩展→管理扩展界面确认两个组件是否显示为已安装状态。# 验证SDK安装成功的标志 1. VS新建项目时能看到ArcGIS Pro SDK分类 2. 项目模板中包含模块加载项选项 3. 解决方案资源管理器里出现Config.daml文件3. 创建第一个模块加载项项目以管理员身份启动VS2019后选择继续但无需代码这个入口很多人会忽略。新建项目时有个筛选技巧先在语言选C#平台选Windows然后在搜索框输入ArcGIS这样能快速定位到正确的项目模板。我建议项目名称用公司缩写功能描述的格式比如GISPark_Toolbox这样后续维护时一目了然。创建完成后别急着写代码先检查项目结构是否完整。一个标准的模块加载项应该包含这些关键文件Config.daml功能清单配置文件Module1.cs主模块类文件Images文件夹存放按钮图标Config.esriaddinx部署描述文件注意如果发现项目里缺少Config.daml文件说明SDK模板安装有问题需要重新安装proapp-sdk-templates.vsix组件。4. 实现第一个地图按钮功能添加新按钮时我推荐先在Images文件夹里准备好PNG格式的图标文件建议32x32像素。右键项目选择添加→新建项时选择ArcGIS Pro按钮后会生成三个关键部分按钮图标引用配置在Config.daml中按钮类定义文件如Button1.cs配套的图标资源文件在OnClick事件里写第一个功能时建议从简单的MessageBox开始测试。下面是个带地图交互的进阶示例protected override async void OnClick() { // 获取当前地图视图 var mapView MapView.Active; if (mapView null) { MessageBox.Show(请先打开地图视图); return; } // 示例缩放至全图范围 await QueuedTask.Run(() { mapView.ZoomToWholeExtent(); }); MessageBox.Show(已缩放到全图范围); }调试时有个实用技巧在VS的调试选项卡里勾选启动外部程序指向ArcGIS Pro的exe文件路径。这样按F5启动时VS会自动附加到ArcGIS Pro进程可以直接断点调试。5. 调试与部署的实战经验第一次运行加载项时ArcGIS Pro可能会提示未识别的扩展。这时需要到项目→属性→生成页面确认输出路径指向的是正确的AddIn文件夹位置。默认路径应该是C:\Users\[用户名]\Documents\ArcGIS\AddIns\ArcGISPro如果按钮在Pro里不显示检查三个地方Config.daml中的节点是否正确定义按钮类是否实现了OnClick方法图标资源是否设置为嵌入的资源打包部署时记得修改Config.esriaddinx中的标签。我有次忘记改这个字段导致客户那边安装时报作者验证错误。正式发布前建议用Inno Setup做个安装包可以自动处理AddIn文件的注册表写入。6. 常见错误排查指南遇到未能加载文件或程序集ESRI.ArcGIS...这类错误时通常是SDK版本不匹配导致的。可以尝试以下步骤检查项目引用的ArcGIS.*开头的dll版本号在NuGet包管理器里查看ESRI官方包的更新清理解决方案后重新生成内存泄漏是另一个高频问题。ArcGIS Pro的二次开发特别要注意及时释放COM对象。建议在访问地图对象时使用这样的模式var map MapView.Active.Map; try { // 操作地图代码 } finally { Marshal.FinalReleaseComObject(map); }性能优化方面所有耗时操作都应该放在QueuedTask.Run里执行。我测试过一个空间查询功能直接在主线程运行要8秒放到后台线程后只要2秒就完成。

相关文章：

从零开始：ArcGIS Pro二次开发环境搭建与首个模块加载项实战

1. 环境准备：从零搭建ArcGIS Pro开发环境 第一次接触ArcGIS Pro二次开发时，我花了整整两天时间才把环境配置好。现在回想起来，其实只要抓住几个关键点就能避开那些坑。首先需要确认的是软件版本匹配问题——这是新手最容易翻车的地方。根据我…...

编程日记 2026/4/12 1:52:35

终极指南：如何用VR-Reversal免费将3D视频转为2D播放

终极指南：如何用VR-Reversal免费将3D视频转为2D播放 【免费下载链接】VR-reversal VR-Reversal - Player for conversion of 3D video to 2D with optional saving of head tracking data and rendering out of 2D copies. 项目地址: https://gitcode.com/gh_mirr…...

编程日记 2026/4/12 1:50:35

C#索引器练习题

索引器是一种特殊的属性，允许类或结构的实例像数组一样通过索引进行访问。它提供了使用 [] 运算符访问对象中元素集合的便捷方式。一、考察索引器的定义与使用 难度：⭐定义一个 StudentClass 班级类，该类中包含一个集合用于存储学生姓名。…...

编程日记 2026/4/12 1:50:35

知乎x-zse-96参数逆向实战：从断点调试到Python复现

1. 逆向分析前的准备工作 第一次接触知乎x-zse-96参数逆向时，我完全是个小白。记得当时为了抓取一些公开的问答数据，直接用requests发请求却总是返回403错误。后来才发现，知乎的接口有个关键的安全校验参数x-zse-96，这个参数的值是…...

编程日记 2026/4/12 1:50:35

从果园到代码：手把手教你用YOLOv5+DeepSort实现猕猴桃自动计数（附避坑指南）

从果园到代码：手把手教你用YOLOv5DeepSort实现猕猴桃自动计数（附避坑指南） 盛夏的果园里，阳光透过茂密的枝叶洒在成串的猕猴桃上。果农老王正拿着记录本，一株株清点着今年的收成。"这活儿太费眼了，数着…...

编程日记 2026/4/12 1:50:35

SDD基于规范编程-OpenSpec及SuperPowers伟

智能体时代的代码范式转移与 C# 的战略转型 传统的 C# 开发模式，即所谓的“工程导向型”开发，要求开发者创建一个复杂的项目结构，包括项目文件（.csproj）、解决方案文件（.sln）、属性设置以及依赖…...

编程日记 2026/4/12 1:50:35

WPF无边框窗口最大化时避免遮挡任务栏的终极方案

1. 为什么无边框窗口会遮挡任务栏？ 很多开发者在使用WPF开发自定义窗口时，都会遇到一个头疼的问题：当窗口设置为无边框（WindowStyle"None"）并最大化时，窗口会遮挡系统的任务栏。这个问题看似简单…...

编程日记 2026/4/12 1:48:34

得意黑Smiley Sans：一款能让你爱上中文排版的窄斜体黑体终极指南

得意黑Smiley Sans：一款能让你爱上中文排版的窄斜体黑体终极指南 【免费下载链接】smiley-sans 得意黑 Smiley Sans：一款在人文观感和几何特征中寻找平衡的中文黑体 项目地址: https://gitcode.com/gh_mirrors/smi/smiley-sans 你是否厌倦了千篇一…...

编程日记 2026/4/12 1:48:34

AI原生敏捷开发落地指南（Gartner 2024验证：交付周期压缩63%的关键转折点）

第一章：AI原生敏捷开发的范式跃迁 2026奇点智能技术大会(https://ml-summit.org) 传统敏捷开发以人为核心、迭代交付为特征，而AI原生敏捷开发则将大模型能力深度嵌入需求分析、测试生成、代码补全与运维反馈闭环中，形成“感知—推理—执行—…...

编程日记 2026/4/12 1:48:34

CentOS 7.6服务器上，用FileZilla搞定VOS3000 8.0安装与授权（附详细命令）

CentOS 7.6服务器上高效部署VOS3000 8.0的完整指南 在当今VoIP业务快速发展的背景下，稳定可靠的通信系统部署成为企业运营的关键。本文将详细介绍如何在CentOS 7.6服务器上，结合FileZilla等工具，完成VOS3000 8.0的专业级部署与授权流程。不同…...

编程日记 2026/4/12 1:48:34

保姆级教程：用PaLI-X和PaLM-E微调你自己的RT-2风格机器人模型（附避坑指南）

从零构建RT-2风格机器人模型：基于PaLI-X/PaLM-E的实战指南 当我在实验室第一次看到RT-2模型准确识别出"即将倾倒的杯子"并实施救援动作时，意识到具身智能的临界点已经到来。这不是简单的物体抓取，而是机器对物理世界的因果推理——…...

编程日记 2026/4/12 1:48:34

Q、K、V大揭秘：小白也能看懂的自注意力机制，助你入门大模型（收藏版）

本文用大白话解释了自注意力机制中的核心元素Q、K、V，通过图书馆找书的类比，说明了Q代表查询指令、K代表索引标签、V代表实际内容。文章阐述了Q、K、V如何协同工作，实现精准的信息匹配和加权整合，帮助读者理解大模型如何处理全局信…...

编程日记 2026/4/12 1:46:34

SGP40气体传感器I²C驱动与嵌入式移植实战

1. SGP40气体传感器底层驱动技术解析1.1 传感器核心特性与工程定位SGP40是瑞士Sensirion公司推出的数字式挥发性有机化合物（VOC）气体传感器，专为室内空气质量监测、智能家电和IoT终端设计。其核心价值不在于直接输出ppm级VOC浓度，…...

编程日记 2026/4/12 1:46:34

SpringCloud进阶--Sentinel 流量防卫兵弛

一、项目背景与核心价值 1. 解决的核心痛点 Navicat的数据库连接密码并非明文存储，而是通过AES算法加密后写入.ncx格式的XML配置文件中。一旦用户忘记密码，常规方式只能重新配置连接，效率极低。本项目只作为学习研究使用，不做其他…...

编程日记 2026/4/12 1:46:34

从Matlab到FPGA：CIC滤波器设计验证全流程（附可下载的Verilog代码与测试脚本）

从Matlab到FPGA：CIC滤波器设计验证全流程实战指南 在数字信号处理领域，CIC（Cascaded Integrator-Comb）滤波器因其无需乘法器的硬件友好特性，成为数字下变频、采样率转换等场景的首选方案。本文将带领算法工程师和FPGA开…...

编程日记 2026/4/12 1:46:34

Hagicode.Libs：统一集成多个 AI 编程助手 CLI 的工程实践郝

1. 什么是 Apache SeaTunnel？ Apache SeaTunnel 是一个非常易于使用、高性能、支持实时流式和离线批处理的海量数据集成平台。它的目标是解决常见的数据集成问题，如数据源多样性、同步场景复杂性以及资源消耗高的问题。 核心特性 丰富的数据源支持&#…...

编程日记 2026/4/12 1:46:32

Claude Code Auto Mode 的技术实现

Claude Code Auto Mode 通过智能代码补全和上下文理解提升编程效率。该模式能自动分析当前代码上下文，预测开发者意图，提供精准的代码建议。支持多种编程语言，包括Python、JavaScript、Java等主流语言。深度学习模型实时学习项目代码风格和模…...

编程日记 2026/4/12 1:44:31

uni-app上传图片总失败？可能是你没处理好这几个细节（uni-file-picker实战排雷）

uni-app图片上传疑难排查指南：从临时路径到稳定交付的完整解决方案 在移动端开发中，文件上传功能看似简单，却暗藏诸多"坑点"。最近接手一个电商项目时，我们团队在uni-file-picker组件上栽了跟头——用户上传的图片时而显…...

编程日记 2026/4/12 1:44:31

mbino：Arduino上实现mbed HAL的轻量级嵌入式抽象层

1. 项目概述mbino 是一个面向 Arduino 平台的轻量级嵌入式抽象层移植库，其核心目标是将 mbed OS 2 的标准化硬件抽象 API（Hardware Abstraction Layer, HAL）无缝引入以 AVR 8-bit 微控制器（如 ATmega328P、ATmega2560）…...

编程日记 2026/4/12 1:44:31

diffusion model的基本概念

主要分为两个步骤：加密加噪声让原图变成模糊图（Forward Process),将模糊图去噪声，让其变成清晰图（Reverse Process) 先说Recerse Process的过程本质就是去除掉无用的像素，让有用的像素留下来（类似加密与解密…...

编程日记 2026/4/12 1:44:31

信息时代的内容创作者，你离“爆款“只差一个正确的信息入口

说实话，作为一个在互联网内容行业摸爬滚打七八年的老编辑，我早就被各种信息轰炸得有些麻木了。每天早上醒来，手机里躺着十几个App的推送通知，微信群里几百条未读消息，邮箱里塞满了各类资讯订阅。想要快速了解今天发生了…...

编程日记 2026/4/12 1:44:31

OpenGL多线程踩坑实录：EGL_BAD_ACCESS错误排查与修复指南

OpenGL多线程开发中的EGL_BAD_ACCESS：从原理到实战解决方案 当你在深夜调试一个复杂的OpenGL多线程应用时，突然在终端看到EGL_BAD_ACCESS错误提示，那种感觉就像在高速公路上爆胎——既焦虑又无助。这个错误在多线程OpenGL开发中极为常见&…...

编程日记 2026/4/12 1:42:31

Redis高危漏洞CVE-2025-49844（RediShell）详解：13年Lua脚本UAF漏洞可实现远程代码执行（RCE）

Download Redis Logo in SVG Vector or PNG File Format - Logo.wine Redis官方已针对CVE-2025-49844漏洞发布安全公告。该漏洞是Lua脚本引擎中的“释放后使用”（Use-After-Free，UAF）内存损坏问题，可被已认证攻击者利用恶意Lua脚…...

编程日记 2026/4/12 1:42:31

GyverMAX7219：亚毫秒级LED矩阵图形库深度解析

1. 项目概述GyverMAX7219 是一款专为 MAX7219 驱动芯片设计的高性能、轻量级嵌入式图形库，面向资源受限的微控制器平台（如 ATmega328P、ESP32、STM32F1/F4 等）提供毫秒级响应的 LED 矩阵控制能力。其核心定位并非通用显示驱动，而是…...

编程日记 2026/4/12 1:42:31

无人机测绘新手避坑：为什么你的TIN模型总是有‘尖刺’和空洞？

无人机测绘实战：TIN模型尖刺与空洞问题的深度解析与解决方案 当你在ContextCapture或Pix4D中点击"生成TIN模型"按钮时，是否曾盯着屏幕上那些诡异的尖刺和黑洞陷入沉思？这些不速之客不仅影响模型美观，更会直接导致体积计…...

编程日记 2026/4/12 1:42:31

告别裸奔！用CubeMX+ThreadX给STM32H743项目快速搭建一个健壮的任务框架

基于CubeMX与ThreadX构建STM32H743高可靠实时系统框架 在嵌入式开发领域，从裸机编程过渡到RTOS（实时操作系统）往往意味着项目复杂度与可靠性的双重提升。对于使用STM32H743这类高性能MCU的开发者而言，如何快速搭建一个既稳定又易于…...

编程日记 2026/4/12 1:42:31

深夜告警炸裂？这份Linux故障排查“作战地图”请收好劣

先唠两句：参数就像餐厅点单 把API想象成一家餐厅的“后厨系统”。 ? 路径参数/dishes/{dish_id} -> 好比你要点“宫保鸡丁”这道具体的菜，它是菜单（资源路径）的一部分。查询参数/dishes?spicytrue&typeSichuan -> 好比…...

编程日记 2026/4/12 1:40:30

2、 Verilog 代码规范

分类 Verilog 教程高级篇 不经意间看到几年前自己写的 FGPA 设计，代码风格勉强说的过去，但是逻辑设计方面的安全隐患比比皆是。许多初学者编写 Verilog 代码，基本都是按照 C 语言的思维和风格去设计，造成了很多不规范的共性问题。…...

编程日记 2026/4/12 1:40:30

【生成模型】【ComfyUI（四）】WebSocket实时监控与进度条优化ComfyUI批量处理

1. WebSocket实时监控的原理与实现 ComfyUI作为生成模型的重要工具，其批量处理能力直接影响工作效率。传统轮询方式会造成资源浪费和延迟，而WebSocket协议的全双工通信特性完美解决了这个问题。我曾在实际项目中处理过300图像的批量生成任务，…...

编程日记 2026/4/12 1:40:30

Linux I/O 演进史：从管道到零拷贝，一篇串起个服务端核心原语劣

前言 在使用 kubectl get $KIND -o yaml 查看 k8s 资源时，输出结果中包含大量由集群自动生成的元数据（如 managedFields、resourceVersion、uid 等）。这些信息在实际复用 yaml 清单时需要手动清理，增加了额外的工作量。 使用 kube…...

编程日记 2026/4/12 1:40:30