Initial draft

[nfode]

@miwurster hier der erste Draft. Ich muss noch reinkommen, geht das aber für dich in die richtige Richtung?

[miwurster]

Ja super! Das geht in die richtige Richtung!

[miwurster]

Generell sollten wir diese Punkte grob abdecken:

• Generell das Konzept der Implementierung
• Was muss man tun um das Plugin zu erweitern / bauen
• Pointer zu den Stellen in der Che Doku
• Build & Packaging Prozess kurz skizzieren

[miwurster]

@nfode ping

Wie schon per Mail gesagt, mir reichen auch Stichpunkte. Ausformulieren kann ich das selbst. Ich brauch nur ein paar Pointer und Stichpunkte um das alles erfassen.

[nfode]

Sorry, dass ich gerade eine so lange Leitung habe.

Grundsaetzlich kann man sagen, dass man eine Extension geschrieben hat, um auf den URL-Pfad zu greifen zu koennen. Das geht mit einem Plugin nicht. Hier ein Vergleich: https://eclipsesource.com/blogs/2019/10/10/eclipse-theia-extensions-vs-plugins-vs-che-theia-plugins/

Zum Build & Packaging Prozess von Theia:

• Hier gibs eine Anleitung wie man Theia mit Dockerfiles baut: https://github.com/eclipse/che-theia/blob/master/dockerfiles/theia/README.md
• Generell kann man sich von den Che-Theia Workflows hier abschauen wie man das ganze baut. Da kommt der Workflow in dem repo hier auch her
• Wenn man das ganze gebaut hat, kann man es wie im Plugin-File hier, integrieren:

  che-winery-extension/deploy/che-theia.yaml

  Line 61 in f0038aa

  image: "opentosca/che-theia:next"

Zum Bauen und Entwickeln von Extensions:

• Aus der Theia Doc kann man sich viel Informationen ziehen: https://github.com/eclipse-theia/theia/blob/master/doc/Developing.md
• Man clont praktisch das eclipse-theia/theia project und kann dann seine Extension reinwerfen, z.B. in dem Examples um dann zu bauen und wie im Guide beschrieben zu debuggen
• Hier der Guide auch ein Guide: https://theia-ide.org/docs/authoring_extensions/
• Mein Vorgehen war aber meistens den Docker Container wie in der Pipeline zu bauen und dann in Eclipse Che zu laden um zu testen, ob das wirklich in der Umgebung tut.

Wie das ganze funktioniert habe ich schon in How does the extension work? beschrieben. Mehr gibts da eigentlich nicht.

Der haupsaechliche Code liegt hier https://github.com/OpenTOSCA/che-winery-extension/blob/master/src/browser/winery-contribution.ts die Methode onReady wird aufgerufen wenn die UI geladen wird, dann parsen wir die URL und oeffnen ein Tosca-File sofern vorhanden.

Reicht dir das so weit? Wenn du explizite Fragen hast, versuche ich sie so schnell wie moeglich zu beantworten!