وقتی افزونه‌ای منتشر می‌کنید، کاربران می‌توانند آن را از طریق برنامه میزبان یا Google Workspace Marketplace نصب کنند. قبل از انتشار، افزونه‌هایی را که توسعه می‌دهید در برنامه‌های میزبانی که آنها را توسعه می‌دهند، آزمایش کنید.
این صفحه نحوه نصب افزونه‌ای که در حال توسعه است (که افزونه منتشر نشده یا افزونه توسعه‌دهنده نامیده می‌شود) را برای آزمایش یا استفاده شخصی شرح می‌دهد. همچنین می‌توانید افزونه‌ها را با استفاده از اشکال‌زدا و نقاط توقف Apps Script IDE اشکال‌زدایی کنید.
پیش‌نیازها
- شما باید به پروژه اسکریپت افزونه دسترسی ویرایشگر داشته باشید.
- برای اینکه به سایر افراد سازمان خود اجازه دهید افزونه را آزمایش کنند، به آنها دسترسی ویرایشگر به پروژه اسکریپت بدهید. برای جزئیات بیشتر در مورد اعطای دسترسی، به همکاری با سایر توسعه‌دهندگان مراجعه کنید.
نصب یک افزونه منتشر نشده
شما می‌توانید افزونه‌های منتشر نشده را از طریق پنجره‌ی Deployments در Apps Script نصب کنید.
برای نصب افزونه‌ی منتشرنشده‌ی Google Workspace جهت آزمایش، این مراحل را دنبال کنید:
- پروژه اسکریپت را در ویرایشگر Apps Script باز کنید.
- روی استقرار > آزمایش استقرارها کلیک کنید.
- روی نصب کلیک کنید.
- در پایین، روی «تمام» کلیک کنید.
شما می‌توانید با اشتراک‌گذاری پروژه Apps Script با حساب کاربری سایر کاربران، به آنها اجازه دهید افزونه را آزمایش کنند (دسترسی ویرایش لازم است). سپس از کاربران بخواهید مراحل بالا را دنبال کنند.
پس از نصب، افزونه بلافاصله در برنامه‌های میزبانی که از آن پشتیبانی می‌کند، در دسترس قرار می‌گیرد. ممکن است لازم باشد قبل از نمایش افزونه، تب برنامه میزبان را رفرش کنید. همچنین قبل از استفاده از افزونه، باید آن را تأیید کنید . اگر پروژه شما از قبل تأیید شده است، از ScriptApp.invalidateAuth برای ابطال مجوزهای موجود استفاده کنید تا بتوانید ویژگی OAuth جزئی را روی افزونه خود آزمایش کنید.
یک افزونه منتشر نشده را حذف نصب کنید
برای حذف نصب افزونه منتشر نشده، این مراحل را دنبال کنید:
- پروژه اسکریپت را در ویرایشگر Apps Script باز کنید.
- روی استقرار > آزمایش استقرارها کلیک کنید.
- روی لغو نصب کلیک کنید.
- در پایین، روی «تمام» کلیک کنید.
این مراحل بلافاصله نصب را حذف می‌کنند و افزونه دیگر در هیچ برنامه میزبانی ظاهر نمی‌شود. می‌توانید در هر زمان با تکرار مراحل نصب، نصب را دوباره نصب کنید.
آزمایش بهترین شیوه‌ها
هنگام آزمایش افزونه‌ی Google Workspace خود، حتماً از « بهترین شیوه‌ها برای توسعه‌ی افزونه» پیروی کنید. علاوه بر این، حتماً موارد زیر را انجام دهید:
پیمایش کارت آزمایشی به طور کامل در تمام برنامه‌های میزبانی که افزونه آنها را توسعه می‌دهد، جریان دارد. مطمئن شوید که رفتار افزونه هنگام حرکت کاربر از یک زمینه به زمینه دیگر و بین کارت‌های غیرزمینه‌ای و زمینه‌ای صحیح است.
از داده‌های آزمایشی نمونه برای ارزیابی رفتار افزونه خود استفاده کنید .
اگر افزونه شما به یک API شخص ثالث یا سرویس دیگری متصل می‌شود، تأیید کنید که سرویس قابل دسترسی است و طبق انتظار عمل می‌کند. مطمئن شوید که افزونه شما به درستی جزئیات مجوز و ورود را مدیریت می‌کند.
مطمئن شوید که هرگونه شرایط خطا به درستی مدیریت می‌شود. در صورت لزوم از کارت‌های خطا استفاده کنید .
به عملکرد افزونه توجه کنید. اگر تغییری در کد ایجاد کردید و افزونه شروع به کند شدن کرد، ممکن است لازم باشد آن ویژگی را حذف یا دوباره روی آن کار کنید.