Testare e eseguire il debug dei componenti aggiuntivi di Google Workspace di Apps Script

Dopo aver pubblicato un componente aggiuntivo, gli utenti possono installarlo tramite l'applicazione host o il Google Workspace Marketplace. Prima di pubblicarlo, testa il componente aggiuntivo all'interno delle applicazioni host che estende.

Questa pagina descrive come installare un componente aggiuntivo in fase di sviluppo (un componente aggiuntivo non pubblicato o per sviluppatori) per test o uso personale. Puoi anche eseguire il debug del componente aggiuntivo utilizzando il debugger e i punti di interruzione di Apps Script .

Prerequisiti

  • Devi disporre dell'accesso come editor al progetto di script.
  • Per consentire ad altri utenti di testare il componente aggiuntivo, concedi loro l'accesso come editor al progetto. Consulta Collaborare con altri sviluppatori.
  • Gli utenti di test devono appartenere allo stesso dominio del proprietario dello script.

Installare un componente aggiuntivo non pubblicato

Installa i componenti aggiuntivi non pubblicati dalla finestra di dialogo Deployment.

Per installare un componente aggiuntivo non pubblicato per i test:

  1. Apri il progetto di script nell'editor di Apps Script.
  2. Seleziona Esegui il deployment > Test di deployment.
  3. Seleziona Installa.
  4. In basso, seleziona Fine.

Per consentire ad altri utenti di testare il componente aggiuntivo, condividi il progetto con il loro account (è necessario l'accesso in modifica). Poi, chiedi agli utenti di seguire gli stessi passaggi.

Dopo aver installato il componente aggiuntivo, questo è immediatamente disponibile nelle applicazioni host che estende. Potresti dover aggiornare la scheda dell'applicazione host prima che venga visualizzato il componente aggiuntivo. Autorizza il componente aggiuntivo prima di utilizzarlo. Se il tuo progetto è già autorizzato, utilizza ScriptApp.invalidateAuth per invalidare le autorizzazioni esistenti. In questo modo puoi testare la funzionalità OAuth granulare.

Disinstallare un componente aggiuntivo non pubblicato

Per disinstallare un componente aggiuntivo non pubblicato:

  1. Apri il progetto di script nell'editor di Apps Script.
  2. Seleziona Esegui il deployment > Test di deployment.
  3. Seleziona Disinstalla.
  4. In basso, seleziona Fine.

Questi passaggi rimuovono il deployment e il componente aggiuntivo non viene più visualizzato. Puoi reinstallare il deployment in qualsiasi momento.

Best practice per i test

Quando testi il componente aggiuntivo, segui le best practice. Inoltre, esegui le seguenti operazioni:

  1. Testa i flussi di navigazione delle schede in tutte le applicazioni host che il componente aggiuntivo estende. Verifica il comportamento dell'utente quando si sposta tra i contesti e tra le schede non contestuali e contestuali.

  2. Utilizza dati di test di esempio per valutare il comportamento del componente aggiuntivo.

  3. Se il componente aggiuntivo si connette a un'API di terze parti, verifica che il servizio sia accessibile. Assicurati che il componente aggiuntivo gestisca l'autorizzazione e l'accesso correttamente.

  4. Gestisci le condizioni di errore in modo appropriato. Utilizza le schede di errore quando necessario.

  5. Monitora il rendimento del componente aggiuntivo. Se il componente aggiuntivo rallenta dopo una modifica del codice, potrebbe essere necessario rielaborare la funzionalità.