Testar um complemento do Editor

Os complementos precisam ser testados completamente antes da publicação para garantir o comportamento conforme o esperado. Com o Apps Script, é possível testar complementos do Editor em desenvolvimento em arquivos específicos do Documentos, Planilhas ou Apresentações Google. Isso pode ser usado para:

  • Verifique se um complemento escrito em um script independente funciona conforme planejado quando aplicado a uma página, um documento, uma apresentação ou um formulário.
  • Verificar se o fluxo de instalação de complementos funciona conforme o esperado, especialmente para diferentes estados iniciais de ciclo de vida da autorização (instalados, ativados ou ambos).
  • Verifique se o complemento funciona conforme planejado ao atuar em um determinado documento e no conteúdo dele.
  • Testar e comparar as versões atual e anterior 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 de desenvolver e testar uma versão do script 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 Select type, clique em Ativar a implantação de tipos e selecione Editor de Complementos.
  5. Clique em Criar novo teste ou Adicionar teste.
  6. Escolha uma versão do código ou selecione Código mais recente.
  7. Na seção Configuração, selecione o estado de autorização inicial do teste.
  8. Em Testar documento, 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 são exibidas na caixa de diálogo Implantações de teste. Isso permite revisar 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, é possível 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 do teste. Você pode verificar se o complemento funciona como esperado, interagindo com os elementos de menu e IU.

Detalhes do teste

Há várias coisas a serem consideradas ao testar complementos do Editor desta maneira:

  • Acionadores instaláveis não são compatíveis durante os testes. Não é possível testar a funcionalidade que depende de acionadores instaláveis.
  • Ao executar uma implantação de teste configurada para testar com o código mais recente, é possível ver as alterações salvas no script de complementos atualizando o documento de teste.
  • O documento de teste tem um URL que pode ser compartilhado 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 seu complemento usa o serviço de propriedades, as propriedades persistem e permanecem disponíveis na próxima vez que a implantação de teste é 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 do segundo e vice-versa, mas somente se as implantações usarem o mesmo script e o mesmo documento de teste.
  • Se você executar uma implantação de teste, talvez receba uma solicitação de autorização se ainda não tiver executado o script. Esteja ciente de que autorizar um script durante o teste também autoriza o script fora do teste.