نصب و راهاندازی 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، مطمئن شوید ابزارهای پایه زیر روی سیستم شما نصب هستند:
- ابزار مدیریت نسخه Git: برای دریافت بهروزرسانیهای فلاتر و مدیریت وابستگیها به
Git 2.xیا بالاتر نیاز دارید. - ویرایشگر کد یا IDE: توصیه رسمی تیم فلاتر استفاده از Visual Studio Code (همراه با افزونههای رسمی
FlutterوDart) یا Android Studio است. - ابزارهای کامپایل پلتفرم هدف: برای ساخت خروجی اندروید به Android SDK و Android Studio و در macOS برای خروجی iOS به Xcode نیاز خواهید داشت.
دریافت و پیکربندی Flutter SDK
پس از دریافت آرشیو پایدار (Stable Channel) متناسب با سیستمعامل خود از مخزن رسمی فلاتر:
- فایل فشرده را در مسیری استخراج کنید که فاقد فاصله (Space) و کاراکترهای غیرلاتین باشد و نیاز به دسترسی سطح ادمین نداشته باشد (بهعنوان مثال در ویندوز مسیر
C:\dev\flutterو در لینوکس یا مک مسیر~/development/flutter). - پوشه
flutter/binرا به متغیر محیطیPATHسیستمعامل خود اضافه کنید تا دستورflutterدر تمام پنجرههای ترمینال قابل اجرا باشد.
برای بررسی وضعیت نصب و شناسایی نیازمندیهای باقیمانده، ترمینال جدیدی باز کرده و دستور زیر را اجرا کنید:
flutter doctor
دستور flutter doctor کل محیط توسعه شما را تحلیل میکند و گزارشی دقیق از وضعیت موارد زیر ارائه میدهد:
- نسخه فعلی Flutter و Dart
- وضعیت زنجیره ابزار اندروید (
Android toolchain) و مجوزهای Android SDK - وضعیت اتصال به دستگاههای فیزیکی یا شبیهسازها (
Connected device) - شناسایی افزونههای نصبشده در VS Code یا Android Studio
در صورتی که هر یک از موارد بالا با علامت هشدار (!) یا خطا (✗) مشخص شده باشد، flutter doctor دستور دقیق رفع آن مشکل را مستقیماً در خروجی چاپ میکند.
ساخت و اجرای اولین پروژه
پس از آنکه محیط توسعه شما آماده شد، میتوانید نخستین پروژه فلاتر خود را با استفاده از ابزار خط فرمان بسازید و اجرا کنید:
flutter create my_app
cd my_app
flutter run
توجه: در اولین اجرای دستور
flutter run، دریافت وابستگیهای Gradle و کامپایل اولیه ممکن است چند دقیقه طول بکشد. پس از اجرای برنامه، با تغییر کدهای فایلlib/main.dartو فشردن کلیدrدر ترمینال (یا ذخیره فایل در ویرایشگر)، قابلیت Stateful Hot Reload تغییرات را در کمتر از یک ثانیه بدون از دست رفتن وضعیت فعلی برنامه نمایش میدهد.