nb plugin import

Importiert ein verpacktes Plugin-Archiv oder npm-Paket nach storage/plugins. Dieser Befehl legt das Plugin nur im Zielverzeichnis ab. Aktiviert wird es dabei nicht automatisch.

Verwendung

nb plugin import <archive> [flags]

Parameter

ParameterTypBeschreibung
<archive>stringPlugin-Quelle. Pflichtfeld. Unterstützt einen lokalen .tgz-Pfad, eine entfernte http(s)-Archiv-URL oder einen npm-Paketnamen / Tag
--env, -estringName der CLI env. Wenn nicht angegeben, wird normalerweise die aktuelle env verwendet. Wenn du --storage-path explizit angibst, kannst du --env weglassen
--yes, -ybooleanÜberspringt die interaktive Bestätigung, wenn ein explizit gesetztes --env auf eine andere env als die aktuelle zeigt
--storage-pathstringÜberschreibt den Zielpfad des Storage-Wurzelverzeichnisses. Das tatsächliche Importverzeichnis ist <storage-path>/plugins
--npm-registrystringGibt an, welches npm-Registry verwendet werden soll, wenn die Quelle ein npm-Paketname oder Tag ist

Beispiele

# Entferntes Archiv
nb plugin import https://github.com/nocobase/plugin-auth-cas/releases/download/v1.4.0/plugin-auth-cas-1.4.0.tgz

# Lokales Archiv
nb plugin import /your/path/plugin-auth-cas-1.4.0.tgz

# npm-Paket oder Tag
nb plugin import @my-scope/plugin-auth-cas@beta

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

# Direkt in einen lokalen Storage-Pfad schreiben, ohne auf die aktuelle env zu setzen
nb plugin import ./plugin-auth-cas-1.4.0.tgz --storage-path ./storage

Hinweise

Wenn du die Ziel-env schon ausgewählt hast, reicht es normalerweise aus, direkt in storage/plugins dieser env zu importieren.

Wenn du das Plugin nur in ein lokales Storage-Verzeichnis schreiben willst, gib --storage-path explizit an. Dann kannst du --env weglassen und die CLI schreibt direkt nach <storage-path>/plugins.

Nach dem Import ist der übliche nächste Schritt ein Neustart der App. Danach entscheidest du, ob das Plugin zusätzlich aktiviert werden muss. In den meisten Fällen gilt:

  • Bei einer Erstinstallation zuerst nb app restart ausführen und danach nb plugin enable
  • Wenn du nur eine neuere Version erneut importiert hast, zuerst neu starten und dann prüfen, ob die neue Version bereits geladen wurde

Wenn die Quelle in einem privaten npm-Registry liegt, loggst du dich normalerweise zuerst ein und startest dann den Import:

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

Du musst nichts manuell nach storage/plugins entpacken. nb plugin import legt das Plugin automatisch im richtigen Verzeichnis ab.

Verwandte Befehle