Apps Script Google Workspace 부가기능 테스트 및 디버그
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
부가기능을 게시하면 사용자는 호스트 애플리케이션 또는 Google Workspace Marketplace를 통해 부가기능을 설치할 수 있습니다. 게시하기 전에 확장하는 호스트 애플리케이션 내에서 개발한 부가기능을 테스트합니다.
이 페이지에서는 테스트 또는 개인용으로 개발 중인 부가기능 (게시되지 않음 또는 개발자 부가기능이라고 함)을 설치하는 방법을 설명합니다. Apps Script IDE의 디버거 및 중단점을 사용하여 부가기능을 디버그할 수도 있습니다.
기본 요건
- 부가기능의 스크립트 프로젝트에 대한 편집자 액세스 권한이 있어야 합니다.
- 조직의 다른 사용자가 부가기능을 테스트할 수 있도록 하려면 스크립트 프로젝트에 대한 편집자 액세스 권한을 부여합니다. 액세스 권한 부여에 관한 자세한 내용은 다른 개발자와 공동작업을 참고하세요.
게시되지 않은 부가기능 설치하기
Apps Script의 배포 대화상자에서 게시되지 않은 부가기능을 설치할 수 있습니다.
테스트를 위해 게시되지 않은 Google Workspace 부가기능을 설치하려면 다음 단계를 따르세요.
- Apps Script 편집기에서 스크립트 프로젝트를 엽니다.
- 배포 > 배포 테스트를 클릭합니다.
- 설치를 클릭합니다.
- 하단에서 완료를 클릭합니다.
다른 사용자의 계정과 Apps Script 프로젝트를 공유하여 부가기능을 테스트하도록 할 수 있습니다 (수정 액세스 권한 필요). 그런 다음 사용자에게 위 단계를 따르도록 안내합니다.
설치된 부가기능은 확장하는 호스트 애플리케이션에서 즉시 사용할 수 있습니다. 부가기능이 표시되기 전에 호스트 애플리케이션 탭을 새로고침해야 할 수 있습니다. 또한 부가기능을 사용하기 전에 승인해야 합니다.
게시되지 않은 부가기능 제거하기
게시되지 않은 부가기능 배포를 제거하려면 다음 단계를 따르세요.
- Apps Script 편집기에서 스크립트 프로젝트를 엽니다.
- 배포 > 배포 테스트를 클릭합니다.
- 제거를 클릭합니다.
- 하단에서 완료를 클릭합니다.
이 단계를 수행하면 배포가 즉시 삭제되고 더 이상 호스트 애플리케이션에 부가기능이 표시되지 않습니다. 언제든지 설치 절차를 반복하여 배포를 다시 설치할 수 있습니다.
테스트 권장사항
Google Workspace 부가기능을 테스트하는 동안 부가기능 개발에 관한 권장사항을 따르세요. 또한 다음 사항을 확인하세요.
부가기능이 확장하는 모든 호스트 애플리케이션에서 카드 탐색 흐름을 철저히 테스트합니다. 사용자가 컨텍스트 간에 이동할 때, 그리고 문맥 외 카드와 문맥 내 카드 간에 이동할 때 부가기능 동작이 올바른지 확인합니다.
예시 테스트 데이터를 사용하여 부가기능의 동작을 평가합니다.
부가기능이 서드 파티 API 또는 다른 서비스에 연결되는 경우 서비스에 액세스할 수 있고 예상대로 작동하는지 확인합니다. 부가기능이 승인 및 로그인 세부정보를 올바르게 처리하는지 확인합니다.
오류 조건이 적절하게 처리되는지 확인합니다. 필요한 경우 오류 카드를 사용합니다.
부가기능의 성능에 주의하세요. 코드를 변경했는데 부가기능이 느려지기 시작한 경우 해당 기능을 삭제하거나 수정해야 할 수 있습니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-12-22(UTC)
[null,null,["최종 업데이트: 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."]]