Änderungen von Dokument Plugin-Entwicklung


Von Version 5.7
bearbeitet von awa
am 25.02.2022, 13:24
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 5.4
bearbeitet von awa
am 25.02.2022, 13:08
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -219,55 +219,10 @@
219 219  
220 220  == Deploy-Plugin
221 221  
222 -Um beim Entwickeln nicht jedes Mal eine neue Plugin-Version manuell über die Oberfläche hochladen zu müssen, kann das Deploy-Plugin verwendet werden. Dieses besteht aus 2 Teilen:
222 +TODO
223 223  
224 -* Ein Maven-Plugin, welches nach dem Bauen das Plugin via HTTP an einen laufenden {{formcycle/}}-Server sendet
225 -* Ein Plugin für {{formcycle/}}, welche die Gegenstelle in {{formcycle/}} bereitstellt und das Plugin aus dem HTTP-Request in {{formcycle/}} installiert.
224 +== FC-Server-Plugin
226 226  
227 -Weitere Details können im [[Hilfe-Artikel zum Deploy-Plugin>>doc:Formcycle.PluginDocumentation.FormcycleDeployPluginPlugin]] nachgelesen werden. Für die meisten Fälle reicht folgende Konfiguration in der //pom.xml// des Plugin-Projekts aus:
226 +TODO
228 228  
229 -{{code language="xml"}}
230 - <properties>
231 - <fc-deploy-plugin-maven-plugin.version>7.0.1<fc-deploy-plugin-maven-plugin.version/>
232 - <build>
233 - <plugins>
234 - <plugin>
235 - <groupId>de.xima.fc.maven.plugin</groupId>
236 - <artifactId>fc-deploy-plugin-maven-plugin</artifactId>
237 - <version>${fc-deploy-plugin-maven-plugin.version}</version>
238 - <executions>
239 - <execution>
240 - <id>upload</id>
241 - <phase>install</phase>
242 - <goals>
243 - <goal>deploy</goal>
244 - </goals>
245 - </execution>
246 - </executions>
247 - </plugin>
248 - </plugins>
249 - </build>
250 -{{/code}}
251 251  
252 -Sofern das Deploy-Plugin bereits in {{formcycle/}} installiert ist, kann das Plugin-Projekt dann beim Bauen wie folgt hochgeladen werden:
253 -
254 -{{code language="bash"}}
255 -mvn clean install -DfcDeployUrl=http://localhost:8080/xima-formcycle -DfcDeployToken=admin
256 -{{/code}}
257 -
258 -Wird Eclipse benutzt, kann auch eine Launch-Configuration mit den //fcDeployUrl// und dem //fcDeployToken// angelegt werden.
259 -
260 -== FC-Server-Plugin ==
261 -
262 -Zum Testen eines Plugins ist es erforderlich, einen laufenden {{formcycle/}}-Server zu haben. Zur Vereinfachung der Entwicklung gibt es das //fc-server-maven-plugin//, welches mittels eines einzigen Befehls ein fertig eingerichtetes {{formcycle/}} lokal startet, wo auch bereits das Deploy-Plugin vorinstalliert ist.
263 -
264 -Sofern wie oben beschrieben in //~~/.m2/settings.xml// die //pluginGroup// hinterlegt wurde, kann in einem beliebiegen Verzeichnis wie folgt ein {{formcycle/}}-Server per Maven gestartet werden:
265 -
266 -{{code language="bash"}}
267 -mvn fc-server:run-ms-war -DxfcVersion=7.0.10
268 -{{/code}}
269 -
270 -Nach kurzer Wartezeit (beim ersten Mal kann es länger dauern) ist dann ein {{formcycle/}}-Server gestartet. Die URL steht am Ende in der Kommandozeile, standardmäßig http://localhost:8080/xima-formcycle
271 -
272 -Dies funktioniert auch in einem Ordner ohne Maven-Projekt. Falls keine {{formcycle/}} angegeben ist, wird eine Standard-Version genommen. Wird der Befehl innerhalb eines Plugin-Maven-Projekts ausgeführt, wird versucht, die Version von {{formcycle/}} aus dem Plugin-Projekt auszulesen.
273 -