Android Studio’da Flutter Projesi Açma ve Çalıştırma (Adım Adım Rehber)

İçindekiler

1. Android Studio’yu Aç
2. Flutter / Dart Eklentilerini Kur
3. Flutter SDK Yolunu Tanıt
4. Flutter Projesini Doğru Klasörden Aç
5. Emulator Kur ve Çalıştır (Device Manager)
6. Projeyi Çalıştır (Run / flutter run)
7. Flutter’da Önemli Dosyalar
8. Sık Karşılaşılan Hatalar ve Çözümler
9. VS Code mu Android Studio mu?
10. Sık Sorulan Sorular (FAQ)
11. Sonuç

1) Android Studio’yu Aç

İlk adım basit: Android Studio’yu çalıştırın. Eğer ilk kez kurulum yaptıysanız, Android Studio’nun temel bileşenleri (SDK Manager vb.) arka planda güncelleme isteyebilir.

2) Flutter / Dart Eklentilerini Kur

Android Studio’da Flutter geliştirmek için Flutter ve Dart eklentileri gerekir. Flutter eklentisi kurulduğunda Dart çoğu zaman otomatik yüklenir; yüklenmezse ayrıca kurun.

Yol: File → Settings → Plugins

• Marketplace’te Flutter ara → Install
• Gerekirse Dart eklentisini de Install
• Android Studio “Restart” ister → Restart

3) Flutter SDK Yolunu Tanıt (En Kritik Adım)

“Çalışmıyor” gibi görünen problemlerin büyük kısmı Flutter SDK path tanımlı olmadığı için oluşur. Flutter’ı zipten çıkardığınız ana klasörü seçmelisiniz (içinde bin klasörü olan ana dizin).

Yol: File → Settings → Languages & Frameworks → Flutter

Örnek path: C:\src\flutter

4) Flutter Projesini Doğru Klasörden Aç

Flutter projesini açarken en sık yapılan hata şudur: Projenin kök klasörü yerine sadece android/ klasörünü açmak. Doğrusu proje kök dizinidir.

• Doğru: C:\...\my_flutter_app\
• Yanlış: C:\...\my_flutter_app\android\

Yol: Android Studio başlangıç ekranı → Open → proje kök klasörünü seç

5) Emulator Kur ve Çalıştır (Device Manager)

Flutter uygulamanızı çalıştırmak için bir Android Emulator gerekir. Android Studio üzerinden Device Manager ile cihaz oluşturabilir ve çalıştırabilirsiniz.

Yol: Tools → Device Manager

• Cihaz yoksa: Create device
• Öneri: Pixel 5 / Pixel 6
• System Image: API 33 / API 34 (x86_64) indir
• Oluşturduktan sonra ▶️ Play ile başlat

6) Projeyi Çalıştır (Run / flutter run)

Emulator çalışıyorsa artık uygulamayı başlatabilirsiniz. Üst menüden cihaz seçip Run butonuna basmanız yeterli.

• Üstteki cihaz listesinden emulator’u seç (örn: Pixel 6 API 34)
• Yeşil ▶️ Run butonuna bas

Alternatif olarak terminalden:

flutter pub get
flutter run

7) Flutter’da Önemli Dosyalar

• lib/main.dart → uygulamanın başlangıç noktası
• pubspec.yaml → paketler ve asset tanımları
• Terminal → flutter pub get, flutter run, flutter clean

8) Sık Karşılaşılan Hatalar ve Çözümler

A) “Flutter SDK path not set”

Flutter SDK yolunu tanımlayın: File → Settings → Languages & Frameworks → Flutter

B) “flutter doctor” Android toolchain kırmızı

Android Studio’da SDK Manager üzerinden Android SDK + Platform Tools kurulu olmalı. Ardından terminalde:

flutter doctor

C) Gradle / build hataları

Genelde şu komutlar sorunu çözer:

flutter clean
flutter pub get

D) Emulator / cihaz görünmüyor

Emulator açıkken şunu kontrol edin:

flutter devices

9) VS Code mu Android Studio mu?

En rahat çalışma düzeni genellikle hibrittir: VS Code ile kod yaz, Android Studio ile emulator ve debug yönet.

• VS Code: hızlı, hafif, pratik eklentiler
• Android Studio: emulator/device manager, logcat, build/release işlemleri

10) Sık Sorulan Sorular (FAQ)

Flutter projesini Android Studio’da açarken neden hata alıyorum?

En yaygın sebep Flutter SDK path tanımlı olmaması veya proje kök klasörü yerine android/ klasörünün açılmasıdır.

Emulator şart mı, gerçek cihazla çalışabilir miyim?

Evet, gerçek cihazla da çalışabilirsiniz. USB debugging açıp cihazı bağladıktan sonra flutter devices ile görünmesini kontrol edin.

Proje açıldı ama bağımlılıklar gelmedi, ne yapmalıyım?

Terminalde flutter pub get çalıştırın. Sorun devam ederse flutter clean sonrası tekrar deneyin.

Sonuç

Bu rehberde Flutter projesini Android Studio’da açıp çalıştırmak için gereken tüm adımları net şekilde gördük. En kritik noktalar: Flutter/Dart eklentileri, Flutter SDK path ve projeyi kök klasörden açmak. Bu üçü doğruysa emulator üzerinden uygulamayı çalıştırmak genellikle sorunsuz olur.