نصب و راه‌اندازی Flutter

Install Flutter

راهنمای جامع دریافت Flutter SDK، پیکربندی متغیر محیطی PATH، بررسی ابزارها با flutter doctor و ساخت اولین اپلیکیشن

فهرست مطالب این صفحه

برای شروع ساخت اپلیکیشن با Flutter، نخست باید بسته Flutter SDK را متناسب با سیستم‌عامل خود و پلتفرم هدفی که قصد توسعه برای آن را دارید نصب و پیکربندی کنید. فلاتر به شما اجازه می‌دهد از یک کدبیس واحد برای Android، iOS، Web، Windows، macOS و Linux خروجی بگیرید.

انتخاب سیستم‌عامل و پلتفرم هدف

مستندات رسمی فلاتر فرآیند نصب را بر اساس سیستم‌عامل میزبان (Development OS) و پلتفرم هدف (Target Platform) دسته‌بندی می‌کند:

سیستم‌عامل توسعه پلتفرم‌های قابل توسعه و اجرا
Windows Android، Web، اپلیکیشن‌های دسکتاپ Windows
macOS iOS، Android، Web، اپلیکیشن‌های دسکتاپ macOS
Linux Android، Web، اپلیکیشن‌های دسکتاپ Linux

نکته: ابزار خط فرمان dart به‌صورت داخلی همراه با بسته Flutter SDK عرضه می‌شود و نیازی به نصب جداگانه Dart SDK نخواهید داشت.

پیش‌نیازهای نرم‌افزاری

پیش از دانلود و راه‌اندازی Flutter SDK، مطمئن شوید ابزارهای پایه زیر روی سیستم شما نصب هستند:

  1. ابزار مدیریت نسخه Git: برای دریافت به‌روزرسانی‌های فلاتر و مدیریت وابستگی‌ها به Git 2.x یا بالاتر نیاز دارید.
  2. ویرایشگر کد یا IDE: توصیه رسمی تیم فلاتر استفاده از Visual Studio Code (همراه با افزونه‌های رسمی Flutter و Dart) یا Android Studio است.
  3. ابزارهای کامپایل پلتفرم هدف: برای ساخت خروجی اندروید به Android SDK و Android Studio و در macOS برای خروجی iOS به Xcode نیاز خواهید داشت.

دریافت و پیکربندی Flutter SDK

پس از دریافت آرشیو پایدار (Stable Channel) متناسب با سیستم‌عامل خود از مخزن رسمی فلاتر:

  1. فایل فشرده را در مسیری استخراج کنید که فاقد فاصله (Space) و کاراکترهای غیرلاتین باشد و نیاز به دسترسی سطح ادمین نداشته باشد (به‌عنوان مثال در ویندوز مسیر C:\dev\flutter و در لینوکس یا مک مسیر ~/development/flutter).
  2. پوشه flutter/bin را به متغیر محیطی PATH سیستم‌عامل خود اضافه کنید تا دستور flutter در تمام پنجره‌های ترمینال قابل اجرا باشد.

برای بررسی وضعیت نصب و شناسایی نیازمندی‌های باقی‌مانده، ترمینال جدیدی باز کرده و دستور زیر را اجرا کنید:

Terminal / Bash
flutter doctor

دستور flutter doctor کل محیط توسعه شما را تحلیل می‌کند و گزارشی دقیق از وضعیت موارد زیر ارائه می‌دهد:

  • نسخه فعلی Flutter و Dart
  • وضعیت زنجیره ابزار اندروید (Android toolchain) و مجوزهای Android SDK
  • وضعیت اتصال به دستگاه‌های فیزیکی یا شبیه‌سازها (Connected device)
  • شناسایی افزونه‌های نصب‌شده در VS Code یا Android Studio

در صورتی که هر یک از موارد بالا با علامت هشدار (!) یا خطا (✗) مشخص شده باشد، flutter doctor دستور دقیق رفع آن مشکل را مستقیماً در خروجی چاپ می‌کند.

ساخت و اجرای اولین پروژه

پس از آنکه محیط توسعه شما آماده شد، می‌توانید نخستین پروژه فلاتر خود را با استفاده از ابزار خط فرمان بسازید و اجرا کنید:

Terminal / Bash
flutter create my_app
cd my_app
flutter run

توجه: در اولین اجرای دستور flutter run، دریافت وابستگی‌های Gradle و کامپایل اولیه ممکن است چند دقیقه طول بکشد. پس از اجرای برنامه، با تغییر کدهای فایل lib/main.dart و فشردن کلید r در ترمینال (یا ذخیره فایل در ویرایشگر)، قابلیت Stateful Hot Reload تغییرات را در کمتر از یک ثانیه بدون از دست رفتن وضعیت فعلی برنامه نمایش می‌دهد.