clasp - অ্যাপস স্ক্রিপ্ট CLI

1. ভূমিকা

Apps Script CLI, বা clasp হল একটি টুল যা আপনাকে স্থানীয়ভাবে Apps স্ক্রিপ্ট প্রকল্পগুলি তৈরি, সম্পাদনা এবং স্থাপন করতে দেয়৷ এটি আপনাকে কমান্ড লাইন থেকে পত্রক, দস্তাবেজ, ফর্ম এবং স্লাইডের মতো পণ্যগুলির জন্য ওয়েব অ্যাপ্লিকেশন এবং অ্যাড-অনগুলি তৈরি এবং প্রকাশ করতে দেয়৷ script.google.com ব্যবহার করে বা আপনার কম্পিউটারে স্থানীয়ভাবে আপনি দুটি উপায়ে Apps স্ক্রিপ্ট বিকাশ করতে পারেন৷ আমরা পরবর্তীটি শিখব, কিভাবে ব্যবহার করতে হয় clasp , অ্যাপস স্ক্রিপ্টের কমান্ড লাইন টুল।

বৈশিষ্ট্য

  • স্থানীয়ভাবে বিকাশ করুন। clasp আপনাকে আপনার নিজের কম্পিউটারে কোড লিখতে এবং আপনার কাজ শেষ হয়ে গেলে অ্যাপস স্ক্রিপ্টে আপলোড করতে দেয়। আপনি বিদ্যমান Apps স্ক্রিপ্ট প্রকল্পগুলি ডাউনলোড করতে পারেন এবং তারপর স্থানীয়ভাবে সেগুলি সম্পাদনা করতে পারেন৷ কোডটি স্থানীয় হয়ে গেলে, আপনি অ্যাপস স্ক্রিপ্ট প্রকল্পগুলিতে কাজ করার জন্য গিট- এর মতো আপনার পছন্দের ডেভেলপমেন্ট টুল ব্যবহার করতে পারেন।
  • স্থাপনার সংস্করণ পরিচালনা করুন । আপনার প্রকল্পের একাধিক স্থাপনা তৈরি করুন, আপডেট করুন এবং দেখুন।
  • স্ট্রাকচার কোড। clasp স্বয়ংক্রিয়ভাবে script.google.com-এ আপনার ফ্ল্যাট প্রকল্পকে ফোল্ডারে রূপান্তর করে। যেমন:
# On script.google.com:
├── tests/slides.gs
└── tests/sheets.gs

# Locally:
├── tests/
│   ├─ slides.gs
│   └─ sheets.gs

আপনি কি শিখবেন

এই কোডল্যাব আপনাকে দেখাবে কিভাবে clasp দিয়ে 3টি মূল ক্রিয়াকলাপ করতে হয়:

  • কীভাবে নতুন অ্যাপস স্ক্রিপ্ট প্রকল্প তৈরি করবেন
  • বিদ্যমান প্রকল্পগুলি কীভাবে ক্লোন, টান এবং পুশ করবেন
  • আপনার স্ক্রিপ্টগুলির স্থাপনাগুলি কীভাবে পরিচালনা করবেন

2. শুরু করা

CLI ডাউনলোড করা হচ্ছে

Apps Script CLI ( clasp ) এর প্রয়োজন Node.js >= v6.0.0 ইনস্টল করা। এখানে Node.js ইনস্টল করুন

একবার আপনার কাছে নোড হয়ে গেলে, বিশ্বব্যাপী CLI ইনস্টল করুন (ওরফে clasp ):

npm i @google/clasp -g

3. লগইন করুন

লগইন করুন

এর আলিঙ্গন চেষ্টা করা যাক! আপনার মনে রাখা উচিত একমাত্র কমান্ড হল clasp .

clasp

আমরা কমান্ড লাইন টুল ব্যবহার শুরু করার আগে, আমাদের অবশ্যই লগ ইন করতে হবে। এই কমান্ডটি চালান:

clasp login

অথবা SSH ব্যবহার করলে:

clasp login --no-localhost

