Developing on Windows (Visual Studio 2017)

⚠️ TODO: This is the documentation for older version. These sections needs updating for the latest version of the engine.

Build requirements

• Git
• Python 2.7+
• Windows >= 10
• Visual Studio 2017+

Prerequisites

Cloning

git clone https://github.com/mogemimi/pomdog.git

Pulling all dependencies using Git

Make sure git is installed. From the root of your engine directory, run:

cd pomdog
git submodule update --init
git clone --depth=1 https://chromium.googlesource.com/external/gyp.git tools/gyp

Updating all dependencies

cd pomdog
git submodule update
cd tools/gyp && git pull origin master && cd ../..

Generating project files

Generate visual studio project files:

PowerShell

python tools\gyp\gyp_main.py test\TestApp\TestApp.gyp `
  --depth=. -f msvs -G msvs_version=2017 `
  --generator-output=build.msvs `
  -Dcomponent=static_library

Windows command prompt (Cmd)

python tools\gyp\gyp_main.py test\TestApp\TestApp.gyp ^
  --depth=. -f msvs -G msvs_version=2017 ^
  --generator-output=build.msvs ^
  -Dcomponent=static_library

Git Bath

python tools/gyp/gyp_main.py test/TestApp/TestApp.gyp \
  --depth=. -f msvs -G msvs_version=2017 \
  --generator-output=build.msvs \
  -Dcomponent=static_library

You can also use gyp instead of python tools/gyp/gyp_main.py:

gyp test/TestApp/TestApp.gyp --depth=. -f msvs \
  -G msvs_version=2017 \
  --generator-output=build.msvs \
  -Dcomponent=static_library

For information on how to install gyp, see How to Install GYP on the wiki.

Building under MSBuild (Visual Studio 2017)

PowerShell

$env:Path += ";${env:ProgramFiles(x86)}\Microsoft Visual Studio\2017\BuildTools\MSBuild\15.0\Bin"
MSBuild build.msvs\test\TestApp\TestApp.sln /t:Build /p:Configuration=Release

Windows command prompt

set PATH=%ProgramFiles(x86)%\Microsoft Visual Studio\2017\BuildTools\MSBuild\15.0\Bin;%PATH%
MSBuild build.msvs\test\TestApp\TestApp.sln /t:Build /p:Configuration=Release

Git Bash (MinGW)

export PATH="$PATH:/c/Program Files (x86)/Microsoft Visual Studio/2017/BuildTools/MSBuild/15.0/Bin"
MSBuild.exe build.msvs/test/TestApp/TestApp.sln -t:Build -p:Configuration=Release

WIP 😱

NOTE

Working Directory
$(ProjectDir)..\..\..\test\TestApp