Android Studio'da Flutter Nasıl Yapılandırılır ve İlk Proje Nasıl Çalıştırılır

Kerem Aydın·9 Temmuz 2026·⏱3 dk

Android Studio'da Flutter'ı çalıştırmak için: Android Studio ve Flutter SDK'yı kurun, flutter/bin dizinini PATH'e ekleyin, IDE'ye Flutter ve Dart eklentilerini yükleyin, ayarlarda SDK yolunu belirtin, yeni bir Flutter projesi oluşturun ve bunu öykünücü veya gerçek bir cihazda çalıştırın — tüm adımlar aşağıdadır.

Gereksinimler ve Hazırlık

  • Minimum: 8 GB RAM, 10 GB boş alan, 64-bit işletim sistemi (Windows 10+, macOS 11+, Ubuntu 20.04+).
  • En son Android Studio'yu kurun. IDE içinde Android SDK'yı (Android 14+) ve SDK Tools bileşenlerini güncelleyin.
  • Java: JDK 17+ genellikle Android Studio ile birlikte gelir. Öykünücü için: HAXM (Intel), Hypervisor Framework (Apple Silicon) veya KVM (Linux).

Git kurulu değilse kurun; bazı şablonlar ve paket yönetimi için gereklidir.

Flutter SDK Kurulumu ve PATH Ayarı

  1. İşletim sisteminize uygun SDK arşivini indirin ve kalıcı bir klasöre çıkarın:
    • Windows: C:\flutter
    • macOS/Linux: ~/development/flutter Program Files veya izin kısıtlamaları olan klasörlere çıkarmayın.
  2. flutter/bin dizinini PATH'e ekleyin:
    • Windows: Sistem → Gelişmiş → Ortam Değişkenleri → Path → C:\flutter\bin ekle yoluyla ortam değişkenleri üzerinden.
    • macOS/Linux: ~/.zshrc veya ~/.bashrc dosyasına export PATH="$PATH:~/development/flutter/bin" satırını ekleyin ve source komutunu çalıştırın.
  3. Terminali açın ve şu komutu çalıştırın: flutter doctor Uyarıları düzeltin (Android araç zinciri, Android SDK, macOS için Xcode, web için Chrome). Hedef, tüm kontrollerin yeşil alanda olmasıdır.

Eklentiler ve Android Studio Entegrasyonu

  1. Android Studio'yu başlatın → File → Settings → Plugins.
  2. Marketplace'ten Flutter ve Dart eklentilerini yükleyin, IDE'yi yeniden başlatın.
  3. Flutter SDK yolunu belirtin: File → Settings → Languages & Frameworks → Flutter → Flutter SDK path → çıkarılan klasörü seçin.
  4. Araçları etkinleştirin: View → Tool Windows → Flutter Inspector ve DevTools (gerektiğinde).

Dart eklentisi kod vurgulama ve analizi için gereklidir; Flutter ise şablon desteği, hızlı yeniden yükleme ve öykünücü entegrasyonu sağlar.

İlk Projeyi Oluşturma ve Çalıştırma

  1. File → New → New Flutter Project → Flutter Application.
  2. Bir ad belirleyin (lowercase_with_underscores), Paket Kimliği (örneğin com.example.myapp) ve Platformlar (Android, iOS) seçin.
  3. IDE bağımlılıkları yüklerken bekleyin (flutter pub get).
  4. Öykünücü oluşturma: Tools → AVD Manager → Create Virtual Device → bir imaj seçin (Pixel, API 34+), başlatın.
  5. Araç çubuğunda cihazı seçin ve Run (yeşil ok) veya Shift+F10 tuşlarına basın. Uygulama çalışacaktır (demo sayaç).
  6. Hızlı yeniden yükleme: Araç çubuğundaki Hot Reload düğmesini kullanın veya terminalde flutter run çalışırken r tuşuna basın (R — tam yeniden başlatma).

Sık Karşılaşılan Hatalar

  • "Flutter SDK not found" — PATH ayarlanmamış veya IDE yeniden başlatılmamış. Çözüm: flutter doctor kontrol edin, ayarlarda yolu belirtin ve Android Studio'yu yeniden başlatın.
  • Öykünücü başlamıyor — HAXM/HVF/KVM eksik. Çözüm: donanım sanallaştırmayı etkinleştirin ve SDK Manager'da ilgili bileşeni kurun.
  • Build failed (Gradle) — uyumsuz Android SDK/Build Tools. Çözüm: SDK'yı güncelleyin (Android 14+), flutter clean ve flutter pub get komutlarını çalıştırın.
  • iOS derlenmiyor — Xcode yok (macOS). Çözüm: Xcode ve komut satırı araçlarını (xcode-select) kurun.
  • Hot Reload çalışmıyor — arka planda derleme var veya flutter run ile başlatılmamış. Çözüm: başlatmayı IDE veya terminal üzerinden yeniden yapın.

SSS

  • Ayrı bir Android SDK gerekli mi? Evet — Android Studio SDK Manager içerir; Android platformlarının ve derleme araçlarının kurulu olduğundan emin olun.
  • Flutter SDK nerede saklanmalı? Program Files dışında, kullanıcı erişim haklarına sahip kalıcı bir dizinde.
  • Gerçek bir cihazda nasıl test edilir? Android'de USB Hata Ayıklamayı etkinleştirin ve cihazı bağlayın, cihazlar listesinde seçip çalıştırın.
  • Windows'ta iOS derlenebilir mi? Hayır — iOS derlemesi için Xcode yüklü macOS gerekir.

Ek olarak: Profil oluşturma için DevTools'u bağlayın, proje büyüdükçe durum yönetimi (Riverpod, Provider veya Bloc) ve yönlendirme sistemi (GoRouter) kullanın. Geliştirme sürecinizde başarılar — temel kurulumdan sonra uygulamaları hızla prototipleyebilir ve ölçeklendirebilirsiniz.