افزونه های Google Workspace Apps Script را آزمایش و اشکال زدایی کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
وقتی افزونه‌ای را منتشر می‌کنید، کاربران می‌توانند آن را از طریق برنامه میزبان یا Google Workspace Marketplace نصب کنند. قبل از انتشار، افزونه‌هایی را که در برنامه‌های میزبانی که توسعه می‌دهند، آزمایش کنید.
این صفحه نحوه نصب افزونه‌ای را که در دست توسعه است (به نام افزونه منتشرنشده یا توسعه‌دهنده ) برای آزمایش یا استفاده شخصی توضیح می‌دهد. همچنین می‌توانید افزونه‌ها را با استفاده از اشکال‌زدای Apps Script IDE و نقاط شکست اشکال‌زدایی کنید.
پیش نیازها
شما باید به پروژه اسکریپت افزونه دسترسی ویرایشگر داشته باشید.
برای اینکه به افراد دیگر سازمانتان اجازه دهید این افزونه را آزمایش کنند، به آنها اجازه ویرایشگر به پروژه اسکریپت بدهید. برای جزئیات در مورد اعطای دسترسی، به همکاری با سایر توسعه دهندگان مراجعه کنید.
یک افزونه منتشر نشده نصب کنید
می‌توانید افزونه‌های منتشر نشده را از گفتگوی استقرار Apps Script نصب کنید.
برای نصب افزونه Google Workspace منتشر نشده برای آزمایش، این مراحل را دنبال کنید:
پروژه اسکریپت را در ویرایشگر Apps Script باز کنید.
روی Deploy > Test Deployments کلیک کنید.
روی Install کلیک کنید.
در پایین، روی انجام شد کلیک کنید.
می‌توانید با اشتراک‌گذاری پروژه Apps Script با حساب خود، به سایر کاربران اجازه دهید افزونه را آزمایش کنند (دسترسی به ویرایش لازم است). سپس از کاربران بخواهید مراحل بالا را دنبال کنند.
پس از نصب، افزونه فوراً در برنامه های میزبانی که گسترش می یابد در دسترس است. ممکن است لازم باشد قبل از ظاهر شدن افزونه، برگه برنامه میزبان را بازخوانی کنید. همچنین باید قبل از استفاده از افزونه مجوز دهید .
یک افزونه منتشر نشده را حذف نصب کنید
برای حذف نصب یک افزونه منتشر نشده، این مراحل را دنبال کنید:
پروژه اسکریپت را در ویرایشگر Apps Script باز کنید.
روی Deploy > Test Deployments کلیک کنید.
روی Uninstall کلیک کنید.
در پایین، روی انجام شد کلیک کنید.
این مراحل فوراً استقرار را حذف می کند و افزونه دیگر در هیچ برنامه میزبانی ظاهر نمی شود. می‌توانید در هر زمان که بخواهید با تکرار مراحل نصب، Deployment را دوباره نصب کنید.
آزمایش بهترین شیوه ها
هنگام آزمایش برافزای Google Workspace، مطمئن شوید که بهترین روش‌ها را برای توسعه افزونه‌ها دنبال می‌کنید. علاوه بر این موارد زیر را حتما انجام دهید:
ناوبری کارت آزمایشی به طور کامل در همه برنامه‌های میزبانی که افزونه گسترش می‌دهد، جریان دارد. هنگام حرکت کاربر از زمینه ای به زمینه دیگر و بین کارت های غیر متنی و متنی، اطمینان حاصل کنید که رفتار افزونه درست است.
اگر افزونه شما به یک API شخص ثالث یا سرویس دیگری متصل است، بررسی کنید که سرویس قابل دسترسی باشد و مطابق انتظار رفتار کند. مطمئن شوید که افزونه شما جزئیات مجوز و ورود به سیستم را به درستی مدیریت می کند.
تاریخ آخرین بهروزرسانی 2024-12-22 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 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."]]
