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 dikembangkan (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.
  • Untuk mengizinkan orang lain di organisasi Anda menguji add-on, berikan 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 Deployments 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 deployments.
  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 langsung tersedia di aplikasi host yang 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 deployments.
  3. Klik Uninstal.
  4. Di bagian bawah, klik Selesai.

Langkah-langkah ini akan segera menghapus deployment dan add-on tidak akan muncul lagi 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 alur navigasi kartu secara menyeluruh di semua aplikasi host yang diperluas add-on. Pastikan perilaku add-on sudah benar saat pengguna berpindah dari konteks ke konteks, dan antara kartu kontekstual dan non-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 kondisi error ditangani dengan baik. Gunakan kartu error jika diperlukan.

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