به هسته کمک کنید

مخزن هسته Blockly حاوی کدی است که برای اجرای هر برنامه مبتنی بر Blockly لازم است.

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

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

  • شاخه کار در حال توسعه است و همه روابط عمومی ها باید در مقابل توسعه باشد.
  • شما باید الگوی درخواست کشش را با اطلاعات درخواستی پر کنید.
  • کد باید با راهنمای سبک TypeScript Google مطابقت داشته باشد.
  • از commit های معمولی در پیام های commit خود استفاده کنید و عناوین درخواست را بکشید.
  • رشته های قابل مشاهده توسط کاربر باید در فایل /msg/messages.js باشد تا بتوان آنها را ترجمه کرد. کمتر از 6 درصد از مردم جهان به صورت بومی انگلیسی صحبت می کنند.
  • متن روی بلوک ها عموما باید با حروف کوچک باشد (دقیقاً مانند کلمات کلیدی در اکثر زبان های برنامه نویسی).
  • سازگاری با عقب را حفظ کنید. برنامه های Blockly زیادی وجود دارد، دیگران را خراب نکنید.

  • هر فایل کد جدید باید با مجوز 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. تست های خودکار را بنویسید. معمولاً، اینها تست‌های موکا در دایرکتوری tests/mocha هستند، اما ممکن است از شما انواع دیگر تست‌ها را بخواهیم.
  7. npm run format اجرا کنید تا کد را فرمت کنید و به طور خودکار برخی از مشکلات پرز را برطرف کنید.
  8. npm test برای اجرای تست های خودکار اجرا کنید. این eslint نیز اجرا می کند.
  9. اگر خطاهای پرز وجود دارد، npm run lint:fix اجرا کنید تا مشکلاتی که قابل رفع خودکار هستند را برطرف کنید. هرگونه هشدار یا خطای باقیمانده پرز را برطرف کنید.
  10. اگر همه آزمون ها قبول شوند، شما آماده هستید تا با تغییرات خود یک روابط عمومی در برابر توسعه باز کنید.