اختبار إضافات Google Workspace في Apps Script وتصحيح الأخطاء فيها
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
عند نشر إضافة، يمكن للمستخدمين تثبيتها
من خلال التطبيق المضيف
أو Google Workspace Marketplace. قبل نشر التطبيقات، اختبِر الإضافة التي تُطوّرها ضمن التطبيقات المضيفّة التي تُضيف إليها ميزات.
توضّح هذه الصفحة كيفية تثبيت إضافة قيد التطوير (تُعرف باسم إضافة غير منشورة أو إضافة المطوّر) للاختبار أو
الاستخدام الشخصي. يمكنك أيضًا تصحيح أخطاء الإضافات باستخدام أداة تصحيح الأخطاء ونقاط التوقف في IDE لأجل
برمجة التطبيقات.
المتطلبات الأساسية
- يجب أن يكون لديك إذن وصول المحرِّر إلى مشروع النصوص البرمجية للإضافات.
- للسماح للمستخدمين الآخرين في مؤسستك باختبار الإضافة، امنحهم إذن وصول كاتب محتوى
إلى مشروع النصوص البرمجية. لمعرفة التفاصيل حول منح الإذن بالوصول، يُرجى الاطّلاع على مقالة
التعاون مع مطوّرين آخرين.
تثبيت إضافة غير منشورة
يمكنك تثبيت إضافات غير منشورة من مربّع حوار عمليات النشر
في Apps Script.
اتّبِع الخطوات التالية لتثبيت إضافة
Google Workspace غير المنشورة للاختبار:
- افتح مشروع النصوص البرمجية في محرِّر Apps Script.
- انقر على النشر > اختبار عمليات النشر.
- انقر على تثبيت.
- في أسفل الصفحة، انقر على تم.
يمكنك السماح للمستخدمين الآخرين باختبار الإضافة من خلال مشاركة مشروع Apps Script
مع حساباتهم (يجب أن يكون لديهم إذن الوصول للتعديل). بعد ذلك، اطلب من المستخدمين
اتّباع الخطوات أعلاه.
بعد التثبيت، تصبح الإضافة متاحة على الفور في التطبيقات المضيفّة التي تُوسّع نطاقها. قد تحتاج إلى إعادة تحميل علامة التبويب الخاصة بالتطبيق المضيف قبل أن تظهر الإضافة. يجب أيضًا
تفويض
الإضافة قبل استخدامها.
إلغاء تثبيت إضافة غير منشورة
لإزالة عملية نشر إضافة غير منشورة، اتّبِع الخطوات التالية:
- افتح مشروع النصوص البرمجية في محرِّر Apps Script.
- انقر على النشر > اختبار عمليات النشر.
- انقر على إلغاء التثبيت.
- في أسفل الصفحة، انقر على تم.
تؤدي هذه الخطوات إلى إزالة عملية النشر على الفور، ولن تظهر الإضافة مجددًا
في أي تطبيق مضيف. يمكنك إعادة تثبيت عملية النشر في أي وقت من خلال تكرار إجراء التثبيت.
أفضل الممارسات المتعلّقة بالاختبار
أثناء اختبار إضافة Google Workspace، احرص على
اتّباع أفضل الممارسات
لتطوير الإضافة. بالإضافة إلى ذلك، يُرجى اتّباع الخطوات التالية:
يجب أن تكون تنقّل بطاقة الاختبار سلسة في جميع التطبيقات المضيفّة التي توفّر الإضافة. تأكَّد من صحة سلوك الإضافة عندما ينتقل المستخدم
من سياق إلى آخر، وبين البطاقات غير السياقية والسياقية.
استخدِم أمثلة على بيانات الاختبار
لتقييم سلوك الإضافة.
إذا كانت الإضافة تتصل بواجهة برمجة تطبيقات أو خدمة أخرى تابعة لجهة خارجية، تأكَّد مما يلي:
إمكانية الوصول إلى الخدمة وعمل الإضافة على النحو المتوقّع. تأكَّد من أنّ الإضافة تعالج
تفاصيل التفويض وتسجيل الدخول
بشكل صحيح.
تأكَّد من معالجة أيّ حالات خطأ بشكلٍ سلس. استخدِم بطاقات الأخطاء
عند الحاجة.
انتبه إلى مستوى أداء الإضافة. إذا أجريت تغييرًا على
الرمز البرمجي وبدأت الإضافة في التباطؤ، قد تحتاج إلى إزالة
هذه الميزة أو إعادة صياغتها.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-12-22 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-12-22 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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."]]
