Delphi 10.4.2 实战：手把手教你用FMXLinux在Ubuntu上跑通第一个GUI程序

Delphi 10.4.2 实战手把手教你用FMXLinux在Ubuntu上跑通第一个GUI程序如果你是一位长期在Windows平台使用Delphi的开发者突然需要将应用部署到Linux环境可能会感到有些无从下手。别担心FMXLinux正是为解决这个问题而生。本文将带你从零开始一步步完成环境配置、项目创建、编译部署到最终在Ubuntu上运行GUI程序的全过程。1. 环境准备搭建跨平台开发桥梁在开始编码之前我们需要准备好Windows和Linux两端的环境。这个过程看似繁琐但每一步都是确保后续开发顺利的关键。1.1 Windows端必备组件安装首先确保你的Delphi 10.4.2已正确安装。接下来需要获取FMXLinux组件这是实现跨平台GUI的核心访问FMXLinux官网下载最新安装包以管理员身份运行安装程序选择与Delphi 10.4.2兼容的版本安装完成后在Delphi的Tool Palette中应能看到新增的FMXLinux组件注意安装过程中可能会提示需要某些运行时库请务必按照提示安装否则可能导致设计时组件无法正常显示。1.2 Ubuntu目标机配置在目标Ubuntu机器上这里以18.04 LTS为例需要安装以下基础依赖sudo apt-get update sudo apt-get install -y libgtk2.0-dev libgl1-mesa-dev libgdk-pixbuf2.0-dev这些库提供了GTK界面框架和OpenGL支持是FMXLinux运行时的基础环境。如果是较新的Ubuntu版本如20.04还需要额外安装sudo apt-get install -y libwebkit2gtk-4.0-dev2. 创建第一个跨平台项目环境就绪后让我们创建一个简单的演示项目来验证整个工具链。2.1 新建FMXLinux项目在Delphi中按以下步骤操作选择 File → New → Multi-Device Application在项目模板中选择 Blank Application右键点击Project Manager中的Target Platforms确保Linux64已勾选保存项目到你的工作目录建议路径不要包含中文或空格2.2 设计基础界面拖拽以下组件到窗体上1个TButton1个TMemo1个TLabel双击按钮添加点击事件procedure TForm1.Button1Click(Sender: TObject); begin Memo1.Lines.Add(Hello from Ubuntu!); Label1.Text : Button clicked at: DateTimeToStr(Now); end;这个简单界面将帮助我们验证基础控件渲染事件响应日期时间功能3. 配置Linux部署环境要让Windows上的Delphi能够将应用部署到Ubuntu需要建立连接通道。3.1 设置PAServer连接在Ubuntu上安装并启动PAServerwget https://altd.embarcadero.com/releases/studio/21.0/21.0.38860.1461/LinuxPAServer21.0.tar.gz tar -xzf LinuxPAServer21.0.tar.gz cd PAServer-21.0/ ./paserver在Delphi中配置连接打开Tools → Options → Deployment → SDK Manager添加新的Linux SDK输入Ubuntu机器的IP地址和密码默认端口64211测试连接确保成功3.2 解决常见配置问题首次配置可能会遇到以下问题连接超时检查Ubuntu防火墙设置sudo ufw allow 64211/tcp库路径错误在SDK配置中添加必要的库路径/usr/lib/x86_64-linux-gnu /usr/lib/gcc/x86_64-linux-gnu/7行尾符警告编辑linux64.redistlist文件将LF转换为CRLF4. 编译与部署实战一切就绪后就可以进行实际的编译部署了。4.1 编译Linux目标在Delphi中在Project Manager中将构建配置设为Linux64选择Build或直接Run首次运行建议先Build观察编译输出窗口是否有错误成功编译后会在项目目录下生成Linux64/Release子目录包含可执行文件。4.2 部署到Ubuntu使用paclient进行部署右键点击Project → Deployment → Refresh确认要部署的文件列表选择Project → Deploy或者手动使用命令行paclient -u8 --putLinux64/Release/Project1,Project1,1,Project1 Ubuntu 18.044.3 在Ubuntu上运行登录Ubuntu机器在用户主目录下应该能找到部署的应用程序cd ~ chmod x Project1 ./Project1如果一切正常你将看到与Windows设计时一致的界面点击按钮会触发事件并更新界面。5. 调试与问题排查即使前面的步骤都正确执行实际运行时仍可能遇到问题。5.1 常见运行时错误libgtk-x11-2.0.so.0缺失sudo apt-get install -y libgtk2.0-0OpenGL上下文创建失败 检查Ubuntu是否安装了正确的显卡驱动尝试sudo ubuntu-drivers autoinstall字体显示异常 安装核心字体包sudo apt-get install -y ttf-mscorefonts-installer5.2 日志收集技巧在Ubuntu上运行前设置环境变量可获取更详细的日志export FMX_DEBUG1 ./Project1 21 | tee run.log这将把运行时输出重定向到run.log文件便于分析问题。6. 进阶配置与优化成功运行基础程序后可以考虑以下增强配置。6.1 添加Linux专有功能利用FMXLinux特有的API可以访问Linux系统功能。例如获取系统信息uses FMUX.Api; procedure TForm1.Button2Click(Sender: TObject); var Info: TLinuxSystemInfo; begin Info : GetLinuxSystemInfo; Memo1.Lines.Add(OS: Info.OSName); Memo1.Lines.Add(Kernel: Info.KernelVersion); end;6.2 打包为.deb安装包要让应用更方便分发可以创建deb包在项目目录创建DEBIAN/control文件Package: myfmxapp Version: 1.0 Architecture: amd64 Maintainer: Your Name your.emailexample.com Description: My FMXLinux Application创建打包脚本mkdir -p pkg/usr/local/bin cp Project1 pkg/usr/local/bin/ dpkg-deb --build pkg myfmxapp_1.0_amd64.deb6.3 性能优化建议在Project → Options → Building中启用优化选项减少动态库依赖静态链接常用库对于图形密集型应用考虑使用FMXLinux的Canvas优化选项7. 项目结构与代码组织当项目规模增长时良好的代码结构尤为重要。7.1 平台条件编译使用IFDEF处理平台差异{$IFDEF LINUX} uses FMXLinux.Platform; {$ENDIF} procedure DoSomething; begin {$IFDEF MSWINDOWS} // Windows特有实现 {$ENDIF} {$IFDEF LINUX} // Linux特有实现 {$ENDIF} end;7.2 资源文件管理Linux和Windows对资源文件的处理方式不同。建议将图片等资源放在单独目录使用相对路径访问在部署设置中明确包含资源文件夹7.3 多窗体应用注意事项主窗体应最后释放模态窗体在Linux上的行为可能与Windows略有不同避免在FormCreate中做耗时操作8. 实际项目经验分享经过多个FMXLinux项目的实践我总结了以下几点心得保持Delphi和FMXLinux版本同步混合版本常导致难以排查的问题定期清理中间文件特别是跨平台编译时旧的DCU文件可能引发错误利用持续集成设置自动构建脚本每次提交都验证Linux构建测试不同桌面环境GNOME、KDE等环境下UI表现可能有差异遇到最难解决的问题是Ubuntu 20.04上WebBrowser组件无法正常工作最终发现是WebKitGTK版本兼容性问题。解决方案是明确指定使用系统自带的WebKit版本而非捆绑的库。