Ao publicar um complemento, os usuários podem instalá-lo pelo aplicativo host ou pelo Google Workspace Marketplace. Antes de publicar, teste os complementos desenvolvidos nos aplicativos host que eles estendem.
Nesta página, descrevemos como instalar um complemento que está em desenvolvimento (chamado de complemento não publicado ou para desenvolvedores) para testes ou uso pessoal. Também é possível depurar complementos usando o depurador e os pontos de interrupção do IDE do Apps Script.
Pré-requisitos
- Você precisa ter acesso de editor ao projeto de script do complemento.
- Para permitir que outras pessoas na sua organização testem o complemento, conceda a elas acesso de editor ao projeto de script. Para detalhes sobre como conceder acesso, consulte Colaborar com outros desenvolvedores.
Instalar um complemento não publicado
É possível instalar complementos não publicados na caixa de diálogo Implantações do Apps Script.
Siga estas etapas para instalar um complemento do Google Workspace não publicado para teste:
- Abra o projeto de script no editor do Apps Script.
- Clique em Implantar > Testar implantações.
- Clique em Instalar.
- Na parte de baixo, clique em Concluído.
Você pode permitir que outros usuários testem o complemento compartilhando o projeto do Apps Script com a conta deles (é necessário ter acesso de edição). Em seguida, peça aos usuários para seguir as etapas acima.
Depois de instalado, o complemento fica disponível imediatamente nos aplicativos host que ele estende. Talvez seja necessário atualizar a guia do aplicativo host antes que o complemento apareça. Você também precisa autorizar o complemento antes de usá-lo. Se o projeto já estiver autorizado, use ScriptApp.invalidateAuth para invalidar as autorizações atuais e testar o recurso de OAuth granular no complemento.
Desinstalar um complemento não publicado
Para desinstalar uma implantação de complemento não publicado, siga estas etapas:
- Abra o projeto de script no editor do Apps Script.
- Clique em Implantar > Testar implantações.
- Clique em Desinstalar.
- Na parte de baixo, clique em Concluído.
Essas etapas removem imediatamente a implantação, e o complemento não aparece mais em nenhum aplicativo host. É possível reinstalar a implantação a qualquer momento repetindo o procedimento de instalação.
Práticas recomendadas para testes
Ao testar seu complemento do Google Workspace, siga as práticas recomendadas para o desenvolvimento de complementos. Além disso, faça o seguinte:
Teste os fluxos de navegação do card em todos os aplicativos host que o complemento estende. Verifique se o comportamento do complemento está correto à medida que o usuário muda de contexto e entre cards não contextuais e contextuais.
Use dados de teste de exemplo para avaliar o comportamento do complemento.
Se o complemento se conectar a uma API ou outro serviço de terceiros, verifique se o serviço pode ser acessado e se comporta conforme o esperado. Verifique se o complemento está processando os detalhes de autorização e login corretamente.
Verifique se as condições de erro são tratadas de maneira adequada. Use cards de erro quando necessário.
Preste atenção no desempenho do complemento. Se você fizer uma mudança no código e o complemento começar a ficar mais lento, talvez seja necessário remover ou refazer esse recurso.