Skip to content
Stephen Edwards edited this page May 12, 2017 · 1 revision

m2e-nar is an M2Eclipse Connector/Extension for the nar-maven-plugin. It is an Eclipse plugin that automagically configures Eclipse CDT when you import your C/C++ NAR Maven project. The result is an Eclipse project that can be built natively in the IDE to produce the same executable or library as nar-maven-plugin does. In other words, from definitions in a single pom.xml file you can develop, test and debug in a fully functional C/C++ Integrated Development Environment as well as produce formal builds using the nar-maven-plugin.

m2e-nar makes sure the CDT indexer can find all your project source files, as well as those of your NAR dependencies. It also configures the CDT managed build system with the same include paths, defines, libraries, compiler and linker options, etc as the real Maven build. This means you get the full CDT experience for your NAR project including: source navigation, type hierarchy, call graph, include browser, macro definition browser, code editor with syntax highlighting, folding and hyperlink navigation, source code refactoring and code generation, unit testing, visual debugging tools, including memory, registers, and disassembly viewers.

Features of m2e-nar include:

  • Creation of a fully configured CDT project when importing a Maven project that uses nar-maven-plugin
  • Synchronisation of the CDT project with any changes in the pom.xml when using the "Update Project..." m2e menu item
  • Execution of nar-maven-plugin dependency unpacking goals when required to make sure all headers are available
  • Resolution of dependencies against the Eclipse workspace so you can easily work on interdependent projects without intermediate mvn install commands
  • Execution of nar-maven-plugin JNI goals when required to generate JNI headers
  • Creation of a different CDT configuration for each compile and test goal execution in your project

Note that, just like m2e for Java, m2e-nar stops at the compile phase, i.e. no NAR packing is done and no testing is run when you do an Eclipse workspace build. You can do a proper Maven build using the "Run As -> Maven Build" menu item for the full nar-maven-plugin lifecycle.

Head over to the m2e-nar Wiki for the tutorial (COMING SOON!)

Clone this wiki locally