কমান্ড লাইন থেকে Lightbuild প্রোজেক্ট তৈরি করা

Lightbuild CLI হল Lightbuild-এর অফিসিয়াল কমান্ড-লাইন টুল। আপনার প্রোজেক্ট তৈরি ও পরীক্ষা করতে, এর বিল্ড টার্গেট খুঁজে পেতে এবং এর ডিপেন্ডেন্সি সমাধান করতে lightbuild কমান্ড ব্যবহার করে। আপনার AI এজেন্ট একই কমান্ড রান করতে পারে। Lightbuild টেমপ্লেট থেকে তৈরি করা প্রোজেক্টে একটি AGENTS.md ফাইল থাকে যা AI এজেন্টকে বলে দেয় যে Lightbuild এবং Lightbuild CLI-এর সাথে কীভাবে কাজ করতে হবে।

Lightbuild CLI-এর কমান্ড ও বিকল্প সম্পর্কে আরও জানতে, Lightbuild CLI রেফারেন্স দেখুন।

Lightbuild CLI ইনস্টল করুন

Lightbuild CLI, Android SDK প্যাকেজ হিসেবে ডিস্ট্রিবিউট করা হয় যা আপনি Android CLI-এর সাথে ইনস্টল করেন। আপনি একটি কমান্ডের সাহায্যে এটি ইনস্টল ও সেট-আপ করতে পারেন অথবা ম্যানুয়ালি ইনস্টল করতে পারেন।

এক ধাপে ইনস্টল ও সেট-আপ করুন

Lightbuild CLI ইনস্টল করতে, আপনার অপারেটিং সিস্টেমের জন্য কমান্ড রান করুন। কমান্ডটি আপনার Android SDK-তে Lightbuild CLI প্যাকেজ ইনস্টল করে এবং তারপরে প্যাকেজের সেটআপ স্ক্রিপ্ট রান করে, যা macOS এবং Linux-এ ~/.local/bin-এ বা Windows-এ $HOME\AppData\LightbuildCLI-এ Lightbuild CLI কপি করে এবং নিশ্চিত করে যে ডিরেক্টরিটি আপনার PATH-এ আছে:

  • macOS ও Linux:

    android sdk install build/lightbuild/0.0.30 && bash "$(android info sdk)/build/lightbuild/0.0.30/cli/install.sh"

  • Windows (PowerShell):

    android sdk install build/lightbuild/0.0.30; if ($LASTEXITCODE -eq 0) { & "$(android info sdk)\build\lightbuild\0.0.30\cli\install.cmd" }; if ($LASTEXITCODE -eq 0) { $env:Path += ";$HOME\AppData\LightbuildCLI"; setx LIGHTBUILD_REFRESH 1 | Out-Null; reg delete HKCU\Environment /v LIGHTBUILD_REFRESH /f | Out-Null }

  • Windows (কমান্ড প্রম্পট):

    android sdk install build/lightbuild/0.0.30 && for /f "delims=" %p in ('android info sdk') do call "%p\build\lightbuild\0.0.30\cli\install.cmd" && setx LIGHTBUILD_REFRESH 1 >nul && reg delete HKCU\Environment /v LIGHTBUILD_REFRESH /f >nul

কমান্ড শেষ হওয়ার পরে, ইনস্টলেশন যাচাই করুন।

ম্যানুয়ালি ইনস্টল করুন

অন্যথায়, Lightbuild CLI ইনস্টল করতে এবং আপনার PATH-এ এটি যোগ করতে, এইসব ধাপ অনুসরণ করুন:

  1. আপনার কাছে Android CLI না থাকলে, এটি ইনস্টল করুন।

  2. Lightbuild প্যাকেজ ইনস্টল করুন:

    android sdk install build/lightbuild/0.0.30

  3. আপনার PATH-এর একটি ডিরেক্টরিতে Lightbuild CLI কপি করুন, যাতে আপনি যেকোনও ডিরেক্টরি থেকে lightbuild চালাতে পারেন। আপনি এটি এমন যেকোনও ডিরেক্টরিতে কপি করতে পারেন যা আগে থেকেই আপনার PATH-এ আছে অথবা সেটআপ স্ক্রিপ্ট যে ডিরেক্টরি ব্যবহার করে সেটিই ব্যবহার করতে পারেন:

    • macOS এবং Linux: lightbuild ফাইলটি ~/.local/bin-এ কপি করুন:

      mkdir -p ~/.local/bin
cp "$(android info sdk)/build/lightbuild/0.0.30/cli/lightbuild" ~/.local/bin/

      ~/.local/bin আপনার PATH-এ না থাকলে, আপনার শেলের স্টার্টআপ ফাইলে নিম্নলিখিত লাইন যোগ করুন, যেমন ~/.zshrc বা ~/.bashrc:

      export PATH="$PATH:$HOME/.local/bin"

    • Windows: PowerShell-এ নিম্নলিখিত কমান্ড রান করুন। তারা lightbuild.exe থেকে $HOME\AppData\LightbuildCLI কপি করে, আপনার ব্যবহারকারী Path-এ সেই ডিরেক্টরি যোগ করে, যদি এটি আগে থেকে না থাকে এবং তারপরে আপনার বর্তমান সেশনে এবং পরে খোলা টার্মিনালে পরিবর্তনটি কার্যকর করে:

      $dir = "$HOME\AppData\LightbuildCLI"
