Instalar e atualizar plugins

Plugins integrados

Os plugins integrados do NocoBase são atualizados automaticamente junto com a versão do núcleo, sem necessidade de operação manual.

Plugins comerciais

Para métodos detalhados de ativação e atualização, consulte: Ativação e atualização de plugins comerciais

Plugins de terceiros

Instalar plugins pela linha de comando

yarn pm pull https://github.com/nocobase/plugin-auth-cas/releases/download/v1.4.0/plugin-auth-cas-1.4.0.tgz
yarn pm pull /your/path/plugin-auth-cas-1.4.0.tgz

Se o aplicativo já tiver esse plugin instalado e precisar atualizá-lo, execute:

yarn nocobase upgrade --skip-code-update

Enviar e descompactar manualmente

Primeiro, baixe o pacote do plugin para o computador local e depois envie-o e descompacte-o manualmente no diretório ./storage/plugins. Se esse plugin já estiver habilitado, execute o comando a seguir após concluir o envio e a descompactação para finalizar a atualização do plugin.

⚠️ Nota: Para evitar problemas de cache, certifique-se de que o aplicativo NocoBase esteja parado antes de executar.

yarn nocobase upgrade --skip-code-update

Forma correta de descompactar um plugin

O exemplo a seguir demonstra como descompactar corretamente o pacote do plugin no diretório especificado:

mkdir -p /my-nocobase/storage/plugins/@nocobase/plugin-auth-cas && \
  tar -xvzf /downloads/plugin-auth-cas-1.4.0.tgz \
  -C /my-nocobase/storage/plugins/@nocobase/plugin-auth-cas \
  --strip-components=1

Esse comando descompacta o plugin no diretório especificado e não cria um nível extra de diretório package.

/my-nocobase/storage/plugins/@nocobase/plugin-auth-cas

Exemplo de estrutura de diretórios correta

./plugin-auth-cas/dist/server/migrations/20240425200816-change-locale-module.js
./plugin-auth-cas/dist/server/auth.js
./plugin-auth-cas/client.js
./plugin-auth-cas/dist/constants.js
./plugin-auth-cas/dist/externalVersion.js
./plugin-auth-cas/dist/client/index.js
./plugin-auth-cas/dist/index.js
./plugin-auth-cas/dist/server/index.js
./plugin-auth-cas/dist/server/actions/login.js
./plugin-auth-cas/dist/server/plugin.js
./plugin-auth-cas/server.js
./plugin-auth-cas/dist/server/actions/service.js
./plugin-auth-cas/dist/locale/en-US.json
./plugin-auth-cas/dist/locale/ko_KR.json
./plugin-auth-cas/package.json
./plugin-auth-cas/dist/locale/zh-CN.json
./plugin-auth-cas/README.md
./plugin-auth-cas/README.zh-CN.md
./plugin-auth-cas/dist/server/migrations/20240425200816-change-locale-module.d.ts
./plugin-auth-cas/dist/server/auth.d.ts
./plugin-auth-cas/client.d.ts
./plugin-auth-cas/dist/constants.d.ts
./plugin-auth-cas/dist/client/index.d.ts
./plugin-auth-cas/dist/client/locale/index.d.ts
./plugin-auth-cas/dist/index.d.ts
./plugin-auth-cas/dist/server/index.d.ts
./plugin-auth-cas/dist/server/actions/login.d.ts
./plugin-auth-cas/dist/client/Options.d.ts
./plugin-auth-cas/dist/server/plugin.d.ts
./plugin-auth-cas/server.d.ts
./plugin-auth-cas/dist/server/actions/service.d.ts
./plugin-auth-cas/dist/client/SigninPage.d.ts
./plugin-auth-cas/LICENSE.txt