Quando pubblichi un componente aggiuntivo, gli utenti possono installarlo tramite l'applicazione host o Google Workspace Marketplace. Prima della pubblicazione, testa i componenti aggiuntivi che sviluppi all'interno delle applicazioni host che estendono.
In questa pagina viene descritto come installare un componente aggiuntivo in fase di sviluppo (denominato componente aggiuntivo non pubblicato o sviluppatore) a scopo di test o per uso personale. Puoi anche eseguire il debug dei componenti aggiuntivi utilizzando debugger e punti di interruzione dell'IDE Apps Script.
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, vedi 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:
- Apri il progetto di script nell'editor di Apps Script.
- Fai clic su Esegui il deployment > Testa i 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 venga visualizzato il componente aggiuntivo. 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:
- Apri il progetto di script nell'editor di Apps Script.
- Fai clic su Esegui il deployment > Testa i 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 nelle applicazioni 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 dei componenti aggiuntivi. Inoltre, assicurati di eseguire le seguenti operazioni:
Testa la navigazione delle schede a fondo in tutte le applicazioni host del componente aggiuntivo. Assicurati che il comportamento del componente aggiuntivo sia corretto man mano che l'utente passa dal contesto al contesto e tra schede non contestuali e contestuali.
Utilizza dati di test di esempio per valutare il comportamento del componente aggiuntivo.
Se il componente aggiuntivo si connette a un'API o a un altro servizio di terze parti, verifica che il servizio sia accessibile e che funzioni come previsto. Assicurati che il tuo componente aggiuntivo gestisca correttamente i dettagli di accesso e autorizzazione.
Assicurati che eventuali condizioni di errore vengano gestite correttamente. Utilizza le schede degli errori dove 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à.