New-Item -ItemType Directory -Force $dir | Out-Null
Copy-Item "$(android info sdk)\build\lightbuild\0.0.30\cli\lightbuild.exe" $dir
$userPath = (Get-ItemProperty HKCU:\Environment).Path
if (($userPath -split ";") -notcontains $dir) { Set-ItemProperty HKCU:\Environment Path "$userPath;$dir" -Type ExpandString }
setx LIGHTBUILD_REFRESH 1 | Out-Null; reg delete HKCU\Environment /v LIGHTBUILD_REFRESH /f | Out-Null
$env:Path += ";$dir"

  4. ইনস্টলেশন যাচাই করা

ইনস্টলেশন যাচাই করুন

Lightbuild CLI ইনস্টল করা আছে কিনা তা যাচাই করতে, এর ভার্সন চেক করুন:

lightbuild --version

আপনার টার্মিনাল lightbuild কমান্ড খুঁজে না পেলে, নতুন টার্মিনাল উইন্ডো খুলুন যাতে আপনার PATH পরিবর্তন কার্যকর হয়।

আপনার প্রোজেক্টের বিল্ড টার্গেট খুঁজুন

Lightbuild CLI কমান্ড একটি টার্গেট নেয়, যা আপনার প্রোজেক্টের সেই অংশকে শনাক্ত করে যেটি বিল্ড, টেস্ট বা পরীক্ষা করতে হবে। টার্গেট কোনও মডিউলের নাম হতে পারে, যেমন app, অথবা আরও নির্দিষ্ট কিছু, যেমন app:app-debug.apk। কোনও মডিউলের সব টার্গেট ম্যাচ করতে, মডিউলের নামের পরে /... ব্যবহার করুন, যেমন app/...। আপনার প্রোজেক্টের সব টার্গেট ম্যাচ করতে, ... ব্যবহার করুন।

আপনার প্রোজেক্টের সব টার্গেট তালিকাভুক্ত করতে, আপনার প্রোজেক্টের রুট ডিরেক্টরি থেকে সেগুলি কোয়েরি করুন:

lightbuild query ...

টার্গেট থেকে তৈরি হওয়া ফাইলের তালিকা দেখতে, --output=files যোগ করুন। যেমন, app টার্গেটের জন্য, রান করুন:

lightbuild query app --output=files

আপনার প্রোজেক্টের জন্য উপলভ্য কমান্ডের তালিকা পেতে, lightbuild help রান করুন।

আপনার অ্যাপ তৈরি করুন

টার্গেট তৈরি করতে, টার্গেটের সাথে lightbuild build রান করুন। যেমন, app মডিউল তৈরি করতে, রান করুন:

lightbuild build app

আপনার প্রোজেক্টে সব টার্গেট তৈরি করতে, রান করুন:

lightbuild build

Google Play-তে আপলোড করার জন্য সাইন করা রিলিজ অ্যাপ বান্ডেল তৈরি করতে, আপনার Lightbuild অ্যাপ প্রকাশ করুন দেখুন।

আপনার প্রোজেক্টের বিল্ড আউটপুট ও ক্যাশে সরাতে, এটি রান করুন:

lightbuild clean

আপনার অ্যাপ রান করুন

Lightbuild CLI আপনার অ্যাপ তৈরি করে, কিন্তু এটি ইনস্টল বা রান করে না। কানেক্ট করা ডিভাইস বা চালু থাকা এমুলেটরে আপনার অ্যাপ রান করতে, অ্যাপটি তৈরি করুন এবং তারপরে Android CLI-তে android run কমান্ডের সাহায্যে এটি রান করুন:

lightbuild build app
android run --apks=app/build/app-debug.apk

মডিউলের প্রতিটি টার্গেট কোথায় তার আউটপুট লেখে তা দেখতে, lightbuild query app/... --output=files রান করুন। লোকেশনগুলি মডিউলের ডিরেক্টরির সাথে সম্পর্কিত।

পরীক্ষা চালান

আপনার প্রোজেক্টে সব টেস্ট চালাতে, এটি চালান:

lightbuild test

এই কমান্ড আপনার লোকাল টেস্ট রান করে, যা আপনার ডেভেলপমেন্ট মেশিনে রান করে এবং আপনার ইনস্ট্রুমেন্টেড টেস্ট, যা কানেক্ট করা ডিভাইস বা রানিং এমুলেটরে রান করে।

একটি মডিউলে টেস্ট চালাতে, মডিউলের টার্গেট যোগ করুন, যেমন app-core। শুধুমাত্র এক ধরনের টেস্ট রান করতে, মডিউলের টার্গেটে লোকাল টেস্টের জন্য :hostTest অথবা ইনস্ট্রুমেন্টেড টেস্টের জন্য :deviceTest যোগ করুন। যেমন:

lightbuild test app-core:hostTest
lightbuild test app-core:deviceTest

ডিপেন্ডেন্সি সংক্রান্ত সমস্যার সমাধান করুন

প্রতিটি মডিউল তার সমাধান করা ডিপেন্ডেন্সি resolved.deps ফাইলে রেকর্ড করে। কোনও মডিউলের জন্য resolved.deps ফাইল জেনারেট করতে, মডিউলের টার্গেটের সাথে lightbuild resolve রান করুন। যেমন, app মডিউলের জন্য, রান করুন:

lightbuild resolve app

আপনার প্রোজেক্টের সব টার্গেট সমাধান করতে, এটি রান করুন:

lightbuild resolve

আরও তথ্যের জন্য, সমাধান করা ডিপেন্ডেন্সি দেখুন।