diff --git a/docs/using_vscode.md b/docs/using_vscode.md new file mode 100644 index 00000000..9e1bb487 --- /dev/null +++ b/docs/using_vscode.md @@ -0,0 +1,43 @@ +# Using vscode + +## Compilation and installation +### Prerequisites + +* before compilation you have to instal tools and dependencies (points 1,2,3) - https://github.com/colobot/colobot/wiki/How-to-Build-Colobot%3A-Gold-Edition-Using-MSVC + +### Configuring vscode + +* open project folder in vscode +* install extension CMake Tools: https://marketplace.visualstudio.com/items?itemName=ms-vscode.cmake-tools +* install extensnion ms-vscode.cpptools: https://marketplace.visualstudio.com/items?itemName=ms-vscode.cpptools +* on the status line at the bottom you can choose cmake configuration and compiler + +### Adding cmake settings: +* create folder .vscode if there is none. Inside that folder create file settings.json with the following content: +```json +{ + "cmake.configureSettings": { + "name": "x64-Debug", + "generator": "Ninja", + "configurationType": "Debug", + "inheritEnvironments": [ "msvc_x64_x64" ], + "CMAKE_TOOLCHAIN_FILE":{input path to toolchain} + "VCPKG_TARGET_TRIPLET": "x64-windows-static", + "BOOST_STATIC": "1", + "GLEW_STATIC": "1", + "MSVC_STATIC": "1" + }, + "cmake.buildDirectory": "${workspaceFolder}\\out\\build\\x64-Debug", + "cmake.installPrefix": "${workspaceFolder}\\out\\build\\x64-Debug", + "cmake.generator": "ninja" +} +``` + +### Compilation and installation +* Open cmake extension in the left menu +* click on 'configure all projects' +* on the status line at the bottom click compilation target and choose install +* click compile +* click launch + +If you have any problems create an issue or talk to us on our Discord channel: https://discord.gg/TRCJRc \ No newline at end of file