Testar um complemento do Editor

Os complementos precisam ser testados completamente antes da publicação para garantir que eles se comportem conforme o esperado. O Apps Script permite testar complementos do Editor em desenvolvimento em arquivos específicos do Documentos, Formulários ou Apresentações Google. Isso pode ser usado para:

  • Verifique se um complemento escrito em um script autônomo funciona como pretendido quando aplicado a uma página, documento, apresentação ou formulário.
  • Verifique se o fluxo de instalação do complemento funciona conforme o esperado, principalmente para estados do ciclo de vida de autorização iniciais diferentes (instalado, ativado ou ambos).
  • Verifique se o complemento funciona conforme o esperado ao atuar em um documento específico e no conteúdo dele.
  • Teste e compare a versão atual e as anteriores do complemento.

Criar uma implantação de teste

Uma implantação de teste é a combinação de um complemento e um documento de teste. Depois que você desenvolver uma versão do script e quiser testá-la como um complemento, siga estas etapas:

  1. Se você ainda não tiver um, crie uma planilha, um documento, uma apresentação ou um formulário para testar o complemento.
  2. Abra o projeto de script que contém o complemento.
  3. Clique em Implantar > Testar implantações.
  4. Ao lado de Selecionar tipo, clique em Ativar tipos de implantação e selecione Complemento do editor.
  5. Clique em Criar novo teste ou Adicionar teste.
  6. Escolha uma versão do código ou selecione Último código.
  7. Na seção Configuração, selecione o estado de autorização inicial para o teste.
  8. Em Documento de teste, clique em Nenhum documento selecionado. Selecione o arquivo do Planilhas, Documentos, Apresentações ou Formulários que você quer usar para testar o complemento e clique em Inserir.
  9. Clique em Salvar teste.

Todas as implantações de teste salvas aparecem na caixa de diálogo Testar implantações. Assim, é possível revisitar a mesma implantação de teste mais tarde.

Executar uma implantação de teste

Se você tiver uma ou mais implantações de teste salvas, poderá executar uma delas seguindo estas etapas:

  1. Abra o projeto de script que contém o complemento.
  2. Clique em Implantar > Testar implantações.
  3. Em Testes salvos, selecione o botão de opção ao lado da implantação de teste salva que você quer executar e clique em Executar.

O documento de teste é aberto em uma nova guia. O complemento está no estado de autorização especificado na implantação de teste. Você pode verificar se o complemento funciona conforme o esperado interagindo com os elementos de menu e interface dele.

Detalhes dos testes

É importante lembrar de vários pontos ao testar os complementos do editor dessa maneira:

  • Não há suporte para gatilhos instaláveis durante os testes. As funcionalidades que dependem de acionadores instalados não podem ser testadas.
  • Ao executar uma implantação de teste configurada para testar com o código mais recente, atualize o documento de teste para ver as alterações salvas no script de complemento.
  • O documento de teste tem um URL que você pode compartilhar com os editores do documento de teste original. Dessa forma, fica mais fácil colaborar com outras pessoas durante os testes e o desenvolvimento.
  • Se o complemento usar o serviço de propriedades, as propriedades permanecerão e permanecerão disponíveis na próxima vez que a implantação de teste for executada.
  • Além disso, qualquer implantação de teste que use a mesma combinação de complemento e documento de teste tem acesso às mesmas informações de propriedade. Por exemplo, se você criar duas implantações de teste, as propriedades salvas ao executar a primeira estarão disponíveis durante a execução da segunda e vice-versa, mas somente se as implantações usarem o mesmo script e documento de teste.
  • Se você executar uma implantação de teste, talvez receba uma solicitação de autorização se não tiver executado o script antes. A autorização de um script durante o teste também o autoriza fora do teste.