Liquidfun links

2015-09-09 18:04:17 +01:00
parent 8833377855
commit 67f7a30ca6
184 changed files with 52115 additions and 2 deletions
@@ -0,0 +1,64 @@
+# 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