Skip to content

Latest commit

 

History

History
157 lines (129 loc) · 3.75 KB

README_zh.md

File metadata and controls

157 lines (129 loc) · 3.75 KB

Overview

声明式 C++ 构建工具

Features

  • 声明式的配置构建脚本
  • 跨平台，支持gcc、msvc等编译器
  • 生成 Visual Studio、 XCode 项目文件
  • 依赖管理库

Install

需要现安装 Fanx runtime.

从源码构建:

  fanb pod.props

设置（Windows系统）

  1. 设置编译器 (Options) 如果你不想从'Visual Studio Developer Command Prompt'来运行命令，可以这样配置. fanx/etc/fmake/config.props:
msvc.home=/D:/Program Files (x86)/Microsoft Visual Studio/2019/Community/VC/Tools/MSVC/14.28.29333/bin/Hostx64/x64/
msvc.include_dir=/D:/Program Files (x86)/Microsoft Visual Studio/2019/Community/VC/Tools/MSVC/14.28.29333/include/;/C:/Program Files (x86)/Windows Kits/10/Include/10.0.18362.0/ucrt/;/C:/Program Files (x86)/Windows Kits/10/Include/10.0.18362.0/winrt/;/C:/Program Files (x86)/Windows Kits/10/Include/10.0.18362.0/cppwinrt/winrt/;/C:/Program Files (x86)/Windows Kits/10/Include/10.0.18362.0/shared/;/C:/Program Files (x86)/Windows Kits/10/Include/10.0.18362.0/um/
msvc.lib_dir=/D:/Program Files (x86)/Microsoft Visual Studio/2019/Community/VC/Tools/MSVC/14.28.29333/lib/x64/;/C:/Program Files (x86)/Windows Kits/10/Lib/10.0.18362.0/ucrt/x64/;/C:/Program Files (x86)/Windows Kits/10/Lib/10.0.18362.0/um/x64/

用法

编译

构建脚本 'fmake.props':

  name = helloExe
  summary = test exe
  version = 1.0.1
  outType = exe
  srcDirs = cpp/
  incDir = include/
  depends = helloLib 1.0.0, abc 1.2

编译:

  fan fmake fmake.props

debug模式编译:

  fan fmake -d  fmake.props

清理后重新编译:

  fan fmake -f  fmake.props

指定编译器:

  fan fmake fmake.props -c gcc

生成IDE项目文件

需要安装cmake.

  fan fmake -G  fmake.props

构建脚本细节

  name: 库名称
  summary: 描述
  version: 构建版本
  outType: exe, lib, dll
  srcDirs: 输入的源文件路径（文件夹需要以'/'结尾）
  excludeSrc: 在搜索源文件时需要排除的文件
  incDir: 需要拷贝的头文件目录
  resDirs: 需要拷贝的资源文件目录
  depends: 依赖的库（只需要名称和版本号，不需要指定头文件和库文件）
  extIncDirs: 额外的头文件搜索路径
  extLibDirs: 额外的库文件搜索路径
  extLibs: 额外依赖的库名称
  defines: 用户定义的宏
  extConfigs.cppflags: 编译器选项
  incDst: 头文件安装位置
  extConfigs.linkflags: 连接器选项
  debug.defines： debug模式的定义
  debug.extLibs： debug模式的额外库名称

编译器和平台相关配置

可以前缀操作系统名称

  • win32
  • macosx
  • linux
  • non-win 例如：
win32.extIncDirs = ...
linux.define = ...

可以前缀编译器名称

gcc.define = ...
msvc.define = ...

包仓库

包仓库是个固定结构的文件夹，不设计网络操作。

数据位置可以在这里配置 fanx/etc/fmake/config.props: fmakeRepo=/D:/fmakeRepo/

目录结构

   |_lib
      |_java
      |_donet
      |_fan
      |_cpp
        |_pro1
        |  |_bin
        |  |_include
        |  |_obj
        |  |_lib
        |_pro2
        |  |_bin
        |  |_include
        |  |_obj
        |  |_lib
        |...

WebAssembly Emscripten

fanx/etc/fmake/config.props:

gcc.home=/D:/workspace/source/emsdk/upstream/emscripten/
gcc.name@{cpp}=emcc.bat @{cppflags} -pthread
gcc.name@{c}=emcc.bat @{cflags} -pthread
gcc.ar=emar.bat
gcc.link=emcc.bat -pthread
gcc.exe=@{gcc.link} @{linkflags} -o @{outFile}.js @{gcc.objList} @{gcc.libDirs} @{gcc.libNames}

做更多的任务

请编写shell脚本来做，不要在makefile里面写业务逻辑。跨平台编译优先使用编程语言“宏”功能来处理。