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 diperluasnya.

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 IDE Apps Script debugger dan titik henti sementara.

Prasyarat

  • Anda harus memiliki akses editor ke project skrip add-on.
  • Untuk mengizinkan orang lain di organisasi Anda 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 belum 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 diperluasnya. Anda mungkin perlu memuat ulang tab aplikasi host sebelum add-on muncul. Anda juga harus mengizinkan add-on sebelum menggunakannya. Jika project Anda sudah diberi otorisasi, gunakan ScriptApp.invalidateAuth untuk membatalkan otorisasi yang ada sehingga Anda dapat menguji fitur OAuth terperinci di add-on Anda.

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 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 alur navigasi kartu secara menyeluruh di semua aplikasi host yang diperluas add-on. Pastikan perilaku add-on sudah benar saat pengguna berpindah dari satu konteks ke konteks lain, dan antara kartu non-kontekstual dan kontekstual.

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

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

  4. Pastikan semua 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 memodifikasi fitur tersebut.