Delphi 12 安装 EhLib VCL 10.2.42：依赖顺序与路径指南

简介这是针对Delphi 12 Athens的EhLib VCL 10.2.42组件库压缩包面向需要快速构建数据库应用、报表、图表及复杂界面的Delphi开发者。组件涵盖EhDBGrid、EhReport、EhGantt等核心控件支持数据网格高级交互、报表自定义布局、甘特图与流程图绘制并提供日期时间处理、对话框封装及树形视图等实用工具可显著降低企业级项目界面开发门槛。压缩包共1490个文件以dfm窗体定义、pas源代码、dcu编译单元为主同时包含hpp、res、dpr、dproj等工程资源以及chm、hlp、docx等帮助文档便于查阅API和示例。整体大小约25.56MB结构紧凑。已有353人下载学习。解压后可直接获取源码、示例工程和完整帮助文档针对Delphi 12 Athens版本做了适配适合希望扩充组件库、提升开发效率的Delphi中高级开发者。1. 装 Delphi 12 上的 EhLib VCL 10.2.42最大的坑在包依赖顺序在 Delphi 12 Athens 上做数据管理类桌面程序我第一个要装的控件包就是 EhLib VCL。这份 10.2.42 压缩包文件名里带着 for Delphi 12 Athens按理说版本是配套的可真正动手装的时候十个人里至少有六个人卡在同一个地方它不是一个双击 Install 就能用的普通组件包而是一组由十几个 .dpk 组成的包组项目必须先按依赖顺序编译再把设计时包注册进 IDE。依赖顺序一乱表现非常经典组件面板上搜不到 TDBGridEh编译时提示 Unable to open file 某个.dcu运行时弹 Cant load package……一圈下来等于没装。这篇笔记把「装什么版本、怎么解压、参数怎么配、坏了怎么救」整个流程拆开讲新手上手能一次跑通老手可以重点看第 5 章的踩坑记录和最后一章的验证清单。2. 版本与环境盘点10.2.42 和 Delphi 12 Athens 的对应关系以及解压前的准备2.1 先认版本Athens 后缀不是随便写的Delphi 12 的 IDE 版本代号是 Athens安装目录里的产品版本号是 23.0。编译器生成的 .dcu 和 .bpl 都带有与 IDE 版本绑定的信息也就是说 Delphi 1122.0编出来的 dcu拿到 Delphi 12 下通常直接不能认反过来也一样。EhLib 压缩包文件名里的 Athens 后缀明确定位到 Delphi 12 配套编译这是动手前第一个要确定的信息。所以在动手之前我一般先确认两件事本机安装的 Delphi 是不是 12 Athens机器上是否残留旧版 EhLib 的 bpl/dcu。如果以前装过别的 10.x 版本先把旧包从 Install Packages 列表里移除再进旧版解压目录删掉遗留的 bpl 和 dcu。否则旧文件和新文件混在同一路径下Delphi 会优先加载旧 bpl之后出现「IDE 启动报错」「面板看不到控件」这类问题排查起来非常费时。这一步是装之前的两分钟省不了。另外10.2.42 这个版本号本身也值得看一眼。EhLib 的版本号最后一段通常对应某个 IDE 版本压缩包标题既然写了 Athens就不要再拿它去兼容 Delphi 10.4 或者 11。在 Packages 目录里挑工程文件时也要选带 d12 或 Athens 标识的目录不要因为文件名看着顺眼就直接双击。选错入口后续编译大概率出现版本不匹配报错白白浪费一次编包时间。2.2 解压工具与路径.7z 格式的两个注意点压缩包格式是 .7zWindows 自带的 zip 解压器打不开需要先安装 7-Zip 这类支持 7z 的工具。这个工具装好后我习惯用命令行解压而不是右键菜单因为可以顺带指定输出目录避免解压到一半发现目录不对再挪。下面这条 PowerShell 命令可以直接在文件所在目录执行 C:\Program Files\7-Zip\7z.exe x EhLib VCL 10.2.42 for Delphi 12 Athens.7z -oD:\Dev\EhLib\10.2.42 -y提示如果 7-Zip 已经加入了系统 PATH可以把前半段换成7z x-o后面直接跟目标目录注意-o和路径之间不要有空格。参数说明x表示解压并把目录结构保留下来-o指定解压目标目录-y表示遇到同名文件自动覆盖省得中途停下问。选目录时我习惯用不含空格的纯字母路径比如D:\Dev\EhLib\10.2.42后面配环境变量、写批处理脚本都能少很多转义问题。如果解压完成后发现文件名乱码多半是压缩包内部使用了 UTF-8 编码重新加开关解压即可7z x 压缩包名 -o目标目录 -scsUTF-8。解压完成后先不要急着打开 Delphi先确认文件没有损坏。7-Zip 会在解压结束时报告错误如果出现 CRC Error说明压缩包下载不完整需要重新下载而不是继续强行编译。2.3 解压后先看目录布局再决定从哪个文件开始EhLib 这类大型控件包解压后通常不是一盘散沙根目录下会有 Source、Packages、Bin、Demos 这些标准目录。这些目录各管一摊Source 是所有单元的源码编译时用来查找 .pasPackages 里是各 IDE 版本对应的包工程dpk/dproj/groupprojBin 是编译输出目录bpl 和 dcu 会按 Win32/Win64 分目录落到这里Demos 里是官方示例工程可以用来验证网格功能是否正常。我一般会先列一下目录确认入口文件的位置Get-ChildItem -Path packages -Recurse -Filter *.groupproj | Select-Object -ExpandProperty FullName winget list --name 7-Zip第一条命令用来找包组工程文件第二条顺手确认本机 7-Zip 装了哪个版本。找到 .groupproj 之后再确认 Packages 目录里有没有带 d12 或 Athens 标识的子目录这个子目录才是 Delphi 12 真正要用的包工程集合。这一眼扫完后面的编译入口就清楚了。目录结构看明白再进 IDE 配参数会顺很多。3. 路径规划与 IDE 参数配置Library Path、输出目录和包命名3.1 为什么必须单独开一个目录Delphi 装控件最常见的错误之一是图省事直接把解压出来的源码丢进 Delphi 自带的 Library 目录或者把包文件的输出目录指向 IDE 安装目录。这样做的坏处在装单个简单控件时还不明显装 EhLib 这种多包组件时就会爆发十几个包编译出来的 bpl 和 dcu 全堆在一起分不清哪些是 Delphi 自己的、哪些是控件包的以后升级版本时根本没有干净的下手点只能靠手动删文件碰运气。我这里的固定做法是把 EhLib 按版本单独放一个目录比如D:\Dev\EhLib\10.2.42版本号写进目录名。这样做有三个直接好处卸载时直接删目录再移除 IDE 里的 Library Path 就能恢复原状同一台机器上需要对比新旧版本时两个版本目录互不干扰所有配置都基于这个根目录换一台电脑复现环境只需要把根目录换成同样结构。另一个顺手要做的事是确认解压目录下没有之前残留的输出文件。如果压缩包自带的 Bin 目录里已经有 bpl 和 dcu我通常会先删掉再自己编译保证最终装进 Delphi 12 的文件是当前机器当前编译器生成的而不是作者用别处编译好的产物拿过来凑数。自己编译一遍也能顺手验证编译器环境本身没有毛病比拿现成二进制直接跑更稳。3.2 用一个环境变量统一根路径接下来要把刚才规划的目录固化到 Delphi 12 里。我不建议在各个项目的 Search Path 里直接写死D:\Dev\EhLib\10.2.42这种绝对路径而是先给 IDE 配一个宏变量EHLIB_ROOT以后所有路径都用$(EHLIB_ROOT)开头。这样做的原因很简单以后升级版本只需要把宏改成D:\Dev\EhLib\10.2.43之类所有项目里的路径引用一起生效不用在一个一个工程里翻。在 Delphi 12 中的配置入口是 Tools Options IDE Environment Variables在 User Overrides 区域新建变量名字填 EHLIB_ROOT值填解压根目录EHLIB_ROOT D:\Dev\EhLib\10.2.42提示Delphi 12 的 IDE 环境变量改完后新的宏一般在下次解析项目时生效如果担心不生效直接重启一次 IDE 最省心。配置完宏之后在 Tools Options Language Delphi Library 里把它用起来。Library 页面顶部有 Platform 下拉框默认显示的是当前活动平台的路径列表。这里要特别说一句Delphi 的 Library Path 是分平台保存的Win32 和 Win64 各自有一份你要在两个平台下都配置一遍只配一个平台的话另一平台编译时会找不到文件。这是后面最常见的翻车点第 5 章会专门展开。3.3 Win32 与 Win64 的 Library Path 各配一次输出目录也分开我按下面的表格配置两个平台表格里的路径是实际要填进 Delphi 12 IDE 里的内容平台Search / Library Path 内容作用Windows 32-bit$(EHLIB_ROOT)\Source; $(EHLIB_ROOT)\Bin\Win32编译时找 .pas 源码和 .dcu 产物Windows 64-bit$(EHLIB_ROOT)\Source; $(EHLIB_ROOT)\Bin\Win64编译时找 .pas 源码和 .dcu 产物Source 目录写在前面是因为编译器查找单元时按路径顺序来源码能找到的地方即使 dcu 版本稍微过期也会触发重新编译。把源码路径放前面能减少很多「装了新版 dcu 却还在用旧编译结果」的怪问题。Bin 下的 Win32/Win64 两个子目录是编译输出目录两类平台的 dcu 物理隔离互不覆盖。接下来确认包的输出目录。编译 .dpk 时包项目的 Output directory 决定 bpl 和 dcu 生成到哪里。我一般会在包项目的 Project Options Delphi Compiler 里把 Unit output directory 设为$(EHLIB_ROOT)\Bin\$(Platform)Package output directory 也设成同一个根目录模式这样两平台的 bpl 会自动落进对应子目录。设置时注意$(Platform)是 Delphi 在编译时自动替换的平台宏Win32 平台生成时替换为 Win32Win64 平台替换为 Win64不需要手工改路径。这一步做完编译前的环境准备就齐了。配置原理其实很简单Search Path 负责「找得到」Output Directory 负责「放得准」环境变量负责「换版本时改一处就够」三个环节互相配合后面编译才不会出现路径类报错。4. 编译与注册从 .groupproj 到设计时包安装4.1 用包组项目编译省去手工排依赖EhLib 给 Delphi 12 准备的包不是一两个文件而是一组互相依赖的包工程。依赖关系靠人手工排序很容易弄反所以我每次都直接用包组项目.groupproj来编译。这个文件相当于一个编译任务清单里面通过 ProjectReference 声明好了各包的先后顺序Delphi 会从底层通用包开始逐一把上层依赖包编译出来。打开方式有两种直接在 Delphi 12 的 Project Manager 里 Open Project定位到 packages 目录下那个 .groupproj或者双击文件让 IDE 自动打开。打开之后在 Project Manager 里能看到一组子项目不要单独双击某个 dpk 去编译直接在根节点右键选择 Build。这一步会把整个包组按依赖顺序编译一遍生成对应的 bpl、dcu 和 bpi。第一次编译需要的时间取决于机器一般在几十秒到几分钟不等。过程中注意输出窗口里有没有出现Unable to open file xxx.dcu这类提示如果出现先按第 3 章的配置检查 Library Path 是否真的生效再重新编译。还有一种常见情况是 IDE 报找不到编译器输出的中间路径多半是包项目的输出目录没有按第 3 章设置改成$(EHLIB_ROOT)\Bin\$(Platform)就能解决。4.2 安装设计时包面板上能不能出现 TDBGridEh就看这一步包组编译完成后要区分两类包运行时包Runtime package和设计时包Design-time package。运行时包的作用是为程序运行提供组件逻辑它不需要注册进 IDE只要编译输出到正确目录即可设计时包则负责把控件注册到组件面板上比如让 TDBGridEh 出现在 Tool Palette 里这一步必须手动操作。进入 Component Install Packages点击 Add定位到 Bin\Win32 目录。设计时包的辨识方法很简单文件名里一般带 Dsgn 或 Design 字样比如EhLibDsgn.bpl这一类。选中能让面板出现 EhLib 网格控件的那个包确认后加入列表。加入成功后组件面板里会新增对应页面快速过滤栏输入 DBGridEh 就能找到。这里有一个容易弄混的点如果你把运行时包也顺手 Add 进 Install PackagesIDE 不会报错但重启 IDE 时偶尔会出现重复加载或加载失败的问题。我自己的规则是 Install Packages 里只放设计时包运行时包一律放在 Library Path 里让编译器去引用。编译出来的 bpl 数量多也不要都塞进去否则卸载和排查都会乱。4.3 用命令行编译做两平台核对IDE 里点一次 Build 只编译当前平台。装了 EhLib 之后项目经常要在 Win32 和 Win64 两个平台下切换我一般会在 GUI 编译完 Win32 之后再用命令行把 Win64 也编一遍这样两边产物都齐后面切平台就不会临时补编。这里的关键是先用 rsvars.bat 加载 Delphi 12 的环境变量再调用 MSBuild 编译包组项目echo off call 你的Delphi12安装目录\bin\rsvars.bat cd /d D:\Dev\EhLib\10.2.42 set EHLIB_PROJ你的包组项目相对路径.groupproj MSBuild.exe %EHLIB_PROJ% /t:Build /p:ConfigRelease /p:PlatformWin32 /flp:logfilebuild-win32.log;verbositynormal MSBuild.exe %EHLIB_PROJ% /t:Build /p:ConfigRelease /p:PlatformWin64 /flp:logfilebuild-win64.log;verbositynormal提示rsvars.bat 一般在 Delphi 12 安装目录下的 bin 目录里不同机器安装位置可能不同用资源管理器搜索 rsvars.bat 就能定位。如果执行时提示找不到 MSBuild.exe先where msbuild确认一下工具所在目录。关于命令参数的说明/t:Build是 MSBuild 的目标执行编译构建/p:ConfigRelease指定 Release 配置发布环境用 Release 更合适/p:PlatformWin32或Win64指定目标平台/flp是把编译日志写入文件格式是logfile文件名;verbositynormalnormal 级别日志能保留大部分关键信息又不会像 detailed 那样刷屏。编译结束后查看 build-win64.log 的结尾如果出现 Build succeeded说明两平台产物都齐了。命令行编译还有一个 IDE 没有的好处日志可留存。哪次编译失败直接打开日志文件搜索 error比在 IDE 输出窗口里翻找更高效。这也是我做环境部署的习惯凡是多包编译一定留一份日志后面出了问题可以回看不用靠记忆。5. 避坑记录五个我实际踩过的 EhLib 安装坑5.1 组件面板上没有 TDBGridEh现象是包组编译成功、Install Packages 也加入了 bpl但在 Tool Palette 的搜索框里输入 DBGridEh什么都搜不到。原因基本只有一个加进 Install Packages 的是运行时包不是设计时包。运行时包负责组件逻辑不负责把控件注册到面板上没有设计时包Delphi 就完全不知道这个组件存在于系统中面板自然不会显示。解决方法是回到 Bin\Win32 目录下找到文件名里带 Dsgn / Design 字样的 bpl在 Component Install Packages 里点 Add 把它加进去。加入完成后如果面板还没刷新在 Palette 任意区域右键选择 Reset Palette或者重新打开 IDE。以后再遇到「装完看不见控件」先检查是不是包类型搞错了比卸载重装快得多。5.2 Win32 编译正常切 Win64 报 Unable to open file xxx.dcu现象是当前项目在 Win32 平台编译顺利切到 64-bit Windows 平台再编译立刻报错找不到 xxx.dcu其中 xxx 往往正好是 EhLib 的某个单元。原因是 Delphi 12 的 Library Path 按平台各存一份我在第 3 章里强调过这一点。Win32 平台下配置的路径不会自动带到 Win64 平台切到 64 位编译时编译器不知道去哪里找 EhLib 的源码和 dcu。解决方法是打开 Tools Options Language Delphi Library把 Platform 下拉框切到 64-bit Windows把第 3 章表格里那几条路径重新加一遍再重新编译。为了避免手工漏配我后来都是直接在命令行里把 Win32 和 Win64 两个平台各编一次两边产物都生成了再回 IDE 里核对一次路径基本不会漏。5.3 单独双击 dpk 编译连环报错现象是不从 .groupproj 执行 Build而是在 packages 目录里挑一个 dpk 文件直接右键编译结果报出一串找不到单元、找不到包的错误而且源源不断。原因是包组里的子包之间存在编译依赖底层包没有先编译出来上层包自然找不到对应单元。Delphi 对单独打开并编译的 dpk 不会主动去编译它的前置依赖包必须通过包组项目的 ProjectReference 关系来串联。解决办法就是回到 .groupproj 上编译让 IDE 或 MSBuild 按依赖顺序处理。如果确实只想编译其中某一个包也不要直接打开 dpk而是在包组项目里找到该子项目再右键 Build这样前置依赖会被一并处理。这个坑我踩过一次之后再也不碰单独编译 dpk 的路径了。5.4 IDE 启动时弹 Cant load package现象是安装完成后每次启动 Delphi 12 都会弹出一个错误框提示 Cant load package xxx.bpl找不到指定的模块关掉错误框后 IDE 还能用但某个组件面板偶尔消失。原因多数是机器上以前装过旧版 EhLibIDE 的 Known Packages 注册表里残留了旧 bpl 的路径信息。新版本装好之后旧路径指向的文件已经被删除或改名Delphi 启动时按注册表逐条加载遇到不存在的就弹错。处理方法是打开 Component Install Packages把列表中旧版本相关的条目逐一 Remove然后重启 IDE。如果重启后还弹同样的错误说明注册表里残留了重复或无效条目我一般会在注册表编辑器里定位到 IDE 版本对应的 Known Packages 键手动删掉包含旧路径的项不过大多数时候在 Install Packages 界面里清理就已经有效。顺手把旧版目录里的 bpl 和 dcu 也删干净避免以后加载时又找到错的文件。5.5 老项目迁移到 Delphi 12搜索路径还指向旧版目录现象是从老环境迁移过来的项目在 Delphi 12 里编译时找不到 EhLib 单元或者提示某个 dcu 版本不兼容但项目明明已经在新环境里配置过了。原因是老项目的 Project Options 里通常写死了旧版 EhLib 的绝对路径比如D:\Legacy\EhLib\Source。Delphi 12 打开旧项目时不会自动改写这些路径编译时就用旧路径去查找源码自然找不到或者找回的是旧版本源码与新版混合使用产生冲突。解决方法是把项目属性里的 Search Path 改成统一宏$(EHLIB_ROOT)\Source再确认EHLIB_ROOT在 IDE 环境变量里已配置好。同时把项目中所有直接指向旧版目录的引用删掉重新编译。我装新版控件时会顺手搜索所有迁过来的 .dproj 文件里的旧路径一次替换干净省得每个项目单独排查。6. 验证跑通从新建 VCL 工程到拖出第一个 TDBGridEh装完控件最怕的是「以为装好了一编译就露馅」。我的做法是固定用一套最小流程验证整个过程不到十分钟。第一步File New VCL Application新建一个 Delphi for Win32 的 VCL 窗体程序。第二步在 Tool Palette 快速过滤里输入 DBGridEh把 TDBGridEh 拖到窗体上如果拖不出来回到第 5 章第 1 条检查设计时包。第三步从面板里拖一个 TDataSource 和一个 TClientDataSet或者 TFDMemTable到窗体设置好 FieldDefs 和几个字段把 DataSource.DataSet 绑定到数据集TDBGridEh.DataSource 绑定到 DataSource并在数据集上设置 Active 为 True。第四步按 F9 运行程序窗体上能看到网格里的数据说明最基础的编译、运行时包加载都通过了。接下来验证 EhLib 的标志性功能在窗体上选中 TDBGridEh把 FooterRowCount 设为 1设计期右键网格调出 Columns Editor给某一列设 Footers运行程序看底部是否出现合计行。如果这一项正常说明设计时包注册到位组件属性面板和运行时行为都正确。再切到 64-bit Windows 平台编译运行一次这一步同时验证了第 3 章里两平台路径是否配齐——我就在这一步上翻过车。有条件的话再试一下导出功能// 运行时导出验证方法名以当前版本的 IDE 代码提示为准 procedure TForm1.btnExportClick(Sender: TObject); begin DBGridEh1.SaveToXLSX(D:\temp\grid_export.xlsx); end;提示D:\temp 目录要先创建否则导出会因路径不存在报错如果 IDE 提示找不到 SaveToXLSX输入DBGridEh1.看自动完成的导出方法列表选 XLS 或 XLSX 对应的那个即可。从那时起我每次在新环境装完 EhLib 都强制自己走一遍这四步新建工程、拖动控件、运行看数据、切 64 位再编译。这套动作基本能把环境问题暴露在十分钟之内而不是等项目开发到一半再来排查控件装没装好。希望这篇安装笔记能帮你在第一次装的时候就把弯路绕开压缩包就在标题给出的下载入口里取回来照着第 2 章到第 6 章的顺序走比装完再猜快得多。本文还有配套的精品资源点击获取