Os complementos precisam ser testados completamente antes da publicação para garantir que se comportem conforme o esperado. Com o Apps Script, você pode testar complementos do editor em desenvolvimento em arquivos específicos de planilhas, formulários ou apresentações do Documentos 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 do complemento funciona conforme o esperado, principalmente para diferentes estados iniciais do ciclo de vida da autorização (instalado, ativado ou ambos).
- Verifique se o complemento funciona conforme o esperado ao agir em um documento e conteúdo específico.
- Teste e compare as versões atuais e 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 de desenvolver uma versão do script e querer 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 do script que contém o complemento.
- Clique em Implantar > Testar implantações.
- Ao lado de Selecionar tipo, clique em "Habilitar 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 do 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 Test deployments. Isso permite que você revisite 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 do 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 de teste. É possível verificar se o complemento funciona como esperado interagindo com o menu e os elementos da interface dele.
Detalhes do teste
Há alguns pontos a serem considerados ao testar complementos do Editor dessa maneira:
- Gatilhos instaláveis não são compatíveis com o teste. A funcionalidade que depende de gatilhos instaláveis não pode ser testada.
- Ao executar uma implantação de teste definida para testar com o código mais recente, é possível conferir as alterações salvas no script de complemento atualizando o documento de teste.
- O documento de teste tem um URL que você pode compartilhar com os editores do documento original. Dessa forma, fica mais fácil colaborar com outras pessoas durante o teste e o desenvolvimento.
- Se o complemento usar o serviço de propriedades, as propriedades vão persistir e permanecer 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 durante a execução da primeira ficarã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 seja necessário conceder autorização se você não tiver executado o script antes. Autorizar um script durante o teste também autoriza o script fora do teste.