Eclipse

Aus SDQ-Wiki

Eclipse ist das für Implementierungsarbeiten bei SDQ standardmäßig verwendete Framework zur Erstellung von Software-Werkzeugen. Auf dieser Seite finden sich Hinweise zur Installation und Einrichtung von Eclipse sowie eine Sammlung weiterführender Links.

Eclipse

  • Download:
  • Installation:
    • Einfach das heruntergeladene Eclipse-Paket im Zielverzeichnis entpacken - fertig!
  • Konfiguration:
    • Editiere eclipse.ini (siehe auch Eclipse-Hilfe):
      • Stelle Speicher zur Verfügung (benötigt für PCM): XXMaxPermSize 512, Xmx 512
      • Spezifiziere ggfs. die zu verwendende VM explizit

Hier eine eclipse.ini Beispieldatei:

-showsplash
org.eclipse.platform
--launcher.XXMaxPermSize
512M
-framework
plugins\org.eclipse.osgi_3.4.3.R34x_v20081215-1030.jar
-vm
C:\Program Files\Java\JDK6\bin
-vmargs
-Dosgi.requiredJavaVersion=1.5
-Xms40m
-Xmx512m

Beim Start einer Launch Configuration aus einem laufenden Eclispe heraus in der Registerkarte Arguments unter VM arguments folgendes angeben:

-Xmx512M
-XX:MaxPermSize=512M
  • Für die Nutzung von IntelliJ bitte diese IntelliJ Anleitung beachten.

PCM

Installationsanleitungen und weitere Informationen auf der Portalseite von Palladio Component Model (PCM) zusammengefasst

Weitere Tools und Richtlinien

Zur Anbindung von Eclipse an das SVN-Repository, in dem der PCM-Code enthalten ist, dient Subversive. Darüber hinaus werden bei SDQ Richtlinien vereinbart, die eine gleichbleibend hohe Qualität der Implementierungsarbeiten gewährleisten sollen. Die folgenden Verweise beschreiben diese Richtlinien und die Werkzeuge, die zu ihrer Umsetzung benötigt werden:

  • Die Einhaltung der SDQ-Code-Konventionen wird durch Checkstyle überprüft
  • Die Dokumentation des Quellcodes erfolgt mit Javadoc
  • Die automatisierte Durchführung von Softwaretests ermöglicht JUnit
  • Zur Verwaltung und Verfolgung von Fehlern und Verbesserungsvorschlägen wird Jira eingesetzt
  • Zur statischen Erkennung von häufigen Fehlermustern kann FindBugs verwendet werden

Weblinks

Überblick

Plugins

Tutorials

Eclipse Modeling Framework (EMF)

Graphical Modeling Framework (GMF)

Sollte nicht mehr verwendet werden. Es sollte besser ein Sirius Editor verwendet werden


Trouble Shooting

  • Eclipse hangs / freezes on startup
    • try to start Eclipse with the -clean option
    • try to remove the file .snap from your <workspace>\.metadata\.plugins\org.eclipse.core.resources (tip from Stackoverflow.com).
    • If Eclipse is hanging while building, try disabling the automated build and see whether you can build manually (maybe all projects separately).
      • To disable the automated build, add the line "description.autobuilding=false" to <workspace>\.metadata\.plugins\org.eclipse.core.runtime\.settings\org.eclipse.core.resources.prefs or change it to false if the line is already there.
    • Rename the folders in which your projects reside in your workspace so that Eclipse will not find them. Then start Eclipse. It will show the projects as closed because it cannot find the .project folder. Then change the name of the folders back and open the projects one by one.

Tips and Tricks

  • Store Run Configurations in SVN with your project: You can also share Eclipse run configurations (launch configurations) with your project data.
    • You find your created run configs at <your workspace>\.metadata\.plugins\org.eclipse.debug.core\.launches
    • Eclipse also searches for run configs in <your project>\.settings
    • You can move a created run config from the .launches folder to the .settings folder in your project and then add it to version control.
    • Refresh your project in Eclipse to detect new and changed run configs
    • When you now edit the run config, the changes are stored in your project folder/.settings
    • Now, colleagues can use the same run config when working with your project, and you know which settings you used when looking at it later.
    • Unfortunately, some paths (e.g. model paths) are absolute in the config, so other users may have to adjust those.