فصل پیوست ۴: شخصی‌سازی بیشتر Build

More Personalization Build

ما در قسمت قبل با instant prototyping آشنا شدیم و به شما توضیح دادم که mode های مختلفی برای خروجی گرفتن داریم که یکی از آن ها حالت production بود و با دستور npm run build به دست می آمد. سوال اصلی اینجاست که این دستور چه چیزی را برای production می سازد؟ ما سه راه مختلف برای ساختن build نهایی داریم، توجه کنید که منظور من mode نیست. بحث ما بحث جدیدی به نام build targets است.

زمانی که ما پروژه Vue خودمان را شروع می کنیم (یا حتی یک کامپوننت Vue) می توانیم آن را به سه شکل متفاوت داشته باشیم یا به زبان دیگر به سه شکل مختلف از آن خروجی بگیریم:

یک برنامه Vue یا همان Vue App
یک کتابخانه Vue یا همان Vue Library که در برنامه های دیگر Vue شما استفاده می شود.
یک web component برای تمام پروژه های شما!

اگر با web component ها آشنایی ندارید باید بگویم که یک web component در واقع چیزی شبیه به یک تگ شخصی سازی شده در زبان HTML است. اگر یادتان باشد ما از کامپوننت ها در Vue به همین شکل استفاده می کردیم (مثلا <my-component>). حالا شکل سوم خروجی ما که web component است یک حالت خاص از web component های عادی است که نیازی به شیء Vue ندارد. یعنی ما می توانیم یک کامپوننت را با Vue بنویسیم اما در پروژه های دیگری که اصلا با Vue نوشته نشده اند از آن استفاده کنیم! برای استفاده از آن می توانیم از کامپوننت خود به صورت یک عنصر HTML ساده استفاده کنیم، گرچه که باید import جاوا اسکریپتی را برایش داشته باشیم چرا که در نهایت این کامپوننت با جاوا اسکریپت کار خواهد کرد (اما نیازی به Vue ندارد). بیایید به تفاوت های این سه مورد نگاهی داشته باشیم.

در حالت اول (Vue App) باید دستور vue build --target app را اجرا کنیم اما از آنجایی که هدف پیش فرض همیشه app می باشد، فقط vue build را اجرا می کردیم. نتیجه اجرای این کد یک برنامه ساده Vue می باشد که به شما کد های خودتان و فریم ورک Vue را می دهد. در چنین حالتی همه چیز آماده است و نیازی به استفاده از import ها نخواهیم داشت.

در حالت دوم (Vue Library) باید دستور vue build --target lib را اجرا کنیم تا یک پروژه نهایی را تحویل بگیریم. تفاوت این حالت با حالت اول در این است که فریم ورک Vue در پروژه نهایی قرار نمی گیرد. چرا؟ vue library ها معمولا مجموعه ای از کامپوننت ها هستند که توسط یک فرد یا یک گروه ساخته می شوند تا بعدا در پروژه های بزرگ تر استفاده شوند. مثلا شما می توانید چندین کامپوننت آماده بسازید تا در پروژه های آینده خود مجبور نباشید برای پیاده سازی فرم ثبت نام همه چیز را از صفر کدنویسی کنید. بنابراین vue library ها فقط در پروژه های Vue قابل استفاده هستند.

در حالت سوم (web component) از دستور vue build --target wc استفاده می کنیم تا پروژه نهایی را به صورت یک web component دریافت کنیم که distributable web component نام دارند. کلمه distributable به معنی «توزیع پذیر» است بنابراین می توان فهمید که این دسته از برنامه ها نیازی به شیء Vue ندارند. خروجی که در این حالت دریافت می کنیم در نهایت یک فایل جاوا اسکریپتی ساده است اما باید Vue را نیز به همراه آن import کنید. به همین دلیل است که تاکید را روی شیء Vue و نه فریم ورک Vue می گذارم. فایده نیاز نداشتن به شیء Vue چیست؟ اگر به شیء Vue نیازی نداشته باشیم، می توانیم از کامپوننت خود در پروژه هایی که با Vue نوشته نشده اند استفاده کنیم (البته که باید vue را import کنیم اما نیازی نیست شیء Vue داشته باشیم) اما اگر به شیء Vue نیاز داشته باشیم، باید حتما در یک پروژه Vue از آن استفاده کنیم.

برای کار عملی با این موارد یک فایل ساده به نام Hello.vue ایجاد کنید که محتوای زیر را داشته باشد:

<template>
  <h1>Hello</h1>
</template>

حالا می توانیم دستور زیر را اجرا کنیم:

vue build Hello.vue --target app

با این کار همین یک فایل را به عنوان پروژه خود در نظر گرفته و خروجی اش را در پوشه جدیدی به نام dist و سپس پوشه js دریافت می کنیم که شامل خود فریم ورک vue نیز می شود. برای اجرای این کامپوننت نیاز به سرور داریم بنابراین می توان گفت:

npm install -g http-server

این پکیج یک سرور ساده node است. حالا می گوییم:

cd dist/

با این کار وارد پوشه خروجی شده ایم. سپس می گوییم:

http-server

با اجرای این کد، سرور ما به طور خودکار فایل را در مرورگر بارگذاری می کند. البته این مثال فقط برای یادگیری بود و گرنه در حالت عادی از یک پروژه عادی برای گرفتن خروجی از Vue app ها استفاده می کنیم (با دستور npm run build). این می شود حالت اول.

حالا با کلیدهای Ctrl + C سرور را قطع می کنیم و ترمینال را می بندیم. سپس در ترمینال جدیدی از پروژه خود می گوییم:

vue build Hello.vue --target lib

با این کار در پوشه dist چندین فایل جاوا اسکریپتی می گیریم که می توانیم آن را در npm برای دانلود دیگران قرار بدهیم. این حالت دوم بود که یک vue library است. در حالت سوم و برای web component نیز میگوییم:

vue build Hello.vue --target wc --name my-greetings

استفاده از name-- الزامی است تا نام تگ نهایی را مشخص کنید. اگر یادتان باشد گفتم که web component ها مانند تگ های شخصی سازی شده هستند که در HTML استفاده می کنیم بنابراین باید یک نام را نیز برای تگ خود انتخاب کنید و این نام باید حتما علامت خط فاصله را داشته باشد. من نام my-greetings را انتخاب کرده ام. در پوشه dist فایل های جاوا اسکریپتی و demo.html خود را دریافت می کنیم که درون آن از my-greetings به شکل زیر استفاده شده است:

<my-greetings></my-greetings>

برای یادگیری اطلاعات بیشتر راجع به این مفاهیم به documentation رسمی Vue مراجعه کنید.