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.
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.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["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."]]
