简介Raize_6.1.1.12_DX10_1_Berlin_cocashu修正版面向使用Delphi/CBuilder进行RAD桌面开发的工程师尤其适合在Berlin版本下集成Raize组件库时遇到编译障碍的开发者。该版本针对原包中pas文件错误导致编译不通过的问题做了修正并已调整好配置文件解压至C:\Program Files\Raize\后执行RC6\Source目录下的!Build_RC6.cmd即可完成构建省去手动排查源码错误的麻烦。压缩包共956个文件约10.74MB以hpp头文件、dcu编译单元、bmp位图、pas源码、dfm窗体文件及res资源为主另含inc、dpk、bpl、dproj等工程与包文件覆盖组件源码、图标素材与安装脚本结构完整。目前已有329人学习下载适合需要快速搭建Raize开发环境、研究组件源码实现或修复编译问题的中高级开发者参考使用。1. 拆开这个标题一个 Delphi 老项目的版本号里藏着什么拿到Raize_6.1.1.12_DX10_1_Berlin_cocashu修正版这个标题第一反应不应该是“这是个什么软件”而是先做一次版本号解剖。Raize 是 Delphi 生态里一套老牌 VCL 控件包6.1.1.12 是它的版本序列DX10 对应 Delphi 10 的代号Berlin 是 Delphi 10.1 的官方代号cocashu 修正版说明这是社区里某位开发者针对原始包做的兼容性修补。把这几个字段拆开之后整个标题的含义就清楚了这是一份在 Delphi 10.1 Berlin 环境下、经过社区修正、能正常编译安装的 Raize 控件包。为什么这件事值得单独写一篇落地笔记因为 Delphi 10.1 Berlin 是 2016 年前后的版本而 Raize 原始安装包在那个时期对 Unicode 字符串处理、包引用路径、编译指令都存在不同程度的适配问题。很多做桌面端维护的团队手上跑着五六年前的业务系统IDE 版本锁死在 Berlin控件包又必须用 Raize 的网格、工具栏和编辑器组件。直接装原版十有八九在编译期就报一堆E2003 Undeclared identifier或者F2613 Unit not found。修正版的价值就在这里——它把已知的编译断点提前补掉了。这篇文章面向两类人一类是刚接手老 Delphi 项目、需要把 Raize 跑起来的新手另一类是在 Berlin 环境下反复装包失败、想搞清楚到底改了什么的熟手。接下来的内容会从环境准备讲到包安装、从编译参数讲到实际踩坑每一步都给出可复现的操作和判断依据。2. 在 Berlin 里把 Raize 装进 IDE从目录结构到包编译2.1 先搞清楚修正版和原版的目录差异拿到修正版之后不要急着双击安装程序。先解压到一个纯英文、无空格的路径下比如D:\Components\Raize_6112_Berlin。路径里有中文或空格Delphi 的包编译器在解析Library Path时会出现路径截断这是血泪经验。解压后对比原版目录修正版通常会在以下几个位置做改动目录/文件原版状态修正版改动Source\下的.pas文件部分单元使用Char类型做索引改为Integer或NativeInt适配 Berlin 的 Unicode 编译器.dpk包定义文件requires段引用旧版 rtl/vcl更新为 Berlin 对应的rtl.dcp、vcl.dcpLib\下的预编译 DCU可能混入 XE 时代的 DCU清空或替换为 Berlin 编译产物Packages\下的.dproj编译目标平台为 Win32增加 Win64 目标或修正DCC_Namespace判断修正版是否靠谱有一个简单方法用文本编辑器打开RaizeComponents.dpk看requires段里有没有rtl、vcl、vclx这些基础包以及contains段里的单元路径是否和实际文件对得上。如果contains里写的单元在Source目录下找不到说明这个修正版本身就不完整。2.2 用命令行编译包比 IDE 里点鼠标更可控很多人习惯在 IDE 里打开.dpk然后点 Compile。但在 Berlin 里IDE 的包编译有时会缓存旧的 DCU导致“明明改了代码却还是报同样的错”。更稳的做法是用命令行调dcc32或dcc64。先确认 Berlin 的编译器路径一般在C:\Program Files (x86)\Embarcadero\Studio\18.0\bin下。然后写一个编译脚本echo off set BDSC:\Program Files (x86)\Embarcadero\Studio\18.0 set DCC%BDS%\bin\dcc32.exe set RAIZED:\Components\Raize_6112_Berlin REM 先编译运行时包 %DCC% -B -Q -W -H -NSSystem;Vcl;Vclx;Winapi ^ -I%RAIZE%\Source ^ -LE%RAIZE%\Lib ^ -LN%RAIZE%\Lib ^ -O%RAIZE%\Lib ^ -U%RAIZE%\Source ^ %RAIZE%\Packages\RaizeComponents.dpk REM 再编译设计期包 %DCC% -B -Q -W -H -NSSystem;Vcl;Vclx;Winapi ^ -I%RAIZE%\Source ^ -LE%RAIZE%\Lib ^ -LN%RAIZE%\Lib ^ -O%RAIZE%\Lib ^ -U%RAIZE%\Source ^ %RAIZE%\Packages\RaizeDesign.dpk这段脚本的关键参数说明-B强制全量编译避免增量编译带来的缓存问题-Q安静模式只输出错误和警告-H生成 DCU 时使用短文件名减少路径过长导致的失败-NSSystem;Vcl;Vclx;Winapi指定命名空间Berlin 的编译器需要这个才能正确解析System.SysUtils这类单元-LE、-LN、-O分别指定 exe、dcu、obj 的输出目录统一放到Lib下方便后续引用。编译过程中如果报F1026 File not found: System.dcu说明-NS后面的命名空间没写全或者 Berlin 的rtl.dcp路径没被正确识别。这时候检查BDS环境变量是否指向了正确的 Studio 版本目录。2.3 在 IDE 里注册设计期包并验证组件面板命令行编译通过后打开 Berlin走Component→Install Packages→Add选择RaizeDesign.bpl。添加成功后组件面板上应该出现Raize标签页里面有RzButton、RzGrid、RzToolbar等组件。如果面板没出现先检查RaizeDesign.bpl是否真的编译出来了再看 IDE 的Library Path里有没有把Lib目录加进去。Berlin 的 Library Path 在Tools→Options→Environment Options→Delphi Options→Library下分Win32和Win64两个平台分别设置。修正版通常只保证 Win32 编译通过Win64 需要额外确认。验证安装是否成功最直接的方法是新建一个 VCL Forms Application从面板上拖一个RzButton到窗体上然后按 F9 运行。如果编译通过且按钮正常显示说明运行时包和设计期包都注册到位了。如果运行时报Class not registered或Error reading RzButton1.Enabled多半是运行时包的 BPL 没有被正确加载检查RaizeComponents.bpl是否在系统 PATH 或 IDE 的Bpl输出目录下。3. 修正版到底修了什么四个高频编译断点与对应改法3.1 Unicode 字符串索引类型不匹配Berlin 的编译器对string的索引类型检查比 XE2 更严格。原版 Raize 里有些代码写成for I : 1 to Length(S) do然后直接用S[I]访问当S是AnsiString时没问题但 Berlin 默认string是UnicodeString索引类型是Integer而某些旧代码里I被声明为Byte或Word就会报E2010 Incompatible types: Integer and Byte。修正版的做法通常是把循环变量统一改成Integer或者在访问前做显式类型转换。如果你手上拿到的修正版没有改全可以自己搜Source目录下的.pas文件找Length(附近的循环变量声明把Byte、Word、SmallInt改成Integer。3.2 包引用路径中的相对路径失效原版.dpk里经常写contains ..\Source\RzButton.pas这种相对路径。在 Berlin 里如果从命令行编译工作目录和.dpk所在目录不一致相对路径就会解析失败报F1026 File not found。修正版一般会把contains段里的路径改成相对于.dpk文件的路径或者干脆去掉路径前缀只写单元名然后靠-U参数指定搜索目录。判断方法打开.dpk看contains段里有没有..\。如果有要么改成绝对路径要么在编译脚本里把工作目录切到.dpk所在目录。3.3 设计期包对 IDE 版本的硬编码检查有些 Raize 版本的设计期包在Register过程里会检查(BorlandIDEServices as IOTAServices).GetEnvironmentOptions的版本号如果发现 IDE 版本不在白名单里就直接抛异常或者静默不注册组件。Berlin 的 IDE 版本号是 18.0修正版需要把这个检查放宽或者去掉。具体位置一般在RaizeDesign.dpk对应的RzDesignReg.pas里搜GetBaseRegistryKey或IDEVersion关键字。如果修正版没处理这里组件面板会显示空白但编译不报错这种“玄学”问题最难查。3.4 Win64 目标下的指针截断如果项目需要编译 Win64原版 Raize 里有些地方把Pointer强制转换成Integer在 Win32 下没问题Win64 下会报E2010 Incompatible types: Integer and Pointer。修正版的做法是把Integer改成NativeInt或IntPtr。检查方法在Source目录下搜Integer(和Pointer(同时出现的行重点看类型转换和Move、FillChar这类内存操作的参数。如果修正版只保证 Win32Win64 需要自己补这些类型转换。4. 避坑与排查装包过程中最容易翻车的五个点现象一编译时报F2613 Unit RzCommon not found。原因Library Path里没有加入Source目录或者加入的路径和实际解压路径不一致。 解决在 IDE 的Library Path里显式添加D:\Components\Raize_6112_Berlin\Source并确保该路径下确实存在RzCommon.pas。如果路径没问题但还是报错检查RzCommon.pas的编码格式Berlin 对 UTF-8 无 BOM 的文件有时会解析失败用记事本另存为 ANSI 或带 BOM 的 UTF-8 再试。现象二组件面板出现 Raize 标签页但里面是空的。原因设计期包注册失败通常是 IDE 版本检查没通过或者RaizeDesign.bpl依赖的运行时包没有先加载。 解决先确认RaizeComponents.bpl已经在Install Packages列表里并且勾选启用再检查RaizeDesign.bpl的依赖项。如果还是空用tdump或Dependency Walker看RaizeDesign.bpl的导入表确认它引用的RaizeComponents.bpl路径正确。现象三拖放组件到窗体后运行时提示Class TRzButton not found。原因运行时包的 BPL 没有被应用程序加载或者应用程序的搜索路径里没有RaizeComponents.bpl。 解决在项目选项的Packages里勾选RaizeComponents或者在Run→Parameters里把Lib目录加到系统 PATH。更彻底的做法是把RaizeComponents.bpl复制到和 exe 同级的目录下。现象四编译通过但运行时网格控件显示空白或列头错位。原因修正版可能只改了编译期兼容性没有处理 Berlin 下 VCL 主题和 DPI 缩放的变化。 解决在窗体OnCreate里显式设置RzGrid.DefaultRowHeight和RzGrid.Font.PixelsPerInch或者在项目 manifest 里关闭 DPI 感知。如果用的是 Berlin 默认主题尝试把RzGrid的Style属性从tsCustom改成tsStandard。现象五安装后 IDE 启动变慢或者关闭时卡死。原因设计期包在Finalize阶段没有正确释放资源或者注册了多余的 IDE 通知。 解决在RaizeDesign.dpk的Finalization段里检查是否有UnregisterComponentEditor或RemoveEditor没配对。如果修正版没处理可以临时在 IDE 的Tools→Options→IDE里关闭“自动加载设计期包”改成手动按需加载。5. 让修正版真正可维护版本锁定与增量升级的实操习惯装好只是第一步真正让这套东西在团队里可维护需要做两件事版本锁定和增量升级记录。版本锁定指的是把修正版的完整目录、编译脚本、IDE 版本号、编译日期写进一个BUILD_NOTES.md和项目源码一起提交到版本控制。不要只存一个 BPL 文件因为 BPL 和 DCU 的兼容性窗口很窄换一台机器、换一个 IDE 补丁号就可能重新编译失败。我一般会在BUILD_NOTES.md里记录这几项记录项示例值作用Raize 版本6.1.1.12和原版对齐方便查差异修正版来源社区修正基于 Berlin 18.0说明适配的 IDE 版本编译命令dcc32 -B -Q -NS...复现编译环境已验证平台Win32明确未验证 Win64已知问题网格控件 DPI 缩放异常提醒后续维护者增量升级记录指的是每次对修正版做改动时不要直接覆盖原文件而是把改动点写成 patch 或者 diff放在Patches目录下。比如这次改了RzGrid.pas里的 DPI 处理就生成一个RzGrid_dpi_fix.patch下次换新版本时先尝试应用 patch而不是重新手工改一遍。这样做的好处是当 Raize 出了 6.2 或者团队升级到 Delphi 11 时你能快速判断哪些修正还需要保留、哪些已经被官方修复。还有一个习惯在 IDE 里装好包之后立刻新建一个最小验证项目只放一个RzButton和一个RzGrid编译运行一次把 exe 和截图存档。以后任何人说“Raize 装不上”先让他跑这个最小项目能排除掉 80% 的项目配置问题。最后说一个我自己的教训。早期我图省事直接把修正版的Lib目录整个拷给同事结果他的 Berlin 是 18.0 Update 1我的是 18.0 原版DCU 版本不匹配他那边一编译就报F2063 Could not compile used unit。后来我改成只给源码和编译脚本让每个人在自己机器上编译一遍反而再没出过这个问题。控件包这种东西二进制产物永远不如源码加脚本可靠。希望帮到你。本文还有配套的精品资源点击获取