/easy-cpp-projects

Repo for Easy C++ Project extension for Visual Studio Code

Primary LanguageTypeScript

Version Installs

Important note!

If you created a project with this extension before version 1.7.0 (Jun 21st 2019), please run "Convert this folder to an Easy C++ Project"

If you don't do this the extension won't load when the folder is opened. Until now, the extension looked for the tasks.json file, and it loaded when any project with tasks was opened. Now it will only load automatically when it is an Easy C++ Project.

Features

Create C++ projects and classes with just few clicks, for MSVC, GCC and Clang

It works with MSVC (Windows), GCC (Linux) and Clang (macOS)

Creating a new project will do the following:

- Project structure: Common folders like src, include and bin
- Makefile: A makefile already set up to build and run your project
- VSCode tasks: Configurations for building and running your project
- VSCode debug configuration: Debugging already setup for Visual Studio Debugger, GDB and LLDB
- Add new classes easily with the `Create new class` command

Creating class will create the appropiate files using one of the templates avaliable here

Getting started

  1. Install the compiler you want to use, look the Requirements section below
  2. Open a new folder in VSCode
  3. Open the command palette (F1) and search for easy cpp, then press the Create new C++ project option
  4. Enjoy programming! Now you can compile your code using the Build & Run button in the status bar at the bottom or F7, you can also set breakpoints and use the debugger!

Requirements

Windows

  • You must have MSVC or GCC installed:

GNU/Linux

  • Install GCC, Make and GDB using the package manager of your distribution, these are some of them:
    • Debian/Ubuntu/Mint: sudo apt install g++ make gdb
    • Fedora: sudo dnf install gcc-c++ make gdb
    • Arch Linux: sudo pacman -S gcc make gdb

MacOS

  • GCC: Check out Brew
  • Clang:
    • Open a Terminal
    • Run the command xcode-select --install
    • A dialog will appear telling you that it requires the command line developer tools, and asks if you would like to install them. Click on the "Install" button

Note:

  • You should install C/C++ VSCode extension for the best experience, avaliable here
  • Alternatively you can run this command from the command palette: ext install ms-vscode.cpptools

Release Notes

1.7.7

Changed custom templates folder location, now it is safe to save templates and they won't be removed upon extension updates

1.7.6

Added support for Visual Studio Build Tools 2019

1.7.5

Added "openFiles" property to JSON. It allows the user to set multiple files to open automatically on project creation

1.7.4

Fix Easy C++ placeholder not being created when using a custom template

1.7.3

New files.json format, now each template can have different directories and blank files created

1.7.2

Added "Convert this folder to an Easy C++ Project" command

1.7.1

Load extension when the file .vscode/.easycpp is present, avoiding loading it when there is a tasks.json but it is not an Easy C++ project

1.7.0

Added support for offline templates if there is no Internet connection avaliable

Added support for custom templates

Added "Open Custom Templates Directory" command

1.6.0

Added Create getter, Create setter and Create getter and setter commands. This is in very early stages, so bugs will happen. Please report any bugs to the issues page on GitHub :)