QFLazarus使用说明（2026-06-15更新）

一、安装前
1、使用相应平台的QFLazarus-Install执行文件
2、选择安装目录（目录不能包含中文）
3、fpc/lazarus版本说明（trunk、stable和fixes对应当前的版本号）

 fpc:
   trunk-------最新的版本，当前的版本号为3.3.1（版本差不多每天都有变化）,龙芯及riscv64都需要使用3.3.1版本  
   stable------当前的发行版为3.2.2  
   fixes-------3.2.2的Bug修正版本,版本号为3.2.4  
 lazarus:
   trunk-------当前最新版本为4.99,适合尝鲜的人群使用  
   stable------当前的发行版(4.6)  
   fixes-------当前的版本为4.7  

4、如果在linux使用lazarus需要提前在终端安装开发环境的依赖包：
1)

sudo apt update

2)

sudo apt install gdb make binutils build-essential libx11-dev libgtk2.0-dev libgdk-pixbuf2.0-dev libcairo2-dev libpango1.0-dev

二、fpc/lazarus安装步骤：
1、选择fpc版本：如果使用龙芯和riscv64等CPU或需要更好兼容delphi的代码，建议选择3.3.1或trunk版本。
     注意：linux内核>=6.0，fpc需要>3.2.2版本，如不用3.3.1版本，可选择fixes
2、选择lazarus版本：建议使用最新稳定版本（stable）
3、在“编译参数设置”和“fpc/lazarus编译参数”勾选相应的参数（也可以直接使用默认的参数）

 4、按下图步骤操作，只需点“编译fpc/lazarus”就可以一键编译安装fpc/lazarus
注意：安装目录不能有空格和中文

lazarus安装要注意：

1、批量安装自定义控件可能因控件原因造成lazarus在安装第三方控件失败。出现这种问题时，在lazarus ide重构lazarus，再根据出错信息重新编译相关控件及重构lazarus，直到安装完成。
2、第一次安装lazarus不建议批量安装自定义控件，大概率安装失败。

三、配置交叉编译环境：

注意：当编译安装fpc后才可以配置交叉环境
1）单一的交叉编译环境：
1、选择目标OS和目标CPU
     下图选择了linux和x86_64
2、点击“安装交叉编译”

2）批量编译交叉编译环境：
1.勾选要批量编译的条件
2.点“批量交叉编译”后，等编译完成就可以。

编译完成后在界面会显示已配置交叉编译的列表，下图说明已配置x86_64-linux:

3、在lazarus选择：

注意：截图的lazarus是在aarch64-linux编译应用为x86_64-linux的。
其他CPU和OS也使用同样的方法配置及编译。

2026-06-15更新：
1、支持lazarus4.x版本用补丁方式升级，保留已安装控件。
建议：用补丁方式升级前，先重构一次lazarus，确保第三控件重构时正常（升级失败大多和第三方控件有关）。
注意：先备份config_lazarus和lazarus目录。

2、鸿蒙支持 fpc trunk版本（不支持特定分支的版本）。

如果没安装DevEco Studio也可以编译fpc，但编译交叉编译环境时需要安装DevEco Studio并设置sdk目录：