X-Git-Url: https://mograsim.net/gitweb/?a=blobdiff_plain;f=docs%2Fdevelopment_environment.md;h=50d8b4fecc0a109da07c71b2c9c946e25585cc2c;hb=76a3b85c9f04a12244f3a9384b41017680bc9e2d;hp=041c6a210682f84a843d45c085da2d1ef9451d8c;hpb=f72e7f0706149d0413e7c607b861022ea7480cc1;p=Mograsim.git diff --git a/docs/development_environment.md b/docs/development_environment.md index 041c6a21..50d8b4fe 100644 --- a/docs/development_environment.md +++ b/docs/development_environment.md @@ -1,6 +1,6 @@ # Mograsim Development Environment -_Mograsim Development Documentation Version 0.3 --- 2019-09-27_ +_Mograsim Development Documentation Version 0.4 --- 2019-10-17_ A short guide to the Mograsim Maven Tycho configuration and Maven Tycho in general, as well as some information on Eclipse Plugin Development and OSGi. @@ -44,11 +44,6 @@ Roughly, an OSGi bundle has: definition used for the build and the same that maven is run with ( -> check the Run Configuration) -## Eclipse Plugins - -- Short explanation of the different names and terms used in Eclipse Plugin Dev, - and short introduction to the different mechanisms used. - ## Mograsim Structure The tree of Mograsim projects: @@ -154,20 +149,21 @@ A short guide to the [Maven goals (Maven Lifecycle)](https://maven.apache.org/gu - I recommend running `clean verify` or `verify`, this will do everything up to and including the testing. -Please note that Tycho 1.5.0 is not released yet, and thus requires a workaround. -More information can be found under [Maven Core Extension Problems](#mceps). - ## Challenges Not everything is as simple as it seems at first glance. -### Maven Core Extension Problems +### Maven Core Extension Problems + +Context: Tycho 1.5.0 was not released, and thus required a workaround. +This Problem may appear again, maybe with a different core extension, so this section +explains the problem, how to diagnose it and a fairly good workaround. The Tycho extra `tycho-pomless` is a Maven core extension allows for simpler structure and less redundancy. Maven core extensions must be available at [the central maven repository](http://repo.maven.apache.org/maven2/) (or already in the local repository), you cannot specify an alternative remote repository in `.mvn/extensions.xml`. If a core extension cannot be resolved, you will get currently -(Maven 3.6.2) only a warning like +(Maven 3.6.1) only a warning like > [WARNING] The POM for org.eclipse.tycho.extras:tycho-pomless:jar:1.5.0-SNAPSHOT is missing, no dependency information available @@ -222,7 +218,7 @@ in it need to be build, too. But not only that, they need to use the same config for the build, which is problematic if you do not have control over them. The solution only exists with Tycho 1.5.0 (currently only as snapshot), where deep folder structures are automatically scanned and poms get gnereated; not every folder requires an aggregator -pom. This however requires (at the moment) certain naming conventions (see section +pom. This however **requires** (at the moment) certain naming conventions (see section on Tycho itself). In our case, [SWTHelper](https://github.com/Haspamelodica/SWTHelper) is a git submodule