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