Menguji dan men-debug add-on Google Workspace Apps Script
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
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:
- Buka project skrip di editor Apps Script.
- Klik Deploy > Test deployments.
- Klik Instal.
- 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:
- Buka project skrip di editor Apps Script.
- Klik Deploy > Test deployments.
- Klik Uninstal.
- 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:
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.
Gunakan contoh data pengujian
untuk mengevaluasi perilaku add-on Anda.
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.
Pastikan kondisi error ditangani dengan baik. Gunakan kartu error
jika diperlukan.
Perhatikan performa add-on. Jika Anda membuat perubahan pada kode dan add-on mulai melambat, Anda mungkin perlu menghapus atau mengerjakan ulang fitur tersebut.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2024-12-22 UTC.
[null,null,["Terakhir diperbarui pada 2024-12-22 UTC."],[[["\u003cp\u003eUnpublished Google Workspace add-ons can be installed for testing and personal use directly from the Apps Script project.\u003c/p\u003e\n"],["\u003cp\u003eUsers need editor access to the script project to install and test the unpublished add-on.\u003c/p\u003e\n"],["\u003cp\u003eUninstalling an unpublished add-on removes it from all host applications and requires reinstallation for further use.\u003c/p\u003e\n"],["\u003cp\u003eThorough testing is crucial, including card navigation, data handling, external service integrations, error management, and performance evaluation.\u003c/p\u003e\n"]]],["To test an unpublished add-on, open its script project in the Apps Script editor and navigate to **Deploy \u003e Test deployments**. Click **Install**, then **Done** to make it available in host applications. Share the project for others to test. Uninstall by repeating the process and selecting **Uninstall**. Testing should include card navigation, example data evaluation, third-party service verification, error handling, and performance monitoring.\n"],null,["# Test and debug Apps Script Google Workspace add-ons\n\nWhen you publish an add-on, users can install it\nthrough the host application\nor the [Google Workspace Marketplace](https://workspace.google.com/marketplace/). Before you publish, test the\nadd-ons that you develop within the host applications that\nthey extend.\n\nThis page describes how to install an add-on that is\nunder development (called an *unpublished* or *developer*\nadd-on) for testing or\npersonal use. You can also debug add-ons using the\nApps Script\nIDE's [debugger and breakpoints](/apps-script/guides/support/troubleshooting#use-debugger).\n\nPrerequisites\n-------------\n\n- You must have editor access to the add-on's script project.\n- To let other people in your organization test the add-on, grant them editor access to the script project. For details about granting access, see [Collaborating with Other Developers](/apps-script/guides/collaborating).\n\nInstall an unpublished add-on\n-----------------------------\n\nYou can install unpublished add-ons from Apps Script's **Deployments**\ndialog.\n\nFollow these steps to install an unpublished\nGoogle Workspace add-on for testing:\n\n1. Open the script project in the Apps Script editor.\n2. Click **Deploy \\\u003e Test deployments**.\n3. Click **Install**.\n4. At the bottom, click **Done**.\n\nYou can let other users test the add-on by sharing the Apps Script project\nwith their account (edit access is required). Then prompt the users to\nfollow the above steps.\n\nOnce installed, the add-on is immediately available in host applications it\nextends. You may need to refresh the host application tab before the add-on\nappears. You must also\n[authorize](/workspace/add-ons/how-tos/authorizing-addons#authorizing_unpublished_g_suite_add-ons)\nthe add-on before using it.\n\nUninstall an unpublished add-on\n-------------------------------\n\nTo uninstall an unpublished add-on deployment, follow these steps:\n\n1. Open the script project in the Apps Script editor.\n2. Click **Deploy \\\u003e Test deployments**.\n3. Click **Uninstall**.\n4. At the bottom, click **Done**.\n\nThese steps immediately remove the deployment and the add-on no longer appears\nin any host application. You can reinstall the deployment at any time by\nrepeating the [install procedure](#install_an_unpublished_add-on).\n\nTesting best practices\n----------------------\n\nWhile testing your Google Workspace add-on, be sure\nto follow the\n[Best practices](/workspace/add-ons/guides/workspace-best-practices)\nfor add-on development. In addition, be sure to do the following:\n\n1. Test card navigation flows thoroughly in all the host applications the\n add-on extends. Make sure the add-on behavior is correct as the user moves\n from context to context, and between non-contextual and contextual cards.\n\n2. [Use example test data](/workspace/add-ons/guides/workspace-best-practices#_write_tests_and_test_messages)\n to evaluate your add-on's behavior.\n\n3. If your add-on connects to a third-party API or other service, verify\n that the service can be accessed and behaves as expected. Make sure\n your add-on is handling the\n [authorization and log-in details](/workspace/add-ons/how-tos/non-google-services)\n correctly.\n\n4. Make sure any error conditions are handled gracefully. [Use error cards](/workspace/add-ons/guides/workspace-best-practices#_use_error_cards)\n where needed.\n\n5. Pay attention to how performant the add-on is. If you make a change to the\n code and the add-on starts slowing down, you may need to remove or rework\n that feature."]]
