Los complementos deben probarse exhaustivamente antes de publicarse para garantizar que funcionen según lo previsto. Apps Script te permite probar complementos del editor en desarrollo en archivos específicos de Documentos, Hojas de cálculo, Formularios o Presentaciones de Google. Esto se puede usar para lo siguiente:
- Verifica que un complemento escrito en una secuencia de comandos independiente funcione según lo previsto cuando se aplica a una hoja de cálculo, un documento, una presentación o un formulario.
- Verifica que el flujo de instalación del complemento funcione según lo previsto, en especial para los diferentes estados del ciclo de vida de autorización iniciales (instalado, habilitado o ambos).
- Verifica que el complemento funcione según lo previsto cuando se aplica a un documento en particular y a su contenido.
- Prueba y compara las versiones actual y anterior del complemento.
Crea una implementación de prueba
Una implementación de prueba es la combinación de un complemento y un documento de prueba. Una vez que tengas una versión de la secuencia de comandos desarrollada y quieras probarla como complemento, sigue estos pasos:
- Si aún no tienes uno, crea una hoja de cálculo, un documento, una presentación o un formulario para probar el complemento.
- Abre el proyecto de secuencias de comandos que contiene tu complemento.
- Haz clic en Implementar > Probar implementaciones.
- Junto a Seleccionar tipo, haz clic en Habilitar los tipos de implementación y selecciona Complemento del editor.
- Haz clic en Crear una prueba nueva o Agregar prueba.
- Elige una versión del código o selecciona Latest Code.
- En la sección Config, selecciona el estado de autorización inicial para la prueba.
- En Documento de prueba, haz clic en No se seleccionó ningún documento. Selecciona el archivo de Hojas de cálculo, Documentos, Presentaciones o Formularios que quieras usar para probar el complemento y haz clic en Insertar.
- Haz clic en Guardar prueba.
Todas las implementaciones de prueba guardadas aparecen en el cuadro de diálogo Implementaciones de prueba. Esto te permite volver a visitar la misma implementación de prueba más adelante.
Ejecuta una implementación de prueba
Si tienes una o más implementaciones de prueba guardadas, puedes ejecutar una de ellas siguiendo estos pasos:
- Abre el proyecto de secuencias de comandos que contiene tu complemento.
- Haz clic en Implementar > Probar implementaciones.
- En Saved Tests, selecciona el botón de selección junto a la implementación de prueba guardada que deseas ejecutar y haz clic en Ejecutar.
El documento de prueba se abrirá en una pestaña nueva. El complemento se encuentra en el estado de autorización especificado en la implementación de prueba. Puedes verificar que el complemento funcione según lo previsto interactuando con su menú y sus elementos de la IU.
Para probar la función de OAuth detallado en tu complemento, asegúrate de que tu proyecto no tenga autorizaciones. Para invalidar cualquier autorización existente, usa ScriptApp.invalidateAuth.
Detalles de la prueba
Hay varios aspectos que debes tener en cuenta cuando pruebas complementos del Editor de esta manera:
- No se admiten los activadores instalables durante las pruebas. La funcionalidad que depende de los activadores instalables no se puede probar.
- Mientras ejecutas una implementación de prueba configurada para probar con el código más reciente, puedes ver los cambios guardados en la secuencia de comandos del complemento si actualizas el documento de prueba.
- El documento de prueba tiene una URL que puedes compartir con los editores del documento de prueba original. De esta manera, puedes colaborar con otras personas más fácilmente mientras pruebas y desarrollas.
- Si tu complemento usa el servicio de Propiedades, las propiedades persisten y permanecen disponibles la próxima vez que se ejecute la implementación de prueba.
- Además, cualquier implementación de prueba que use la misma combinación de complemento y documento de prueba tendrá acceso a la misma información de la propiedad. Por ejemplo, si creas dos implementaciones de prueba, las propiedades guardadas durante la ejecución de la primera estarán disponibles durante la ejecución de la segunda y viceversa, pero solo si las implementaciones usan el mismo documento de prueba y secuencia de comandos.
- Si ejecutas una implementación de prueba, es posible que se te solicite autorización si no ejecutaste la secuencia de comandos antes. Ten en cuenta que autorizar una secuencia de comandos durante las pruebas también la autoriza fuera de ellas.