اجرا دستی Appsan CLI (عدم استفاده از Intellij)

این راهنما شما را از آماده‌سازی جاوا تا اجرای راهنمای خط فرمان (CLI) هدایت می‌کند.

پیش‌نیازها

  • Appsan SDK را دانلود و اکسترکت کرده‌اید و فایل appsan-cli.jar داخل پوشه‌ی SDK موجود است.

  • دسترسی Admin روی سیستم عامل (در صورت نیاز به افزودن متغیرهای محیطی).

1) نصب و راه‌اندازی Java (JDK) و افزودن به محیط

نسخهٔ موردنیاز جاوا را مطابق نسخهٔ SDK خود نصب کنید (معمولاً JDK 17 یا جدیدتر). پس از نصب، مطمئن شوید که java در PATH قابل دسترسی است.

بررسی نصب

java -version

اگر نسخهٔ جاوا نمایش داده نشد، مراحل زیر را انجام دهید.

Windows (PowerShell)

  1. مسیر نصب JDK را پیدا کنید، مثلاً:

C:\Program Files\Java\jdk-21

  1. متغیرها را تنظیم کنید (PowerShell را با سطح کاربر اجرا کنید):

[Environment]::SetEnvironmentVariable("JAVA_HOME","C:\Program Files\Java\jdk-21","User") [Environment]::SetEnvironmentVariable("Path",$Env:Path + ";C:\Program Files\Java\jdk-21\bin","User")

  1. ترمینال را ببندید و دوباره باز کنید و بررسی کنید:

java -version

macOS (zsh)

  1. اگر چند نسخه جاوا دارید:

/usr/libexec/java_home -V

  1. فایل ~/.zshrc را ویرایش کنید و بیفزایید:

export JAVA_HOME="$(/usr/libexec/java_home)" export PATH="$JAVA_HOME/bin:$PATH"

  1. اعمال تنظیمات و بررسی:

source ~/.zshrc java -version

Linux (bash/zsh)

بستهٔ JDK توزیع خود را نصب کنید (مثلاً Debian/Ubuntu):

sudo apt update && sudo apt install -y openjdk-17-jdk

سپس در ~/.bashrc یا ~/.zshrc اضافه کنید:

export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64 export PATH="$JAVA_HOME/bin:$PATH"

و اعمال و بررسی:

source ~/.bashrc # یا ~/.zshrc java -version

2) باز کردن ترمینال در پوشه‌ی Appsan SDK

  • Windows: در File Explorer روی پوشهٔ SDK بروید → راست‌کلیک → Open in Terminal یا Open PowerShell window here.

  • macOS/Linux: در فایل‌منیجر Open in Terminal یا با دستور:

cd /path/to/appsan-sdk

در این پوشه باید فایل appsan-cli.jar را ببینید.

3) نمایش راهنمای CLI

در همان پوشه‌ی SDK دستور زیر را اجرا کنید:

Linux/macOS:

java -jar ./appsan-cli.jar --help

Windows (PowerShell/CMD):

java -jar .\appsan-cli.jar --help

اگر همه‌چیز درست باشد، فهرست دستورات و سویچ‌های CLI نمایش داده می‌شود.

 

4) عیب‌یابی سریع

  • 'java' is not recognized / command not found: جاوا نصب نیست یا PATH به‌روز نشده است. ترمینال را ببندید/باز کنید یا مراحل تنظیم PATH را تکرار کنید.

  • Error: Unable to access jarfile appsan-cli.jar: در پوشهٔ درست نیستید یا نام فایل جابه‌جا/غلط است. با ls/dir وجود فایل را بررسی کنید.

  • UnsupportedClassVersionError: نسخهٔ جاوای شما قدیمی است. JDK جدیدتر نصب/فعال کنید.

  • مسیرهای دارای فاصله: مسیرها را در نقل‌قول " " قرار دهید.

  • پروکسی/فایروال: در صورت نیاز از گزینه‌های جاوا مانند -Dhttp.proxyHost و -Dhttp.proxyPort استفاده کنید.

No Comments
Back to top