مشارکت در نمونه ها

Blockly Samples حاوی محتوای اضافی مرتبط با Blockly است که بخشی از مخزن اصلی نیست، از جمله پلاگین ها، کدها، و کد نمونه. برای جزئیات بیشتر در مورد هر یک از اینها، صفحه ساختار مخزن را ببینید.

نیاز به دانستن

در اینجا مروری سریع از حقایق مربوط به نمونه های بلوکی است که برای ایجاد روابط عمومی باید بدانید.

  • شاخه کاری استاد است و همه روابط عمومی ها باید در مقابل استاد انجام شود.
  • npm install در سطح root نمونه های بلوکی اجرا کنید، نه در سطح پلاگین فردی. Blockly-samples یک monorepo است، به این معنی که شامل چندین بسته در یک مخزن است و نصب در سطح root بخشی از گردش کار برای مدیریت monorepo با لرنا است.
  • بسته به زبان مورد استفاده، کد باید با راهنمای سبک جاوا اسکریپت گوگل یا راهنمای سبک تایپ اسکریپت مطابقت داشته باشد.
  • از commit های معمولی در پیام های commit خود استفاده کنید و عناوین درخواست را بکشید.

  • هر فایل کد جدید باید با مجوز Apache v2.0 پیشوند شود:

    /**
 *   @license
 *   Copyright <Current YYYY> Google LLC
 *   SPDX-License-Identifier: Apache-2.0
 */

ایجاد و تأیید تغییر

  1. برای نصب وابستگی ها npm install در سطح ریشه نمونه های بلوکی اجرا کنید.
  2. npm run start در دایرکتوری افزونه اجرا کنید تا سروری را که صفحه آزمایشی افزونه را اجرا می کند ساخته و راه اندازی کنید. می‌توانید از این صفحه برای مشاهده رفتار موجود یک افزونه استفاده کنید، یا اگر یک افزونه جدید اضافه می‌کنید، باید این صفحه را به یک صفحه آزمایشی مفید تبدیل کنید تا دیگران بتوانند کارهای افزونه شما را ببینند. برای اطلاعات بیشتر به صفحه زمین بازی مراجعه کنید.
  3. هر گونه تغییر لازم را در کد افزونه انجام دهید.
  4. اگر سرور را در حال اجرا رها کرده باشید، تغییرات شما به طور خودکار بارگیری می شود. در غیر این صورت، سرور را مجددا راه اندازی کنید و بررسی کنید که افزونه مطابق انتظار عمل می کند و هیچ خطایی یا هشداری در کنسول وجود ندارد.
  5. npm run build اجرا کنید و مطمئن شوید که خطای ساخت وجود ندارد.
  6. تست‌های موکای خودکار را در فهرست راهنمای test/ بنویسید.
  7. npm run test برای اجرای تست های خودکار اجرا کنید.
  8. اجرای npm run lint:fix برای رفع خطاهای lint. هرگونه هشدار یا خطای باقی مانده را برطرف کنید.
  9. npm run format برای اجرای خودکار فرمت اجرا کنید.
  10. اگر همه تست ها قبول شوند، شما آماده هستید تا با تغییرات خود، یک روابط عمومی در برابر استاد باز کنید.