Pruebe un complemento de Editor

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Los complementos deben probarse exhaustivamente antes de su publicación para garantizar que se comporten como se espera. Apps Script te permite probar complementos de Editor en desarrollo para archivos específicos de Documentos, Hojas de cálculo, Presentaciones o Formularios de Google. 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, 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 diferentes estados del ciclo de vida de autorización iniciales (instalados, habilitados o ambos).
  • Verifica que el complemento funcione según lo previsto cuando actúe sobre un documento en particular y su contenido.
  • Pruebe y compare las versiones actuales y anteriores 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 la secuencia de comandos y deseas probarla como complemento, sigue estos pasos:

  1. Si todavía no tienes uno, crea una hoja de cálculo, un documento, una presentación o un formulario para probar el complemento.
  2. Abre el proyecto de secuencia de comandos que contiene el complemento.
  3. Haz clic en Implementar > Probar implementaciones.
  4. Junto a Seleccionar tipo, haz clic en Habilitar tipos de implementación y selecciona Complemento de editor.
  5. Haz clic en Crear prueba nueva o Agregar prueba.
  6. Elige una versión de código o selecciona Código más reciente.
  7. En la sección Configuración, selecciona el estado de autorización inicial para la prueba.
  8. En Documento de prueba, haga 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.
  9. Haz clic en Guardar prueba.

Todas las implementaciones de prueba guardadas aparecen en el 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 con estos pasos:

  1. Abre el proyecto de secuencia de comandos que contiene el complemento.
  2. Haz clic en Implementar > Probar implementaciones.
  3. En Pruebas guardadas, 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 está en el estado de autorización especificado en la implementación de prueba. Para verificar que el complemento funciona según lo previsto, interactúa con el menú y los elementos de la IU.

Detalles de la prueba

Cuando pruebe los complementos de Editor de esta manera, debe tener en cuenta lo siguiente:

  • Los activadores instalables no son compatibles con las pruebas. No se puede probar la funcionalidad que depende de activadores instalables.
  • 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 más fácilmente con otras personas mientras realizas pruebas y desarrollos.
  • Si tu complemento usa el servicio Properties, las propiedades persisten y seguirán 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 tiene acceso a la misma información de propiedad. Por ejemplo, si creas dos implementaciones de prueba, las propiedades que se guardan mientras se ejecuta la primera están 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 ejecutaste la secuencia de comandos anteriormente. Ten en cuenta que autorizar una secuencia de comandos durante la prueba también autoriza la secuencia de comandos fuera de la prueba.