حظر الإعلانات

تتوفّر عدة طرق للحصول على رمز الحظر، بالإضافة إلى عدة طرق لتحميله. بمجرد الحصول عليها.

إنشاء نص برمجي لحزمة

يوفر حظرًا نصًا برمجيًا يعمل على بدء تشغيل تطبيق المبتدئين، والذي يمكنك ثم تعديلها. تستخدم أدوات تطوير الويب الشائعة مثل webpack eslint، ولكنه لا يتضمن إطار عمل، مثل React أو Angular.

ويتطلب ذلك منك تثبيتNode.js وnpm قبل التشغيل الأوامر التالية.

لإنشاء تطبيق مكتوب بلغة JavaScript في دليل hello-world جديد:

npx @blockly/create-package app hello-world

لإنشاء تطبيق مكتوب بلغة TypeScript في دليل hello-world جديد:

npx @blockly/create-package app hello-world --typescript

يؤدي ذلك إلى إنشاء حزمة تستورد استهدافات الحزمة. كما تستخدم package.json لإدارة التبعيات، مما يجعل من السهل البقاء محدثًا مع أحدث إصدار من Blockly.

كما أنه يأتي مع بعض النصوص البرمجية المفيدة للمبتدئين، مثل نص لاختبار المشروع محليًا في المتصفح:

cd hello-world
npm run start

ويمكنك الرجوع إلى ملف package.json الذي تم إنشاؤه لتنفيذ أوامر أخرى.

Unpkg

إذا كنت تفرِط بأفكارك ولا تريد فيديو طويل يمكنك تحميل Blockly من unpkg باستخدام علامات البرنامج النصي.

إذا أضفت ما يلي إلى أي صفحة HTML، يمكنك فتح HTML مباشرةً في لتجربة استخدام Blockly:

<!-- Load Blockly core -->
<script src="https://unpkg.com/blockly/blockly_compressed.js"></script>
<!-- Load the default blocks -->
<script src="https://unpkg.com/blockly/blocks_compressed.js"></script>
<!-- Load a generator -->
<script src="https://unpkg.com/blockly/javascript_compressed.js"></script>
<!-- Load a message file -->
<script src="https://unpkg.com/blockly/msg/en.js"></script>

وهذا ليس حلاً جيدًا على المدى الطويل للاستحواذ على Blockly، لأنه لا والعمل مع برامج الحزم مثل webpack، لكنها جيدة لإنشاء نماذج أولية التجارب.

الحصول على الرمز‏

هناك عدة طرق يمكنك من خلالها الحصول على الرمز لتشغيل Blockly.

يوصي فريق Blockly بالمطالبة بـ Blockly من خلال مدير الحزم (مثل NPM أو Yarn) للأسباب التالية:

يمكنك الاطّلاع على آخر التغييرات بسهولة في Blockly
تشجع على استخدام مكونات إضافية بدلاً من monkeypatching Blockly

إدارة شبكة الشركاء (NPM)

npm install blockly --save

خيط الغزل

yarn add blockly

GitHub

يمكنك أيضًا تنزيل الرمز المضغوط من إصدارات GitHub. ومع ذلك، فإن هذا يتطلب منك تنزيل الرمز على فترات منتظمة للحصول على آخر التحديثات وإصلاحات في Blockly.

تحميل الرمز

بعد حصولك على الرمز، ستتمكن من الوصول إليه بعدة طرق من الرمز.

علامات النص البرمجي

<!-- Load Blockly core -->
<script src="./my-lib-directory/blockly/blockly_compressed.js"></script>
<!-- Load the default blocks -->
<script src="./my-lib-directory/blockly/blocks_compressed.js"></script>
<!-- Load a generator -->
<script src="./my-lib-directory/blockly/javascript_compressed.js"></script>
<!-- Load a message file -->
<script src="./my-lib-directory/blockly/msg/en.js"></script>

عند استخدام علامات النص البرمجي، يمكنك الوصول إلى عمليات الاستيراد من مساحة الاسم العامة:

// Access Blockly.
Blockly.thing;

// Access the default blocks.
Blockly.libraryBlocks['block_type'];

// Access the generator.
javascript.javascriptGenerator;

عمليات الاستيراد

// Import Blockly core.
import * as Blockly from 'blockly/core';
// Import the default blocks.
import * as libraryBlocks from 'blockly/blocks';
// Import a generator.
import {javascriptGenerator} from 'blockly/javascript';
// Import a message file.
import * as En from 'blockly/msg/en';

عند استيراد ملفات الرسائل، عليك أيضًا تطبيقها.

Blockly.setLocale(En);

يتطلب

// Require Blockly core.
const Blockly = require('blockly/core');
// Require the default blocks.
const libraryBlocks = require('blockly/blocks');
// Require a generator.
const {javascriptGenerator} =  require('blockly/javascript');
// Require a message file.
const En = require('blockly/msg/en');

عندما تحتاج إلى ملفات الرسائل، عليك أيضًا تطبيقها.

Blockly.setLocale(En);