Apps Komut Dosyası Google Workspace eklentilerini test etme ve hata ayıklama
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Yayınladığınız eklentileri kullanıcılar, barındıran uygulama veya Google Workspace Marketplace üzerinden yükleyebilir. Geliştirdiğiniz eklentileri, yayınlamadan önce genişlettikleri ana uygulamalarda test edin.
Bu sayfada, geliştirme aşamasındaki bir eklentinin (yayınlanmamış veya geliştirici eklentisi olarak adlandırılır) test veya kişisel kullanım için nasıl yükleneceği açıklanmaktadır. Ayrıca, Apps Script IDE'nin hata ayıklayıcısını ve kesme noktalarını kullanarak eklentilerde hata ayıklama yapabilirsiniz.
Ön koşullar
- Eklentinin komut dosyası projesine düzenleyici erişiminiz olmalıdır.
- Kuruluşunuzdaki diğer kullanıcıların eklentiyi test etmesine izin vermek için komut dosyası projesine düzenleyici erişimi verin. Erişim verme hakkında ayrıntılı bilgi için Diğer Geliştiricilerle Ortak Çalışma başlıklı makaleyi inceleyin.
Yayınlanmamış bir eklentiyi yükleme
Yayınlanmamış eklentileri Apps Komut Dosyası'nın Dağıtımlar iletişim kutusundan yükleyebilirsiniz.
Test için yayınlanmamış bir Google Workspace eklentisini yüklemek üzere aşağıdaki adımları uygulayın:
- Komut dosyası projesini Apps Script düzenleyicisinde açın.
- Dağıt > Dağıtımları test et'i tıklayın.
- Yükle'yi tıklayın.
- Alt tarafta Bitti'yi tıklayın.
Apps Script projesini hesaplarıyla paylaşarak diğer kullanıcıların eklentiyi test etmesine izin verebilirsiniz (düzenleme erişimi gereklidir). Ardından kullanıcılardan yukarıdaki adımları uygulamalarını isteyin.
Yüklenen eklentiler, genişlettikleri ana uygulamalarda hemen kullanılabilir. Eklenti görünmeden önce ana makine uygulaması sekmesini yenilemeniz gerekebilir. Ayrıca, eklentiyi kullanmadan önce yetkilendirmeniz gerekir.
Yayından kaldırılan eklentileri kaldırma
Yayınlanmamış bir eklenti dağıtımını kaldırmak için aşağıdaki adımları uygulayın:
- Komut dosyası projesini Apps Script düzenleyicisinde açın.
- Dağıt > Dağıtımları test et'i tıklayın.
- Kaldır'ı tıklayın.
- Alt tarafta Bitti'yi tıklayın.
Bu adımlar, dağıtımı hemen kaldırır ve eklenti artık hiçbir barındırma uygulamasında görünmez. Yükleme prosedürünü tekrarlayarak dağıtımı dilediğiniz zaman yeniden yükleyebilirsiniz.
Testlerle ilgili en iyi uygulamalar
Google Workspace eklentinizi test ederken eklenti geliştirmeyle ilgili en iyi uygulamaları izlediğinizden emin olun. Ayrıca aşağıdakileri yaptığınızdan emin olun:
Eklentinin genişlettiği tüm ana uygulamalarda test kartı gezinme akışını ayrıntılı olarak test edin. Kullanıcı bağlamdan bağlama ve bağlam dışı ile bağlama dayalı kartlar arasında geçiş yaparken eklenti davranışının doğru olduğundan emin olun.
Eklentinizin davranışını değerlendirmek için örnek test verilerini kullanın.
Eklentiniz bir üçüncü taraf API'ye veya başka bir hizmete bağlanıyorsa hizmete erişilebildiğini ve beklendiği gibi davrandığını doğrulayın. Eklentinizin yetkilendirme ve giriş ayrıntılarını doğru şekilde işlediğinden emin olun.
Tüm hata koşullarının uygun şekilde ele alındığından emin olun. Gerekirse hata kartlarını kullanın.
Eklentinin performansına dikkat edin. Kodda yaptığınız bir değişiklikten sonra eklenti yavaşlamaya başlarsa bu özelliği kaldırmanız veya yeniden çalışmanız gerekebilir.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2024-12-22 UTC.
[null,null,["Son güncelleme tarihi: 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."]]
