اجرا دستی Appsan CLI (عدم استفاده از Intellij)
این راهنما شما را از آماده‌سازی جاوا تا اجرای راهنمای خط فرمان (CLI) هدایت می‌کند.
پیش‌نیازها
-
Appsan SDK را دانلود و اکسترکت کرده‌اید و فایل
appsan-cli.jarداخل پوشه‌ی SDK موجود است. -
دسترسی Admin روی سیستم عامل (در صورت نیاز به افزودن متغیرهای محیطی).
1) نصب و راه‌اندازی Java (JDK) و افزودن به محیط
نسخهٔ موردنیاز جاوا را مطابق نسخهٔ SDK خود نصب کنید (معمولاً JDK 17 یا جدیدتر). پس از نصب، مطمئن شوید که
javaدر PATH قابل دسترسی است.
بررسی نصب
java -version
اگر نسخهٔ جاوا نمایش داده نشد، مراحل زیر را انجام دهید.
Windows (PowerShell)
-
مسیر نصب JDK را پیدا کنید، مثلاً:
C:\Program Files\Java\jdk-21
-
متغیرها را تنظیم کنید (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")
-
ترمینال را ببندید و دوباره باز کنید و بررسی کنید:
java -version
macOS (zsh)
-
اگر چند نسخه جاوا دارید:
/usr/libexec/java_home -V
-
فایل
~/.zshrcرا ویرایش کنید و بیفزایید:
export JAVA_HOME="$(/usr/libexec/java_home)"
export PATH="$JAVA_HOME/bin:$PATH"
-
اعمال تنظیمات و بررسی:
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استفاده کنید.