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

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

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

يوفر بشكل أساسي نصًا برمجيًا يشغّل تطبيقًا أوّليًا، ويمكنك تعديله بعد ذلك. وهو يستخدم أدوات شائعة لتطوير الويب مثل 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 مباشرةً في متصفّح لتجربة استخدام حظر:

<!-- 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>

هذا ليس حلاً جيدًا طويل المدى لاقتناء Bluely، لأنه لا يعمل مع أدوات الحزم مثل Webpack، ولكنه مفيد للنماذج الأولية والتجريب.

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

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

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

  • من الأسهل الاطّلاع على آخر الأخبار من خلال التغييرات في تطبيق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);