#Plug-in-Installation und Upgrade von Drittanbietern

Wenn Sie ein Plug-in-Paket eines Drittanbieters erhalten, importieren Sie es normalerweise in storage/plugins der Zielanwendung, starten Sie die Anwendung neu und aktivieren Sie dann weiter oder überprüfen Sie, ob das Plug-in wirksam wird.

#Schnellindex

#Bestätigen Sie zuerst die Zielumgebung

Wenn Sie mehrere Anwendungen lokal verwalten, wechseln Sie zunächst zur Zielumgebung und führen Sie dann Folgendes aus:

nb env use app1

#Verwenden Sie nb plugin import, um das Plug-in-Paket zu importieren

nb plugin import unterstützt drei Arten von Quellen: entfernte komprimierte Pakete, lokal komprimierte Pakete und NPM-Paketnamen. Dieser Befehl ist nur für den Import des Plug-Ins in storage/plugins verantwortlich und aktiviert das Plug-In nicht automatisch.

Wenn Sie die Download-Adresse des Plug-in-Pakets oder den lokalen Dateipfad erhalten haben oder das Plug-in in npm veröffentlicht wurde, können Sie Folgendes ausführen:

# 远程压缩包
nb plugin import https://github.com/nocobase/plugin-auth-cas/releases/download/v1.4.0/plugin-auth-cas-1.4.0.tgz

# 本地压缩包
nb plugin import /your/path/plugin-auth-cas-1.4.0.tgz

# npm 包名或 tag
nb plugin import @my-scope/plugin-auth-cas@beta

Wenn Sie eine private NPM-Quelle verwenden, melden Sie sich normalerweise zuerst an und geben Sie dann die Registrierung an:

npm login --registry=https://registry.example.com
nb plugin import @my-scope/plugin-auth-cas@beta --npm-registry=https://registry.example.com

#Geben Sie den Speicherpfad für den Import an

Wenn Sie das Stammverzeichnis storage der Zielanwendung bereits kennen, können Sie --storage-path auch direkt übergeben, ohne auf die aktuelle Umgebung angewiesen zu sein:

nb plugin import /your/path/plugin-auth-cas-1.4.0.tgz --storage-path ./storage

Die CLI schreibt das Plugin in <storage-path>/plugins. Zu diesem Zeitpunkt dürfen Sie nb env use nicht zuerst ausführen oder --env übergeben.

#Nach dem Import neu starten

Nachdem der Import abgeschlossen ist, starten Sie die Zielanwendung neu:

nb app restart

Wenn Sie nicht zuerst die aktuelle Umgebung wechseln, können Sie im Befehl auch explizit -e <env> übergeben.

#Nach dem Neustart aktivieren oder überprüfen

Wenn es sich um die erste Installation handelt, starten Sie das Plugin neu und aktivieren Sie es:

nb plugin enable @nocobase/plugin-auth-cas

Die Installation wird bei der ersten Aktivierung automatisch abgeschlossen.

#Was ist beim Upgrade von Plugins zu tun?

Wenn das Plug-in bereits aktiviert ist und Sie dieses Mal einfach auf eine neue Version wechseln, sind es in der Regel nur zwei Schritte:

nb plugin import /your/path/plugin-auth-cas-1.5.0.tgz
nb app restart

Das Gleiche gilt, wenn Sie ein npm-Paket importieren:

nb plugin import @my-scope/plugin-auth-cas@latest
nb app restart

Mit anderen Worten: Das Upgrade-Szenario erfordert keine zusätzliche Ausführung von nb plugin enable. Importieren Sie einfach das neue Paket und starten Sie die Anwendung neu.

#Wenn das Internet nicht direkt verbunden werden kann

Wenn der Zielcomputer nicht direkt auf die Plug-In-Download-Adresse zugreifen kann, können Sie zunächst die Datei .tgz in ein beliebiges Verzeichnis auf dem Zielcomputer hochladen und dann einen lokalen Import auf dem Zielcomputer durchführen.

Zum Beispiel:

nb plugin import /your/path/plugin-auth-cas-1.4.0.tgz
nb app restart

:::Warnhinweis

Es ist hier nicht erforderlich, manuell nach storage/plugins zu extrahieren. nb plugin import legt das Plug-in automatisch im richtigen Verzeichnis ab.

:::