Add-on harus diuji secara menyeluruh sebelum dipublikasikan untuk memastikan berperilaku sebagaimana mestinya. Apps Script memungkinkan Anda menguji Add-on Editor dalam pengembangan pada file Google Dokumen, Spreadsheet, Formulir, atau Slide tertentu. Ini dapat digunakan untuk:
- Memastikan add-on yang ditulis dalam skrip mandiri berfungsi sebagaimana mestinya saat diterapkan ke sheet, dokumen, presentasi, atau formulir.
- Verifikasi bahwa alur penginstalan add-on berfungsi sebagaimana mestinya, terutama untuk inisial yang berbeda status siklus proses otorisasi (diinstal, diaktifkan, atau keduanya).
- Verifikasi bahwa add-on berfungsi sebagaimana mestinya saat menindaklanjuti dokumen dan isinya.
- Uji dan bandingkan add-on versi saat ini dan sebelumnya.
Membuat deployment pengujian
Deployment pengujian adalah kombinasi add-on dan dokumen pengujian. Setelah versi skrip dikembangkan dan ingin mengujinya sebagai {i>add-on<i}, ikuti langkah-langkah berikut:
- Jika Anda belum memilikinya, buatlah {i>spreadsheet<i}, dokumen, presentasi, atau formulir untuk menguji add-on.
- Buka project skrip yang berisi add-on Anda.
- Klik Deploy > Test deployment.
- Di sebelah Pilih jenis, klik Aktifkan jenis deployment dan pilih Add-on Editor.
- Klik Buat pengujian baru atau Tambahkan pengujian.
- Pilih versi kode atau pilih Kode Terbaru.
- Di bagian Config, pilih status otorisasi awal untuk pengujian.
- Di bagian Dokumen pengujian, klik Tidak ada dokumen yang dipilih. Pilih Spreadsheet, Dokumen, File Slide, atau Formulir yang ingin Anda gunakan untuk menguji add-on, lalu klik Sisipkan.
- Klik Simpan pengujian.
Semua deployment pengujian yang tersimpan akan muncul di dialog Test deployment. Hal ini memungkinkan Anda mengunjungi kembali deployment pengujian yang sama nanti.
Menjalankan deployment pengujian
Jika Anda memiliki satu atau beberapa deployment pengujian yang tersimpan, Anda dapat menjalankan salah satunya dengan dengan mengikuti langkah-langkah berikut:
- Buka project skrip yang berisi add-on Anda.
- Klik Deploy > Test deployment.
- Di bagian Pengujian Tersimpan, pilih tombol pilihan di samping pengujian yang disimpan deployment yang ingin Anda jalankan, lalu klik Execute.
Dokumen pengujian akan terbuka di tab baru. Add-on ini berada di status otorisasi yang ditentukan dalam deployment pengujian. Anda dapat memverifikasi bahwa add-on berfungsi sebagai yang diinginkan melalui interaksi dengan elemen menu dan UI-nya.
Detail pengujian
Ada sejumlah hal yang perlu diingat saat menguji Add-on Editor seperti ini:
- Pemicu yang dapat diinstal tidak didukung saat pengujian. Fungsi yang bergantung pada penginstalan pemicu tidak dapat diuji.
- Saat menjalankan deployment uji coba yang diatur untuk diuji dengan kode terbaru, Anda dapat melihat perubahan yang disimpan pada skrip add-on dengan memuat ulang dokumen pengujian.
- Dokumen tes memiliki URL yang dapat Anda bagikan kepada editor dokumen asli dokumen pengujian. Dengan cara ini, Anda dapat lebih mudah berkolaborasi dengan orang lain sambil pengujian dan pengembangan.
- Jika add-on Anda menggunakan Layanan properti, properti akan dipertahankan dan tersedia saat deployment pengujian lagi dijalankan.
- Selain itu, setiap deployment pengujian yang menggunakan kombinasi add-on dan dokumen pengujian memiliki akses ke informasi properti yang sama. Misalnya, jika Anda membuat dua deployment pengujian, properti disimpan saat menjalankan tersedia saat menjalankan perintah kedua dan sebaliknya, tetapi hanya jika metode deployment menggunakan skrip dan dokumen uji yang sama.
- Jika menjalankan deployment pengujian, Anda mungkin akan diminta untuk melakukan otorisasi belum pernah menjalankan skrip tersebut. Perhatikan bahwa memberikan otorisasi pada skrip ketika pengujian juga akan mengotorisasi skrip di luar pengujian.