Skip to content

cobigen eclipse_installation

Malte Brunnlieb edited this page Aug 4, 2017 · 18 revisions

Installation

Remark: CobiGen is preinstalled in the devonfw/devon-ide.

Preconditions

  • Eclipse 4.x

  • Java 7 Runtime (for starting eclipse with CobiGen). This is independent from the target version of your developed code.

Installation steps

  1. Open the eclipse installation dialog
    menu bar → HelpInstall new Software…​

    01 install new software

  2. Open CobiGen’s updatesite
    Insert the update site of your interest into the filed Work with and press Add …​

  3. Follow the installation wizard
    Select CobiGen Eclipse Plug-inNextNext → accept the license → FinishOKYes

  4. Once installed, a new menu entry named "CobiGen" will show up in the Package Explorer’s context menu. In the sub menu there will the Generate…​ command, which will start the generation wizard of CobiGen.

  5. Checkout (clone) your project’s templates folder or use the current templates released with CobiGen (https://github.com/devonfw/tools-cobigen/tree/master/cobigen-templates) and then choose Import -> General -> Existing Projects into Workspace to import the templates into your workspace.

  6. Now you can start generating. To get an introduction of CobiGen try the oasp4j templates and work on the oasp4j sample application. There you might want to start with Entity objects as a selection to run CobiGen with, which will give you a good overview of what CobiGen can be used for right out of the box in oasp4j based development. If you need some more introduction in how to come up with your templates and increments, please be referred to the documentation of the context configuration and the templates configuration

Dependent on your context configuration menu entry Generate…​ may be greyed out or not. See for more information about valid selections for generation.

Updating

In general updating CobiGen for eclipse is done via the update mechanism of eclipse directly.

Upgrading to v3

Upgrading from eclipse previous to v3.0.0 to v3.0.0 will take some more attention due to a changed plug-in architecture of cobigen-core and the eclipse integration. Eventually, we were able to provide any plug-in of CobiGen seperately as its own eclipse bundle (fragment), which is automatically discovered by the main CobiGen Eclipse Plug-in after installation.

Clone this wiki locally