FlatUI四平台构建全攻略：Windows、Linux、macOS与Android环境搭建

FlatUI四平台构建全攻略Windows、Linux、macOS与Android环境搭建【免费下载链接】flatuiEfficient Immediate Mode UI for Games项目地址: https://gitcode.com/gh_mirrors/flatu/flatuiFlatUI 是一款面向游戏开发的高效即时模式Immediate ModeUI 库用 C 编写专门用于快速搭建菜单、HUD 等游戏界面。很多新手拿到源码后第一反应是这个游戏 UI 库到底该怎么编译好消息是FlatUI 原生支持 Windows、Linux、macOS 与 Android 四大平台并自带 CMake 与 Android 构建脚本。本文就带来一份完整的FlatUI 四平台构建全攻略从环境准备到编译运行一次讲透让你 30 分钟内跑通第一个游戏 UI 示例。FlatUI 构建基础先了解项目结构动手编译前花一分钟认识一下 FlatUI 的目录布局后面每一步都离不开它CMakeLists.txt顶层构建脚本同时驱动 Windows / Linux / macOS 三个平台jni/Android.mkAndroid NDK 构建入口自动引入各依赖模块jni/Application.mkAndroid 应用级配置ABI、STL 等sample/CMakeLists.txt示例工程清单包含 basic、animation、sdf 等 10 个示例include/flatui/flatui.h主头文件所有 UI 接口的入口docs/src/programmers_guide/building.md官方构建总览文档FlatUI 依赖 FPLBase、HarfBuzz、FreeType、MathFu 等库这些依赖以子模块形式存在克隆时必须使用递归参数否则编译会直接报找不到依赖git clone --recursive https://gitcode.com/gh_mirrors/flatu/flatuiWindows 平台 FlatUI 构建Visual Studio 快速配置方法Windows 是最常用的开发环境官方构建流程只需要 Visual Studio 与 CMake 两样工具最低版本要求为 VS 2012 和 CMake 2.8.12.1新版本完全兼容。详细说明见 building_windows.md。一键生成 VS 工程步骤安装 Visual Studio 与 CMakecmake.org 下载安装包打开命令行进入 FlatUI 源码根目录执行 CMake 生成 Visual Studio 解决方案cd flatui cmake -G Visual Studio 11 2012 .生成成功后目录下会出现FlatUI.sln双击打开在菜单栏选择生成 → 生成解决方案稍等片刻库与示例就会全部编译完成。编译产物默认输出到bin目录直接在 VS 里运行 basic 示例就能看到你的第一个 FlatUI 界面。Linux 平台 FlatUI 构建CMake 与 Makefile 两步搞定Linux 下的构建流程最简洁只需两条命令。FlatUI 在 Linux 上依赖 FPLBase 及其前置库SDL、FreeType 等请先按 FPLBase 的文档装好依赖再执行cd flatui cmake -GUnix Makefiles . make最快配置方法Debug 与 Release 切换技巧CMake 的-D参数可以切换构建类型注意它是粘性的——一旦设置了 Debug后续构建会一直保持 Debug想切回 Release 必须显式指定cmake -GUnix Makefiles -DCMAKE_BUILD_TYPEDebug . make # 切回 Release cmake -GUnix Makefiles -DCMAKE_BUILD_TYPERelease . make构建完成后flatui静态库与全部单元测试都会生成运行测试可以立刻验证环境是否正常。更详细的选项说明可参考 CMakeLists.txt 中通过option()暴露的构建开关。macOS 平台 FlatUI 构建Xcode 工程生成技巧macOS 下官方推荐的构建方式是生成 Xcode 工程最低要求为 OS X 10.9.1 与 Xcode 5.0.1。要点在于即使你用命令行编译也要先打开一次 Xcode 并同意许可协议否则命令行构建会静默失败。完整流程见 building_osx.md。Xcode 图形界面构建步骤cd flatui cmake -G Xcode .执行后生成FlatUI.xcodeproj双击打开选择Product → Build即可编译。想跑单元测试时在 Scheme 下拉框里选择一个应用 Scheme例如angle_test点击 Run 按钮就能看到测试结果。macOS 命令行加速构建方法如果你习惯命令行也可以直接生成 Unix Makefiles 并用多线程加速cd flatui cmake . make -j20-j20表示 20 个并行任务能显著缩短首次编译时间。Android 平台 FlatUI 构建NDK 交叉编译完整步骤Android 是移动游戏的主战场FlatUI 对它的支持也最完善构建脚本见 jni/Android.mk。相比桌面端Android 需要多准备三样工具Java 1.7Windows / macOS 直接下载安装包Linux 执行sudo apt-get install openjdk-7-jdkAndroid SDK推荐用 Android Studio 一键安装Android NDK官方测试版本为android-ndk-r10e装好后把 SDK 的sdk/tools目录和 NDK 目录加入 PATH 环境变量。以 Linux 为例在~/.bashrc中追加export PATH$PATH:/home/androiddev/adt/sdk/tools:/home/androiddev/ndk编译命令与 ABI 选择进入源码根目录直接调用 ndk-buildcd flatui ndk-build -j20默认会为armeabi-v7a、x86、armeabi三种 ABI 生成代码。如果你想要包含所有 ABI 的 fat APK或者只含单一 ABI 的瘦身 APK可以覆盖APP_ABI参数# 全 ABI fat 包 ndk-build APP_ABIall -j20 # 仅 armeabi-v7a 瘦身包 ndk-build APP_ABIarmeabi-v7a -j20构建常见问题排查清单四平台踩坑点大同小异这里整理一份高频问题速查表问题现象大概率原因解决办法找不到 fplutil 目录克隆时没加--recursive重新递归克隆或用-Ddependencies_fplutil_dir指定依赖路径macOS 命令行编译失败未同意 Xcode 许可协议先打开一次 Xcode 接受协议Android 报 JAVA 相关错误JDK 版本不对或 JAVA_HOME 未设置Linux 用update-java-alternatives切换Windows 设置 JAVA_HOME编译极慢未开并行加-j20参数示例缺少资源文件未执行后处理拷贝构建会自动把assets与schemas拷贝到bin/assets确认构建日志无报错从示例到实战验证构建成果构建成功后别急着写代码先把自带的 10 个示例全部跑一遍它们是最好的学习素材。在 sample/CMakeLists.txt 中可以找到全部示例清单basic最基础的按钮、文字、图片渲染animation带动画的界面效果sdfSDF 字体渲染高清晰缩放text_html_labelHTML 标签解析渲染serialization用 JSON 配置 UI 布局以 basic 为例它演示了 FlatUI 最核心的编程模型——即时模式每一帧 UI 都会被创建、渲染、销毁配合gui::Run与StartGroup组织布局代码直观且无状态残留非常适合新手入门。示例使用的柯基素材如 corgi_happy.webp、scrolling_clouds.webp都存放在sample/assets/textures/下可以作为你自定义界面时的参考资源。跑通示例后你就可以在自己的游戏引擎中集成 FlatUI 了初始化 FPLBase 的渲染器与输入系统创建FontManager加载字体然后在渲染循环里调用gui::Run编写界面逻辑。四大平台的构建基础已经打好剩下的就是发挥创造力用这套高效的即时模式 UI 库为你的游戏打造炫酷的菜单与 HUD【免费下载链接】flatuiEfficient Immediate Mode UI for Games项目地址: https://gitcode.com/gh_mirrors/flatu/flatui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考