Raize 6.1.1.12修正版：Delphi 10.1 Berlin老项目迁移的组件兼容指南

简介Raize 6.1.1.12 DX10.1 Berlin 修正版是一份经典原生 VCL 控件库安装包面向使用 RAD Studio Berlin 10.1 的中高级 Delphi 开发人员可用于窗体界面增强、工具栏、对话框等常见 UI 模块开发。原版存在的 pas 源码错误会导致编译不成功本修正版已针对相关源文件修复并同步调整好配置文件。配置上已按可用方式调好解压至 C:\Program Files\Raize\ 后运行 RC6\Source 目录下的 !Build_RC6.cmd 即可完成编译作者亲测可用省去手动排查 pas 的麻烦。rar 压缩包内共 956 个文件大小约 10.74MB主要文件类型包括 hpp 头文件、dcu 编译单元、pas 源码、dfm 窗体、bmp 位图资源、res 资源文件等兼顾头文件、源码、界面定义与运行资源同时附带安装说明文本和 dpk 工程文件便于按需编译与二次定制整体体积小巧适合离线留存与团队内部分发。目前已有 328 人学习下载适合需要快速搭建 Raize 组件开发环境、又不愿受编译细节困扰的项目团队与个人开发者收藏备用。1. Raize 6.1.1.12 修正版Delphi 10.1 Berlin 老项目迁移的第一块拼图老 Delphi 项目升级到 10.1 Berlin 时第三方组件往往是最先翻车的那一批而 RaizeRz 系列又是名单里出现频率最高的一个。标题这串命名里6.1.1.12 是组件版本号DX10_1 是这个发布者对 Delphi X 10.1 的简写标注Berlin 指 10.1 这个 IDE 版本cocashu 修正版则表明这包组件在原版基础上被人重新处理过。对拿到这包东西的人来说真正要搞清楚的是三件事它修了什么、怎么装才不会污染现有环境、装完怎么判断它运行期没给你留后患。这篇文章按这个顺序展开最后给一套能直接用的验证手段。2. 搞懂 Raize 版本号DX10_1 的含意与兼容边界2.1 版本号里的三块信息主版本、IDE 代号与发布者标记Raize 6.1.1.12 里的四段编号前两段是产品主版本和次版本后两段是维护序号。6.x 属于 Raize 在 Delphi XE 时代到 10.x 时代广泛使用的经典分支网上能找到的安装包基本都是这个系列。真正容易被误读的是 DX10_1。很多人第一眼会想到 DirectX 10.1但 Raize Components 是纯 VCL 控件库业务上和 DirectX 没有任何交集。这里的 DX10_1 更合理的解释是资源站约定俗成的简写Delphi X 10.1也就是 Delphi 10.1 Berlin。你可以把它理解为发布者自己的命名习惯官方不会这么叫。Berlin 是 Delphi 10.1 的 IDE 版本代号编译器版本对应的是 dcc32 的 27.x 系列。判断一个 Raize 包是否匹配当前 IDE最直接的办法不是看标题而是看包文件里的 .dproj 或 .dpk 头部的条件编译注释。标题末尾的 cocashu 是发布者标识它的意义仅在于告诉你这不是原厂光盘内容而是经过第三方重新整理过的副本。2.2 原版在 Berlin 下的兼容问题与常见修正方向Raize 6.x 官方适配的 IDE 版本跨度很大从 Delphi 2009 一路覆盖到 10.3 甚至更高。但在 Berlin 这个具体版本上原版安装包经常遇到两类问题一是设计期包编译时报资源冲突二是运行期包能编译但设计期组件图标变空白。这些问题的根源并不复杂Raize 的老式注册单元里硬编码了一些 IDE 内部接口的偏移或过时的运行时行为Berlin 的 IDE 面板机制做了调整后老代码就走不到正确的注册分支。修正版最常见的处理方向有三块。第一块是注册单元把 RegisterComponents 的过程改成 Berlin 兼容的写法同时补上缺失的设计期图标引用。第二块是包依赖声明原版 .dpk 里可能引用了已经更名的系统包修正版会把依赖统一改到 Berlin 实际提供的运行时包上。第三块是条件编译分支老代码里用于兼容旧 IDE 的 ifdef 分支在新版本上不再触发修正版会重新调整这些宏的取值。注意这些属于这类修正包的普遍做法具体某一版改了什么你需要通过对比包内源码和原版文件才能精确确认。2.3 为什么停留在 6.1.1.12 而不升级到更新版本一个项目如果已经用 Raize 写了一年以上的业务界面升级组件版本往往比升级 IDE 还痛苦。Raize 6.x 后续维护版在属性默认值和绘制行为上有过调整尤其是焦点框、边框颜色、表格控件的行高计算。这些细微差异平时看不出来但老项目里只要有几个界面是依赖旧默认值微调过的升完级就是一片细碎的界面回归。标题这个修正版存在的价值恰恰在这里它在 6.1.1.12 这个老版本基础上修复新 IDE 的适配问题而不是让你换一套新组件去重构界面。另一个现实约束是团队经验。老项目组成员脑子里都有 Rz 组件的属性记忆换新版本或者换新控件库意味着属性查表、事件签名、默认行为全部要重新学。对于一个以维护为主的业务系统这成本不划算。所以只要修正版能稳定编译、运行期表现与原版一致停留在 6.1.1.12 就是性价比最高的选择。判断标准就一条它能让你在 Berlin 里打开老窗体不报错、不改属性、编译通过那就够了。3. 在 Berlin 里装好修正版从备份到编译成功的完整流程3.1 安装前三个必须做的检查拿到 Raize_6.1.1.12_DX10_1_Berlin_cocashu修正版之后别急着双击安装脚本。先做三件事。第一确认 IDE 的实际版本号Delphi 10.1 Berlin 也有 Update 1 和 Update 2 的区别打开 IDE 的 About 对话框看更新版本这决定后面条件编译的宏是否需要手动调整。第二检查系统里是否已经装过其他版本的 Raize如果之前装过 6.0 或 6.1 的其他修正包先通过 IDE 的 Component 菜单卸载旧包再手工删除旧 BPL、DCP、DCU 文件否则两个版本的单元会互相污染。第三确认安装目录路径。路径这点很多人不在意但 Raize 坑就坑在这里。安装目录不要带空格不要带中文不要放到系统盘的 Program Files (x86) 默认目录里。常见做法是放到D:\Components\Raize这类干净的根路径下。原因倒不是组件本身有多娇贵而是老式组件包的源码搜索路径里空格和中文字符在 IDE 的 Path 解析里容易出现截断问题一旦出现编译报错的提示往往指向完全不相关的系统单元排查起来很浪费时间。我一般会专门建一个D:\Components目录所有第三方控件都按厂商_版本分文件夹管理每个版本独立一份互不覆盖升级回退都有后悔药可吃。3.2 编译设计期包命令行方式与参数说明Raize 的包分为运行期包和设计期包两类。先编译运行期包再编译设计期包最后在 IDE 里注册设计期包。用命令行方式编译的好处是错误信息完整、不依赖 IDE 的缓存而且能记成脚本重复执行。打开一个管理员权限的命令行先导入 IDE 的环境变量set IDE_BINC:\Program Files (x86)\Embarcadero\Studio\18.0\bin call %IDE_BIN%\rsvars.bat cd /d D:\Components\Raize_6.1.1.12 msbuild.exe RzRuntime.dproj /t:Build /p:PlatformWin32 /p:ConfigReleasersvars.bat 是 IDE 自带的批处理它会一次性把 dcc32 编译器路径、系统单元搜索路径等环境变量全部配好。Studio\18.0 对应的是 Delphi 10.1 Berlin如果你本机安装目录不同以实际路径替换即可。RzRuntime.dproj 是运行期包的示例文件名实际以包里文件列表为准可能是其他名字。这一步如果编译通过说明包的源码本身在 Berlin 下没有语法级问题再往下走才是注册环节。运行期包编译通过后接着编译设计期包。设计期包链接了运行期包同时包含 IDE 注册代码和组件图标msbuild.exe RzDesign.dproj /t:Build /p:PlatformWin32 /p:ConfigRelease这条命令结束后在输出目录里会生成对应的 .bpl 和 .dcp 文件。PlatformWin32表示生成 32 位版本Delphi 10.1 里 32 位是设计期强制要求64 位包只用于运行期分发后面单独处理。如果这里报F1026 File not found: RzRuntime.dcu基本是运行期包的 DCU 输出目录没在 IDE 的 Library 搜索路径里回到项目选项里把运行期包输出目录加进去即可。3.3 在 IDE 中注册并验证组件面板命令行编译只是把包造出来了要让组件出现在 IDE 面板上还得注册。打开 Delphi 10.1 Berlin菜单 Component 中找到 Install Packages点 Add定位到刚才生成的 RzDesign.bpl确认后 IDE 会重新扫描包并加载设计期注册单元。这一步完成后工具面板里应该出现一组 Rz 开头的组件页签。注册成功后别急着写业务代码做三个快速验证。第一个验证是在工具栏上右键确认 RzPageControl、RzEdit、RzButton 等常见组件能拖到窗体上这证明注册过程本身没有失败。第二个验证是打开一个已有的老项目窗体如果窗体上原本有 Rz 控件IDE 应该能正常反序列化并显示出来不会弹“找不到类”之类的错误。第三个验证是直接编译这个老项目编译过程不报单元路径错误生成结果能正常运行。三步全部通过安装环节才算真正收尾。提示注册设计期包前最好关闭所有已打开的窗体老工程里如果有同名组件类IDE 在切换包时可能报类名冲突。这种情况不是包坏了是 IDE 缓存没刷新重启 IDE 通常能解决。4. 修正版的核心改动与 Berlin 协同的关键差异4.1 修正版通常动的是哪几类文件拿到修正版之后有人会忍不住把里面所有源文件跟原版做一遍 diff这是一个不错但耗时的工作。更高效的路径是先看三类文件包项目文件.dpk / .dproj、注册单元通常以 Reg 或 Design 开头、资源文件.res。包项目文件的改动优先级最高因为它的依赖声明直接决定编译顺序。如果修正版把原来的contains列表做了调整或者增加/删除了某个单元编译时的依赖链就会完全不一样。注册单元是第二个关注点。Raize 的老注册单元里经常有一段判断 IDE 版本的代码不同版本走不同的注册分支。Berlin 对应的 IDE 内部版本号是 18.0如果修正版没有在注册单元里正确设置这个版本分支就会出现“组件装上了但面板死活不出来”的情况。资源文件的改动则相对隐蔽设计期图标通常打包在 .res 里资源索引与注册单元里的字符串LoadIcon调用对应一旦索引错位图标空白但组件本身能正常拖拽。4.2 与 Berlin VCL Styles 的协同StyleElements 是最大变量Raize 与原生 VCL 控件最大的不同在于它大量自绘。原生 TEdit 的边框和背景由 VCL 统一绘制Raize 控件则接管了大部分绘制逻辑。Delphi 10.1 Berlin 里 VCL Styles 机制已经非常成熟默认情况下 StyleElements 属性里包含 seClient、seBorder、seFont 三项意味着客户区、边框、字体都会被系统样式接管。问题就出在这里Raize 自绘的边框和客户区效果与 VCL Style 的绘制指令叠加后常常出现边框变细、背景色偏灰、焦点框消失这类现象。这不是组件损坏而是两类绘制体系冲突。处理方式是运行期调整 StyleElements移除与 Raize 绘制冲突的选项。下面这段代码递归遍历窗体上的组件把 Rz 编辑类控件的客户区和边框绘制权交还给组件自身procedure ConfigureRaizeStyles(AParent: TComponent); var i: Integer; wc: TWinControl; begin if AParent is TRzEdit then begin TRzEdit(AParent).StyleElements : TRzEdit(AParent).StyleElements - [seClient, seBorder]; end; if AParent is TWinControl then begin wc : TWinControl(AParent); for i : 0 to wc.ControlCount - 1 do if wc.Controls[i] is TWinControl then ConfigureRaizeStyles(wc.Controls[i]); end; end;调用时传入 Form 自身即可ConfigureRaizeStyles(Self)。代码里最关键的是seClient和seBorder两个枚举值的移除它们分别代表客户区背景和边框的样式接管权。移除后 Raize 的绘制代码能完整走自己的逻辑同时字体样式保留seFont这样界面的整体主题风格还能保持一致。如果你项目里用了 VCL Styles 并发现某些 Rz 控件显示不对先按这个思路处理不要急着换组件版本。4.3 运行期行为差异焦点框、DPI 与字体缩放编译层面的兼容只是第一步运行期行为才是真正需要盯的地方。Raize 6.1.1.12 这个分支在焦点绘制上有一个特点获得焦点的编辑框会额外画一圈高亮边框。在 Berlin 默认的字体渲染和 DPI 缩放模式下这圈边框偶尔会出现 1 像素的偏移尤其在窗体从 96 DPI 切换到 120 DPI 之后。这不是修正版引入的问题是组件本身基于老式 GDI 坐标计算导致的。处理办法是关注窗体的 ScaleBy 行为和 PerMonitorDpi 设置确保 Rz 容器控件在 DPI 变化时能拿到正确的客户区尺寸。另一个常见差异是字体缩放。老项目里如果直接给 Rz 控件设置了Font.Size而父窗体启用了AutoSize和ScaledBerlin 下可能出现字体没缩放但控件尺寸缩放了的错位。修正版如果要调整这类行为通常是在发布时间期属性默认值或者覆盖控件的Loaded过程。如果你在跑老项目时发现某个 Rz 控件的文字位置偏移先检查是不是字体名称被替换成了新版本的系统字体Segoe UI 和 MS Sans Serif 的字高差异足够让对齐效果肉眼可见地崩掉。5. 常见问题与避坑从安装到运行你要知道的 5 个坑5.1 编译报错找不到 Rz 相关单元现象打开老项目后编译IDE 直接报Unit RzEdit not found或者E1026 File not found: RzEdit.dcu。原因几乎都是 Library 搜索路径没配好。Raize 的 DCU 输出目录没有自动注册到 IDE 的环境变量里编译器找不到目标文件。解决方式是在 IDE 的 Tools 菜单中找到 Options切到 Library 页把 Rz 包的 DCU 输出目录加进 Library Path。注意运行期包和设计期包的输出目录是分开的两个都要加只加一个会出现在不同 IDE 版本上时而能编过时而编不过的玄学问题。5.2 运行期提示缺少 BPL 包现象程序编译成功但启动时弹窗提示Cannot find RzRuntime.bpl。原因很简单运行期包没有随程序分发。Raize 默认采用动态链接方式运行期 BPL 需要在目标机器上可用。解决方式有两个一是把 RzRuntime.bpl 复制到程序输出目录和 exe 放一起省事直接二是在项目选项里把 Build with runtime packages 的勾去掉改成静态链接这样生成的 exe 不再依赖外部 BPL但体积会明显增大。对于内部工具类程序静态链接更省心少一个环境问题。5.3 设计期图标全空白现象组件面板里 Rz 系列的图标是空的或者拖到窗体上之后IDE 左侧的类树里看不到组件图标。原因几乎可以锁定在资源索引错位。修正版如果重新编译过 .res但注册单元里LoadIcon的资源 ID 与实际情况不一致就会图标丢失。解决方式也直接确认安装包里有没有带原版 .res 备份有就替换回去重新编译注册单元没有的话图标问题可以接受因为这不影响运行期行为只要发布给用户的是 exe 而不是 IDE 包图标空白只是开发环境的观感问题。5.4 64 位目标编译失败现象项目切换到 Win64 平台编译时报E2597链接错误或者提示某些 OBJ 文件与模块不匹配。原因通常是只安装了 32 位版本的运行期包。Delphi 10.1 Berlin 的 64 位编译需要单独的 .dproj 编译产物。解决方式是对每个 Raize 包文件重复一次 64 位编译把msbuild命令里的PlatformWin32换成PlatformWin64然后把 64 位 DCU 输出目录也加到 Library Path 中。这块没有捷径两个平台的 DCU 必须分开产出共用一份 32 位 DCU 去编 64 位程序属于常见的低级翻车。5.5 系统自带主题控件与 Rz 的视觉冲突现象程序在没有启用 VCL Styles 时一切正常一换主题部分 Rz 按钮的背景色、边框和文字颜色表现得像混搭。原因还是第 4 章说的 StyleElements 接管问题。解决方式是项目级统一处理不要在窗体里逐个改属性先在公共基类或框架启动代码里做一次递归遍历统一调整 Rz 控件的 StyleElements。如果你用了我上面的ConfigureRaizeStyles注意它只处理了编辑框一类按钮和工具栏类还需要单独加分支把seFont之外的元素按需移除才能保证主题切换后界面不破相。6. 验证修正版是否靠谱最小复现项目与回归清单6.1 最小复现项目该放哪些控件判断一个 Raize 修正版值不值得长用核心指标是能不能稳定复现典型使用场景。建议新建一个 VCL Forms 工程往窗体上放这些控件RzEdit带数字格式校验、RzButton带 Default/ Cancel 属性、RzPageControl至少三页每页放不同控件、RzCheckListBox数据项超过十条、RzTreeView带层级结构。这套组合覆盖了 Raize 最常用的自绘、容器、列表和树形四条路径。然后给这个窗体打开 VCL Styles主题切换两三次观察是否有绘制残留。6.2 回归验证清单与预期结果下面的清单可以直接打印出来当验收表用每一项都有明确的操作和预期结果不存在模糊的“看起来差不多”验证项操作方式预期结果焦点边框用 Tab 键遍历 RzEdit焦点框完整显示无 1px 裁切图标资源IDE 组件面板查看 Rz 页图标完整或空白但可拖拽编译链接分别编 Win32 / Win64两个平台均无 E1026 / E2597主题切换Windows 主题在深浅色间切换边框不重影、背景色正确列表滚动RzCheckListBox 拖到底部再拖回顶部无障碍、无黑块残留字体缩放窗体设置 96/120 DPI 各跑一次控件尺寸随窗体等比缩放6.3 一个验证习惯最后说一个我自己的习惯验证第三方组件修正版时不只看能不能编过而是会故意构造一个错误场景。在最小复现项目里放一个故意写错事件绑定的按钮触发编译错误观察 IDE 的错误定位是否准确指向用户代码而不是组件包内部。如果错误定位指向的是 Rz 包源码或者报错信息里出现组件包内部的怪路径说明这个修正版的调试符号和源码映射做得不好以后排问题会很痛苦。正常情况下组件包的内部符号不应该干扰用户代码的调试定位。这个习惯帮我过滤掉过不少看着能用、实际维护起来想骂人的包版本。组件库这东西编译通过只是入场券运行期稳定、排错清晰才是真正省时间的部分。希望这篇笔记能帮你少走一段弯路。本文还有配套的精品资源点击获取