Os complementos devem ser testados por completo antes da publicação para garantir que se comportam conforme o esperado. Com o Apps Script, você testa Complementos do editor em desenvolvimento em arquivos específicos do Documentos, Planilhas, Formulários ou Apresentações Google. Isso pode ser usado para:
- Verificar se um complemento criado em um script independente funciona conforme o esperado quando aplicadas a uma planilha, documento, apresentação ou formulário.
- Verificar se o fluxo de instalação de complementos funciona conforme o esperado, principalmente para inicial diferente estados do ciclo de vida de autorização (instalado, ativado ou ambos).
- Verificar se o complemento funciona conforme esperado durante a execução em uma determinada documento e seu conteúdo.
- 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 de script desenvolvida e quiser testá-la como um complemento, siga estas etapas:
- Se você ainda não tem um, crie uma planilha, um documento apresentação ou 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 as opções do Planilhas, Apresentações ou Formulários que você deseja 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 você revisita 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 do teste salvo. implantação 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 especificados na implantação de teste. É possível verificar se o complemento funciona ao interagir com os elementos da interface e do menu.
Detalhes dos testes
Há vários pontos a serem considerados ao testar os complementos do Editor. desta forma:
- Acionadores instaláveis não são compatíveis durante os testes. Funcionalidade que depende da instalação não é testável.
- Ao executar uma implantação de teste configurada para testar com o código mais recente, você poderá ver as alterações salvas no script do complemento atualizando o documento de teste.
- O documento de teste tem um URL que você pode compartilhar com os editores do documento original documento de teste. Dessa forma, você pode colaborar mais facilmente com outras pessoas enquanto testes e desenvolvimento.
- Caso seu complemento use o Serviço de propriedades, as propriedades persistem e permanecem disponíveis na próxima vez que a implantação de teste é executado.
- Além disso, qualquer implantação de teste que use a mesma combinação de complementos documento de teste tem acesso às mesmas informações da propriedade. Por exemplo, se você criar duas implantações de teste, com as propriedades salvas durante a execução da primeira estão disponíveis ao executar a segunda e vice-versa, mas somente se o usam o mesmo script e documento de teste.
- Ao executar uma implantação de teste, talvez você receba uma solicitação de autorização se: nunca executaram o script antes. Autorizar um script teste também autoriza o script fora do teste.