Bölüm 9 — Konu 41: Permission Yönetimi (`permission_handler`)

Konu 40'ta native kodla elle nasıl konuşulacağını gördük. Bu derste, o mekanizmayı elle kurmana gerek bırakmayan, hazır ve çok yaygın kullanılan bir paketle — kullanıcıdan izin istemeyi (konum, kamera, bildirim vb.) öğreneceğiz. Bu, Konu 40'ın sonunda bahsettiğimiz "çoğu native ihtiyaç hazır paketlerle karşılanır" ilkesinin ilk somut örneği.

#Neden İzin Sistemi Var?

Hem Android hem iOS, kullanıcının mahremiyetini korumak için, bir uygulamanın hassas kaynaklara (konum, kamera, mikrofon, kişiler, bildirimler) erişmeden önce açıkça izin istemesini zorunlu kılar. Bu izinler çalışma zamanında (runtime) istenir — yani kullanıcı, uygulamayı kullanırken, tam da o özelliğe ihtiyaç duyulduğu anda bir izin diyaloğu görür (App Store/Play Store kurulumu sırasında değil).

#Paketi Ekleme ve Platform Ayarları

flutter pub add permission_handler

Paketi eklemek yeterli değildir — her platformun kendi manifest/plist dosyasında da hangi izinleri kullanacağını beyan etmen gerekir:

<!-- android/app/src/main/AndroidManifest.xml -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<uses-permission android:name="android.permission.CAMERA"/>

<!-- ios/Runner/Info.plist -->
<key>NSLocationWhenInUseUsageDescription</key>
<string>Yakınındaki mağazaları gösterebilmek için konumuna ihtiyacımız var.</string>
<key>NSCameraUsageDescription</key>
<string>Profil fotoğrafı çekebilmen için kameraya ihtiyacımız var.</string>

Dikkat et — iOS'taki fark önemli: iOS'ta her izin için neden istediğini açıklayan bir metin (...UsageDescription) zorunludur — bu metin, kullanıcıya gösterilen izin diyaloğunda görünür. Bunu unutursan, uygulaman çalışma zamanında çökebilir (App Store, bu açıklama olmadan uygulamanı reddedebilir de).

#İzin İsteme — Temel Akış

import 'package:permission_handler/permission_handler.dart';

Future<void> konumIzniIste() async {
  final durum = await Permission.location.request();

  if (durum.isGranted) {
    print('İzin verildi, konum alınabilir');
  } else if (durum.isDenied) {
    print('Kullanıcı izni reddetti (tekrar sorulabilir)');
  } else if (durum.isPermanentlyDenied) {
    print('Kullanıcı kalıcı olarak reddetti — ayarlara yönlendirmemiz lazım');
    openAppSettings(); // paketin sunduğu hazır fonksiyon
  }
}

Permission.location — Dart Bölüm 7'de öğrendiğimiz enum benzeri sabit değerler kalıbı (Permission, paketin tanımladığı bir dizi sabit: .camera, .microphone, .contacts, .notification vb.).

.request() — Bölüm 5'te öğrendiğimiz async/await kalıbıyla, izin diyaloğunu gösterir ve kullanıcının kararını bekler — bu yüzden Future<PermissionStatus> döner.

PermissionStatus — bu da bir enum, ama sıradan granted/denied ikilisinden daha zengin:

permanentlyDenied neden önemli? Bir kullanıcı bir izni iki kez reddederse (platforma göre değişir), sistem bunu "kalıcı red" sayar ve uygulamanın bir daha izin diyaloğu göstermesine izin vermez — tek çözüm, kullanıcıyı openAppSettings() ile sistem ayarlarına yönlendirip, izni elle açmasını istemektir.

#İzin İstemeden Önce Kontrol Etmek

Future<void> kameraErisimiKontrolEt() async {
  final durum = await Permission.camera.status; // sadece KONTROL et, sormaz

  if (durum.isGranted) {
    // doğrudan kamerayı aç
  } else {
    final yeniDurum = await Permission.camera.request(); // şimdi SOR
    if (yeniDurum.isGranted) {
      // kamerayı aç
    }
  }
}

.status (sadece okuma) ile .request() (isteme, diyalog gösterme) arasındaki fark önemli — Bölüm 6 Konu 24'te Provider'da öğrendiğimiz context.read (sadece erişim) ile context.watch (aktif katılım) ayrımına kavramsal olarak benzer: biri pasif kontrol, diğeri aktif bir eylem tetikliyor.

#Birden Fazla İzni Aynı Anda İsteme

