প্লাগইন

একটি প্লাগইন হল একটি স্বয়ংসম্পূর্ণ কোড যা ব্লকলিতে কার্যকারিতা যোগ করে। উদাহরণস্বরূপ, এটি একটি কাস্টম ক্ষেত্র যোগ করতে পারে, একটি নতুন থিম সংজ্ঞায়িত করতে পারে বা একটি কাস্টম রেন্ডারার প্রদান করতে পারে। প্লাগইনগুলি সাধারণত প্যাকেজ করা হয় এবং npm এর মাধ্যমে বিতরণ করা হয়।

দ্রষ্টব্য: BlocklyOptions অবজেক্টে ক্লাস ইনজেকশনের জন্য একটি plugins বৈশিষ্ট্য রয়েছে যা ব্লকলি আচরণ কাস্টমাইজ করে । যদিও এই ক্লাসগুলি প্লাগইন হিসাবে প্রয়োগ করা যেতে পারে, এটির প্রয়োজন নেই এবং সেগুলি অন্যথায় সম্পর্কহীন।

প্লাগইনগুলির একটি দ্রুত পরিচিতির জন্য, আমাদের প্লাগইন ওভারভিউ টক (2021) দেখুন।

আপনি যদি নিজের প্লাগইন তৈরি করতে চান তবে একটি প্লাগইন যুক্ত করুন দেখুন।

প্রথম এবং তৃতীয় পক্ষের প্লাগইন

প্রথম পক্ষের প্লাগইনগুলি Blockly টিম দ্বারা সমর্থিত এবং npm-এ @blockly স্কোপের অধীনে প্রকাশিত। এগুলি ব্লকলি অ্যাপ্লিকেশনগুলির বিস্তৃত পরিসরে ব্যবহারযোগ্য হওয়ার জন্য ডিজাইন করা হয়েছে।

তৃতীয় পক্ষের প্লাগইন রক্ষণাবেক্ষণ করা হয় এবং স্বাধীনভাবে প্রকাশিত হয়। এগুলি আরও জটিল, আরও পরীক্ষামূলক, বা ব্লকলি অ্যাপ্লিকেশনগুলির একটি সংকীর্ণ পরিসরে লক্ষ্যবস্তু হতে পারে।

একটি প্লাগইন খুঁজুন

• Blockly Plugins & Demos এ যান, যেখানে প্রথম পক্ষের প্লাগইনগুলির লাইভ ডেমো রয়েছে।

• keyword:blockly-plugin । @blockly স্কোপ সহ প্লাগইনগুলি Blockly টিম দ্বারা প্রকাশিত হয়। বৃহত্তর ফলাফলের জন্য, keyword:blockly বা blockly ।

• GitHub-এ blockly-samples/plugins ডিরেক্টরি দেখুন, যা প্রথম পক্ষের প্লাগইনগুলির সংগ্রহস্থল। প্রতিটি প্লাগইনের একটি README থাকে যা এর আচরণ এবং উদ্দেশ্যমূলক ব্যবহার বর্ণনা করে।

একটি প্লাগইন ইনস্টল করুন

আমরা npm বা সুতার মতো প্যাকেজ ম্যানেজার দিয়ে প্লাগইন ইনস্টল করার পরামর্শ দিই। এটি আপডেটগুলি পেতে সহজ করে তোলে।

• প্যাকেজ ম্যানেজারের সাথে একটি প্লাগইন ইনস্টল করুন

  npm

  npm install @blockly/field-angle
  

  সুতা

  yarn add @blockly/field-angle
  

• প্যাকেজ ম্যানেজার ছাড়া একটি প্লাগইন ইনস্টল করুন

  আনপিকেজি

  <script src="https://unpkg.com/@blockly/field-angle"></script>
  

  এছাড়াও আপনি প্লাগইন ধারণকারী GitHub সংগ্রহস্থল ক্লোন করতে পারেন। প্রথম পক্ষের প্লাগইনগুলির জন্য, এটি blockly-samples ।

কোন অতিরিক্ত ইনস্টলেশন নির্দেশাবলী আছে কিনা দেখতে প্লাগইন এর README চেক করুন.

