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