Introduction

The CMake Wiki mentions the options to use CMake with Eclipse. This Eclipse plugin offers an option to automatically generate buildscripts for the Eclipse CDT managed build system from your CMake scripts.

Why cmake4eclipse?

Blindly invoked, CMake will generate makefiles (or other build scripts) inside the source tree, cluttering it with lots of files and directories that have to be fleed out from version control: This practice might be ok for simple hello-world-projects, but for larger projects, the CMake developers recommend You to set up a separate directory for building the source.

Annoyingly, these recommended out-of-source-builds impose some tedious tasks on Your co-workers who check out the code and just want to build it:

leave eclipse workbench,
manually fire up a command-line shell,
manually create a directory for the out-of-source-build,
manually change the CWD to that directory,
manually invoke cmake, telling it to generate build scripts, which kind of build scripts you want and where source source files live,
re-enter eclipse workbench, configure the checked out project to use the generated buildscripts.

Cmake4eclipse aims to address these tasks: Co-workers can just check out the source and have all the tedious tasks automated.

Screenshots

Screenshots can be found at the Eclipse Marketplace.

Quick start

If you do not have any existing code, check out the Sample Projects, chose one and fill in your code.
If you have an existing C/C++ project code, inside Eclipse, goto Help:Help Contents, then read the CMake for CDT User Guide:Getting Started node to adjust your project settings.

License

The plugin is licensed under the Eclipse Public License Version 1.0 ("EPL").

System Requirements

CDT v 8.7 or newer and Eclipse v 4.5 (Mars) or newer

Java 8 or newer

Installation Instructions

The easiest way is to drag this: to your running Eclipse workbench.

Alternatively, cmake4eclipse can be installed into Eclipse using the "Install New Software..." dialog and entering the update site URL listed below.

Update Site

This composite update site is for use in a Eclipse workbench and contains the latest release as well as selected older releases: https://raw.githubusercontent.com/15knots/cmake4eclipse/master/releng/comp-update/.

Tool integrators will find each release at bintray. Each release is provided as a standalone zipped p2 repository and can be consumed in a PDE target platform. To add one of these repositories to your target platform, add a Software Site and enter a URL for the location as jar:https://dl.bintray.com/15knots/p2-zip/cmake4eclipse-1.12.1.zip!/ (note the leading jar: and the trailing !/).

Debug and Build

This project uses Apache maven as its build system. To build from a command-line, run mvn -f ./parent/pom.xml package in the root directory of the project source files.

There is a run configuration for eclipse to invoke maven build cmake4eclipse plus a launch configuration to debug the plugin: cmake4eclipse.

Release Notes

1.13.0 (201?-??-??)

Changes

Fix #94: CMAKE_EXPORT_COMPILE_COMMANDS parser fails to parse inline-command-files @<<...<<
Fix #97: Adjust documentation to newer CDT versions.
CMAKE_EXPORT_COMPILE_COMMANDS Built-ins Parser: run detection in container, if build runs in container.
UI/doc: Use Cmake4eclipse instead of just CMake to avoid confusion with CDT`s new cmake support.
Add optional console view for compiler built-ins detection (#96).
Fix: CMAKE_EXPORT_COMPILE_COMMANDS * Parser settings were not persisted for projects.

1.12.2 (2018-09-23)

Changes

Change related to #73 (CMake Error Parser): Deleted the old parser (which was based on CDT output handling and gave poor results) and re-wrote it from scratch. Note that the new parser does not claim to detect any cmake message; more input from the community is required to detect more messages.
Removed deprecated CMake Build Output Parser.

1.12.1 (2018-07-28)

Changes

Fixed #86: Parsing compile_commands.json creates duplicate entries.
Fixed #85: Poor workbench startup performance due to doing a IIndexManger.reindex().
Fixed #84: CMAKE_EXPORT_COMPILE_COMMANDS Parser no longer detects macros specified on a command-line.
Fixed #79: CMAKE_EXPORT_COMPILE_COMMANDS Parser does not detect compiler-built-in macros and include paths.
Builtins-detector get no longer started in non-existing CWD.
Plugin now requires Java 8, Eclipse 4.5 (mars) and CDT 8.7 to run.
Reworked documentation (a little).

1.12.0 (2018-07-04)

Changes

Fixed #79: CMAKE_EXPORT_COMPILE_COMMANDS Parser does not detect compiler-built-in macros and include paths. (Forget CDT's GCC-builtin-specs-detector:-)

1.11.2 (2018-05-23)

Changes

Fixed #78: NPE when running builder 'CDT Builder' on project.
Fixed #80: Custom build command is not used verbatim.

1.11.1 (2018-05-02)

Changes

Eliminate duplicate mnemonics in UI.
Build in docker container: Fix NPE occurring in CDT 9.4+ with docker build launcher.
Build in docker container: let CDT copy header files back when building in a docker container.

1.11.0 (2018-03-12)

Changes

Fixed #52: Allow to run parallel builds.
Fail the build if build tool name cannot be determined from CMakeCache.txt.

1.10.0 (2018-02-14)

Changes

Fixed #65: Recognize nvcc as a CUDA compiler and integrate with the Nsight Eclipse Plugins.
Merge pull request #67 from @havogt: Allow -isystem without whitespace.
Fixed #68: Allow to parse -isystem= (nvcc compiler).

1.9.1 (2018-01-24)

Changes

Fixed #64: Project is fully reindexed after each build.

1.9.0 (2017-12-29)

Changes

Enhancement: Improve diagnostic messages during build-script generation.
Enhancement #23: Handle CDT variables instead of just eclipse core variables.
Enhancement #58: CMAKE_EXPORT_COMPILE_COMMANDS Parser now evaluates compiler options passed in a "response file".
Enhancement #52: Make 'CMake Make Builder' GNU-make specific and allow to build in parallel. Builder renamed to 'CMake Builder (GNU Make)'

1.8.0 (2017-11-18)

Changes

Enhancement #54: Support variable expansion in build output location.
Fixed #55: NPE if project is of plain make-nature (no managed build).
Fixed #51: No error message in build log, when cmake executable could not be found.
Revised online documentation.
Enhancement #57: Add workaround for relative include paths produced by cmake`s ninja generator.

