#Установка и обновление сторонних плагинов

Если вы получили пакет подключаемого модуля стороннего производителя, обычно импортируйте его в storage/plugins целевого приложения, затем перезапустите приложение, а затем продолжайте включать или проверять, вступит ли подключаемый модуль в силу.

#Быстрый индекс

#Сначала подтвердите целевую среду

Если вы управляете несколькими приложениями локально, сначала переключитесь на целевую среду, а затем действуйте:

nb env use app1

#Используйте nb plugin import для импорта пакета плагина

nb plugin import поддерживает три типа источников: удаленные сжатые пакеты, локальные сжатые пакеты и имена пакетов npm. Эта команда отвечает только за импорт плагина в storage/plugins и не включает плагин автоматически.

Если вы получили адрес загрузки пакета плагина, путь к локальному файлу или плагин опубликован в npm, вы можете выполнить:

# 远程压缩包
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

Если вы используете частный источник npm, обычно сначала войдите в систему, а затем укажите реестр:

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

#Укажите путь к хранилищу для импорта

Если вы уже знаете корневой каталог storage целевого приложения, вы также можете передать --storage-path напрямую, не полагаясь на текущую среду:

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

CLI запишет плагин в <storage-path>/plugins. В настоящее время вы не можете сначала выполнить nb env use или передать --env.

#Перезагрузка после импорта

После завершения импорта перезапустите целевое приложение:

nb app restart

Если вы сначала не переключите текущую среду окружения, вы также можете явно передать -e <env> в команде.

#Включить или проверить после перезапуска

Если это первая установка, перезапустите и затем включите плагин:

nb plugin enable @nocobase/plugin-auth-cas

Установка будет завершена автоматически при первом включении.

#Что делать при обновлении плагинов

Если плагин уже включен и в этот раз вы просто переключаетесь на новую версию, обычно требуется всего два шага:

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

То же самое применимо, если вы импортируете пакет npm:

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

Другими словами, сценарий обновления не требует дополнительного выполнения nb plugin enable. Просто импортируйте новый пакет и перезапустите приложение.

#Когда невозможно подключиться к Интернету напрямую

Если целевой компьютер не может напрямую получить доступ к адресу загрузки подключаемого модуля, вы можете сначала загрузить файл .tgz в любой каталог на целевом компьютере, а затем выполнить локальный импорт на целевом компьютере.

например:

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

:::предупреждение

Здесь нет необходимости вручную извлекать данные в storage/plugins. nb plugin import автоматически поместит плагин в правильный каталог.

:::