Testowanie i debugowanie dodatków do Google Workspace za pomocą Apps Script
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Po opublikowaniu dodatku użytkownicy mogą go zainstalować za pomocą aplikacji hosta lub Google Workspace Marketplace. Zanim opublikujesz dodatki, przetestuj je w aplikacjach hostujących, które rozszerzają.
Na tej stronie opisaliśmy, jak zainstalować dodatek, który jest w trakcie tworzenia (tzw. nieopublikowany lub dodatek dla dewelopera) na potrzeby testowania lub użytku osobistego. Dodatki możesz też debugować za pomocą debugera i punktów przerwania w IDE Apps Script.
Wymagania wstępne
Musisz mieć uprawnienia edytującego do projektu skryptu dodatku.
Aby umożliwić innym osobom w organizacji testowanie dodatku, przyznaj im uprawnienia edytora do projektu skryptu. Szczegółowe informacje o przyznawaniu dostępu znajdziesz w artykule Współpraca z innymi deweloperami.
Instalowanie nieopublikowanego dodatku
Nieopublikowane dodatki możesz zainstalować w dialogu Wdrożenia w Apps Script.
Aby zainstalować nieopublikowany dodatek Google Workspace do celów testowania:
Otwórz projekt skryptu w edytorze Apps Script.
Kliknij Wdrażanie > Testuj wdrożenia.
Kliknij Zainstaluj.
U dołu kliknij Gotowe.
Możesz pozwolić innym użytkownikom na testowanie dodatku, udostępniając projekt Apps Script na ich koncie (wymaga to dostępu do edycji). Następnie poproś użytkowników o wykonywanie czynności opisanych powyżej.
Po zainstalowaniu dodatek jest od razu dostępny w aplikacjach hosta, które rozszerza. Zanim wtyczka się wyświetli, może być konieczne odświeżenie karty aplikacji hosta. Zanim zaczniesz korzystać z dodatku, musisz go też autoryzować.
Odinstalowywanie nieopublikowanego dodatku
Aby odinstalować nieopublikowane wdrożenie dodatku:
Otwórz projekt skryptu w edytorze Apps Script.
Kliknij Wdrażanie > Testuj wdrożenia.
Kliknij Odinstaluj.
U dołu kliknij Gotowe.
W ten sposób wdrożenie zostanie natychmiast usunięte, a dodatek nie będzie już widoczny w żadnej aplikacji hosta. W każdej chwili możesz ponownie zainstalować wdrożenie, powtarzając procedurę instalacji.
Sprawdzone metody testowania
Podczas testowania dodatku do Google Workspace przestrzegaj sprawdzonych metod dotyczących tworzenia dodatków. Dodatkowo pamiętaj o tych kwestiach:
Dokładnie przetestuj przepływy nawigacji kart we wszystkich aplikacjach hosta, do których rozszerza się dodatek. Upewnij się, że zachowanie dodatku jest prawidłowe, gdy użytkownik przechodzi z jednego kontekstu do drugiego oraz między kartami kontekstowymi i niekontekstowymi.
Jeśli Twój dodatek łączy się z interfejsem API innej firmy lub inną usługą, sprawdź, czy można uzyskać dostęp do tej usługi i czy działa ona zgodnie z oczekiwaniami. Upewnij się, że dodatek poprawnie obsługuje dane logowania i autoryzacji.
Upewnij się, że wszystkie błędy są obsługiwane prawidłowo. W razie potrzeby użyj kart z błędami.
Zwróć uwagę na wydajność dodatku. Jeśli po wprowadzeniu zmian w kodzie dodatek zacznie działać wolniej, może być konieczne usunięcie tej funkcji lub jej przerobienie.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 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."]]
