#Instalación y actualización de complementos de terceros

Si obtiene un paquete de complemento de terceros, generalmente impórtelo al storage/plugins de la aplicación de destino, luego reinicie la aplicación y luego continúe habilitando o verificando si el complemento surte efecto.

#Índice rápido

#Confirme primero el entorno de destino

Si administra varias aplicaciones localmente, primero cambie al entorno de destino y luego opere:

nb env use app1

#Utilice nb plugin import para importar el paquete del complemento

nb plugin import admite tres tipos de fuentes: paquetes comprimidos remotos, paquetes comprimidos locales y nombres de paquetes npm. Este comando solo es responsable de importar el complemento a storage/plugins y no lo habilitará automáticamente.

Si obtuvo la dirección de descarga del paquete del complemento, la ruta del archivo local o el complemento se publicó en npm, puede ejecutar:

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

Si está utilizando una fuente npm privada, generalmente inicie sesión primero y luego especifique el registro:

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

#Especifique la ruta de almacenamiento para importar

Si ya conoce el directorio raíz storage de la aplicación de destino, también puede pasar --storage-path directamente sin depender del entorno actual:

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

La CLI escribirá el complemento en <storage-path>/plugins. En este momento, no puede ejecutar nb env use primero ni pasar --env.

#Reiniciar después de importar

Una vez completada la importación, reinicie la aplicación de destino:

nb app restart

Si no cambia primero el entorno actual, también puede pasar explícitamente -e <env> en el comando.

#Habilitar o verificar después de reiniciar

Si esta es la primera instalación, reinicie y luego habilite el complemento:

nb plugin enable @nocobase/plugin-auth-cas

La instalación se completará automáticamente cuando se habilite por primera vez.

#Qué hacer al actualizar complementos

Si el complemento ya está habilitado y esta vez simplemente cambia a una nueva versión, generalmente solo hay dos pasos:

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

Lo mismo se aplica si importa un paquete npm:

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

En otras palabras, el escenario de actualización no requiere la ejecución adicional de nb plugin enable. Simplemente importe el nuevo paquete y reinicie la aplicación.

#Cuando no se puede conectar Internet directamente

Si la máquina de destino no puede acceder directamente a la dirección de descarga del complemento, primero puede cargar el archivo .tgz en cualquier directorio de la máquina de destino y luego realizar la importación local en la máquina de destino.

Por ejemplo:

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

:::nota de advertencia

No es necesario extraer manualmente a storage/plugins aquí. nb plugin import colocará automáticamente el complemento en el directorio correcto.

:::