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:
- Se você ainda não tiver um, crie uma planilha, um documento, uma apresentação ou um formulário para testar o complemento.
- Abra o projeto de script que contém o complemento.
- Clique em Implantar > Testar implantações.
- Ao lado de Select type, clique em Ativar a implantação de tipos e selecione Editor de Complementos.
- Clique em Criar novo teste ou Adicionar teste.
- Escolha uma versão do código ou selecione Código mais recente.
- Na seção Configuração, selecione o estado de autorização inicial do teste.
- 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.
- 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:
- Abra o projeto de script que contém o complemento.
- Clique em Implantar > Testar implantações.
- 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.