
简介TMS FNC WX Pack v1.7.3.0 是面向 Delphi 与 CBuilder XE7-13含 12.3 Athens开发者的跨平台 Web 扩展控件包同一套源码可编译为 VCL、FMX、LCL 及 TMS WEB Core 应用覆盖 Windows、macOS、iOS、Android、Linux 与 Web 全平台。包内提供条码生成、摄像头调用、HTML 富文本编辑、PDF 渲染、视频播放、JSON 树编辑、TTS 朗读、OCR 识别、DocX 生成、LaTeX 公式编辑及 WebControl 嵌入等十余类组件并针对 Delphi 13 的 64 位 IDE 与 Win64x Modern 目标做了高 DPI 优化新增 WebEngine 属性可切换 Edge/WebView2 内核。资源共 815 个文件以 pas 源码、dproj/dpr 工程、dfm/fmx 窗体、dcr 组件资源及 html、json 示例为主压缩包约 14.37MB全源码交付、无 DLL 依赖可闭源商用。目前已有 128 人学习下载适合需要快速为桌面与移动项目补齐 Web 能力的 Delphi 中高级开发者参考。1. TMS FNC WX Pack 到底解决 Delphi 什么痛点做 Delphi 桌面项目的人大多有过这种经历客户要求界面里嵌一个现代浏览器内核、要能跑 WebAssembly、要支持 PDF 预览结果翻遍 VCL 自带控件发现根本没有第三方库要么停更多年要么只支持某个特定版本。TMS FNC WX Pack 就是冲着这类需求来的——它把一批基于 WebView 和 Web 技术的现代 UI 能力封装成 Delphi 原生控件让 XE7 到 13 Florence 这条版本线上的项目都能直接拖控件用。这个包的核心价值在于「跨框架 跨版本」。FNC 是 TMS 的跨平台控件框架同一套控件在 VCL 和 FMX 下都能编译WX Pack 在此之上叠加了 Web 相关的组件层。对于还在维护 XE7 老项目、又不想大改架构的团队它提供了一条低成本升级路径。适合谁一是需要给传统 Win32 程序加现代 Web 能力的开发者二是用 FMX 做跨平台但缺 Web 组件的团队三是想研究 Delphi 如何桥接 Web 技术栈的工程师。2. 包内组件构成与版本适配逻辑2.1 核心组件清单与各自职责拿到这个 7z 包先别急着装。解压后你会看到源码目录、编译好的 DCU、示例工程和帮助文档几大块。真正要理解的是里面几个核心组件的分工组件名底层依赖典型用途TTMSFNCWXBrowserWebView2 / 系统 WebView嵌入网页、加载本地 HTMLTTMSFNCWXPDFViewerPDF.js在窗体里直接渲染 PDFTTMSFNCWXEditor富文本引擎轻量级富文本编辑TTMSFNCWXViewerWeb 渲染层展示 Markdown、HTML 片段这些组件不是简单包一层 IE 控件。以 Browser 为例Windows 平台走的是 WebView2Chromium 内核这意味着你能用现代 CSS、ES6 甚至部分 WebAssembly 能力而不是被 IE 的兼容模式卡死。PDFViewer 则依赖 PDF.js 做前端渲染Delphi 侧只负责传文件路径和接收回调。2.2 版本适配XE7 到 13 Florence 的编译差异这个包号称支持 XE7 到 13 Florence但不同版本的实际体验差别不小。XE7 时代编译器对泛型和匿名方法的支持还不完善部分源码里用了条件编译指令来绕开语法限制。到了 Delphi 11 Alexandria 之后包内开始利用新的内联变量和更完善的泛型约束代码可读性明显提升。安装前先确认你的 IDE 版本对应的包目录。通常包内会按版本分文件夹比如packages\DelphiXE7、packages\Delphi12这种结构。如果你拿到的包没有明确分版本那就需要手动在 IDE 里加载对应的.dpk文件让编译器自己处理条件编译分支。提示不要试图用一个版本的 DCU 跨 IDE 版本链接Delphi 的 DCU 格式在 major version 之间不兼容混用必出 unit was compiled with a different version 错误。3. 从零安装到第一个 Browser 控件的完整流程3.1 安装前的环境检查与库路径配置安装前先做三件事确认 IDE 版本号、关闭所有 Delphi 实例、备份现有库路径。TMS 的包安装器会往 IDE 的 Library Path 里写路径如果之前装过其他 TMS 产品路径冲突会导致编译时找不到单元。手动安装的步骤大致如下# 假设解压到 D:\Components\TMSFNCWXPack # 1. 先编译运行时包 # 打开 IDE - File - Open - 选择对应版本的 .dpk # 例如 Delphi 12 对应 D:\Components\TMSFNCWXPack\packages\Delphi12\TMSFNCWXPack.dpk # 2. 在 Project Manager 里右键 - Build # 3. 再编译设计时包 D:\Components\TMSFNCWXPack\packages\Delphi12\dclTMSFNCWXPack.dpk # 右键 - Install编译运行时包时如果报缺单元检查 Library Path 里是否包含了source目录。设计时包安装成功后Tool Palette 里会出现 TMS FNC WX 分类。3.2 拖一个 Browser 控件并加载本地 HTML新建一个 VCL Application从 Tool Palette 拖一个TTMSFNCWXBrowser到窗体上。默认情况下它会在设计期显示一个占位区域。运行时加载本地 HTML 的代码procedure TForm1.FormCreate(Sender: TObject); begin // 设置浏览器内核为 Edge WebView2 TMSFNCWXBrowser1.BrowserType : TBrowserType.Edge; // 加载本地文件路径用 file:// 协议 TMSFNCWXBrowser1.LoadFromFile(C:\test\index.html); // 或者直接加载 HTML 字符串 // TMSFNCWXBrowser1.LoadFromString(htmlbodyh1Hello/h1/body/html); end;BrowserType这个属性在 Windows 上建议显式设为 Edge否则可能回退到旧内核。LoadFromFile内部会把路径转成file:///URL注意路径里不要有中文和空格否则 WebView2 可能拒绝加载。如果加载后白屏先检查 WebView2 Runtime 是否已安装——Win10 某些版本不自带需要单独装 Evergreen Runtime。3.3 用 PDFViewer 做文档预览的最小实现PDFViewer 的用法比 Browser 更直接它封装了 PDF.js 的加载逻辑procedure TForm1.Button1Click(Sender: TObject); begin // 指定 PDF 文件路径 TMSFNCWXPDFViewer1.LoadFromFile(D:\docs\manual.pdf); // 设置初始缩放 TMSFNCWXPDFViewer1.Zoom : 1.5; // 跳转到指定页 TMSFNCWXPDFViewer1.CurrentPage : 3; end;Zoom是浮点数1.0 表示 100%。CurrentPage从 1 开始计数。如果 PDF 加载失败大概率是文件路径含特殊字符或者 PDF 本身加密了。PDF.js 对加密文档的支持有限遇到密码保护的 PDF 需要先在服务端解密再传给控件。4. 避坑与常见问题排查4.1 安装后控件面板不显示现象编译安装都成功但 Tool Palette 里找不到 TMS FNC WX 分类。 原因设计时包虽然装了但 IDE 的缓存没刷新或者包被装到了错误的 IDE 实例下。 解决关闭 IDE删除%APPDATA%\Embarcadero\BDS\版本\下的palette.cache文件重启 IDE 让它重建缓存。如果还不行检查dclTMSFNCWXPack.dpk是否真的 Install 成功在 Component - Install Packages 列表里确认它处于勾选状态。4.2 WebView2 初始化失败导致 Browser 白屏现象程序运行后 Browser 区域一片空白没有任何报错。 原因目标机器没装 WebView2 Runtime或者 Runtime 版本太旧。 解决在程序启动时调用TMSFNCWXBrowser.CheckWebView2Available如果包内提供了这个接口返回 False 就弹窗提示用户去装 Runtime。部署时可以把 WebView2 Evergreen Bootstrapper 一起打包首次运行静默安装。4.3 编译时报 Unit TMSFNCWXCore was compiled with a different version现象明明源码都在编译却报单元版本不匹配。 原因Library Path 里存在多个版本的 TMSFNCWX 单元编译器找到了旧的 DCU。 解决在 IDE 的 Library Path 里把 TMS 相关路径全部删掉只保留当前包对应的source目录。然后 Build All不要只按 F9 增量编译。4.4 FMX 项目下控件显示异常现象VCL 下正常的 Browser在 FMX 里位置错乱或无法响应触摸。 原因FNC 控件在 FMX 下的渲染走的是另一套逻辑部分属性行为不一致。 解决FMX 项目里尽量用Align和Margins做布局少用绝对坐标。触摸事件需要设置Touch.InteractiveGestures否则 WebView 会吞掉手势。4.5 发布后目标机器缺 DLL现象开发机跑得好好的拷到客户机器就报错找不到WebView2Loader.dll。 原因这个 DLL 是 WebView2 的加载器编译时不会自动打包。 解决从包内的redist目录如果有或 NuGet 缓存里找到对应平台x86/x64的WebView2Loader.dll放到 exe 同目录。部署脚本里加一步文件拷贝。5. 进阶把 Browser 变成双向通信的宿主环境5.1 用 JavaScript 调用 Delphi 方法Browser 控件真正强大的地方在于 Delphi 和 JavaScript 可以互相调用。先看 JS 调 Delphi 的写法// Delphi 侧注册一个供 JS 调用的方法 procedure TForm1.FormCreate(Sender: TObject); begin TMSFNCWXBrowser1.AddJavaScriptMethod(delphiLog, procedure(const AParams: string) begin // AParams 是 JS 传过来的 JSON 字符串 Memo1.Lines.Add(来自 JS: AParams); end); end;// JS 侧调用 Delphi 注册的方法 delphiLog(JSON.stringify({ action: click, id: 42 }));AddJavaScriptMethod的第二个参数是一个匿名方法参数是字符串。JS 侧传对象时用JSON.stringify序列化Delphi 侧再解析。注意方法名不要和 JS 内置函数重名否则会被覆盖。5.2 Delphi 主动执行 JS 并拿返回值反过来Delphi 也可以往页面里注入 JS 并获取结果procedure TForm1.Button2Click(Sender: TObject); begin // 同步执行 JS返回值通过回调拿到 TMSFNCWXBrowser1.ExecuteJavaScript(document.title, procedure(const AResult: string) begin Caption : 页面标题: AResult; end); end;ExecuteJavaScript是异步的结果通过回调返回。如果 JS 执行出错回调里的 AResult 会是空字符串不会抛异常。调试时建议在 JS 里加try-catch把错误信息 return 出来方便定位。5.3 一个完整的双向通信验证方法想确认通信链路是否真的通了可以做一个最小验证页面加载后自动调 Delphi 方法上报document.readyStateDelphi 收到后回写一个时间戳到页面。// Delphi 侧 procedure TForm1.FormCreate(Sender: TObject); begin TMSFNCWXBrowser1.AddJavaScriptMethod(onReady, procedure(const AParams: string) begin // 收到就绪通知后回写时间戳 TMSFNCWXBrowser1.ExecuteJavaScript( Format(document.getElementById(ts).innerText %s, [FormatDateTime(yyyy-mm-dd hh:nn:ss, Now)]), nil); end); TMSFNCWXBrowser1.LoadFromFile(C:\test\comm.html); end;!-- comm.html -- html body div idts等待 Delphi 回写.../div script // 页面就绪后通知 Delphi window.onload function() { onReady(JSON.stringify({ ready: true })); }; /script /body /html跑起来后如果#ts区域显示了时间戳说明 JS→Delphi→JS 这条链路完全通了。这个验证方法我每次集成新版本包时都会走一遍因为 TMS 在不同 Delphi 版本下对回调线程的处理有差异有时候回调不在主线程直接操作 UI 会出玄学问题。遇到回调里更新 VCL 控件报错时用TThread.Queue(nil, procedure begin ... end)包一层切回主线程。从那以后我每次升级 Delphi 版本或者换 TMS 包版本都强制先跑这个双向通信验证确认回调线程模型没变再动业务代码。希望帮到你。本文还有配套的精品资源点击获取