نصب

با starterهای آنلاین یا به صورت محلی از طریق terminal، سریع کار با Angular را شروع کنید.

اجرای آنلاین

اگر فقط می‌خواهید بدون راه‌اندازی یک پروژه، Angular را در مرورگر خود امتحان کنید، می‌توانید از sandbox آنلاین ما استفاده کنید:

راه‌اندازی یک پروژه جدید به صورت محلی

اگر در حال شروع یک پروژه جدید هستید، به احتمال زیاد می‌خواهید یک پروژه محلی بسازید تا بتوانید از ابزارهایی مثل Git استفاده کنید.

پیش‌نیازها

• Node.js - v20.19.0 یا جدیدتر
• Text editor - ما Visual Studio Code را پیشنهاد می‌کنیم
• Terminal - برای اجرای commandهای Angular CLI لازم است
• Development Tool - برای بهتر شدن جریان توسعه، Angular Language Service را پیشنهاد می‌کنیم

دستورالعمل‌ها

راهنمای زیر شما را مرحله‌به‌مرحله با راه‌اندازی یک پروژه محلی Angular همراه می‌کند.

نصب Angular CLI

یک terminal باز کنید؛ اگر از Visual Studio Code استفاده می‌کنید، می‌توانید یک integrated terminal باز کنید. سپس command زیر را اجرا کنید:

npm install -g @angular/cli

pnpm install -g @angular/cli

yarn global add @angular/cli

bun install -g @angular/cli

اگر در اجرای این command در Windows یا Unix مشکلی دارید، برای اطلاعات بیشتر مستندات CLI را ببینید.

ساخت یک پروژه جدید

در terminal خود، command مربوط به CLI یعنی ng new را با نام دلخواه پروژه اجرا کنید. در نمونه‌های زیر، از نام پروژه نمونه my-first-angular-app استفاده می‌کنیم.

ng new <project-name>

چند گزینه پیکربندی برای پروژه به شما نمایش داده می‌شود. با کلیدهای جهت‌نما و Enter جابه‌جا شوید و گزینه‌هایی را که می‌خواهید انتخاب کنید.

اگر ترجیح خاصی ندارید، فقط Enter را بزنید تا گزینه‌های پیش‌فرض انتخاب شوند و راه‌اندازی ادامه پیدا کند.

بعد از انتخاب گزینه‌های پیکربندی و اجرای مراحل راه‌اندازی توسط CLI، باید پیام زیر را ببینید:

✔ Packages installed successfully.
    Successfully initialized git.

در این مرحله، آماده‌اید پروژه خود را به صورت محلی اجرا کنید!

اجرای پروژه جدید به صورت محلی

در terminal خود وارد پروژه جدید Angular شوید.

cd my-first-angular-app

در این مرحله همه dependencyهای شما باید نصب شده باشند؛ می‌توانید این را با بررسی وجود پوشه node_modules در پروژه تأیید کنید. سپس می‌توانید پروژه را با اجرای command زیر شروع کنید:

npm start

اگر همه چیز موفقیت‌آمیز باشد، باید یک پیام تأیید مشابه در terminal ببینید:

Watch mode enabled. Watching for file changes...
NOTE: Raw file sizes do not reflect development server per-request transformations.
  ➜  Local:   http://localhost:4200/
  ➜  press h + enter to show help

حالا می‌توانید مسیر نمایش‌داده‌شده در Local، برای مثال http://localhost:4200، را باز کنید و برنامه خود را ببینید. کدنویسی خوش بگذرد! 🎉

استفاده از AI برای توسعه

برای شروع ساخت برنامه در IDE مجهز به AI مورد علاقه‌تان، قوانین prompt و بهترین روش‌های Angular را ببینید.

قدم‌های بعدی

حالا که پروژه Angular خود را ساخته‌اید، می‌توانید در راهنمای Essentials بیشتر درباره Angular یاد بگیرید یا از راهنماهای عمیق‌تر یک موضوع را انتخاب کنید!