You are viewing the Portuguese (Brazil) site, but your language preference is set to English. Switch to English site →

Menu

Executar vários plugins localmente usando a CLI do Flex Plugins

O comando twilio flex:plugins:start permite carregar vários plugins em uma instância local do Flex. Ele pode carregar plugins a partir do diretório de origem local de um plugin ou daqueles que estão atualmente ativados em seu aplicativo Flex. Este comando facilita e agiliza o teste de um plugin que você está desenvolvendo localmente com outros plugins.

Versões compatíveis da CLI

Você precisa instalar a versão mais recente da CLI do Flex Plugins para usar esses recursos. Se estiver migrando um plugin legado para usar a nova CLI, consulte nosso Guia de migração.

Registrar plugins existentes

Os plugins em sua máquina de desenvolvimento devem ser registrados com a CLI do Plugins se você quiser incluí‐los em um ambiente de teste. Para registrar seus plugins:

Opção 1: faça o download da fonte do plugin usando a CLI.

twilio flex:plugins:create --template <github url of plugin> --install

Opção 2: registre um plugin já existente em sua máquina.

# Executed within the directory of your plugin
twilio flex:plugins:start

Executar vários plugins

A CLI do Plugins pode acessar qualquer plugin que você tenha implantado em sua conta Flex (plugins remotos) e qualquer plugin que esteja em desenvolvimento em sua própria máquina (plugins locais).

Usando plugins locais

Você pode escolher os plugins que deseja executar localmente usando o argumento --name. O nome corresponde ao campo de nome no package.json do plugin. Quando você executa o comando em seu diretório de plugins, não precisa passar o nome do plugin.

plugin-agent-response $ twilio flex:plugins:start --name plugin-sample

O comando faz o seguinte:

  • Inicia uma instância local do Flex.
  • Como o comando está sendo executado em um diretório de plugins, ele carrega plugin-agent-response.
  • Como plugin-sample está sendo passado usando o argumento --name, ele também carrega plugin-sample.

Por padrão, sua instância Flex local pode ser acessada a partir do localhost:3000. Se você vir uma página de login, a opção 'Login with Twilio' (Fazer login com a Twilio) fará login no Flex sem configurar o SSO.

Consulte a saída do terminal para obter informações sobre os diretórios de plugins que estão sendo usados pelo servidor local:

Multipluginlocal.png

Usando plugins remotos

Visualizando plugins implantados em seu aplicativo Flex

Você pode visualizar os plugins atualmente implantados em seu aplicativo Flex acessando o Plugins Dashboard (Dashboard de plugins) ou executando o seguinte comando por meio da CLI:

twilio flex:plugins:list:plugins

Incluindo todos os plugins remotos

Use o argumento --include-remote para carregar todos os plugins que já estão ativados em seu aplicativo Flex em execução. Este atalho permite testar novas alterações em seu ambiente Flex normal sem fazer o download manual e executar cada plugin individualmente.

plugin-agent-response $ twilio flex:plugins:start --include-remote

O comando faz o seguinte:

  • Inicia uma instância local do Flex.
  • Como o comando está sendo executado em um diretório de plugins, ele carrega plugin-agent-response.
  • Como --include-remote é usado, ele acessa seu aplicativo Flex em execução, busca a lista de todos os plugins atualmente ativados e carrega cada um deles junto a plugin-agent-response.

Se plugin-agent-response já estiver implantado em seu aplicativo Flex em execução, a versão local será usada no lugar da versão remota.

Um exemplo de saída é mostrado abaixo:

multiplugins-includeremote.png

Incluindo plugins remotos selecionados

Você pode usar a tag @remote se quiser executar apenas um subconjunto de plugins ativos. A tag @remote carregará automaticamente a versão que está atualmente ativa no aplicativo Flex. Cada plugin que você deseja incluir deve ser identificado com o sinalizador --name.

plugin-agent-response $ twilio flex:plugins:start --name plugin-agent-notes@remote

Um exemplo de saída é mostrado abaixo:

multiplugin-remote.png

Incluindo a versão de plugin remoto selecionada

Você pode escolher uma versão de um plugin para carregar usando o formato plugin name@version. Você precisa garantir que a versão tenha sido implantada em seu aplicativo Flex. Isso permite que você execute um plugin remoto localmente sem habilitá‐lo em sua conta.

plugin-sample $ twilio flex:plugins:start --name plugin-agent-notes@1.0.0

Um exemplo de saída é mostrado abaixo:

skitch-version-cli-start.png

Exibir todos os plugins registrados pela CLI do Flex Plugins

Esse arquivo de configurações é usado para identificar quais plugins podem ser acessados pela CLI. Se você remover ou editar esse arquivo, talvez seja necessário registrar novamente seus plugins usando os métodos listados acima.

A CLI do Plugins controla todos os plugins registrados em um arquivo de configurações. Para exibir detalhes sobre seus plugins registrados:

macOS/Linux

cd & cat ~/.twilio-cli/flex/plugins.json

Windows

Execute o seguinte comando em seu diretório base ( C:\Users\$USERNAME)

type .twilio-cli\flex\plugins.json

Ao testar seu plugin em vários aplicativos Flex, recomendamos alternar seu projeto dentro de seu aplicativo Flex remoto e reiniciar o servidor de desenvolvimento.

Próximas etapas

Classifique esta página:

Precisa de ajuda?

Às vezes, todos nós precisamos; a programação é difícil. Receba ajuda agora da nossa equipe de suporte, ou confie na sabedoria da multidão navegando pelo Stack Overflow Collective da Twilio ou buscando a tag Twilio no Stack Overflow.

Obrigado pelo seu feedback!

Selecione o(s) motivo(s) para seu feedback. As informações adicionais que você fornece nos ajudam a melhorar nossa documentação:

Enviando seu feedback...
🎉 Obrigado pelo seu feedback!
Algo deu errado. Tente novamente.

Obrigado pelo seu feedback!

thanks-feedback-gif