Os complementos precisam ser testados completamente antes da publicação para garantir que se comportem conforme o esperado. Com o Apps Script, você testa complementos do editor em desenvolvimento em arquivos específicos dos apps Documentos, Planilhas, Formulários ou Apresentações Google. Isso pode ser usado para:
- Verifique se um complemento escrito em um script independente funciona conforme o esperado quando aplicado a uma planilha, documento, apresentação ou formulário.
- Verifique se o fluxo de instalação de complementos funciona conforme o esperado, especialmente para diferentes estados do ciclo de vida de autorização iniciais (instalado, ativado ou ambos).
- Verifique se o complemento funciona conforme esperado em um documento específico e no conteúdo dele.
- Teste e compare a versão atual e a 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. Quando você tiver uma versão do script desenvolvida e quiser testá-la 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 Selecionar tipo, clique em Ativar tipos de implantação e selecione Complemento do Editor.
- 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 para o teste.
- 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.
- Clique em Salvar teste.
Todas as implantações de teste salvas aparecem na caixa de diálogo Testar implantações. Isso permite 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:
- 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 interface.
Detalhes do teste
Há vários pontos a serem considerados ao testar os complementos do Editor desta maneira:
- Acionadores instaláveis não são compatíveis durante o teste. Não é possível testar funcionalidades que dependem de acionadores instaláveis.
- 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 pode ser compartilhado com os editores do documento de teste original. Dessa forma, você pode colaborar mais facilmente com outras pessoas durante os testes e o desenvolvimento.
- Se o complemento usar o serviço de propriedades, as propriedades serão mantidas 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 complementos e documentos de teste tem acesso às mesmas informações da 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, poderá receber uma solicitação de autorização se não tiver executado o script antes. Esteja ciente de que autorizar um script durante o teste também autoriza o script fora do teste.