Menguji dan men-debug Add-on Google Workspace Apps Script

Saat Anda memublikasikan add-on, pengguna dapat menginstalnya melalui aplikasi host atau Google Workspace Marketplace. Sebelum memublikasikan, uji add-on yang Anda kembangkan dalam aplikasi host yang diperluas.

Halaman ini menjelaskan cara menginstal add-on yang sedang dalam pengembangan (disebut add-on tidak dipublikasikan atau developer) untuk pengujian atau penggunaan pribadi. Anda juga dapat men-debug add-on menggunakan debugger dan titik henti sementara IDE Apps Script.

Prasyarat

  • Anda harus memiliki akses editor ke project skrip add-on.
  • Agar orang lain di organisasi Anda dapat menguji add-on, beri mereka akses editor ke project skrip. Untuk mengetahui detail tentang cara memberikan akses, lihat Berkolaborasi dengan Developer Lain.

Menginstal add-on yang tidak dipublikasikan

Anda dapat menginstal add-on yang tidak dipublikasikan dari dialog Deployment Apps Script.

Ikuti langkah-langkah berikut untuk menginstal Add-on Google Workspace yang tidak dipublikasikan untuk pengujian:

  1. Buka project skrip di editor Apps Script.
  2. Klik Deploy > Test deployment.
  3. Klik Instal.
  4. Di bagian bawah, klik Selesai.

Anda dapat mengizinkan pengguna lain menguji add-on dengan membagikan project Apps Script ke akun mereka (akses edit diperlukan). Kemudian minta pengguna untuk mengikuti langkah-langkah di atas.

Setelah diinstal, add-on akan segera tersedia di aplikasi host yang akan diperluas. Anda mungkin perlu memuat ulang tab aplikasi host sebelum add-on muncul. Anda juga harus memberi otorisasi add-on sebelum menggunakannya.

Meng-uninstal add-on yang tidak dipublikasikan

Untuk meng-uninstal deployment add-on yang tidak dipublikasikan, ikuti langkah-langkah berikut:

  1. Buka project skrip di editor Apps Script.
  2. Klik Deploy > Test deployment.
  3. Klik Uninstall.
  4. Di bagian bawah, klik Selesai.

Langkah-langkah ini akan segera menghapus deployment dan add-on tidak lagi muncul di aplikasi host mana pun. Anda dapat menginstal ulang deployment kapan saja dengan mengulangi prosedur penginstalan.

Praktik terbaik pengujian

Saat menguji Add-on Google Workspace, pastikan Anda mengikuti Praktik terbaik untuk pengembangan add-on. Selain itu, pastikan untuk melakukan hal berikut:

  1. Uji navigasi kartu berjalan secara menyeluruh di semua aplikasi host yang diperluas add-on. Pastikan perilaku add-on benar saat pengguna berpindah dari konteks ke konteks, serta antara kartu non-kontekstual dan kontekstual.

  2. Gunakan contoh data pengujian untuk mengevaluasi perilaku add-on Anda.

  3. Jika add-on Anda terhubung ke API pihak ketiga atau layanan lainnya, pastikan layanan dapat diakses dan berperilaku seperti yang diharapkan. Pastikan add-on Anda menangani detail otorisasi dan login dengan benar.

  4. Pastikan setiap kondisi error ditangani dengan baik. Gunakan kartu error jika diperlukan.

  5. Perhatikan performa add-on ini. Jika Anda membuat perubahan pada kode dan add-on mulai melambat, Anda mungkin perlu menghapus atau mengerjakan ulang fitur tersebut.