از صفر مطلق تا اجرای اولین اپلیکیشن (بدون خطا)

اگر قصد داری وارد دنیای برنامه‌نویسی موبایل بشی، Flutter یکی از بهترین انتخاب‌هاست.
اما نصب Flutter برای خیلی‌ها تبدیل به یک کابوس می‌شود 😐

در این مقاله، نصب Flutter را کاملاً اصولی، مرحله‌به‌مرحله و بدون دردسر یاد می‌گیری.

📌 در این آموزش چه چیزهایی یاد می‌گیری؟

✅ Flutter چیست و چرا باید یادش بگیری
✅ پیش‌نیازهای نصب Flutter در ویندوز
✅ نصب Flutter به روش رسمی و استاندارد
✅ تنظیم صحیح PATH در ویندوز
✅ نصب Android Studio
✅ تنظیم Android SDK
✅ تنظیم Environment Variables ویندوز
✅ ساخت Emulator اندروید
✅ اجرای اولین برنامه Flutter
✅ حل خطاهای رایج Flutter در ایران

🧠 Flutter چیست؟

Flutter یک SDK متن‌باز از Google است که به کمک آن می‌توان با یک کد واحد اپلیکیشن‌های زیر را ساخت:

• Android 📱

• iOS 🍎

• Web 🌐

• Desktop 💻

Flutter از زبان Dart استفاده می‌کند و همه چیز در آن بر پایه‌ی Widgetها ساخته می‌شود.

🎯 چرا Flutter؟

دلایل محبوبیت Flutter:

✅ سرعت بالا
✅ UI بسیار زیبا
✅ یک کد برای چند پلتفرم
✅ پشتیبانی Google
✅ بازار کار عالی

⚠️ نکته بسیار مهم قبل از نصب Flutter

Flutter برای دانلود فایل‌ها به سرورهای Google متصل می‌شود.

اگر داخل ایران هستی یا دسترسی مستقیم به Google نداری:

🔴 حتماً VPN پایدار روشن کن
در غیر این صورت نصب ناقص می‌شود.

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

قبل از نصب Flutter، این ابزارها باید نصب باشند:

1️⃣ Git for Windows

• Flutter برای دانلود از Git استفاده می‌کند

• آخرین نسخه Git را نصب کن

2️⃣ Visual Studio Code

• ویرایشگر سبک و حرفه‌ای

• بهترین گزینه برای Flutter

• افزونه Flutter داخلش نصب می‌شود

🚀 مرحله اول: نصب Flutter (روش رسمی و پیشنهادی)

نصب Flutter از داخل VS Code

این روش:

• بدون خطاست

• تمیز نصب می‌شود

• PATH خودکار تنظیم می‌شود

مراحل نصب Flutter

1️⃣ VS Code را اجرا کن

2️⃣ افزونه Flutter را نصب کن
در Extensions سرچ کن:

3️⃣ کلیدهای زیر را بزن:

4️⃣ تایپ کن:

5️⃣ وقتی پرسید Flutter SDK کجاست:
👉 Download SDK

6️⃣ مسیر نصب را انتخاب کن (مثلاً):

Flutter اینجا نصب می‌شود:

7️⃣ روی Clone Flutter کلیک کن
⏳ صبر کن (VPN روشن باشد)

8️⃣ وقتی پیام زیر را دیدی:

یعنی نصب موفق بوده ✅

🔁 VS Code را ببند و دوباره باز کن

🧪 بررسی نصب Flutter

در ترمینال VS Code بنویس:

اگر این بخش‌ها سبز بودند:

یعنی Flutter درست نصب شده است.

🤖 مرحله دوم: نصب Android Studio

برای اجرای اپ روی موبایل یا شبیه‌ساز، Android Studio لازم است.

مراحل نصب Android Studio

1️⃣ Android Studio را نصب کن
2️⃣ موقع نصب این گزینه‌ها فعال باشند:

✔ Android SDK
✔ Android SDK Platform
✔ Android Virtual Device

3️⃣ نصب را کامل کن (VPN روشن)

📦 مرحله سوم: بررسی مسیر Android SDK

مسیر پیش‌فرض Android SDK:

این مسیر را حتماً به خاطر بسپار.

⚙️ مرحله چهارم: تنظیم Environment Variables ویندوز

اضافه کردن ANDROID_HOME

1. Start → سرچ کن:

2. وارد Environment Variables شو

3. در بخش System variables روی New بزن

Variable name:

Variable value:

اضافه کردن Android SDK به PATH

در بخش System variables → Path → Edit
این مسیرها را اضافه کن:

OK → OK → OK

🔁 ویندوز یا VS Code را ری‌استارت کن

🧪 مرحله پنجم: بررسی اتصال Flutter به Android

در ترمینال بنویس:

اگر دیدی:

یعنی Android Studio و SDK درست تنظیم شده‌اند.

📱 مرحله ششم: ساخت Emulator اندروید

1️⃣ Android Studio → More Actions
2️⃣ Virtual Device Manager
3️⃣ Create Virtual Device
4️⃣ یک گوشی (مثلاً Pixel) انتخاب کن
5️⃣ یک نسخه Android انتخاب کن
6️⃣ Finish

▶️ اجرای اولین برنامه Flutter

ساخت پروژه:

اجرا روی شبیه‌ساز:

اجرا روی مرورگر:

❌ خطاهای رایج Flutter و راه‌حل

❌ دسترسی به Google

✔ VPN روشن کن

❌ Android SDK not found

✔ مسیر ANDROID_HOME اشتباه است

❌ licenses not accepted

همه را y بزن

🔚 جمع‌بندی نهایی

بعد از این مراحل:

✅ Flutter نصب است
✅ Android Studio نصب است
✅ Android SDK تنظیم شده
✅ Environment Variables ست شده
✅ Emulator آماده است

🎉 حالا کاملاً آماده‌ی شروع برنامه‌نویسی Flutter هستی