افزونه‌ها باید قبل از انتشار به‌طور کامل آزمایش شوند تا اطمینان حاصل شود که مطابق خواسته‌ها رفتار می‌کنند. Apps Script به شما امکان می‌دهد افزونه‌های ویرایشگر را در حال توسعه در برگه‌ها، فرم‌ها، یا فایل‌های اسلایدهای Google Docs خاص آزمایش کنید. از این می توان برای موارد زیر استفاده کرد:
- بررسی کنید که افزونه ای که در یک اسکریپت مستقل نوشته شده است، هنگام اعمال بر روی یک برگه، سند، ارائه یا فرم همانطور که در نظر گرفته شده است عمل می کند.
- بررسی کنید که جریان نصب افزونه همانطور که در نظر گرفته شده است، به ویژه برای حالت های مختلف چرخه حیات مجوز اولیه ( نصب شده، فعال یا هر دو ) کار می کند.
- بررسی کنید که هنگام کار بر روی یک سند خاص و محتویات آن، افزونه همانطور که در نظر گرفته شده است عمل کند.
- نسخه فعلی و قبلی افزونه را تست و مقایسه کنید.
یک استقرار آزمایشی ایجاد کنید
استقرار آزمایشی ترکیبی از یک افزونه و یک سند آزمایشی است. هنگامی که یک نسخه اسکریپت را توسعه دادید و می خواهید آن را به عنوان یک افزونه آزمایش کنید، مراحل زیر را دنبال کنید:
- اگر قبلاً ندارید، یک صفحه گسترده، سند، ارائه یا فرم ایجاد کنید تا افزونه را با آن آزمایش کنید.
- پروژه اسکریپت حاوی افزونه خود را باز کنید.
- روی Deploy > Test Deployments کلیک کنید.
- در کنار انتخاب نوع ، روی فعال کردن انواع استقرار کلیک کنید و افزودنی ویرایشگر را انتخاب کنید.
- روی ایجاد آزمایش جدید یا افزودن آزمایش کلیک کنید.
- یک نسخه کد را انتخاب کنید یا آخرین کد را انتخاب کنید.
- در قسمت Config ، وضعیت مجوز اولیه را برای آزمایش انتخاب کنید.
- در بخش آزمایش سند ، روی هیچ سندی انتخاب نشده است . فایل Sheets، Docs، Slides یا Forms را که می‌خواهید برای آزمایش افزونه استفاده کنید انتخاب کنید و روی Insert کلیک کنید.
- روی ذخیره تست کلیک کنید.
همه استقرارهای آزمایشی ذخیره شده در گفتگوی استقرارهای آزمایشی ظاهر می شوند. این به شما امکان می دهد بعداً همان استقرار آزمایشی را مجدداً مشاهده کنید.
یک استقرار آزمایشی را اجرا کنید
اگر یک یا چند برنامه آزمایشی ذخیره شده دارید، می توانید یکی از آنها را با دنبال کردن مراحل زیر اجرا کنید:
- پروژه اسکریپت حاوی افزونه خود را باز کنید.
- روی Deploy > Test Deployments کلیک کنید.
- در بخش تست‌های ذخیره شده ، دکمه رادیویی را در کنار برنامه آزمایشی ذخیره‌شده‌ای که می‌خواهید اجرا کنید انتخاب کنید و روی Execute کلیک کنید.
سند آزمایشی در یک برگه جدید باز می شود. افزونه در وضعیت مجوز مشخص شده در استقرار آزمایشی است. می‌توانید با تعامل با منو و عناصر UI، بررسی کنید که عملکرد افزونه همانطور که در نظر گرفته شده است.
جزئیات تست
هنگام آزمایش افزونه های ویرایشگر به این روش، باید به چند نکته توجه داشت:
- راه‌اندازهای قابل نصب هنگام آزمایش پشتیبانی نمی‌شوند. عملکردی که به تریگرهای قابل نصب بستگی دارد قابل آزمایش نیست.
- هنگام اجرای یک استقرار آزمایشی که برای آزمایش با آخرین کد تنظیم شده است، می‌توانید تغییرات ذخیره شده در اسکریپت افزودنی را با بازخوانی سند آزمایشی مشاهده کنید.
- سند آزمایشی دارای یک URL است که می توانید آن را با ویرایشگران سند آزمایشی اصلی به اشتراک بگذارید. به این ترتیب، هنگام آزمایش و توسعه، راحت‌تر می‌توانید با دیگران همکاری کنید.
- اگر افزونه شما از سرویس Properties استفاده می‌کند، ویژگی‌ها باقی می‌مانند و دفعه بعد که استقرار آزمایشی اجرا می‌شود در دسترس باقی می‌مانند.
- بعلاوه، هر برنامه آزمایشی که از ترکیب یکسانی از افزونه و سند آزمایشی استفاده می‌کند، به اطلاعات ویژگی یکسانی دسترسی دارد. به عنوان مثال، اگر دو استقرار آزمایشی ایجاد کنید، ویژگی‌های ذخیره شده در حین اجرای اولی در حین اجرای دومی و بالعکس در دسترس هستند، اما تنها در صورتی که استقرارها از یک اسکریپت و سند آزمایشی استفاده کنند.
- اگر یک استقرار آزمایشی را اجرا می کنید، اگر قبلاً اسکریپت را اجرا نکرده باشید، ممکن است از شما درخواست مجوز شود. توجه داشته باشید که مجوز دادن به یک اسکریپت در حین آزمایش، اسکریپت را خارج از آزمایش نیز مجاز می کند.