bgfx-01-各个平台编译

原文链接：https://shanysheng.github.io/

bgfx

• Cross-platform, graphics API agnostic, "Bring Your Own Engine/Framework" style rendering library.
• https://github.com/bkaradzic/bgfx
• https://gitter.im/bkaradzic/bgfx
• https://bkaradzic.github.io/bgfx/overview.html

下载

• bgfx依赖的库相对比较简单，三个git，分别对应基础平台、图像库和绘制库

mkdir bgfx
cd bgfx
git clone git://github.com/bkaradzic/bx.git
git clone git://github.com/bkaradzic/bimg.git
git clone git://github.com/bkaradzic/bgfx.git

目录结构：

• bgfx
  • bgfx
  • bimg
  • bx

GENie

GENie是bgfx用来生成各个平台工程文件的工具，类似cmake，不过相对来说还是小众，但从使用上来说还是挺好用。

Windows平台

编译

• windows配置make相关编译环境比较复杂，bgfx采用genie生成vs工程文件；
• 通过下载上述三个git代码后，git shell进入bgfx/bgfx目录，执行：

..\bx\tools\bin\windows\genie --with-examples vs2015

• --with-examples代表生成example的工程文件

• vs2015表示生成的工程文件为visual studio 2015版，可以制定各种版本；

  
  
• 在bgfx/.build/projects/vs2015目录下会生成对应的工程文件

运行

• 打开.build/projects/vs2015中的sln文件，编译完成后会在./build/win64_vs2015/bin生成可执行文件和链接库
• 示例工程运行所需的资源在bgfx/bgfx/examples/runtime下，git shell下则需要在runtime目录下运行：

   ../../.build/win64_vs2015/bin/example-06-bumpRelease

Linux平台

prerequisties

• 需要预先安装界面、图形相关的依赖库

sudo apt-get install libgl1-mesa-dev x11proto-core-dev libx11-dev

编译

Linux平台编译相对来说更简单一些，两种方法：

1. 直接通过make命令；
2. 通过genie命令手动生成gmake工程文件，实际上直接通过make的方式也是内部调用genie生成gmake，采用genie相对来说更多的参数可以选择

make

• 直接在目录中输入make，会输出可以选择的参数；
• 在linux64位ubuntu下可以选择：

make linux-Debug64 
make linux-Release64

genie

• 在bgfx目录下运行genie命令，会输出各类可选择参数，例如下面就通过参数选择生成动态链接库的方式

../bx/tools/bin/linux/genie

运行

• 需要在bgfx/bgfx/examples/runtime目录下运行命令，否则导致无法找到资源

Android

• android在linux下或者Mac都可以进行编译，流程上没什么区别
• 主要区别在于配置Android sdk的环境变量的区别上

vim ~/.bashrc

• 通过不同的编译指令参数编译不同硬件平台下的.so或.a

make android-arm
make android-x86
make android-mips

Mac编译

make

make osx

genie

../bx/tools/bin/darwin/genie --with-examples --xcode=osx xcode4

运行

• 同window、linux类似，需要在bgfx/bgfx/examples/runtime目录下运行命令，否则导致无法找到资源

../../.build/osx64_clang/bin/example-06-bump.app/Contents/MacOS/example-06-bumpRelease

iOS编译

make

![bgfx-01-genie-vs2015.png](http://upload-images.jianshu.io/upload_images/37436-4114d2947e0ab2fd.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

make ios-arm64
make ios-arm

genie

../bx/tools/bin/darwin/genie --with-examples --xcode=ios xcode4

运行

ios运行需要将资源打包打.app里面，所以需要：

• 在xcode文件下创建group，例如：resource
• 将runtime目录下的文件和文件夹以reference的方式加入到xcode工程中，否则导致无法找到资源

• 然后就可以打包运行