viktorljung
65 lines
2.0 KiB
Markdown
65 lines
2.0 KiB
Markdown
# Building for Windows
|
|
|
|
You can use [cmake][] to generate a [Visual Studio][] project for
|
|
LiquidFun's Testbed and Unittests on [Windows][].
|
|
|
|
Alternatively, you can download a pre-generated Visual Studio solution
|
|
from the [release page][]. The Visual Studio solution is free of
|
|
host-specific dependencies.
|
|
|
|
### Version Requirements
|
|
|
|
These are the minimum required versions for building LiquidFun for Windows:
|
|
|
|
- Windows: 7
|
|
- Visual Studio: 2010 or 2012
|
|
- cmake: 2.8.12.1
|
|
|
|
### Creating the Visual Studio solution using [cmake][]
|
|
|
|
When working directly with the source, use [cmake][] to generate the
|
|
[Visual Studio][] solution and project files. For example, the following
|
|
generates the [Visual Studio][] 2012 solution in the `liquidfun/Box2D`
|
|
directory:
|
|
|
|
cd liquidfun\Box2D
|
|
cmake -G "Visual Studio 11"
|
|
|
|
To generate a [Visual Studio][] 2010 solution, use this commend:
|
|
|
|
cd liquidfun\Box2D
|
|
cmake -G "Visual Studio 10"
|
|
|
|
Running [cmake][] under [cygwin][] requires empty TMP, TEMP, tmp and temp
|
|
variables. To generate a [Visual Studio][] solution from a [cygwin][]
|
|
bash shell use:
|
|
|
|
$ cd liquidfun/Box2D
|
|
$ ( unset {temp,tmp,TEMP,TMP} ; cmake -G "Visual Studio 11" )
|
|
|
|
### Building with [Visual Studio][]
|
|
|
|
- Double-click on `liquidfun/Box2D/Box2D.sln` to open the solution.
|
|
- Select "Build-->Build Solution" from the menu.
|
|
|
|
### Executing a Sample
|
|
|
|
- Right-click on an example project (e.g Testbed) in the Solution Explorer
|
|
pane, and select "Set as StartUp Project".
|
|
- Select "Debug-->Start Debugging" from the menu.
|
|
|
|
### Running Unit Tests
|
|
|
|
Developers modifying the LiquidFun library can verify that it is still working
|
|
correctly by executing the provided unit tests.
|
|
|
|
Use the run\_tests.bat batch file to execute unit tests:
|
|
|
|
liquidfun\Box2D\Unittests\run_tests.bat
|
|
|
|
[cmake]: http://www.cmake.org
|
|
[Visual Studio]: http://www.visualstudio.com/
|
|
[Windows]: http://windows.microsoft.com/
|
|
[cygwin]: http://www.cygwin.com/
|
|
[release page]: http://github.com/google/liquidfun/releases
|