قبل از ساخت افزونه ویرایشگر خود، سهمیهها و محدودیتهای Apps Script را بررسی کنید تا مطمئن شوید طراحی پروژه شما با این دستورالعملها همسو است. آشنایی با این محدودیتها در اوایل فرآیند توسعه میتواند به جلوگیری از مشکلات احتمالی بعدی کمک کند. Apps Script برای توسعه افزونههای سبک برای خودتان، تیمتان یا سازمانتان ایدهآل است. با این حال، اگر پیشبینی میکنید که یک افزونه در مقیاس بزرگ بسازید که نیاز به مدیریت کاربران زیادی دارد، به تأخیر کم نیاز دارد یا کنترل کامل بر زیرساخت شما را میطلبد، توسعه یک افزونه Google Workspace را در یک محیط زمان اجرای متفاوت در نظر بگیرید.
هنگام ساخت افزونهی ویرایشگر، این روال کلی را دنبال کنید:
- یک پروژه Apps Script ایجاد کنید.
- با استفاده از سرویس HTML داخلی Apps Script، کدی بنویسید که ظاهر و رفتار افزونه را تعریف کند.
- افزونه را تست کنید.
- افزونه را منتشر کنید.
ایجاد یک پروژه اسکریپت
افزونهی ویرایشگر، یک پروژهی مستقل اسکریپت برنامهها است. راهنمای اسکریپت مستقل، دستورالعملهایی برای ایجاد پروژههای جدید ارائه میدهد. همچنین میتوانید یک اسکریپت جدید را باز کنید . اگر این کار را انجام دهید، فایل پروژه (که در ابتدا Untitled project نام دارد) در پوشهی اصلی درایو شما قرار میگیرد.
همکاری
وقتی با دیگران در توسعه یک افزونه همکاری میکنید، یک حساب کاربری واحد مالک پروژه افزونه است. وقتی یک افزونه را منتشر میکنید، یک حساب کاربری واحد به عنوان ناشر عمل میکند. حساب ناشر باید دسترسی ویرایش به پروژه اسکریپت افزونه را داشته باشد، اما نیازی نیست که مالک پروژه باشد.
بسیار مهم است که از موقعیتهایی که به دلیل ترک سازمان توسط مالک پروژه، دسترسی به کد یا تنظیمات افزونه را از دست میدهید، اجتناب کنید.
برای جلوگیری از از دست دادن دسترسی به کد افزونه، توصیه میکنیم هنگام همکاری روی یک افزونه از درایوهای مشترک استفاده کنید. قرار دادن فایل اسکریپت افزونه در یک درایو مشترک تضمین میکند که هیچ حساب کاربری واحدی مالک انحصاری پروژه نیست.
همچنین توصیه میشود که همکارانی را به پروژه پلتفرم ابری (GCP) پروژه اسکریپت اضافه کنید . این کار به شما کمک میکند تا مطمئن شوید که یکی از اعضای تیم شما همیشه میتواند به تنظیمات ابری افزونه دسترسی داشته باشد.
افزونه را کدنویسی کنید
پس از ایجاد یک پروژه اسکریپت، میتوانید شروع به نوشتن کد برای تعریف ظاهر و رفتار افزونه کنید. شما از Apps Script HtmlService برای ساخت رابط کاربری افزونه - دیالوگها و نوارهای کناری - با استفاده از HTML و CSS معمولی استفاده میکنید. افزونههای ویرایشگر میتوانند آیتمهای منوی سفارشی را نیز تعریف کنند.
هنگام کدنویسی، برای راهنمایی در مورد نحوه طراحی تجربه کاربری افزونه خود، به راهنمای سبک افزونه ویرایشگر مراجعه کنید. همچنین، مطمئن شوید که حالتهای مختلف چرخه عمر مجوز که افزونه شما ممکن است با آنها مواجه شود را درک کرده و برای آنها برنامهریزی میکنید.
افزونه را تست کنید
شما میتوانید افزونههای ویرایشگر را قبل از انتشار آزمایش کنید تا مطمئن شوید که مطابق انتظار عمل میکنند. آزمایش مستلزم ایجاد یک پیکربندی آزمایشی و استفاده از یک سند، صفحه گسترده، فرم یا ارائه آزمایشی است.
برای جزئیات بیشتر ، افزونهی «آزمایش یک ویرایشگر» را ببینید.
افزونه را منتشر کنید
انتشار افزونه، آن را در دسترس دیگران، چه به صورت عمومی و چه فقط کاربران دامنه شما، قرار میدهد. قبل از شروع فرآیند انتشار، حتماً نمای کلی انتشار را بررسی کنید.
افزونههای ویرایشگر در بازار Google Workspace منتشر میشوند. افزونههای در دسترس عموم باید قبل از انتشار، بررسی افزونه را تکمیل کنند.
برای جزئیات بیشتر ، به انتشار افزونهی ویرایشگر مراجعه کنید.