এই মুহুর্তে, আপনাকে Google-এ লগ ইন করতে বলা হবে। CLI এর সাথে আপনার তৈরি করা যেকোনো প্রকল্প এই Google অ্যাকাউন্টের সাথে যুক্ত।

4. একটি নতুন প্রকল্প তৈরি করুন

একটি স্বতন্ত্র প্রকল্প তৈরি করুন

নিম্নলিখিত কমান্ড দিয়ে একটি স্বতন্ত্র Google Apps স্ক্রিপ্ট প্রকল্প তৈরি করে শুরু করুন:

mkdir clasp_codelab;
cd clasp_codelab;
clasp create --title "Clasp Codelab"  --type standalone;

আপনি এইমাত্র "class_codelab" ফোল্ডারে একটি অ্যাপস স্ক্রিপ্ট প্রকল্প তৈরি করেছেন!

(ঐচ্ছিক বিকল্প) একটি বিদ্যমান প্রকল্প ক্লোন করুন

আসুন একটি Google স্লাইড অ্যাড-অনের জন্য একটি কন্টেইনার-বাউন্ড স্ক্রিপ্ট তৈরি করার চেষ্টা করি৷

এটি করতে, slides.google.com এ যান এবং একটি নতুন উপস্থাপনা তৈরি করুন৷ উপস্থাপনার নাম পরিবর্তন করে " ক্ল্যাপ কোডল্যাব টেস্ট " করুন। হেডারে, টুলের অধীনে, স্ক্রিপ্ট এডিটর টিপুন...।

এটি script.google.com এ আপনার Apps স্ক্রিপ্ট প্রকল্প খুলবে। একটি প্রকল্প ক্লোন করতে, আমাদের Script ID প্রয়োজন। আপনি /projects/ এর পরে Apps স্ক্রিপ্ট প্রকল্পের URL-এ এই আইডিটি খুঁজে পেতে পারেন। মানটি অনুলিপি করুন এবং নিম্নলিখিত কমান্ডে পেস্ট করুন:

clasp clone <scriptID>

আউটপুট এই মত হওয়া উচিত ...

4e3b128f4dcf6467.gif

এখন আপনি আপনার বর্তমান ডিরেক্টরিতে প্রকল্পটি ডাউনলোড করেছেন। Code.gs (একটি খালি ফাংশন) এর বিষয়বস্তু দেখতে আপনার প্রিয় সম্পাদক ব্যবহার করুন।

5. ফাইল টানানো এবং পুশ করা

script.google.com-এ কোড সম্পাদনা করুন

এখন যেহেতু আপনি একটি প্রজেক্ট ক্লোন করতে সক্ষম হয়েছেন, আসুন শিখি কিভাবে ফাইল টানতে হয় এবং পুশ করতে হয়। আমরা আপনাকে script.google.com এর মাধ্যমে ক্লাউডে সম্পাদনা করতে এবং স্থানীয়ভাবে আপনার কম্পিউটারে টেনে নিয়ে যাওয়ার পদক্ষেপগুলি নিয়ে যাব৷ আসুন ক্লাউডে স্ক্রিপ্টটি খুলি:

clasp open

এখন যেহেতু আমরা অনলাইন এডিটরে আছি, আমরা অনলাইনে কিছু কোড সম্পাদনা করব যা আমরা পরে clasp ব্যবহার করে আনব।

একটি নতুন Apps স্ক্রিপ্ট ফাইল তৈরি করতে, ফাইলের পাশে সম্পাদকের বামে, একটি ফাইল যুক্ত করুন ক্লিক করুন একটি ফাইল যোগ করুন > স্ক্রিপ্টutils/strings নাম লিখুন। সদ্য তৈরি করা ফাইলে, utils/strings.gs , নিম্নলিখিতগুলির সাথে কোডটি প্রতিস্থাপন করুন:

var world = "世界";

Code.gs এ, বিদ্যমান কোডটিকে নিম্নলিখিত দিয়ে প্রতিস্থাপন করুন:

function hello() {
  Logger.log("Hello, " + world);
}

উপরে, সংরক্ষণ ক্লিক করুন সংরক্ষণ .

