User:Brita/Configs/VSCode

= Configuring and Using VSCode =

Visual Studio Code is a lightweight code editing environment that supports C, C++, Python (among many others) and has integrated debugging and Git support.

It is available for Windows, MacOs and Linux.

This page shows how to setup for both C/C++ Blender development and for Python addons.

Installing
There are two versions to choose from when downloading VSCode:
 * pre-built version with proprietary license and End User Agreement: https://code.visualstudio.com/
 * free and open source version on github: https://github.com/Microsoft/vscode

To use the free and open source version, you need to build it yourself. Make sure you have the dependencies listed in the following instructions: https://github.com/Microsoft/vscode/wiki/How-to-Contribute

You will also need to enable the marketplace extension gallery manually by adding the following to ;

Basic Configuration
In  you can find a multitude of settings and commonly used options to set VSCode to your liking.

You might want to opt out of sending data to Microsoft as at the moment that is not the default.

Setup for Core Blender development
Install the following extensions:
 * C/C++ - language support for C and C++
 * CMake - language support for CMake files (syntax highlighting, etc)
 * CMake Tools - workflow tools for CMake (documentation)
 * Note: As of CMake Tools version 0.11.0 it is no longer necessary to also install cmake-tools-helper

Setup CMake Tools
Command Palette (Ctrl+Shift+P):

Connect the Cpp and CMake Tools extensions
This step is needed so that the Cpp Extension, which does the syntax highlighting and symbol lookup knows what is the current CMake setup in regard to the include paths and variables (eg. WITH_CYCLES).

File Search for   (should be in the project's .vscode folder)

Find the configuration you are using (eg. "Linux") and add the path to the file  that is generated by CMake in the blender-build folder. Example:

Running
To launch Blender with, you can setup the executable to launch in VSCode's launch settings.

Command Palette : Add the path to the program and optionally some command line arguments.

Git integration
svn?

Setup for Python Addon development
bla

Updating VSCode and the extensions
For the free software version: