Quando pubblichi un componente aggiuntivo, gli utenti possono installarlo tramite l'applicazione host o Google Workspace Marketplace. Prima di pubblicare, testa i componenti aggiuntivi 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 per sviluppatori) per test o uso personale. Puoi anche eseguire il debug dei componenti aggiuntivi utilizzando il debugger e i punti di interruzione dell'IDE di Apps Script.
Prerequisiti
- Devi disporre dell'accesso come editor al progetto di script del componente aggiuntivo.
- Per consentire ad altre persone della tua organizzazione di testare il componente aggiuntivo, concedi loro l'accesso come editor al progetto script. Per informazioni dettagliate sulla concessione dell'accesso, vedi Collaborare con altri sviluppatori.
Installare un componente aggiuntivo non pubblicato
Puoi installare componenti aggiuntivi non pubblicati dalla finestra di dialogo Implementazioni di Apps Script.
Per installare un componente aggiuntivo di Google Workspace non pubblicato per il 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 (è necessario 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 componente aggiuntivo venga visualizzato. Devi anche autorizzare il componente aggiuntivo prima di utilizzarlo. Se il tuo progetto è già autorizzato, utilizza ScriptApp.invalidateAuth per invalidare le autorizzazioni esistenti in modo da poter testare la funzionalità OAuth granulare sul tuo componente aggiuntivo.
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 la distribuzione in qualsiasi momento ripetendo la procedura di installazione.
Best practice per i test
Durante il test del componente aggiuntivo Google Workspace, assicurati di seguire le best practice per lo sviluppo di componenti aggiuntivi. Inoltre, assicurati di:
Testa a fondo i flussi di navigazione delle schede in tutte le applicazioni host a cui si estende il componente aggiuntivo. Assicurati che il comportamento del componente aggiuntivo sia corretto man mano che l'utente si sposta da un contesto all'altro 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 sia possibile accedere al servizio e che funzioni come previsto. Assicurati che il componente aggiuntivo gestisca correttamente i dettagli di autorizzazione e accesso.
Assicurati che le 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, potresti dover rimuovere o rielaborare questa funzionalità.