ফাংশনটি চালানোর জন্য, সম্পাদকের শীর্ষে, ফাংশন ড্রপডাউন তালিকা থেকে hello নির্বাচন করুন এবং রান এ ক্লিক করুন।

এক্সিকিউশন লগের নীচে অভিবাদনটি প্রদর্শিত হবে।

স্থানীয়ভাবে কোড সম্পাদনা করুন

আসুন কমান্ড লাইনে ফিরে যাই যেখানে আমরা শেষ প্রকল্পটি ক্লোন করেছি। আপনি লক্ষ্য করতে পারেন যে আমাদের কোড এখন অনলাইন সম্পাদকের সাথে সিঙ্কের বাইরে। এটি ঠিক করতে, আসুন আমাদের অনলাইন প্রকল্প থেকে কোড টানুন।

clasp pull

এখন কোডে ফিরে যান। আপনার লক্ষ্য করা উচিত যে আমাদের ইউটিলসের জন্য একটি ফোল্ডার রয়েছে। clasp CLI স্বয়ংক্রিয়ভাবে স্থানীয় ফাইল সিস্টেমে স্ল্যাশ অক্ষর / ফোল্ডারে রূপান্তর করে।

আপনার প্রিয় টেক্সট এডিটরে, util/strings.gs এ নেভিগেট করুন এবং ভেরিয়েবল নামের world mondo প্রতিস্থাপন করুন। এছাড়াও, world mondo প্রতিস্থাপন করে Code.gs আপডেট করুন। script.google.com এ আপডেট করা কোড আপডেট করতে, আপনার সম্পাদিত কোডটি চাপুন।

clasp push

আর এটাই! আপনার কোড এখন script.google.com এ আপডেট করা হয়েছে।

6. সংস্করণ এবং স্থাপনা

clasp আপনাকে সংস্করণ এবং স্থাপনা পরিচালনা করতে দেয়। প্রথমত, কিছু শব্দভাণ্ডার:

  • সংস্করণ : একটি স্ক্রিপ্ট প্রকল্পের একটি "স্ন্যাপশট"। একটি সংস্করণ স্থাপনার জন্য ব্যবহৃত শুধুমাত্র-পঠন শাখা হিসাবে বিবেচনা করা যেতে পারে।
  • স্থাপনা : একটি স্ক্রিপ্ট প্রকল্পের একটি প্রকাশিত প্রকাশ (প্রায়শই একটি অ্যাড-অন বা ওয়েব অ্যাপ হিসাবে)। একটি সংস্করণ নম্বর প্রয়োজন.

আসুন আমাদের স্ক্রিপ্টের একটি সংস্করণ তৈরি করি:

clasp version "First version"

লগ করা সংস্করণ স্ট্রিং ব্যবহার করে আমরা [version] এর জায়গায় তৈরি করেছি, আমরা স্ক্রিপ্টটি স্থাপন করতে পারি:

clasp deploy 1 "First deployment"

clasp deploy কমান্ড আপনার ম্যানিফেস্ট দেখে এবং একটি নতুন সংস্করণের স্থাপনা তৈরি করে। আপনার কোড এখন একটি এক্সিকিউটেবল হিসাবে স্থাপন করা হয়েছে। ডিপ্লয়মেন্ট গাইডে এই সম্পর্কে আরও জানুন।

7. এটাই!

আমরা আশা করি Apps Script CLI হল একটি সহজ টুল যা আপনাকে Apps স্ক্রিপ্ট প্রকল্পগুলি পরিচালনা করতে সাহায্য করবে।

আমরা কভার করেছি কি

  • কীভাবে নতুন অ্যাপস স্ক্রিপ্ট প্রকল্প তৈরি করবেন
  • বিদ্যমান প্রকল্পগুলিকে কীভাবে ক্লোন, পুশ এবং টানতে হয়
  • আপনার স্ক্রিপ্টগুলির স্থাপনাগুলি কীভাবে পরিচালনা করবেন

Clasp GitHub এ উপলব্ধ এবং নতুন বৈশিষ্ট্য এবং প্যাচগুলিতে স্বাগত জানাই৷

আপনি কি তৈরি করেন তা দেখার জন্য আমরা অপেক্ষা করতে পারি না!