1.7.0 (2017-09-26)

Changes

Enhancement #29: make the Output directory configurable
Fixed #48 NPE in project configuration when OK button is clicked

1.6.0 (2017-09-13)

Changes

Enhancement #46 Populate CMake cache entries from a file
Enhancement: Added mnemonics to UI
Fixed: "ResourceException: The resource tree is locked for modifications" when opening project.
Fixed #38: Build occurs in eclipse install directory.

1.5.0 (2017-08-26)

Changes

fixed #43 CMAKE_EXPORT_COMPILE_COMMANDS Parser should support different versions of compilers
Fixed #44: CMAKE_EXPORT_COMPILE_COMMANDS Parser fails for command paths using a forward slash
CMAKE_EXPORT_COMPILE_COMMANDS Parser show problems in Problems View instead of writing them to the application log file

1.4.9 (2017-07-18)

Changes

Fixed #36: Variable substitution for CMake executable
Added documentation on project builders
Fixed #41: CMAKE_EXPORT_COMPILE_COMMANDS Parser doesn't work if compiler command doesn't contain full path
Fixed #39: Enabling build output parser does not pass necessary arguments to cmake

1.4.8 (2017-05-22)

Changes

Closed #26: CMakeFiles, cache and others generated into wrong directory
Closed #31: CMAKE_EXPORT_COMPILE_COMMANDS Parser fails if compiler executable has a MSDOS "Short path" name. Thanks to @nolange for reporting and testing under windows
Requires Java 7 or newer

Repository URL

jar:https://bintray.com/artifact/download/15knots/p2-zip/cmake4eclipse-1.4.8.zip!/

System Requirements

CDT v 8.7 or newer and Eclipse v 4.5 (Mars) or newer

Java 8 or newer

1.4.7 (2017-04-11)

Changes

Closed #28: CMAKE_BUILD_TOOL is deprecated in cmake version 3.0

Repository URL

jar:https://bintray.com/artifact/download/15knots/p2-zip/cmake4eclipse-1.4.7.zip!/

System Requirements

CDT v 8.1.0 or higher and Eclipse v 3.8.0 (Juno) or higher

1.4.6 (2017-03-20)

Changes

Closed #24: CMake dialog box does not save all modified configs.

Repository URL

jar:https://bintray.com/artifact/download/15knots/p2-zip/cmake4eclipse-1.4.6.zip!/

System Requirements

CDT v 8.1.0 or higher and Eclipse v 3.8.0 (Juno) or higher

1.4.5 (2016-11-08)

Changes

Closed #20: CMAKE_EXPORT_COMPILE_COMMANDS Parser treats clang++ as a C compiler.

Repository URL

jar:https://bintray.com/artifact/download/15knots/p2-zip/cmake4eclipse-1.4.5.zip!/

System Requirements

CDT v 8.1.0 or higher and Eclipse v 3.8.0 (Juno) or higher

1.4.4 (2016-10-05)

Changes

Closed #17: CMAKE_EXPORT_COMPILE_COMMANDS parser doesn't recognize g++ as a C++ compiler.

Repository URL

jar:https://bintray.com/artifact/download/15knots/p2-zip/cmake4eclipse-1.4.4.zip!/

System Requirements

CDT v 8.1.0 or higher and Eclipse v 3.8.0 (Juno) or higher

1.4.3 (2016-08-30)

Changes

Closed #16: The CMAKE_EXPORT_COMPILE_COMMANDS parser now knows about GCC cross compilers for C and C++ if the compiler executable follows the naming convention of <target_triplet>-gcc or <target_triplet>-g++.

Repository URL

jar:https://bintray.com/artifact/download/15knots/p2-zip/cmake4eclipse-1.4.3.zip!/

System Requirements

CDT v 8.1.0 or higher and Eclipse v 3.8.0 (Juno) or higher

1.4.2 (2016-05-30)

Changes

CMAKE_EXPORT_COMPILE_COMMANDS Parser triggers UI update to show newly detected include paths in project explorer view.
Closed #14: Pass variables given in C++ Build->Environment to the cmake process.

Repository URL

jar:https://bintray.com/artifact/download/15knots/p2-zip/cmake4eclipse-1.4.2.zip!/

System Requirements

CDT v 8.1.0 or higher and Eclipse v 3.8.0 (Juno) or higher

1.4.1 (2016-03-08)

Changes

Closes #9: Improve support for code-completion and symbol browsing in CDT source editors.
Closes #10: Can't install version 1.4.0 in eclipse mars.2 release 4.5.2

Repository URL

Ancient Releases

Other revisions can be found at https://googledrive.com/host/0B-QU1Qnto3huZUZ0QUdxM01pR0U/ .
Do not forget to add the trailing !/ to the repository URL!