Los complementos se deben probar minuciosamente antes de la publicación para garantizar que se comporte según lo previsto. Apps Script te permite probar Complementos del editor en desarrollo en archivos específicos de Hojas de cálculo, Formularios o Presentaciones de Google. Esta se pueden usar para:
- Verifica que un complemento escrito en una secuencia de comandos independiente funcione según lo previsto cuando se aplican a una hoja, un documento, una presentación o un formulario.
- Verifica que el flujo de instalación del complemento funcione según lo previsto, especialmente para diferente inicial estados del ciclo de vida de la autorización (instaladas, habilitadas o ambas).
- Verificar que el complemento funcione según lo previsto al realizar una acción en un particular documento y su contenido.
- Prueba y compara la versión actual y la 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 hayas desarrollado una versión de secuencia de comandos y quieras probarla como complemento, sigue estos pasos:
- Si aún no tienes una hoja de cálculo, documento, una presentación o un formulario para probar el complemento.
- Abre el proyecto de secuencia de comandos que contiene tu complemento.
- Haz clic en Implementar > Implementaciones de prueba.
- Junto a Seleccionar tipo, haz clic en Habilitar tipos de implementación . y selecciona Editor Add-on.
- Haz clic en Crear prueba nueva o Agregar prueba.
- Elige una versión de código o selecciona Latest Code.
- En la sección Configuración, selecciona el estado de autorización inicial de la prueba.
- En Documento de prueba, haz clic en No se seleccionó ningún documento. Selecciona las pestañas Hojas de cálculo, Documentos Presentaciones o archivos de 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 diálogo Test deployments. Esto permite volverás 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 secuencia de comandos que contiene tu complemento.
- Haz clic en Implementar > Implementaciones de prueba.
- En Pruebas guardadas, selecciona el botón de selección junto a la prueba guardada. Deployment que quieras ejecutar y haz clic en Ejecutar.
El documento de prueba se abrirá en una pestaña nueva. El complemento se encuentra en estado de autorización especificadas en la implementación de prueba. Puedes verificar que el complemento funciona como lo previsto a través de la interacción con el menú y los elementos de la IU.
Detalles de las pruebas
Existen varios aspectos que debes tener en cuenta al probar los complementos del editor. de la siguiente manera:
- Activadores instalables no son compatibles durante las pruebas. Funcionalidad que depende del tipo instalable activadores no se pueden probar.
- Mientras ejecutas una implementación de prueba configurada para probar con el código más reciente, Para ver los cambios guardados en la secuencia de comandos del complemento, actualiza el documento de prueba.
- El documento de prueba tiene una URL que puedes compartir con los editores del documento original documento de prueba. De esta manera, podrás colaborar más fácilmente con otros mientras las pruebas y el desarrollo.
- Si tu complemento usa Servicio de propiedades se mantienen y permanecen disponibles la próxima vez que se ejecute de que se ejecute.
- Además, cualquier implementación de prueba que use la misma combinación de complementos y el documento de prueba tiene acceso a la misma información de propiedad. Por ejemplo, si crear dos implementaciones de prueba, las propiedades que se guardan al ejecutar la primera disponibles mientras se ejecuta la segunda y viceversa, pero solo si las implementaciones usan la misma secuencia de comandos y el mismo documento de prueba.
- Si ejecutas una implementación de prueba, es posible que se te solicite autorización si no hayan ejecutado antes la secuencia de comandos. Ten en cuenta que autorizar una secuencia de comandos mientras las pruebas también autorizan la secuencia de comandos fuera de la prueba.