ایجاد پروژه جدید از ترمینال

این صفحه فقط روی ایجاد پروژه تمرکز دارد. اجرای پروژه و ساخت بسته (Bundle) در صفحات جداگانه توضیح داده شده‌اند.

پیش‌نیازها

Appsan SDK را دانلود کرده‌اید و فایل appsan-cli.jar داخل پوشهٔ SDK موجود است.
Java (JDK 11+) نصب و در PATH در دسترس است (java -version).

گام 1) ساخت پوشهٔ پروژه

mkdir hello-appsan
cd hello-appsan

گام 2) ایجاد ساختار پوشه‌ها

mkdir -p layout
mkdir -p assets      # اختیاری
mkdir -p webdist     # اختیاری

گام 3) افزودن فایل پیکربندی پروژه (`appsan.json`)

در ریشهٔ پروژه فایل زیر را بسازید:

appsan.json

{
  "name": "hello-appsan",
  "id": "com.example.helloappsan",
  "version": "1.0.0",
  "description": "My first Appsan project"
}

نکتهٔ مهم: CLI هنگام اجرای دستورها (run/bundle) از مسیر --file به سمت بالا به‌دنبال appsan.json می‌گردد. نبود این فایل باعث خطای No Appsan.json file found. می‌شود.

گام 4) ایجاد یک Layout اولیه

در مسیر layout/ یک فایل اصلی بسازید:

layout/main.xml

<!-- این نمونه صرفاً نمایشی است؛ عناصر را مطابق مستندات Layout پروژهٔ خود تنظیم کنید -->
<layout>
    <!-- نمونهٔ استفاده از Mustache -->
    <!-- متن: {{TITLE}} -->
</layout>

پوشه‌های assets/ و webdist/ (اختیاری) در حالت اجرا روی وب میزبانی شده و در خروجی Bundle نیز اضافه می‌شوند.

ادامهٔ کار:

برای اجرای پروژه (پیش‌نمایش) به صفحهٔ «اجرای پروژه با Appsan CLI (پیش‌نمایش)» بروید.
برای ساخت بستهٔ انتشار (Bundle) به صفحهٔ «ساخت Bundle با Appsan CLI» مراجعه کنید.