Test dei componenti aggiuntivi di Google Workspace

Quando pubblichi un componente aggiuntivo, gli utenti possono installarlo tramite l'applicazione host o Google Workspace Marketplace. Tuttavia, prima della pubblicazione è utile testare i componenti aggiuntivi che sviluppi all'interno delle applicazioni host che estendono.

In questa pagina viene descritto come installare un componente aggiuntivo attualmente in fase di sviluppo (chiamato componente aggiuntivo non pubblicato o per sviluppatori) a scopo di test o per uso personale.

Prerequisiti

  • Devi disporre dell'accesso in modifica al progetto di script del componente aggiuntivo.
  • Per consentire ad altri utenti della tua organizzazione di testare il componente aggiuntivo, concedi loro l'accesso in modifica al progetto di script. Per maggiori dettagli sulla concessione dell'accesso, consulta Collaborazione con altri sviluppatori.

Installare un componente aggiuntivo non pubblicato

Puoi installare componenti aggiuntivi non pubblicati dalla finestra di dialogo Deployment di Apps Script.

Segui questi passaggi per installare un componente aggiuntivo di Google Workspace non pubblicato per i test:

  1. Apri il progetto di script nell'editor di Apps Script.
  2. Fai clic su Esegui il deployment > Testa i deployment.
  3. Fai clic su Installa.
  4. In basso, fai clic su Fine.

Per consentire ad altri utenti di testare il componente aggiuntivo, condividi 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 si estende. Potrebbe essere necessario aggiornare la scheda dell'applicazione host prima che il componente aggiuntivo venga visualizzato. Devi anche autorizzare il componente aggiuntivo prima di utilizzarlo.

Disinstallare un componente aggiuntivo non pubblicato

Per disinstallare il deployment di un componente aggiuntivo non pubblicato, segui questi passaggi:

  1. Apri il progetto di script nell'editor di Apps Script.
  2. Fai clic su Esegui il deployment > Testa i deployment.
  3. Fai clic su Disinstalla.
  4. In basso, fai clic su Fine.

Questi passaggi consentono di rimuovere 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

Quando testi il componente aggiuntivo di Google Workspace, assicurati di seguire le best practice per lo sviluppo dei componenti aggiuntivi. Inoltre, assicurati di fare quanto segue:

  1. Testa il flusso della navigazione delle schede in tutte le applicazioni host estese dal componente aggiuntivo. Assicurati che il comportamento del componente aggiuntivo sia corretto quando l'utente passa da un contesto all'altro e tra 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 o a un altro servizio, verifica che il servizio sia accessibile e funzioni come previsto. Assicurati che il componente aggiuntivo gestisca correttamente i dettagli di autorizzazione e accesso.

  4. Assicurati che eventuali condizioni di errore vengano gestite correttamente. Utilizza le schede di errore dove necessario.

  5. Presta attenzione alle prestazioni del componente aggiuntivo. Se modifichi il codice e il componente aggiuntivo inizia a rallentare, potrebbe essere necessario rimuovere o rielaborare la funzionalità.