একটি প্লাগইন ব্যবহার করুন

প্রতিটি প্লাগইন আলাদা, তাই সেই প্লাগইনটি কীভাবে ব্যবহার করবেন সে সম্পর্কে তথ্যের জন্য প্লাগইনটির README দেখুন। নিম্নলিখিত উদাহরণ দেখায় কিভাবে @blockly/field-angle প্লাগইন ব্যবহার করতে হয়:

1. প্লাগইন থেকে কোড আমদানি করুন। আপনি কীভাবে এটি করবেন তা নির্ভর করে আপনি কীভাবে প্লাগইন ইনস্টল করেছেন তার উপর।

   npm বা সুতা

   import Blockly from 'blockly';
   import {registerFieldAngle} from '@blockly/field-angle';
   

   আনপিকেজি

   আপনি একটি import বিবৃতি ব্যবহার করতে হবে না.

   ক্লোন করা ভান্ডার

   import {registerFieldAngle} from 'path/to/plugin';
   

2. প্রয়োজন অনুযায়ী প্লাগইন শুরু করুন। কাস্টম ক্ষেত্রগুলি প্রদান করে এমন প্লাগইনগুলির জন্য আপনাকে প্রায়ই ক্ষেত্র নিবন্ধন করতে হবে:

   registerFieldAngle();
   

3. প্লাগইন ব্যবহার করুন.

   Blockly.common.defineBlocksWithJsonArray([
     {
       type: "my_angle_block",
       message0: "%1 degrees",
       args0: [
         {
           // Use @blockly/field-angle.
           type: "field_angle",
           name: "FIELDNAME",
           value: 45,
         },
       ],
       output: null,
       style: 'math_blocks'
     },
   ]);
   

   

প্লাগইন সংস্করণ

blockly-samples প্লাগইনগুলি শব্দার্থিক সংস্করণ ব্যবহার করে, যার জন্য একটি নতুন প্রধান সংস্করণ ব্যবহার করার জন্য ব্রেকিং পরিবর্তন প্রয়োজন। যেকোন নতুন প্লাগইন যা বানর প্যাচ কোরে 0 এর একটি বড় সংস্করণ থাকবে প্রাথমিক বিকাশকে বোঝাতে ।

বেশিরভাগ প্লাগইনে blockly প্যাকেজকে dependency পরিবর্তে peerDependency হিসেবে অন্তর্ভুক্ত করে। কারণ আমরা ধরে নিচ্ছি যে আপনি ইতিমধ্যেই ব্লকলি ইনস্টল করেছেন। (Blockly ব্যবহার না করে প্লাগইন ব্যবহার করার কোন মানে হয় না।) এটি আপনাকে Blockly সংস্করণটি নিজে পরিচালনা করতে দেয়, তবে আপনাকে Blockly এর ন্যূনতম সংস্করণ নির্ধারণ করতে প্লাগইন এর package.json চেক করতে হবে। ব্লকলির একটি নতুন সংস্করণের প্রয়োজনের জন্য একটি প্লাগইন আপডেট করা হলে, এটি একটি ব্রেকিং পরিবর্তন হিসাবে বিবেচিত হয় এবং এর প্রধান সংস্করণ বৃদ্ধি করা হবে।

আপনি যখন আপনার অ্যাপ্লিকেশনের package.json এ একটি প্লাগইন যোগ করেন, ডিফল্ট হল সংস্করণের আগে একটি ক্যারেট অন্তর্ভুক্ত করা:

"dependencies": {
  "@blockly/field-angle": "^5.0.12"
}

এটি npm-কে তালিকাভুক্ত সংস্করণে বা তার উপরে যেকোনো ছোট সংস্করণ ইনস্টল করতে দেবে, তাই সংস্করণ 5.0.20 বা 5.1.0 কাজ করে, কিন্তু একটি নতুন প্রধান সংস্করণ যেমন 6.0.1 তা করে না। আপনি যখন Blockly-এর একটি নতুন সংস্করণে আপডেট করেন, তখন আপনার প্লাগইনগুলির কোনো একটি নতুন বড় সংস্করণে আপডেট করা যায় কিনা তা পরীক্ষা করা ভাল।