Future<void> coklulzinIste() async {
  final durumlar = await [
    Permission.camera,
    Permission.microphone,
    Permission.location,
  ].request(); // List<Permission> üzerinde .request()!

  if (durumlar[Permission.camera]!.isGranted &&
      durumlar[Permission.microphone]!.isGranted) {
    print('Video kaydı için gerekli izinler tam');
  }
}

[Permission.camera, ...].request() — Dart Bölüm 4'te öğrendiğimiz List üzerinde, paketin extension method (Dart Bölüm 12'de öğrendiğimiz kavramı hatırla) olarak eklediği bir .request() metodu — birden fazla izni tek bir kullanıcı etkileşiminde ister ve sonucu bir Map<Permission, PermissionStatus> olarak döner.

#UI ile Birleştirme — Gerçekçi Bir Akış

class KonumEkrani extends StatefulWidget {
  const KonumEkrani({super.key});

  @override
  State<KonumEkrani> createState() => _KonumEkraniState();
}

class _KonumEkraniState extends State<KonumEkrani> {
  PermissionStatus? _durum;

  Future<void> _konumIzniIste() async {
    final durum = await Permission.location.request();
    setState(() => _durum = durum); // Bölüm 2 Konu 6 — rebuild tetikleme
  }

  @override
  Widget build(BuildContext context) {
    if (_durum == null) {
      return Center(
        child: ElevatedButton(
          onPressed: _konumIzniIste,
          child: const Text('Konum İznini Ver'),
        ),
      );
    }

    if (_durum!.isGranted) {
      return const Center(child: Text('Konum alınıyor...'));
    }

    if (_durum!.isPermanentlyDenied) {
      return Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            const Text('Konum izni kapalı görünüyor.'),
            TextButton(
              onPressed: openAppSettings,
              child: const Text('Ayarları Aç'),
            ),
          ],
        ),
      );
    }

    return const Center(child: Text('Bu özellik için konum izni gerekli.'));
  }
}

Bu, gerçek uygulamalarda göreceğin standart deseni gösteriyor: her PermissionStatus durumu için farklı bir UI — kullanıcıyı asla "hiçbir şey olmuyor" hissiyle baş başa bırakmamak, özellikle permanentlyDenied durumunda açık bir çıkış yolu (ayarlara yönlendirme) sunmak önemlidir.

#İyi Pratikler — Ne Zaman İzin İstenmeli?

Kötü pratik: Uygulama açılır açılmaz, kullanıcı henüz hiçbir şey yapmadan, tüm izinleri (konum + kamera + bildirim + kişiler) art arda istemek. Bu, kullanıcıyı ürkütür ve genelde hepsinin reddedilmesiyle sonuçlanır.

İyi pratik — "bağlamsal izin isteme" (contextual permission): İzni, kullanıcı tam olarak o özelliği kullanmaya çalıştığı anda iste (örn. "Fotoğraf Çek" butonuna bastığında kamera izni). Bu hem daha anlaşılır (kullanıcı "neden bu izni istiyor" sorusuna kendi kendine cevap bulur) hem de kabul oranını belirgin şekilde artırır.

#🎯 Bu Dersten Çıkarılması Gerekenler

• İzinler çalışma zamanında istenir; Android'de AndroidManifest.xml'de, iOS'ta Info.plist'te (kullanım açıklamasıyla birlikte) beyan edilmesi zorunludur.
• Permission.x.status, sadece kontrol eder; Permission.x.request(), diyaloğu gösterip kullanıcıdan karar ister.
• PermissionStatus, sadece granted/denied değil, permanentlyDenied (kalıcı red — openAppSettings() gerekir), restricted, limited gibi daha zengin durumlar içerir.
• Birden fazla izin, [Permission.a, Permission.b].request() ile tek seferde istenebilir, sonuç bir Map<Permission, PermissionStatus> döner.
• İyi pratik: izinleri, uygulama açılışında değil, kullanıcı tam o özelliğe ihtiyaç duyduğu anda (bağlamsal olarak) istemek.

#📝 Ödevler

• [ ] permission_handler ekle, kamera izni isteyen ve sonucu ekranda (granted/denied/permanentlyDenied) gösteren bir buton yap.
• [ ] permanentlyDenied durumunu simüle et (izni birkaç kez reddet), openAppSettings() ile sistem ayarlarına yönlendiren bir buton ekle.
• [ ] Aynı ekranda hem kamera hem mikrofon iznini tek bir kullanıcı etkileşiminde iste, ikisinin de granted olup olmadığını kontrol et.
• [ ] Kendi cümlelerinle, "neden uygulamanın açılışında tüm izinleri birden istemenin kötü bir pratik olduğunu" açıkla.

Sıradaki konu: Bölüm 9 — Konu 42: Kamera, Konum, Sensörler