ساخت Bundle با Appsan CLI

این صفحه نحوهٔ ساخت خروجی قابل توزیع (Zip) از پروژه را توضیح می‌دهد.

پیش‌نیازها

• پروژه و appsan.json طبق صفحهٔ «ایجاد پروژه جدید از ترمینال» آماده باشند.

• Layout اصلی (مثلاً layout/main.xml) موجود باشد.

الگوی دستور

java -jar /path/to/appsan-sdk/appsan-cli.jar bundle [options]

ساخت سریع

java -jar /path/to/appsan-sdk/appsan-cli.jar bundle -f ./layout/main.xml

گزینه‌های مهم

• -f, --file <path> مسیر فایل Layout (الزامی)

• -r, --root <path> ریشهٔ منابع (پیش‌فرض: <projectPath>/layout)

• -k, --keyVal <k:v> مقداردهی Mustache (قابل تکرار)

• -v, --variable <id:val> افزودن <var/> (قابل تکرار)

• -q, --qualifier <k:v> تعیین Qualifierها (قابل تکرار)

• --keep-comments <bool> حفظ کامنت‌ها در خروجی (مثلاً true)

• -b, --bundle-type <zip|xml> فعلاً در خروجی اثری ندارد (خروجی zip است)

خروجی‌ها

پس از اجرا، پوشهٔ dist/ ایجاد می‌شود و شامل موارد زیر است:

• dist/index.xml — کد تولیدشده از Layout

• dist/manifest.xml — تولیدشده بر اساس appsan.json

• dist/<name>.zip — شامل index.xml, manifest.xml, و در صورت وجود assets/** و webdist/**

نمونهٔ پیشرفته

java -jar /path/to/appsan-sdk/appsan-cli.jar bundle -f ./layout/main.xml \
  -k TITLE:"Hello Appsan" -q density:mdpi --keep-comments true

خطاهای متداول و رفع آن‌ها

• No Appsan.json file found.
  appsan.json در ریشهٔ پروژه موجود نیست یا مسیر -f خارج از پروژه است.

• مسیر فایل‌ها
  در صورت وجود فاصله در مسیرها از نقل‌قول " " استفاده کنید.

• java not found / نسخهٔ جاوا
  JDK 11+ نصب باشد و java -version نسخهٔ درست را نشان دهد.