راهنمای افزودن پروژه وب به پروژه Appsan

محتوای این آموزش در حال توسعه می باشد و در نسخه های پابلیش شده در دسترس نیست.

در این راهنما، نحوه افزودن یک پروژه وب به پروژه Appsan به صورت گام‌به‌گام توضیح داده می‌شود. با استفاده از این راهنما، شما می‌توانید پروژه‌های وب خود را به‌طور مؤثری درون Appsan ادغام کرده و از قابلیت‌های جدید عنصر web-page بهره‌مند شوید.

۱. ایجاد پوشه‌های مورد نیاز

1. ایجاد پوشه web:

   • ابتدا در مسیر اصلی پروژه Appsan خود، یک پوشه به نام web ایجاد کنید.
   • این پوشه قرار است حاوی کد منبع پروژه‌های وب شما باشد.

2. ایجاد پوشه webdist:

   • در کنار پوشه web، یک پوشه دیگر به نام webdist ایجاد کنید.
   • این پوشه قرار است فایل‌های ساخته شده (build) پروژه‌های وب شما را نگهداری کند.

۲. اضافه کردن پروژه وب به پوشه web

1. ایجاد پوشه برای پروژه وب:

   • درون پوشه web، یک پوشه جدید به نام پروژه وب خود ایجاد کنید. به عنوان مثال، اگر پروژه وب شما "MyWebProject" نام دارد، یک پوشه به نام MyWebProject بسازید.

2. افزودن کد منبع:

   • تمام فایل‌های مرتبط با پروژه وب خود را درون این پوشه کپی کنید. این شامل HTML، CSS، JavaScript و هر فایل دیگری است که برای پروژه وب شما نیاز است.

۳. ساخت پروژه وب

1. ساخت پروژه:

   • با استفاده از ابزار ساخت مناسب (مانند Webpack، Parcel، یا ابزارهای دیگر)، پروژه وب خود را بسازید.
   • نتیجه ساخت (فایل‌های build شده) باید شامل فایل‌های HTML، CSS، و JavaScript بهینه شده باشد.

2. کپی فایل‌های ساخته شده به webdist:

   • پس از ساخت پروژه، تمامی فایل‌های ساخته شده را درون پوشه‌ای با همان نام پروژه در webdist کپی کنید.
   • برای مثال، اگر پروژه شما "MyWebProject" نام دارد، فایل‌های ساخته شده باید در مسیر webdist/MyWebProject قرار گیرند.

۴. استفاده از عنصر web-page در پروژه Appsan

1. افزودن عنصر web-page به فایل XML:

   • حالا می‌توانید از عنصر web-page در فایل XML پروژه Appsan خود استفاده کنید.
   • ویژگی src را به نام پوشه پروژه در webdist تنظیم کنید و ویژگی title را نیز به دلخواه مقداردهی کنید.

   مثال:

   <web-page src="MyWebProject" title="پروژه وب من"/>
   

2. تست و اشکال‌زدایی:

   • پروژه Appsan خود را اجرا کرده و بررسی کنید که صفحه وب به درستی بارگذاری می‌شود.
   • در صورت وجود هر گونه اشکال، به مسیرهای پروژه در پوشه‌های web و webdist و همچنین تنظیمات ساخت پروژه وب خود مراجعه کنید.

نکات مهم

• اطمینان حاصل کنید که نام پوشه‌ها در web و webdist کاملاً یکسان باشد.
• برای لینک‌های خارجی از ویژگی src با یک لینک HTTPS معتبر استفاده کنید.
• در صورت تغییر در کد منبع پروژه وب، پروژه را مجدداً ساخته و فایل‌های ساخته شده را به پوشه webdist کپی کنید.

این راهنما به شما کمک می‌کند تا پروژه‌های وب خود را به‌طور مؤثر در پروژه‌های Appsan ادغام کنید و از قابلیت‌های جدید آن بهره‌مند شوید.