CMake build system for Atom

This is a fork of https://github.com/siegelaaron94/atom-build-cmake

Source files that were existing before the fork are licenced under MIT licence. New source files created since the fork are licenced under the GPLv3 or later version licence.

Dependencies

This package requires the atom-build or its fork buildium to be installed and operate succesfully.

What's new

0.12.5

Migrated to an external library to manage the configuration from atom.

0.12.4

Technical refactoring for watching the configuration of the plugin.

0.12.3

Put proper copyright notice on source files, prepare licencing of new files under GPLv3 or later.

0.12.2

• Resolves #2 : [rework] enumerations of generators

0.12.1

• Fixed : use 'atom.project.onDidChangeFiles(...)' instead of 'fs.watch(...)'

Preview

Configuration

Default Configuration

By default four different build configurations are supported, Debug, Release, RelWithDebInfo, and MinSizeRel all using the default CMake generator for you platform. Basic default generation and build settings such as build location, cmake arguments, and build tool arguments can be configured in the project settings, for more advanced configuration see the Custom Configuration section.

Custom Configuration

Custom configuration options can be defined in a file called CMakeSettings.json at the root of your project folder. The name and schema of this file was intentionally created to match Visual Studio 15 2017's implementation.

Here is an example CMakeSettings.json file.

{
  "configurations": [
    {
      "name": "Debug",
      "generator": "Unix Makefiles",
      "configurationType" : "Debug",
      "buildRoot":  "${projectDir}/build/${name}",
      "cmakeCommandArgs":  "",
      "buildCommandArgs": "",
      "ctestCommandArgs":  "",
      "variables": [{
        "name": "TEST_VAR",
        "value": "ON"
        }]
    },
    {
      "name": "Release",
      "generator": "Unix Makefiles",
      "configurationType" : "Release",
      "buildRoot": "${projectDir}/build/${name}",
      "cmakeCommandArgs": "",
      "buildCommandArgs": "",
      "ctestCommandArgs": ""
    }
  ]
}

A configuration is an JSON object containing the fields.

• name:

A string that describes the current configuration.

• generator:

A string containing one of the CMake generators to use for the current configuration.

• configurationType:

A string with one of the values; Debug, Release, RelWithDebInfo, or MinSizeRel.

• buildRoot:

A string containing the build location for the current configuration, this field supports variable replacement.

• cmakeCommandArgs:

A string of extra arguments to pass to CMake, this field supports variable replacement.

• buildCommandArgs:

A string of extra arguments to pass to the build tool, this field supports variable replacement.

• ctestCommandArgs:

This string value is ignored for now.

• variables:

A list of objects that define a variable to be passed to CMake equivalent to -Dname=value.

Variable Replacement

The following variable substitutions will be made on the configuration fields that are marked as supporting variable replacement.

• ${projectFile} - The path of the root CMakeLists.txt file.
• ${projectDir} - The current project directory.
• ${thisFile} - The path to the CMakeSettings.json file if one exits.
• ${name} - The name of this configuration.
• ${generator} - Then CMake generator used for this configuration.
• ${TMPDIR} - The operating system's default temp directory.
• ${PROJECT_DIR} - The current project directory.
• ${PROJECT_DIRNAME} - The current project directory name.