Os complementos precisam ser testados antes da publicação para garantir que funcionem conforme o esperado. Com o Apps Script, é possível testar complementos do editor em desenvolvimento em arquivos específicos dos Documentos, das Planilhas, dos Formulários ou das 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, um documento, uma apresentação ou um formulário.
- Verifique se o fluxo de instalação do complemento funciona como esperado, principalmente para diferentes estados iniciais do ciclo de vida de autorização (instalado, ativado ou ambos).
- Verifique se o complemento funciona como esperado ao agir em um documento específico e no conteúdo dele.
- Teste e compare 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 uma versão do script e quiser testá-la como um complemento, siga estas etapas:
- Se você ainda não tiver, 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 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 para o teste.
- Em Documento de teste, clique em Nenhum documento selecionado. Selecione o arquivo das Planilhas, Documentos, Apresentações ou Formulários Google 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 Implantações de teste. 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 salvo 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. Para verificar se o complemento funciona como esperado, interaja com o menu e os elementos da interface.
Para testar o recurso de OAuth granular no seu complemento, verifique se o projeto ainda não tem autorizações. Para invalidar autorizações atuais, use ScriptApp.invalidateAuth.
Detalhes do teste
Há algumas coisas a serem consideradas ao testar complementos do Editor dessa forma:
- Acionadores instaláveis não são compatíveis durante 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, você pode ver as mudanças salvas no script do complemento atualizando o documento de teste.
- O documento de teste tem um URL que pode ser compartilhado com os editores do documento de teste original. Assim, você pode colaborar com outras pessoas com mais facilidade durante os testes e o desenvolvimento.
- Se o complemento usar o serviço Properties, as propriedades vão persistir e ficar 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 da propriedade. Por exemplo, se você criar duas implantações de teste, as propriedades salvas ao executar a primeira estarão disponíveis ao executar a segunda e vice-versa, mas apenas se as implantações usarem o mesmo script e documento de teste.
- Se você executar uma implantação de teste, talvez seja necessário autorizar o script se ele não tiver sido executado antes. Autorizar um script durante o teste também o autoriza fora do teste.