Cómo probar un complemento del editor
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Los complementos deben probarse exhaustivamente antes de publicarlos para garantizar que se comporten según lo previsto. Apps Script te permite probar complementos de 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, un documento, una presentación o un formulario.
- Verifica que el flujo de instalación del complemento funcione según lo previsto, en particular para los diferentes estados del ciclo de vida de la 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 hayas desarrollado una versión de la secuencia de comandos y quieras probarla como complemento, sigue estos pasos:
- Si aún no tienes una, crea una hoja de cálculo, un documento, una presentación o un formulario para probar el complemento.
- Abre el proyecto de secuencia de comandos que contiene el complemento.
- Haz clic en Implementar > Probar implementaciones.
- Junto a Seleccionar tipo, haz clic en Habilitar los tipos de implementación settings
y selecciona Editor add-on.
- Haz clic en Crear una prueba nueva o Agregar prueba.
- Elige una versión de código o selecciona Código más reciente.
- 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 diálogo Implementaciones de prueba. Esto te permite volver a ver 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 seguir estos pasos para ejecutar una de ellas:
- Abre el proyecto de secuencia de comandos que contiene el complemento.
- Haz clic en Implementar > Probar implementaciones.
- 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 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 los elementos de la IU.
Detalles de las pruebas
Ten en cuenta lo siguiente cuando pruebes los complementos de Editor de esta manera:
- Los activadores instalables
no se admiten durante las pruebas. La funcionalidad que depende de 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 actualizando 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 ejecuta 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 la propiedad. Por ejemplo, si
creas dos implementaciones de prueba, las propiedades que se guardaron mientras se ejecutaba 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 nunca antes ejecutaste la secuencia de comandos. Ten en cuenta que autorizar una secuencia de comandos durante
las pruebas también la autoriza fuera de las pruebas.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2024-12-22 (UTC)
[null,null,["Última actualización: 2024-12-22 (UTC)"],[[["\u003cp\u003eApps Script allows developers to test editor add-ons directly within Google Docs, Sheets, Slides, or Forms to verify functionality and installation flow.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can create test deployments to specify add-on versions, authorization states, and associated documents for controlled testing environments.\u003c/p\u003e\n"],["\u003cp\u003eSaved test deployments can be executed repeatedly, enabling developers to iterate on their add-ons and observe changes in real-time within the test document.\u003c/p\u003e\n"],["\u003cp\u003eWhile offering valuable testing capabilities, test deployments have limitations such as not supporting installable triggers and shared property persistence across deployments using the same add-on and document.\u003c/p\u003e\n"],["\u003cp\u003eTest deployments provide a shareable URL for collaborative testing and may require authorization for the script, both within and outside the testing environment.\u003c/p\u003e\n"]]],["To test add-ons in development, create a test deployment linking a script version to a specific Google Docs, Sheets, Forms, or Slides file. Select the add-on's authorization state and save the test. Run saved tests by selecting them in the \"Test deployments\" dialog and clicking \"Execute.\" During testing, changes to the script can be viewed by refreshing the test document; the test document URL is shareable for collaboration. Any properties created are also persisted across multiple test deployments.\n"],null,["# Test an Editor add-on\n\nAdd-ons should be tested thoroughly prior to publishing to ensure they\nbehave as intended. Apps Script lets you test\n[Editor add-ons](/workspace/add-ons/concepts/types#editor_add-ons)\nin development on specific Google Docs Sheets, Forms, or Slides files. This\ncan be used to:\n\n- Verify that an add-on written in a standalone script functions as intended when applied to a sheet, doc, presentation, or form.\n- Verify that the add-on installation flow works as intended, particularly for different initial [authorization lifecycle states](/workspace/add-ons/concepts/editor-auth-lifecycle#the_complete_lifecycle) ([installed, enabled, or both](/workspace/add-ons/concepts/editor-auth-lifecycle#installed_versus_enabled)).\n- Verify that the add-on functions as intended when acting on a particular document and its contents.\n- Test and compare the current and previous versions of the add-on.\n\nCreate a test deployment\n------------------------\n\nA test deployment is the combination of an add-on and a test document.\nOnce you have a script version developed and would like to test it as an add-on,\nfollow these steps:\n\n1. If you don't have one already, create a spreadsheet, document, presentation, or form to test the add-on with.\n2. Open the script project containing your add-on.\n3. Click **Deploy** \\\u003e **Test deployments**.\n4. Next to **Select type** , click Enable deployment types settings and select **Editor add-on**.\n5. Click **Create new test** or **Add test**.\n6. Choose a code version or select **Latest Code**.\n7. In the **Config** section, select the initial [authorization state](/workspace/add-ons/concepts/editor-auth-lifecycle#installed_versus_enabled) for the test.\n8. Under **Test document** , click **No document selected** . Select the Sheets, Docs, Slides, or Forms file you want to use to test the add-on and click **Insert**.\n9. Click **Save test**.\n\nAll saved test deployments appear in the **Test deployments** dialog. This lets\nyou revisit the same test deployment later on.\n\nRun a test deployment\n---------------------\n\nIf you have one or more saved test deployments, you can run one of them by\nfollowing these steps:\n\n1. Open the script project containing your add-on.\n2. Click **Deploy** \\\u003e **Test deployments**.\n3. Under **Saved Tests** , select the radio button next to the saved test deployment you want to run and click **Execute**.\n\nThe test document opens in a new tab. The add-on is in the\n[authorization state](/workspace/add-ons/concepts/editor-auth-lifecycle#installed_versus_enabled)\nspecified in the test deployment. You can verify that the add-on functions as\nintended by interacting with its menu and UI elements.\n\n### Testing details\n\nThere are a number of things to keep in mind while testing Editor add-ons\nthis way:\n\n- [Installable triggers](/workspace/add-ons/concepts/editor-triggers#installable_triggers_in_add-ons) aren't supported when testing. Functionality that depends on installable triggers is not testable.\n- While running a test deployment that's set to test with the latest code, you can see changes saved to the add-on script by refreshing the test document.\n- The test document has a URL that you can share with editors of the original test document. This way, you can more easily collaborate with others while testing and developing.\n- If your add-on uses the [Properties service](/apps-script/reference/properties/properties-service), properties persist and remain available the next time the test deployment is run.\n- In addition, any test deployment that uses the same combination of add-on and test document has access to the same property information. For example, if you create two test deployments, the properties saved while running the first are available while running the second and vice versa, but only if the deployments use the same script and test document.\n- If you run a test deployment, you might be prompted for authorization if you have not run the script before. Be aware that authorizing a script while testing also authorizes the script outside of testing."]]
