Testare e eseguire il debug dei componenti aggiuntivi di Google Workspace di Apps Script
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Quando pubblichi un componente aggiuntivo, gli utenti possono installarlo tramite l'applicazione host o Google Workspace Marketplace. Prima di pubblicare, testa i plug-in che sviluppi all'interno delle applicazioni host che estendono.
Questa pagina descrive come installare un componente aggiuntivo in fase di sviluppo (chiamato componente aggiuntivo non pubblicato o sviluppatore) per i test o per uso personale. Puoi anche eseguire il debug dei componenti aggiuntivi utilizzando il debugger e i breakpoint dell'IDE di Apps Script.
Prerequisiti
Devi disporre dell'accesso come editor al progetto dello script del componente aggiuntivo.
Per consentire ad altri utenti della tua organizzazione di testare il componente aggiuntivo, concedi loro l'accesso come editor al progetto dello script. Per informazioni dettagliate sulla concessione dell'accesso, consulta
Collaborare con altri sviluppatori.
Installare un componente aggiuntivo non pubblicato
Puoi installare i componenti aggiuntivi non pubblicati dalla finestra di dialogo Deployment di Apps Script.
Per installare un componente aggiuntivo di Google Workspace non pubblicato per i test:
Apri il progetto di script nell'editor di Apps Script.
Fai clic su Deployment > Verifica deployment.
Fai clic su Installa.
In basso, fai clic su Fine.
Puoi consentire ad altri utenti di testare il componente aggiuntivo condividendo il progetto Apps Script con il loro account (è richiesto l'accesso in modifica). Quindi chiedi agli utenti di seguire i passaggi precedenti.
Una volta installato, il componente aggiuntivo è immediatamente disponibile nelle applicazioni host che estende. Potresti dover aggiornare la scheda dell'applicazione host prima che il plug-in venga visualizzato. Inoltre, devi autorizzare il componente aggiuntivo prima di utilizzarlo.
Disinstallare un componente aggiuntivo non pubblicato
Per disinstallare un deployment di componenti aggiuntivi non pubblicati:
Apri il progetto di script nell'editor di Apps Script.
Fai clic su Deployment > Verifica deployment.
Fai clic su Disinstalla.
In basso, fai clic su Fine.
Questi passaggi rimuovono immediatamente il deployment e il componente aggiuntivo non viene più visualizzato in nessuna applicazione host. Puoi reinstallare il deployment in qualsiasi momento ripetendo la procedura di installazione.
Best practice per i test
Durante il test del componente aggiuntivo di Google Workspace, assicurati di seguire le best practice per lo sviluppo di componenti aggiuntivi. Inoltre, assicurati di:
Testa attentamente la navigazione tra le schede in tutte le applicazioni host a cui si applica il componente aggiuntivo. Assicurati che il comportamento del componente aggiuntivo sia corretto quando l'utente si sposta da un contesto all'altro e tra schede non contestuali e contestuali.
Se il componente aggiuntivo si connette a un'API o a un altro servizio di terze parti, verifica che sia possibile accedere al servizio e che funzioni come previsto. Assicurati che il tuo componente aggiuntivo gestisca correttamente i dettagli di autorizzazione e accesso.
Assicurati che eventuali condizioni di errore vengano gestite correttamente. Utilizza le schede di errore
se necessario.
Presta attenzione alle prestazioni del componente aggiuntivo. Se apporti una modifica al codice e il componente aggiuntivo inizia a rallentare, potrebbe essere necessario rimuovere o rielaborare la funzionalità.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2024-12-22 UTC."],[[["\u003cp\u003eUnpublished Google Workspace add-ons can be installed for testing and personal use directly from the Apps Script project.\u003c/p\u003e\n"],["\u003cp\u003eUsers need editor access to the script project to install and test the unpublished add-on.\u003c/p\u003e\n"],["\u003cp\u003eUninstalling an unpublished add-on removes it from all host applications and requires reinstallation for further use.\u003c/p\u003e\n"],["\u003cp\u003eThorough testing is crucial, including card navigation, data handling, external service integrations, error management, and performance evaluation.\u003c/p\u003e\n"]]],["To test an unpublished add-on, open its script project in the Apps Script editor and navigate to **Deploy \u003e Test deployments**. Click **Install**, then **Done** to make it available in host applications. Share the project for others to test. Uninstall by repeating the process and selecting **Uninstall**. Testing should include card navigation, example data evaluation, third-party service verification, error handling, and performance monitoring.\n"],null,["# Test and debug Apps Script Google Workspace add-ons\n\nWhen you publish an add-on, users can install it\nthrough the host application\nor the [Google Workspace Marketplace](https://workspace.google.com/marketplace/). Before you publish, test the\nadd-ons that you develop within the host applications that\nthey extend.\n\nThis page describes how to install an add-on that is\nunder development (called an *unpublished* or *developer*\nadd-on) for testing or\npersonal use. You can also debug add-ons using the\nApps Script\nIDE's [debugger and breakpoints](/apps-script/guides/support/troubleshooting#use-debugger).\n\nPrerequisites\n-------------\n\n- You must have editor access to the add-on's script project.\n- To let other people in your organization test the add-on, grant them editor access to the script project. For details about granting access, see [Collaborating with Other Developers](/apps-script/guides/collaborating).\n\nInstall an unpublished add-on\n-----------------------------\n\nYou can install unpublished add-ons from Apps Script's **Deployments**\ndialog.\n\nFollow these steps to install an unpublished\nGoogle Workspace add-on for testing:\n\n1. Open the script project in the Apps Script editor.\n2. Click **Deploy \\\u003e Test deployments**.\n3. Click **Install**.\n4. At the bottom, click **Done**.\n\nYou can let other users test the add-on by sharing the Apps Script project\nwith their account (edit access is required). Then prompt the users to\nfollow the above steps.\n\nOnce installed, the add-on is immediately available in host applications it\nextends. You may need to refresh the host application tab before the add-on\nappears. You must also\n[authorize](/workspace/add-ons/how-tos/authorizing-addons#authorizing_unpublished_g_suite_add-ons)\nthe add-on before using it.\n\nUninstall an unpublished add-on\n-------------------------------\n\nTo uninstall an unpublished add-on deployment, follow these steps:\n\n1. Open the script project in the Apps Script editor.\n2. Click **Deploy \\\u003e Test deployments**.\n3. Click **Uninstall**.\n4. At the bottom, click **Done**.\n\nThese steps immediately remove the deployment and the add-on no longer appears\nin any host application. You can reinstall the deployment at any time by\nrepeating the [install procedure](#install_an_unpublished_add-on).\n\nTesting best practices\n----------------------\n\nWhile testing your Google Workspace add-on, be sure\nto follow the\n[Best practices](/workspace/add-ons/guides/workspace-best-practices)\nfor add-on development. In addition, be sure to do the following:\n\n1. Test card navigation flows thoroughly in all the host applications the\n add-on extends. Make sure the add-on behavior is correct as the user moves\n from context to context, and between non-contextual and contextual cards.\n\n2. [Use example test data](/workspace/add-ons/guides/workspace-best-practices#_write_tests_and_test_messages)\n to evaluate your add-on's behavior.\n\n3. If your add-on connects to a third-party API or other service, verify\n that the service can be accessed and behaves as expected. Make sure\n your add-on is handling the\n [authorization and log-in details](/workspace/add-ons/how-tos/non-google-services)\n correctly.\n\n4. Make sure any error conditions are handled gracefully. [Use error cards](/workspace/add-ons/guides/workspace-best-practices#_use_error_cards)\n where needed.\n\n5. Pay attention to how performant the add-on is. If you make a change to the\n code and the add-on starts slowing down, you may need to remove or rework\n that feature."]]
