Add-on harus diuji secara menyeluruh sebelum dipublikasikan untuk memastikan add-on tersebut berfungsi sebagaimana mestinya. Apps Script memungkinkan Anda menguji Add-on Editor dalam pengembangan di file Spreadsheet, Formulir, atau Slide Google Dokumen tertentu. Ini dapat digunakan untuk:
- Pastikan add-on yang ditulis dalam skrip mandiri berfungsi sebagaimana mestinya saat diterapkan ke sheet, dokumen, presentasi, atau formulir.
- Pastikan alur penginstalan add-on berfungsi sebagaimana mestinya, terutama untuk status siklus proses otorisasi awal yang berbeda (diinstal, diaktifkan, atau keduanya).
- Pastikan add-on berfungsi sebagaimana mestinya saat menindaklanjuti dokumen tertentu beserta kontennya.
- Uji dan bandingkan add-on versi saat ini dengan versi sebelumnya.
Membuat deployment pengujian
Deployment pengujian adalah kombinasi add-on dan dokumen pengujian. Setelah Anda mengembangkan versi skrip dan ingin mengujinya sebagai add-on, ikuti langkah-langkah berikut:
- Jika Anda belum memilikinya, buat spreadsheet, dokumen, presentasi, atau formulir untuk menguji add-on ini.
- Buka project skrip yang berisi add-on Anda.
- Klik Deploy > Uji deployment.
- Di samping Select type, klik Enable deployment types , lalu pilih Editor Add-on.
- 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 file Spreadsheet, Dokumen, Slide, atau Formulir yang ingin Anda gunakan untuk menguji add-on, lalu klik Sisipkan.
- Klik Save test.
Semua deployment pengujian yang tersimpan akan muncul dalam dialog Test deployment. Hal ini memungkinkan Anda mengunjungi kembali deployment pengujian yang sama nanti.
Menjalankan deployment uji
Jika memiliki satu atau beberapa deployment pengujian tersimpan, Anda dapat menjalankan salah satunya dengan mengikuti langkah-langkah berikut:
- Buka project skrip yang berisi add-on Anda.
- Klik Deploy > Uji deployment.
- Di bagian Saved Tests, pilih tombol pilihan di samping deployment pengujian tersimpan yang ingin Anda jalankan, lalu klik Execute.
Dokumen pengujian akan terbuka di tab baru. Add-on berada dalam status otorisasi yang ditentukan dalam deployment pengujian. Anda dapat memverifikasi bahwa add-on berfungsi seperti yang dimaksudkan dengan berinteraksi dengan menu dan elemen UI-nya.
Detail pengujian
Ada sejumlah hal yang perlu diingat saat menguji Add-on Editor dengan cara ini:
- Pemicu yang dapat diinstal tidak didukung saat pengujian. Fungsi yang bergantung pada pemicu yang dapat diinstal tidak dapat diuji.
- Saat menjalankan deployment uji coba yang ditetapkan untuk diuji dengan kode terbaru, Anda dapat melihat perubahan yang disimpan pada skrip add-on dengan memuat ulang dokumen pengujian.
- Dokumen pengujian memiliki URL yang dapat Anda bagikan kepada editor dokumen pengujian asli. Dengan cara ini, Anda dapat lebih mudah berkolaborasi dengan orang lain saat menguji dan mengembangkan.
- Jika add-on Anda menggunakan layanan Properties, properti akan tetap tersedia dan akan tetap tersedia saat deployment pengujian berikutnya.
- Selain itu, setiap deployment pengujian yang menggunakan kombinasi add-on dan dokumen pengujian yang sama memiliki akses ke informasi properti yang sama. Misalnya, jika Anda membuat dua deployment uji, properti yang disimpan saat menjalankan yang pertama akan tersedia saat menjalankan yang kedua dan sebaliknya. Namun, hanya jika deployment menggunakan skrip dan dokumen pengujian yang sama.
- Jika menjalankan deployment uji coba, Anda mungkin akan diminta untuk melakukan otorisasi jika belum menjalankan skrip sebelumnya. Perlu diketahui bahwa memberi otorisasi skrip saat pengujian juga memberi otorisasi skrip di luar pengujian.