افزونه های Google Workspace Apps Script را آزمایش و اشکال زدایی کنید

پس از انتشار یک افزونه، کاربران می‌توانند آن را از طریق برنامه میزبان یا Google Workspace Marketplace نصب کنند. قبل از انتشار، افزونه را در برنامه‌های میزبانی که آن را توسعه می‌دهد، آزمایش کنید.

این صفحه نحوه نصب افزونه‌ای که در حال توسعه است (افزونه‌ای منتشر نشده یا افزونه‌ای که توسط توسعه‌دهندگان نوشته شده است) را برای آزمایش یا استفاده شخصی شرح می‌دهد. همچنین می‌توانید افزونه را با استفاده از اشکال‌زدای Apps Script و نقاط توقف اشکال‌زدایی کنید.

پیش‌نیازها

  • شما باید به پروژه اسکریپت دسترسی ویرایشگر داشته باشید.
  • برای اینکه دیگران بتوانند افزونه را آزمایش کنند، به آنها دسترسی ویرایشگر به پروژه بدهید. به بخش همکاری با سایر توسعه‌دهندگان مراجعه کنید.
  • کاربران آزمایشی باید متعلق به همان دامنه‌ای باشند که مالک اسکریپت در آن قرار دارد.

نصب یک افزونه منتشر نشده

افزونه‌های منتشر نشده را از پنجره‌ی Deployments نصب کنید.

برای نصب یک افزونه منتشر نشده برای آزمایش، این مراحل را دنبال کنید:

  1. پروژه اسکریپت را در ویرایشگر Apps Script باز کنید.
  2. گزینه‌ی «استقرار» > «آزمایش استقرارها» را انتخاب کنید.
  3. نصب را انتخاب کنید.
  4. در پایین، «تمام» را انتخاب کنید.

برای اینکه سایر کاربران بتوانند افزونه را آزمایش کنند، پروژه را با حساب کاربری آنها به اشتراک بگذارید (دسترسی ویرایش لازم است). سپس، از کاربران بخواهید همین مراحل را دنبال کنند.

پس از نصب افزونه، بلافاصله در برنامه‌های میزبانی که آن را توسعه می‌دهد، در دسترس خواهد بود. ممکن است لازم باشد قبل از نمایش افزونه، تب برنامه میزبان را رفرش کنید. قبل از استفاده از افزونه، آن را تأیید کنید. اگر پروژه شما از قبل تأیید شده است، از ScriptApp.invalidateAuth برای ابطال مجوزهای موجود استفاده کنید. این به شما امکان می‌دهد ویژگی OAuth جزئی را آزمایش کنید.

یک افزونه منتشر نشده را حذف نصب کنید

برای حذف نصب افزونه‌ای که منتشر نشده است، مراحل زیر را دنبال کنید:

  1. پروژه اسکریپت را در ویرایشگر Apps Script باز کنید.
  2. گزینه‌ی «استقرار» > «آزمایش استقرارها» را انتخاب کنید.
  3. لغو نصب را انتخاب کنید.
  4. در پایین، «تمام» را انتخاب کنید.

این مراحل، استقرار را حذف می‌کنند و افزونه دیگر ظاهر نمی‌شود. می‌توانید در هر زمانی استقرار را دوباره نصب کنید.

بهترین شیوه‌های آزمایش

هنگام آزمایش افزونه، از بهترین شیوه‌ها پیروی کنید. همچنین موارد زیر را انجام دهید:

  1. جریان‌های ناوبری کارت را در تمام برنامه‌های میزبانی که افزونه آنها را توسعه می‌دهد، آزمایش کنید. رفتار کاربر را هنگام حرکت بین زمینه‌ها و بین کارت‌های غیرزمینه‌ای و زمینه‌ای بررسی کنید.

  2. از داده‌های آزمایشی نمونه برای ارزیابی رفتار افزونه خود استفاده کنید .

  3. اگر افزونه شما به یک API شخص ثالث متصل می‌شود، تأیید کنید که سرویس قابل دسترسی است. مطمئن شوید که افزونه، مجوزها و ورود به سیستم را به درستی مدیریت می‌کند.

  4. شرایط خطا را به طور مناسب مدیریت کنید. در صورت لزوم از کارت‌های خطا استفاده کنید .

  5. عملکرد افزونه را زیر نظر داشته باشید. اگر افزونه پس از تغییر کد کند شد، ممکن است لازم باشد آن ویژگی را دوباره تنظیم کنید.