若需在本地编译代码并模拟运行，可使用本地模拟器。

有两种搭建方式：让桌面应用自动创建并构建模拟器，或者下载模板后按下面的步骤手动构建。

设置编译环境

本地模拟器依赖编译工具链和 SDL2 库。

Windows

  • 编译工具链

    官方提供了 Windows 工具链，可从 tools-for-windows 下载。双击 launch-tools-shell.bat 打开命令提示符，环境变量会自动配置好；在同一个窗口中 cd 到模拟器项目目录，运行模拟器。

  • SDL2

    模拟器项目目录中已内置 SDL2 库，无需单独安装。

macOS

  • 编译工具链

    需安装 C/C++ 编译工具链，用于编译模拟器代码。若 macOS 已装有 clang，可跳过此步。

  • SDL2

    可运行以下命令在 macOS 上安装 SDL2：

    brew install sdl2

Linux

  • 编译工具链

    需安装 C/C++ 编译工具链，用于编译模拟器代码，从所用发行版的包管理器安装即可。

  • SDL2

    可运行以下命令在 Linux 上安装 SDL2：

    • Ubuntu/Debian

      sudo apt install libsdl2-dev libsdl2-image-dev libsdl2-ttf-dev

    • Fedora

      sudo dnf install SDL2-devel SDL2_image-devel SDL2_ttf-devel

    • 其他 Linux 发行版

      在所用发行版的包管理器中搜索 SDL2 并安装。

获取模拟器项目模板

桌面应用

在桌面应用中创建项目并选择项目路径后，应用会把与目标版本匹配的模拟器模板复制到该文件夹。模板包含全部支持的版本：8.3.7、9.2.2、9.3.0、9.4.0、9.5.0 与 9.6.0。

手动下载

官方也提供本地模拟器项目模板，可直接取用，参见模拟器项目模板。模板目录以 LVGL 版本命名，例如 v8.3.7 和 v9.2.2。

添加生成的代码

  • 使用桌面应用时，在设置中为目标版本设置导出文件夹，导出后点击工具栏的 构建并运行。应用会直接写入生成的源码，并在底部面板显示构建日志。
  • 手动操作时，从 anyui-LIVE 下载生成的代码，解压后把 generated 目录复制到下载的模拟器模板的版本目录中。

完成以上步骤后，在对应的版本目录下执行以下命令即可运行模拟器：

cd v9.2.2
make && make run

请使用与项目目标版本一致的目录名，例如 v8.3.7 或 v9.6.0。