Entwickler Tutorial (Legacy)
Installation von ProcessCube-Extensions für das Studio

Installation von ProcessCube-Extensions für das Studio

Auf dieser Seite wird gezeigt, wie man ProcesCube-Extensions für das Studio installiert.

Voraussetzungen

Für die Installation von Extensions wird die ProcessCube CLI verwendet. Diese lässt sich mit folgendem Befehl installieren:

npm install @5minds/processcube_cli

Installieren einer Extension

Es gibt verschiedene Arten, eine Extension zu installieren. Im Folgenden werden diese erklärt.

Installieren einer lokalen Extension-Datei

Installieren einer lokal existierenden Extension-Datei (tar oder auch zip) ist einfach:

pc install <extension-name>.<datei-endung>

Installieren einer Extension über eine URL

Zur installation einer Extension über eine URL muss folgender Befehl genutzt werden:

pc install http://<url-zur-extension>.<datei-endung>

Installation einer Extension als NPM-Paket

Wenn das NPM-Repository privat ist muss Folgender Befehl ausgeführt werden, Um die gewünschte Erweiterung zu installieren, der das Paket zuerst herunterlädt:

npm pack <orga>/<npm-paket-name>

Beispiel:

npm pack @5minds/processcube-documentation-plugin

Anschließend muss im Studio-Extension-Ordner die Ordnerstruktur angelegt werden:

mkdir -p ~/.processcube/studio/extensions/<orga>/<extension-name>

Beispiel:

mkdir -p ~/.processcube/studio/extensions/@5minds/processcube-documentation-plugin

Nun ist es an der Zeit mittels der processcube_cli die Erweiterung zu installieren:

pc install --type studio -y ./<paket-name>.<datei-endung>

Beispiel:

pc install --type studio -y ./<processcube-documentation-plugin.tgz>

Der Name des Plugins muss angepasst werden. Da die .tgz Datei im Aktuellen Ordner ist, kann man Tab-Completion nutzen.

Wenn das getan ist, fehlt nur ein letzter Schritt. Folgender Befehl wird die Erweiterung ausführbar für das Studio machen:

mv ~/.processcube/studio/extensions/<orga>/<extension-name> ~/.processcube/studio/extensions

Beispiel:

mv ~/.processcube/studio/extensions/@5minds/processcube-documentation-plugin ~/.processcube/studio/extensions/

Das hinterlässt den @5minds-Ordner leer und kann daher wie folgt gelöscht werden:

rm -rf ~/.processcube/studio/extensions/<orga>

Beispiel:

rm -rf ~/.processcube/studio/extension/@5minds