یک افزونه ویرایشگر را آزمایش کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
افزونه‌ها باید قبل از انتشار به‌طور کامل آزمایش شوند تا اطمینان حاصل شود که مطابق خواسته‌ها رفتار می‌کنند. Apps Script به شما امکان می‌دهد افزونه‌های ویرایشگر را در حال توسعه در برگه‌ها، فرم‌ها، یا فایل‌های اسلایدهای Google Docs خاص آزمایش کنید. از این می توان برای موارد زیر استفاده کرد:
- بررسی کنید که افزونه ای که در یک اسکریپت مستقل نوشته شده است، هنگام اعمال بر روی یک برگه، سند، ارائه یا فرم همانطور که در نظر گرفته شده است عمل می کند.
- بررسی کنید که جریان نصب افزونه همانطور که در نظر گرفته شده است، به ویژه برای حالت های مختلف چرخه حیات مجوز اولیه ( نصب شده، فعال یا هر دو ) کار می کند.
- بررسی کنید که هنگام کار بر روی یک سند خاص و محتویات آن، افزونه همانطور که در نظر گرفته شده است عمل کند.
- نسخه فعلی و قبلی افزونه را تست و مقایسه کنید.
یک استقرار آزمایشی ایجاد کنید
استقرار آزمایشی ترکیبی از یک افزونه و یک سند آزمایشی است. هنگامی که یک نسخه اسکریپت را توسعه دادید و می خواهید آن را به عنوان یک افزونه آزمایش کنید، مراحل زیر را دنبال کنید:
- اگر قبلاً ندارید، یک صفحه گسترده، سند، ارائه یا فرم ایجاد کنید تا افزونه را با آن آزمایش کنید.
- پروژه اسکریپت حاوی افزونه خود را باز کنید.
- روی Deploy > Test Deployments کلیک کنید.
- در کنار انتخاب نوع ، روی فعال کردن settings انواع استقرار کلیک کنید و افزودنی ویرایشگر را انتخاب کنید.
- روی ایجاد آزمایش جدید یا افزودن آزمایش کلیک کنید.
- یک نسخه کد را انتخاب کنید یا آخرین کد را انتخاب کنید.
- در قسمت Config ، وضعیت مجوز اولیه را برای آزمایش انتخاب کنید.
- در بخش آزمایش سند ، روی هیچ سندی انتخاب نشده است . فایل Sheets، Docs، Slides یا Forms را که می‌خواهید برای آزمایش افزونه استفاده کنید انتخاب کنید و روی Insert کلیک کنید.
- روی ذخیره تست کلیک کنید.
همه استقرارهای آزمایشی ذخیره شده در گفتگوی استقرارهای آزمایشی ظاهر می شوند. این به شما امکان می دهد بعداً همان استقرار آزمایشی را مجدداً مشاهده کنید.
یک استقرار آزمایشی را اجرا کنید
اگر یک یا چند برنامه آزمایشی ذخیره شده دارید، می توانید یکی از آنها را با دنبال کردن مراحل زیر اجرا کنید:
- پروژه اسکریپت حاوی افزونه خود را باز کنید.
- روی Deploy > Test Deployments کلیک کنید.
- در بخش تست‌های ذخیره شده ، دکمه رادیویی را در کنار برنامه آزمایشی ذخیره‌شده‌ای که می‌خواهید اجرا کنید انتخاب کنید و روی Execute کلیک کنید.
سند آزمایشی در یک برگه جدید باز می شود. افزونه در وضعیت مجوز مشخص شده در استقرار آزمایشی است. می‌توانید با تعامل با منو و عناصر رابط کاربری آن، تأیید کنید که عملکرد افزونه همانطور که در نظر گرفته شده است.
جزئیات تست
هنگام آزمایش افزونه های ویرایشگر به این روش، باید به چند نکته توجه داشت:
- راه‌اندازهای قابل نصب هنگام آزمایش پشتیبانی نمی‌شوند. عملکردی که به تریگرهای قابل نصب بستگی دارد قابل آزمایش نیست.
- هنگام اجرای یک استقرار آزمایشی که برای آزمایش با آخرین کد تنظیم شده است، می‌توانید تغییرات ذخیره شده در اسکریپت افزودنی را با بازخوانی سند آزمایشی مشاهده کنید.
- سند آزمایشی دارای یک URL است که می توانید آن را با ویرایشگران سند آزمایشی اصلی به اشتراک بگذارید. به این ترتیب، هنگام آزمایش و توسعه، راحت‌تر می‌توانید با دیگران همکاری کنید.
- اگر افزونه شما از سرویس Properties استفاده می‌کند، ویژگی‌ها باقی می‌مانند و دفعه بعد که استقرار آزمایشی اجرا می‌شود در دسترس باقی می‌مانند.
- بعلاوه، هر برنامه آزمایشی که از ترکیب یکسانی از افزونه و سند آزمایشی استفاده می‌کند، به اطلاعات ویژگی یکسانی دسترسی دارد. به عنوان مثال، اگر دو استقرار آزمایشی ایجاد کنید، ویژگی‌های ذخیره شده در حین اجرای اولی در حین اجرای دومی و بالعکس در دسترس هستند، اما تنها در صورتی که استقرارها از یک اسکریپت و سند آزمایشی استفاده کنند.
- اگر یک استقرار آزمایشی را اجرا می کنید، اگر قبلاً اسکریپت را اجرا نکرده باشید، ممکن است از شما درخواست مجوز شود. توجه داشته باشید که مجوز دادن به یک اسکریپت در حین آزمایش، اسکریپت را خارج از آزمایش نیز مجاز می کند.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2024-12-22 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2024-12-22 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eApps Script allows developers to test editor add-ons directly within Google Docs, Sheets, Slides, or Forms to verify functionality and installation flow.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can create test deployments to specify add-on versions, authorization states, and associated documents for controlled testing environments.\u003c/p\u003e\n"],["\u003cp\u003eSaved test deployments can be executed repeatedly, enabling developers to iterate on their add-ons and observe changes in real-time within the test document.\u003c/p\u003e\n"],["\u003cp\u003eWhile offering valuable testing capabilities, test deployments have limitations such as not supporting installable triggers and shared property persistence across deployments using the same add-on and document.\u003c/p\u003e\n"],["\u003cp\u003eTest deployments provide a shareable URL for collaborative testing and may require authorization for the script, both within and outside the testing environment.\u003c/p\u003e\n"]]],["To test add-ons in development, create a test deployment linking a script version to a specific Google Docs, Sheets, Forms, or Slides file. Select the add-on's authorization state and save the test. Run saved tests by selecting them in the \"Test deployments\" dialog and clicking \"Execute.\" During testing, changes to the script can be viewed by refreshing the test document; the test document URL is shareable for collaboration. Any properties created are also persisted across multiple test deployments.\n"],null,["# Test an Editor add-on\n\nAdd-ons should be tested thoroughly prior to publishing to ensure they\nbehave as intended. Apps Script lets you test\n[Editor add-ons](/workspace/add-ons/concepts/types#editor_add-ons)\nin development on specific Google Docs Sheets, Forms, or Slides files. This\ncan be used to:\n\n- Verify that an add-on written in a standalone script functions as intended when applied to a sheet, doc, presentation, or form.\n- Verify that the add-on installation flow works as intended, particularly for different initial [authorization lifecycle states](/workspace/add-ons/concepts/editor-auth-lifecycle#the_complete_lifecycle) ([installed, enabled, or both](/workspace/add-ons/concepts/editor-auth-lifecycle#installed_versus_enabled)).\n- Verify that the add-on functions as intended when acting on a particular document and its contents.\n- Test and compare the current and previous versions of the add-on.\n\nCreate a test deployment\n------------------------\n\nA test deployment is the combination of an add-on and a test document.\nOnce you have a script version developed and would like to test it as an add-on,\nfollow these steps:\n\n1. If you don't have one already, create a spreadsheet, document, presentation, or form to test the add-on with.\n2. Open the script project containing your add-on.\n3. Click **Deploy** \\\u003e **Test deployments**.\n4. Next to **Select type** , click Enable deployment types settings and select **Editor add-on**.\n5. Click **Create new test** or **Add test**.\n6. Choose a code version or select **Latest Code**.\n7. In the **Config** section, select the initial [authorization state](/workspace/add-ons/concepts/editor-auth-lifecycle#installed_versus_enabled) for the test.\n8. Under **Test document** , click **No document selected** . Select the Sheets, Docs, Slides, or Forms file you want to use to test the add-on and click **Insert**.\n9. Click **Save test**.\n\nAll saved test deployments appear in the **Test deployments** dialog. This lets\nyou revisit the same test deployment later on.\n\nRun a test deployment\n---------------------\n\nIf you have one or more saved test deployments, you can run one of them by\nfollowing these steps:\n\n1. Open the script project containing your add-on.\n2. Click **Deploy** \\\u003e **Test deployments**.\n3. Under **Saved Tests** , select the radio button next to the saved test deployment you want to run and click **Execute**.\n\nThe test document opens in a new tab. The add-on is in the\n[authorization state](/workspace/add-ons/concepts/editor-auth-lifecycle#installed_versus_enabled)\nspecified in the test deployment. You can verify that the add-on functions as\nintended by interacting with its menu and UI elements.\n\n### Testing details\n\nThere are a number of things to keep in mind while testing Editor add-ons\nthis way:\n\n- [Installable triggers](/workspace/add-ons/concepts/editor-triggers#installable_triggers_in_add-ons) aren't supported when testing. Functionality that depends on installable triggers is not testable.\n- While running a test deployment that's set to test with the latest code, you can see changes saved to the add-on script by refreshing the test document.\n- The test document has a URL that you can share with editors of the original test document. This way, you can more easily collaborate with others while testing and developing.\n- If your add-on uses the [Properties service](/apps-script/reference/properties/properties-service), properties persist and remain available the next time the test deployment is run.\n- In addition, any test deployment that uses the same combination of add-on and test document has access to the same property information. For example, if you create two test deployments, the properties saved while running the first are available while running the second and vice versa, but only if the deployments use the same script and test document.\n- If you run a test deployment, you might be prompted for authorization if you have not run the script before. Be aware that authorizing a script while testing also authorizes the script outside of testing."]]
