Menguji add-on Editor (original) (raw)

Add-on harus diuji secara menyeluruh sebelum dipublikasikan untuk memastikan add-on berfungsi sebagaimana mestinya. Apps Script memungkinkan Anda mengujiadd-on Editoryang sedang dikembangkan pada file Google Dokumen, Spreadsheet, Formulir, atau Slide tertentu. Hal ini dapat digunakan untuk:

• Verifikasi bahwa add-on yang ditulis dalam skrip mandiri berfungsi sebagaimana mestinya saat diterapkan ke spreadsheet, dokumen, presentasi, atau formulir.
• Pastikan alur penginstalan add-on berfungsi sebagaimana mestinya, terutama untuk status siklus proses otorisasi awalyang berbeda(diinstal, diaktifkan, atau keduanya).
• Pastikan add-on berfungsi sebagaimana mestinya saat bertindak pada dokumen tertentu 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 Anda mengembangkan versi skrip dan ingin mengujinya sebagai add-on, ikuti langkah-langkah berikut:

1. Jika Anda belum memilikinya, buat spreadsheet, dokumen, presentasi, atau formulir untuk menguji add-on.
2. Buka project skrip yang berisi add-on Anda.
3. Klik Deploy > Test deployments.
4. Di samping Pilih jenis, klik Aktifkan jenis deployment lalu pilih Add-on editor.
5. Klik Buat pengujian baru atau Tambahkan pengujian.
6. Pilih versi kode atau pilih Kode Terbaru.
7. Di bagian Config, pilih status otorisasi awal untuk pengujian.
8. Di bagian Test document, klik No document selected. Pilih file Spreadsheet, Dokumen, Slide, atau Formulir yang ingin Anda gunakan untuk menguji add-on, lalu klik Sisipkan.
9. Klik Simpan tes.

Semua deployment pengujian tersimpan akan muncul di dialog Test deployments. Dengan begitu, Anda dapat membuka kembali deployment pengujian yang sama di lain waktu.

Menjalankan deployment pengujian

Jika memiliki satu atau beberapa deployment pengujian tersimpan, Anda dapat menjalankan salah satunya dengan mengikuti langkah-langkah berikut:

1. Buka project skrip yang berisi add-on Anda.
2. Klik Deploy > Test deployments.
3. 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 dalamstatus otorisasiyang ditentukan dalam deployment pengujian. Anda dapat memverifikasi bahwa add-on berfungsi sebagaimana yang dimaksudkan dengan berinteraksi dengan menu dan elemen UI-nya.

Untuk menguji fitur OAuth terperinci di add-on Anda, pastikan project Anda belum memiliki otorisasi. Untuk membatalkan otorisasi yang ada, gunakan ScriptApp.invalidateAuth.

Detail pengujian

Ada sejumlah hal yang perlu diingat saat menguji add-on Editor dengan cara ini:

• Pemicu yang dapat diinstaltidak didukung saat pengujian. Fungsi yang bergantung pada pemicu yang dapat diinstal tidak dapat diuji.
• Saat menjalankan deployment pengujian yang disetel untuk menguji dengan kode terbaru, Anda dapat melihat perubahan yang disimpan ke skrip add-on dengan memuat ulang dokumen pengujian.
• Dokumen pengujian memiliki URL yang dapat Anda bagikan kepada editor dokumen pengujian asli. Dengan begitu, Anda dapat berkolaborasi dengan orang lain secara lebih mudah saat menguji dan mengembangkan.
• Jika add-on Anda menggunakanlayanan Properti, properti akan tetap ada dan tersedia saat deployment pengujian dijalankan pada waktu 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 pengujian, properti yang disimpan saat menjalankan deployment pertama tersedia saat menjalankan deployment kedua dan sebaliknya, tetapi hanya jika deployment menggunakan skrip dan dokumen pengujian yang sama.
• Jika menjalankan deployment pengujian, Anda mungkin diminta untuk memberikan otorisasi jika belum pernah menjalankan skrip sebelumnya. Perhatikan bahwa mengizinkan skrip saat menguji juga mengizinkan skrip di luar pengujian.